Changes between Initial Version and Version 1 of WRF4Ggihc


Ignore:
Timestamp:
May 3, 2013 10:19:55 AM (9 years ago)
Author:
carlos
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WRF4Ggihc

    v1 v1  
     1== How to add new Neptuno facilities to WRF4G ==
     2
     3WRF4G 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 
     11In 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
     19where:
     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
     32The 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
     42Examples of configuration:
     43
     44If 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
     46In 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{{{
     48remote_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