[[PageOutline(1-10,Page Contents)]]
= 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 -> '''neptuno'''
 
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 `$HOME/.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:

{{{
neptuno =  ssh://userid@IP_neptuno?LRMS_TYPE=neptuno;NODECOUNT=1500
}}}

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]) between '''MACC cluster''' and '''Neptuno''', and '''vice-versa'''. 


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

= Neptuno Running Options  =

[wiki:WRF4Gresources_wrf4g#RunningOptions  Running Options] section is defined in [wiki:WRF4Gresources_wrf4g  resources.wrf4g ] file and its variables of interest are:

 * '''NP''' is the number of processors requested in a parallel job.

 * '''PPN''' indicates the number of processors available per node.

Example of configuration:

{{{
REQUIREMENTS = 'PPN = 16'
NP = 16
}}}

NP = 16 and REQUIREMENTS = 'PPN = 16' which means 16 processors on one node.

= Neptuno Data Repository =

In addition, you need to update `WRF4G_BASEPATH`, `WRF4G_DOMAINPATH`, `WRF4G_INPUT` and `WRF4G_APPS` variables, which are defined in [wiki:WRF4Gresources_wrf4g#DataRepository  resources.wrf4g ] file. Due to the fact that these variables may point to other machines by default. See [wiki:WRF4Gresources_wrf4g#Runningenvironment running environment ] for more information as well.

Example of configuration:

{{{
WRF4G_BASEPATH="rsync://id_user_neptuno@IP_neptuno/home/users/id_user_neptuno/wrf_repos/projects/seawind_ncep/data/raw" 
WRF4G_DOMAINPATH="/home/users/id_user_neptuno/wrf_repos/projects/seawind_ncep/domains"
WRF4G_INPUT="/home/users/id_user_neptuno/wrf_repos/DATA"
WRF4G_APPS="rsync://id_user_neptuno@IP_neptuno/home/users/id_user_neptuno/wrf_repos/apps"
}}}

= Seawing Package Version =

[wiki:WRF4Gresources_wrf4g#PackageVersion  Package Version] section is defined in [wiki:WRF4Gresources_wrf4g  resources.wrf4g ] file.

 * '''WRF4G_VERSION''' : WRF4G version to use. A file WRF4G-[WRF4G_VERSION].tar.gz must exist under `$HOME/etc/templates`. 

 * '''WRF_VERSION''': WRFbin version to use. A file WRFbin-[WRF_VERSION].tar.gz must exist under `$WRF4G_APPS`. 

And for this experiment, we are going to use:

{{{
WRF4G_VERSION="1.0"
WRF_VERSION="3.1.1_r832INTEL_OMPInew"
}}}