- How do I gain access to Rivanna?
- How do I log on to Rivanna?
- How do I reset my current password / obtain a new password?
- How do I check my allocation status on Rivanna?
- How do I add or remove people from my allocations?
- How do I use research software that's already installed?
- Does ARCS install research software?
- Is there any other way to install research software that I need?
- How do I submit jobs?
- How do I submit an interactive job?
- What queues can I use?
- How do I choose which queue to use?
- How do I check the status of my jobs?
- Why is my job not starting?
- Why was my job killed?
- Why can't I submit jobs anymore?
- How do I check the efficiency of my completed jobs?
- How do I obtain leased storage?
- How do I check my /scratch usage on Rivanna?
- How do I share data from my /scratch directory or my group's leased storage with a colleague?
- How do I check how much storage I am using on Rivanna?
- What if my question doesn't appear here?
How do I gain access to Rivanna?
A faculty or research staff member must first set up an allocation group using Mygroups. After that, users added to the group will be automatically set up with an account after an hour or so. Full details can be found here.
How do I log on to Rivanna?
Use an SSH client from a campus-connected machine and connect to rivanna.hpc.virginia.edu. Instructions for using ssh and other login tools, as well as recommended clients for different operating systems, are here. You can also use FastX. If you are off Grounds you must use the UVA Anywhere VPN.
How do I reset my current password / obtain a new password?
Access to the HPC cluster requires a valid Eservices password. Your Netbadge password is not necessarily the same thing, so if you are unable to log in, you should first try resetting your Eservices password here. If the problem persists, contact ITS (which manages all Eservices accounts) through the group's online.
How do I check my allocation status on Rivanna?
In all cases you will need to use an account with remaining service units in order to submit jobs.
How do I add or remove people from my allocations?
You must use the MyGroups interface to do this, and you must have administrative access to the group.
How do I use research software that's already installed?
We use the Lmod system for managing software environments. More information is here.
Does ARCS install research software?
ARCS will install software onto Rivanna if it is of wide applicability to the user community. Software used by one group should be installed by the group members, ideally onto leased storage for the group. We can provide assistance for individual installations.
For help installing research software on your PC, please contact Research Software Support at email@example.com.
Is there any other way to install research software that I need?
Some groups and departments have installed a bundle of software they need into shared space. Please see your departmental IT support personnel if your department has its own bundle.
How do I submit jobs?
You submit jobs by writing a SLURM script and submitting it with the sbatch command. Please see our SLURM documentation page.
How do I submit an interactive job?
You may use the locally-written ijob command to submit an interactive job. The minimum required options are -A and -c for allocation and number of cores. Run ijob -h for a list of all options.
If you wish to forward X11 in order to use a graphical user interface or to run other graphics programs, on the Rivanna frontend node run ssh -Y $HOSTNAME before you run ijob.
For more information see the documentation.
What queues can I use?
After logging in, run the command queues to see a list of queues to which you have access and their current status.
How do I choose which queue to use?
Queues (partitions to SLURM) are set up to emphasize one-core (serial or threaded), multi-node parallel, and specialty hardware including large-memory nodes and GPUs. More information about queue policy is at the Rivanna homepage.
How do I check the status of my jobs?
If reporting a problem to us about a particular job, please let us know the JobID for the job that you are having a problem with. You can also run jobq -l to relate particular jobs to specific submission scripts.
Why is my job not starting?
Several things can cause jobs to wait in the queue. If you request a resource combination we do not have, such as 28 cores on a parallel node, the queueing system will not recognize that this condition will not be met and will leave the job pending (PD). You may also have run a large number of jobs in the recent past and the "fair share" algorithm is allowing other users higher priority. Finally, the queue you requested may simply be very busy. If your job is pending there will be another field with the reason; if it is Resources that means that the resource you requested isn't available, either because it is busy or because you requested a nonexistent resource. If the reason is "Priority" it means that a job with higher priority than yours is running. Your job will rise in priority as it waits so it will start eventually. To request an estimate from the queueing system of your start time, run squeue -u <mst3k> --start (substitute your own login for mst3k).
Why was my job killed?
Usually this is because you inadvertently submitted the job to run in a location that the compute nodes can't access or is temporarily unavailable. If your jobs exit immediately this is usually why. Other common reasons include using too much memory, too many cores, or running past a job's timelimit.
You can run sacct:
[aam2y@udc-ba36-27:/root] sacct JobID JobName Partition Account AllocCPUS State ExitCode ------------ ---------- ---------- ---------- ---------- ---------- -------- 159637 ompi_char+ parallel hpc_admin 80 COMPLETED 0:0 159637.batch batch hpc_admin 1 COMPLETED 0:0 159637.0 orted hpc_admin 3 COMPLETED 0:0 159638 ompi_char+ parallel hpc_admin 400 TIMEOUT 0:1 159638.batch batch hpc_admin 1 CANCELLED 0:15 159638.0 orted hpc_admin 19 CANCELLED 255:126
If it's still not clear why your job was killed, please contact us and send us the output from sacct.
Why can't I submit jobs anymore?
In order to be allowed to submit jobs, you must not be overallocated with your /scratch usage and you must have some remaining service units. Please check the output of sfsq and/or allocations to determine what the problem is.
How do I check the efficiency of my completed jobs?
If your rating is low, please contact us: we can help.
How do I obtain leased storage?
You can lease Enterprise or Value storage from here. You should receive a path to which the share can be mounted to Rivanna as well as a path for mounting to Windows or Mac. Please contact us that you wish to have the storage mounted, or if you encounter any problems accessing your leased storage.
How do I check my /scratch usage on Rivanna?
If you have used up too much space, created too many files, or have "old" files you may be regarded as "overallocated". Please note that if you are overallocated, you won't be able to submit any new jobs until you clean up your /scratch folder.
How do I share data in my /scratch or leased storage with a colleage?
To share data from your /scratch directly with any other user, use Globus sharing. If your colleague also has an account on Rivanna, he or she does not need to set up a personal endpoint but can simply log into the uva#main-DTN endpoint and navigate to his or her /scratch directory to transfer the files.
If you wish to share data in leased space with a member of your group, be sure that permissions are set so that the group member can access your subdirectory. The college can then simply use the data directly, or copy it elsewhere. If you wish to share data from your leased storage to a colleague who is not a member of the group, use Globus sharing in the same manner as sharing /scratch.
How do I check how much leased or home storage I am using on Rivanna?
To check your home space, run hdquota (home directory quota).
To check your leased space, change directory into your your leased space and then run df -h /nv/volX/yourshare, where volX is your leased storage volume and your share name is the name of the group set up for the storage: