3.4 Job Scripts
This topic provides information about the different job scripts, including customization options (where applicable).
In this topic
The nitro_job.sh script is located in the /opt/nitro/etc/ directory.
Typically the nitro_job.sh script is customized by the system administrator and executed by the nitrosub command. This job script is used for static jobs, if resources are not in a range. For dynamic jobs, it sets up the initial resource request (minimum resource value in the range).
Alternatively, the system administrators can modify the nitro_job.sh script and then have authorized users copy and customize the script for their task file. This script is then executed using the resource manager's job submission command (for example, Torque's qsub). This functionality is similar to the Nitro functionality prior to version 2.1.
The nitro_job.sh script:
- Defines path to your task file (NITRO_TASK_FILE)
- Defines the directory to which Nitro writes log files (NITROJOBDIR). This directory can be used to store output files from your tasks.
- Executes the launch_nitro.sh script (last line in the script)
In the nitro.job.sh script, can also customize the launch_nitro.sh script.
- NITROJOBID – Job ID used by Nitro. If not provided, this ID is based on the resource manager's job ID.
Unless you are restarting a job that partially completed and was canceled, you don't need to set this environment variable. If you specify this environment variable in the job's submission, it will override the resource manager job ID and Nitro will use the value you supplied.
If your job scheduler and resource manager use different numbering systems, the job ID that Nitro will use is the one that it gets from the resource manager. You may want to submit the job directly to the resource manager in this case to avoid confusion. Check with your system administrator to find out if your job scheduler's and resource manager's job ids are synchronized.
- Command line options – Any command line options you want passed to the launch_nitro.sh script must be contained in the NITRO_OPTIONS, NITRO_COORD_OPTIONS, or NITRO_WORKER_OPTIONS environment variables. See 3.2 Command Line Flags or Options or Environment Variables for more information.
The worker_job.sh script is located in the /opt/nitro/etc/ directory.
The worker_job.sh script is executed only by the nitrosub command. This job script is used for the dynamic portion of dynamic jobs (resources after the initial request up to the maximum value).
- Defines the job ID for the coordinator set up by the nitro_job.sh script for the first part of the dynamic job submission (NITROJOBID).
- Defines the directory to which Nitro writes log files (NITROJOBDIR). This directory can be used to store output files from your tasks.
- Executes the launch_worker.sh script (last line in the script).