Skip to content

RCCTool command

The rcctool command is available on the HPC login nodes. It provides a way to check your account information, HPC job reports, and storage information.

Basic usage#

From any HPC login node, run rcctool. You may have to enter your RCC/HPC username and password:

[USER@h22-login-26 ~]$ rcctool
RCCTool Console Application 6.26.1 (USERNAME)

Usage:
  command [options] [arguments]

Options:
  -h, --help            Display help for the given command. When no command is given display help for the list command
  -q, --quiet           Do not output any message
  -V, --version         Display this application version
      --ansi|--no-ansi  Force (or disable --no-ansi) ANSI output
  -n, --no-interaction  Do not ask any interactive question
  -v|vv|vvv, --verbose  Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

Available commands:
  authenticate              [login|user:login] Login/authenticate user session
  completion                Dump the shell completion script
  help                      Display help for a command
  list                      List commands
 my
  my:account                Provides a summary of your account
  my:jobs                   Lookup your recent or current HPC jobs
  my:password               Rest your RCC password
  my:queues                 [my:partitions] Lists HPC queues that your account has access to
  my:storage                View storage usage for your home directory and for volumes you have access to

Examples#

See an account summary#

[USER@h22-login-25 ~]$ rcctool my:account
Person: User McUser
+-----------------+-----------------------------------------+
| Status          | Active                                  |
| FSUID           | abc12a                                  |
| Email Address   | abc12a@fsu.edu                          |
| Signed Up       | 2012-03-27 00:00:00 (11 years ago)      |
| Affiliation     | Sponsored                               |
| Can Sponsor     | Yes                                     |
| Department      | Information Technology Service (ITS)    |
| Sponsor         | Faculty McLastname                      |
| Approved        | 2024-01-29 09:51:28 (1 month ago)       |
| Sync with FSUID | Yes                                     |
+-----------------+-----------------------------------------+
Account: abc12a (68169)
+------------------+-----------------------------------------------------------------------------------------------------------+
| Username         | abc12a                                                                                                    |
| Unix ID          | 12345                                                                                                     |
| Display Name     | User McUser                                                                                               |
| Password Changed | 2022-12-29 08:53:26 (1 year ago)                                                                          |
| Created          | 2012-03-27 00:00:00 (11 years ago)                                                                        |
| Shell            | /bin/bash                                                                                                 |
| Home directory   | /gpfs/home/USER                                                                                           |
|                  |                                                                                                           |
| Groups           | genacc (513) - General Access | enrolled 2018-05-08 11:28:56 (5 years ago)                                |
|                  | workshop (60151) - WorkshopGroup | enrolled 2022-02-07 13:34:08 (2 years ago)                             |
|                  |                                                                                                           |
| Resources        | HPC Queue: workshop (Workshop Queue)                                                                      |
|                  | Storage Volume: system_gpfs (System software)                                                             |
|                  | HPC Queue: condor (Condor Partition)                                                                      |
|                  | HPC Queue: quicktest (Quick Test Queue)                                                                   |
|                  | HPC Queue: backfill2 (Backfill 2 Queue)                                                                   |
|                  | HPC Queue: genacc_q (General Access Queue)                                                                |
|                  | HPC Queue: backfill (Backfill Queue)                                                                      |
|                  | Storage Volume: gpfs_software_gpfs (Global HPC software)                                                  |
|                  |                                                                                                           |
+------------------+-----------------------------------------------------------------------------------------------------------+

Check your storage quotas for all RCC volumes#

1
2
3
4
5
6
7
8
[USER@h22-login-25 ~]$ rcctool my:storage
+-------------------+----------------+--------------------------------------+-----------+------------+----------------+--------+
| Volume            | Storage System | Timestamp                            | Used (GB) | Quota (GB) | Available (GB) | Used % |
+-------------------+----------------+--------------------------------------+-----------+------------+----------------+--------+
| /gpfs/home/USER   | HPC Home       | 2024-02-29 12:25:54 (0 seconds ago)  |      9.97 |     150.00 |         140.03 |  6.65% |
| software          | HPC            | 2024-02-29 11:30:51 (55 minutes ago) |  1,536.46 |   5,562.00 |       4,025.54 | 27.62% |
| system            | HPC            | 2024-02-29 11:30:35 (55 minutes ago) |  4,303.74 |   7,000.00 |       2,696.26 | 61.48% |
+-------------------+----------------+--------------------------------------+-----------+------------+----------------+--------+

See information about your Slurm accounts (queues/partitions)#

[USER@h22-login-25 ~]$ rcctool my:queues genacc_q --nodes
Queue: General Access Queue
+------------------------------------+-------------------------------+
| Enabled                            | ✔                             |
| Name                               | genacc_q                      |
| Default Job Time                   | 14-00:00:00 (14 days)         |
| Max Job Time                       | 14-00:00:00 (14 days)         |
| Max Jobs/User (queued and running) | 100                           |
| Max Jobs/User (running)            | 75                            |
| Max Cores/Job                      | 400                           |
| Default Memory/CPU                 | 1.9GB                         |
| Max Memory/CPU                     | 4.0GB                         |
| CPU Core Limit                     | 100,000                       |
| Pricing Type                       | n/a (general access)          |
| Node Pools                         | General Access Nodes (genacc) |
| Owning Groups                      | genacc                        |
+------------------------------------+-------------------------------+
453 Nodes / 9,472 cores (use sinfo -p genacc_q to get node status)
The genacc_q queue has access to 100000 cores on these nodes
+--------------+------+-------------------------------------------+-------+--------+----------+
| Name         | Year | Platform                                  | Cores | Memory | Features |
+--------------+------+-------------------------------------------+-------+--------+----------+
| hpc-r34-10   | 2023 | Quad-Core AMD Opteron(tm) Processor 2356  | 8     | 15GB   |          |
| hpc-i33-8-4  | 2012 | Intel(R) Xeon(R) CPU E5-2670 0 @ 2.60GHz  | 16    | 64GB   |          |
| hpc-i30-7    | 2010 | AMD Opteron(tm) Processor 6174            | 48    | 128GB  |          |
| hpc-d33-6-1  | 2013 | Intel(R) Xeon(R) CPU E5-2670 0 @ 2.60GHz  | 16    | 64GB   |          |
| hpc-i29-15   | 2010 | AMD Opteron(tm) Processor 6174            | 48    | 128GB  |          |
| hpc-d32-5-4  | 2013 | Intel(R) Xeon(R) CPU E5-2670 0 @ 2.60GHz  | 16    | 64GB   |          |
| hpc-i32-3    | 2010 | AMD Opteron(tm) Processor 6174            | 48    | 128GB  |          |
| etc...       | etc  | etc...                                    | etc   | etc    | etc...   |
+--------------+------+-------------------------------------------+-------+--------+----------+
. Note: Node names are subject to change periodically

Submitting bug reports#

Please submit bug reports through our case management system.