== How to add Neptuno facilities to WRF4G ==

WRF4G uses [wiki:DRM4G DRM4G] to access to different Distributed Resource Managements (DRM) such as:

* PBS/Torque
* SGE
* FORK
* !LoadLeveler
* '''SLURM'''
 
In order to add new resources, you need to edit [wiki:WRF4Gframework4g_conf#ComputingResources Computing Resources] section in the [wiki:WRF4Gframework4g_conf framework4g.conf] file, which is located under `$HOME/WRF4G/etc` directory. The file has to contain one resource per line with the format:

{{{
   resource_name  = attributes
   ...     ...
   resource_name  = attributes
}}}

where:
* '''resource_name''': It is the name of the CR.
* '''attributes''': They are the static attributes of the CR. The syntax is:
 * `<scheme>://<username>@<host:port>?<query>`
  * '''scheme''':  URL schemes available are "ssh" and "local".
    * '''ssh''':   In order to connect to remote resource via SSH
    * '''local''': In order to use a local resource
  * '''username''': user name on the resource
  * '''host''': host name
  * '''port''': host port. By DEFAULT it is 22
  * '''query''': contains additional information of computing resources. The query string syntax is:
    * key1=value1;key2=value2;key3=value3

The keys available are:
* '''LRMS_TYPE'''(mandatory): Type of LRMS system ('''neptuno''')
* '''NODECOUNT'''(mandatory): Maximum number of job slots for a resource.
* '''SSH_KEY_FILE'''(optional): It defines the key file for "ssh" connection. By DEFAULT it is ~/.ssh/id_rsa.
* '''TEMP_DIR'''(optional): Temporary directory on the resource to store data. By DEFAULT it is `$HOME`. TEMP_DIR path must be absolute.
* '''RUN_DIR'''(optional): Temporary directory used to run WRF Model on the resource. By DEFAULT it is `$HOME`. RUN_DIR path must be absolute.

Example of configuration:

If you want to configure Neptuno facilities using '''ssh''' protocol, you need to set up SSH login without ''password'' (see [wiki:DRM4G#AppendixB Appendix B]). 

In addition, you need to update `WRF4G_BASEPATH`, `WRF4G_DOMAINPATH`, `WRF4G_INPUT` and `WRF4G_APPS` variables, which are defined in [wiki:WRF4Gresources_wrf4g  resources.wrf4g ] file. Due to the fact that these variables may point to other machines. See [wiki:WRF4Gresources_wrf4g#Runningenvironment running environment ] for more information.
{{{
neptuno =  ssh://userid@193.144.213.182?LRMS_TYPE=neptuno;NODECOUNT=1500
}}}

[[NoteBox(warn, After modifying `ComputingResources` section\, WRF4G takes few seconds in order to update the changes)]]