| | 1 | == How to add new Neptuno facilities to WRF4G == |
| | 2 | |
| | 3 | WRF4G uses [wiki:DRM4G DRM4G] to access to different Distributed Resource Managements (DRM) such as: |
| | 4 | |
| | 5 | * PBS/Torque |
| | 6 | * SGE |
| | 7 | * FORK |
| | 8 | * !LoadLeveler |
| | 9 | * SLURM |
| | 10 | |
| | 11 | In order to add new resources, you need to edit `ComputingResources` section in the [wiki:WRF4Gframework4g_conf framework4g.conf] file which is located under `$WRF4G_LOCATION/etc` directory. The file has to contain one resource per line with the format: |
| | 12 | |
| | 13 | {{{ |
| | 14 | resource_name = attributes |
| | 15 | ... ... |
| | 16 | resource_name = attributes |
| | 17 | }}} |
| | 18 | |
| | 19 | where: |
| | 20 | * '''resource_name''': It is the name of the computing resource. |
| | 21 | * '''attributes''': They are the static attributes of the computing resource. The syntax is: |
| | 22 | * `<scheme>://<username>@<host:port>?<query>` |
| | 23 | * '''scheme''': URL schemes available are "ssh" and "local". |
| | 24 | * '''ssh''': In order to connect to remote resource via SSH |
| | 25 | * '''local''': In order to use a local resource |
| | 26 | * '''username''': user name on the resource |
| | 27 | * '''host''': host name |
| | 28 | * '''port''': host port to connect to. By DEFAULT is 2 |
| | 29 | * '''query''': contains additional information of computing resources. The query string syntax is: |
| | 30 | * key1=value1;key2=value2;key3=value3 |
| | 31 | |
| | 32 | The keys available are: |
| | 33 | * '''LRMS_TYPE'''(mandatory): Type of LRMS system [pbs | sge | fork | slurm ] |
| | 34 | * '''NODECOUNT'''(mandatory): Maximum number of job slots for a resource. |
| | 35 | * '''QUEUE_NAME'''(mandatory): Queue name to configure. It is mandatory except for "LRMS_TYPE=fork" |
| | 36 | * '''SSH_KEY_FILE'''(optional): It defines the key file for "ssh" connection. By DEFAULT is ~/.ssh/id_rsa. |
| | 37 | * '''PROJECT'''(optional): It specifies the project which the jobs are assigned. It is only optional for SGE and PBS. |
| | 38 | * '''PARALLEL_TAG'''(optional): It defines the parallel environments available for SGE. |
| | 39 | * '''TEMP_DIR'''(optional): Temporary directory on the resource to store data. By DEFAULT is $HOME. TEMP_DIR path must be absolute. |
| | 40 | * '''RUN_DIR'''(optional): Temporary directory used to run WRF Model on the resource. By DEFAULT is $HOME. RUN_DIR path must be absolute. |
| | 41 | |
| | 42 | Examples of configuration: |
| | 43 | |
| | 44 | If you want to configure a remote computing resource through ssh protocol, you need to put your private keys into your [[http://en.wikipedia.org/wiki/Ssh-agent|ssh-agent]], and it will handle your authentication thereafter (see [wiki:DRM4G#AppendixA Appendix A]) or set up SSH login without ''password'' (see [wiki:DRM4G#AppendixB Appendix B]). |
| | 45 | |
| | 46 | In addition, you will probably need to update `WRF4G_BASEPATH`, `WRF4G_DOMAINPATH`, `WRF4G_INPUT` and `WRF4G_APPS` variables, which are defined in [wiki:WRF4Gresources_wrf4g resources.wrf4g ]. Due to the fact that these variables may point to other machines. See [wiki:WRF4Gresources_wrf4g#Runningenvironment running environment ] for more information. |
| | 47 | {{{ |
| | 48 | remote_PBS = ssh://userid@193.144.213.182?LRMS_TYPE=neptuno;NODECOUNT=1500 |
| | 49 | }}} |
| | 50 | |
| | 51 | [[NoteBox(warn, After modifying `ComputingResources` section\, WRF4G takes few seconds in order to update the changes)]] |
| | 52 | |
