4.5 Configuring streaming job output
The job output page allows a user to view the standard output and standard error files for a job as the job is running and after the job completes. The page is accessible via the get-output button in the Configuring Job Management Buttons page (for details, see Configuring buttons in the Job Management table).
To configure streaming job output
- Open the jobs.xml file located in the Viewpoint home directory and locate the <job-management> element.
- Insert the <spool-dir> element to enable streaming job output. Point it to the directory where Viewpoint can read the job output files.
<spool-dir>/var/spool/torque/spool</spool-dir>
Since Viewpoint assumes the job output files are contained in the specified directory both while the job is running and after it is completed, you must configure the file system where the spool directory is located.
- Configure the resource manager that runs the jobs.
Set the resource manager to place job output files in the specified directory and keep them there after the job completes. If Viewpoint and any of the MOM daemons are running on different machines (which is the typical scenario), the spool directory must be configured as a shared network directory to which all MOMs and Viewpoint share access.
- Configure the <stdout-format> element to describe the file format of the job’s stdout stream. This element allows for string interpolation in the same way as the <title> element for job management. By default, these parameters are configured to use the format TORQUE uses when $spool_as_final_name is configured and a directory is specified via the -o and -e flags for qsub. The format is $name.o$id for stdout and $name.e$id for stderr. (For more information, see the TORQUE Administrator Guide.)
<stdout-format>$name.o$id</stdout-format>
- Configure the <stderr-format> element to describe the file format of the job’s stderr stream in the same way that the <stdout-format> element is configured.
<config>
...
<job-management>
<spool-dir>/var/spool/torque/spool</spool-dir>
<stdout-format>$name.o$id</stdout-format>
<stderr-format>$name.e$id</stderr-format>
...
</job-management>
</config>
Related topics
