Changes between Version 1 and Version 2 of net.sf.basedb.opengrid/install


Ignore:
Timestamp:
Jan 12, 2017, 9:42:27 AM (2 years ago)
Author:
nicklas
Comment:

Started to write the configuration section

Legend:

Unmodified
Added
Removed
Modified
  • net.sf.basedb.opengrid/install

    v1 v2  
    1717 8. Go to '''Administrate->Services''' and check that the ''Open Grid Scheduler service'' is running.
    1818 
     19== Configuration ==
     20
     21Configuration settings are stored in the `opengrid-config.xml` file which should be located in the BASE `WEB-INF/classes` directory. The file is an XML file with a top-level `<opengrid>` tag and then one or more `<cluster>` tags. Each `<cluster>` tag defines a unique user + Open Grid Cluster combination. The following attributes are defined for the `<cluster>` tag:
     22
     23|| '''Attribute''' || '''Required''' || '''Description''' ||
     24|| name || yes || A readable name that is intended to be used in interfaces with users. ||
     25|| address || yes || Network address or IP number to the master host of the Open Grid Cluster. ||
     26|| port || no || Port number that accepts SSH connections (default value is 22) ||
     27|| fingerprint || yes || SSH fingerprint formatted as a 16 two-digit hexadecimal numbers separated with ':' ||
     28|| user || yes || Username to use when connecting to the Open Grid Cluster. ||
     29|| password ||yes || Password to use when connecting to the Open Grid Cluster. ||
     30
     31Example:
     32{{{
     33<cluster
     34  name="Open Grid"
     35  address="grid.example.com"
     36  port="22"
     37  fingerprint="6a:b1:88:54:78:34:a9:60:ef:81:95:79:6a:c8:49:8a"
     38  user="griduser"
     39  password="gridpassword"
     40>
     41}}}
     42
     43You may add as many `<cluster>` tags as you like if you have more than one Open Grid Cluster or if you want to configure access for multiple users to the same cluster. The only restriction is that the combination of `user`, `address` and `port` must be unique. Internally, an ID for each definition is created by combining the three values. Note that the port number is always included even if it is not present in the configuration file. The example about will get an ID like `griduser@grid.example.com:22`. The ID is important since this is what other extensions have to use in order to find the correct Open Grid Cluster and to be able to connect to it and submit jobs.
     44
     45Inside each `<cluster>` tag there are also several sub-tags that need to be configured:
     46
     47|| '''Sub-tag''' || '''Required''' || '''Default value''' || '''Description''' ||
     48