Spirit Quick Start Guide
Table of Contents
- 1. Introduction
- 2. Get a Kerberos Ticket
- 3. Connect to Spirit
- 4. Home, working, and center-wide directories
- 5. Transfer files and data to Spirit
- 6. Submit jobs to the batch queue
- 7. Batch queues
- 8. Monitoring your job
- 9. Saving your work
- 10. Modules
- 11. Available software
- 12. Advance Reservation Service
This document provides a brief summary of information that you'll need to know to quickly get started working on Spirit. For more detailed information, see the Spirit User Guide.
2. Get a Kerberos Ticket
For security purposes, you must have a current Kerberos ticket on your computer before attempting to connect to Spirit. A Kerberos client kit must be installed on your desktop to enable you to get a Kerberos ticket. Information about installing Kerberos clients on your Windows desktop can be found at HPC Centers: Kerberos & Authentication.
3. Connect to Spirit
Spirit can be accessed via Kerberized ssh as follows:% ssh email@example.com
4. Home, working, and center-wide directories
Each user has file space in the $HOME, $WORKDIR, and $CENTER directories. The $HOME, $WORKDIR, and $CENTER environment variables are predefined for you and point to the appropriate locations in the file systems. You are strongly encouraged to use these variables in your scripts.
NOTE: $WORKDIR is a "scratch" file system, and $CENTER is a center-wide file system that is accessible to all center production machines, including the Utility Server. Neither of these file systems is backed up. You are responsible for managing files in your $WORKDIR and $CENTER directories by backing up files to the archive server and deleting unneeded files. Currently, $WORKDIR files older than 15 days and $CENTER files older than 30 days are subject to being purged.
5. Transfer files and data to Spirit
File transfers to DSRC systems must be performed using Kerberized versions of the following tools: scp, ftp, sftp, and mpscp. For example, the command below uses secure copy (scp) to copy a local file into a destination directory on a Spirit login node.% scp local_file firstname.lastname@example.org:/target_dir
6. Submit jobs to the batch queue
The Portable Batch System (PBS Professional ™) is the workload management system for Spirit. To submit a batch job, use the following command:qsub [ options ] my_job_script
where my_job_script is the name of the file containing your batch script. For more information on using PBS or on job scripts, see the Spirit User Guide, the Spirit PBS Guide, or the sample script examples in the $SAMPLES_HOME directory on Spirit.
7. Batch queues
The following table describes the PBS queues available on Spirit:
|Highest||urgent||Urgent||168 Hours||36720||Jobs belonging to DoD HPCMP Urgent Projects.|
|debug||Debug||1 Hour |
|User testing;In the debug queue, you may use 736 cores for 1 hour or 1472 cores for 1/2 hour.|
|high||High||168 Hours||36720||Jobs belonging to DoD HPCMP High Priority Projects.|
|challenge||Challenge||168 Hours||36720||Jobs belonging to DoD HPCMP Challenge Projects.|
|standard||Standard||168 Hours||36720||Standard jobs.|
|transfer||N/A||12 Hours||1||Data transfer for user jobs.|
|Lowest||background||Background||120 Hours||32||Unrestricted Access - no allocation charge.|
8. Monitoring your job
You can monitor your batch jobs on Spirit using the qpeek, qview, or qstat commands.
The qstat command lists all jobs in the queue. The "-u username" option shows only jobs owned by the given user, as follows:
% qstat -u smith Req'd Req'd Elap Job ID Username Queue Jobname SessID NDS TSK Memory Time S Time -------- -------- -------- --------- ------ --- --- ------ ----- - ----- 1570853 smith background tw2 -- 1 1 -- 12:00 R 01:12 1570854 smith challenge inspect -- 16 1 -- 06:00 Q -- 1570939 smith standard 45dh8 -- 2 1 -- 02:00 R 00:22
Notice that the output contains the JobID for each job. This ID can be used with the qpeek, qview, qstat, and qdel commands.
To delete a job, use the command "qdel jobID".
To view a partially completed output file, use the "qpeek jobID" command.
9. Saving your work
When your job is finished, you should archive any important data to prevent automatic deletion by the purge scripts.
Copy one or more files to the archive server
archive put [-C path ] [-D] [-s] file1 [file2 ...]
Copy one or more files from the archive server
archive get [-C path ] [-s] file1 [file2 ...]
For more information on archiving your files, see the Archive Guide.
Software modules are a very convenient way to set needed environment variables and include necessary directories in your path so that commands for particular applications can be found. Spirit uses "modules" to initialize your environment with COTS application software, system commands and libraries, compiler suites, environment variables, and PBS batch system commands.
A number of modules are loaded automatically as soon as you log in. To see the modules that are currently loaded, run "module list". To see the entire list of available modules, run "module avail". You can modify the configuration of your environment by loading and unloading modules. For complete information on how to do this, see the Modules User Guide.
11. Available software
A list of software on Spirit is available on the software page.
12. Advance Reservation Service
A subset of Spirit's nodes has been set aside for use as part of the Advanced Reservation Service (ARS). The ARS allows users to reserve a user-designated number of nodes for a specified number of hours starting at a specific date/time. This service enables users to execute interactive or other time-critical jobs within the batch system environment. The ARS is accessible via most modern web browsers at https://reservation.hpc.mil/. Authenticated access is required. An ARS User's Guide is available online once you have logged in.