sbank Example Commands
Below is a set of helpful commands to help you better manage the projects you have running at the ALCF.
View your project's allocations
Command: sbank-list-allocations
Use this command to list all of your active allocations for a specific project [Project-X]. This is useful when you need to provide this information in a report.
> sbank-list-allocations -p ProjectX -r all
Id Start End Resource Project Jobs Charged Available Balance
--------- ---------- ---------- --------- --------------- ---------- --------------- -----------------
2106 2016-01-04 2017-01-01 cooley ProjectX 1,139 6,032.8 43,967.2
2146 2016-01-14 2017-01-10 theta ProjectX 983 1,084,770.3 25,483,927.5
6438 2020-09-22 2022-01-01 thetagpu ProjectX 3 0.0 2,000.0
Totals:
Rows: 3
Cooley:
Available Balance: 43,967.2 node hours
Charged : 6,032.8 node hours
Jobs : 1,139
Theta:
Available Balance: 25,483,927.5 node hours
Charged : 1,084,770.3 node hours
Jobs : 983
Thetagpu:
Available Balance: 2,000.0 node hours
Charged : 0.0 node hours
Jobs : 3
List your project's quota on Grand and/or Eagle File system
> sbank-list-allocations -p ProjectX -r grand
Allocation Suballocation Start End Resource Project Quota
---------- ------------- ---------- ---------- -------- ----------- -----
6687 6555 2020-12-16 2022-01-01 grand ProjectX 1.0
Totals:
Rows: 1
Grand:
Quota: 1.0 TB
> sbank-list-allocations -p ProjectX -r eagle
Allocation Suballocation Start End Resource Project Quota
---------- ------------- ---------- ---------- -------- ----------- -----
6688 6556 2020-12-16 2022-01-01 eagle ProjectX 1.0
Totals:
Rows: 1
Eagle:
Quota: 1.0 TB
List only the created timestamp field for all allocations that were created before 01-01-2015 for ProjectX accross all resources
> sbank-list-allocations --created "<20150101" -r all -p ProjectX "-f created"
Created
----------
2016-01-04
2016-01-14
2016-01-15
Totals:
Rows: 3
Date filters (UTC): created < "2015-01-01 00:00:00",
List all active allocations for all resources for project ProjectX and add the field Created to the display list
shrubbery~ > sbank-list-allocations -r all -p ProjectX -f "+created"
Id Start End Resource Project Jobs Charged Available Balance Created
--------- ---------- ---------- --------- --------------- ---------- --------------- ----------------- ----------
279 2011-08-30 2020-01-01 theta ProjectX 6,361 12,332,699.9 -12,332,699.9 2013-02-22
2106 2016-01-04 2017-01-01 cooley ProjectX 1,150 6,080.9 43,919.1 2016-01-04
Totals:
Rows: 2
Theta:
Available Balance: -12,332,699.9 node hours
Charged : 12,332,699.9 node hours
Jobs : 6,361
Cooley:
Available Balance: 43,919.1 node hours
Charged : 6,080.9 node hours
Jobs : 1,150
List all available fields for the sbank-list-allocations command
> sbank-list-allocations -f "?"
available fields:
id
start_timestamp
end_timestamp
resource
project_name
jobs_count
charged_sum
available_balance_sum
created_timestamp
award_category
award_type_name
admin_name
cbank_ref
comment
View your project's users
Command: sbank-list-users
List all charges for userx on theta on project ProjectX
> sbank-list-users -p ProjectX -r theta -u userx
User Jobs Charged
--------------- ---------- ---------------
userx 1,814 9,884.5
Totals:
Rows: 1
Resources: theta
Charged: 9,884.5 node hours
Jobs : 1,814
```
### List charges for all users in ProjectX on Cooley.
This works for project leads (i.e. PIs, Co-PIs, Proxies), since they can see everything in their own projects.
sbank-list-users -p ProjectX -r theta User Jobs Charged
user1 120 4,243.7 user2 0 0.0 user3 0 0.0 user4 181 1,195.5 user5 0 0.0 user6 2,560 10,868.7 user7 0 0.0 user8 0 0.0 user9 0 0.0 user10 7 3.5 user11 0 0.0
Totals: Rows: 11 Resources: theta Charged: 16,311.4 node hours Jobs : 2,868
## View your project's jobs
List jobs for user "userx" for jobs that started in the range 2016-02-15<= started < 2016-02-29 and add the transactions related to the job
### **Command:** sbank-list-jobs
**Note:** The job with the refund ```transaction_ids_list field can be shorten all the way to "t" in the -f "+ t"```
1013857 730417 theta ProjectX 1740 userx 1:53:07 61,776.8 CHARGE-1011230
1013860 730558 theta ProjectX 1740 userx 1:53:07 61,776.8 CHARGE-1011233
1014168 730668 theta ProjectX 1740 userx 1:53:25 61,940.6 CHARGE-1011541
Totals: Rows: 3 Theta: Charged : 185,494.2 node hours Duration : 6:44:00 Date filters (UTC): "2016-02-15 00:00:00" <= start < "2016-02-29 00:00:00",
### List the nodes used, runtime and start timestamp for Cooley job 744160
**Note**: To display the date and time we increased the the number of characters of start_timestamp to 19
## View your project's transactions
### **Command:** sbank-list-transactions
List of transactions that where at or after 2016-02-29 for ProjectX add fields: job_duration, nodes_used and hosts
**Note**:
- job_duration, nodes_used and hosts are shorten, but they are still uniquely identified
- host has the left justified width of 20, specified as "h:-20"
1025426 theta ProjectX 2147 2016-02-29 userx CHARGE 48,005.1 740587 1:27:54 2048 MIR-00800-33BF1-2048 1028046 theta ProjectX 2147 2016-03-01 userx CHARGE 147,647.1 742090 4:30:21 2048 MIR-40000-733F1-2048 1028755 theta ProjectX 2147 2016-03-02 userx CHARGE 1,576,068.0 742126 6:00:44 16384 MIR-04000-77FF1-1638
Totals:
Rows: 3
Theta:
Charges Amount: 1,771,720.2 node hours
Job Duration : 11:58:98
Date filters (UTC) : at >= "2016-02-29 00:00:00",
```