Managing Allocations

Managing Project Compute Hour Allocations on Fusion using QBank

Fusion project computer time allocations are managed on the Fusion cluster using the QBank package. This document describes how a user can set their default project, check current project balances, etc. Rather than have the user use the actual QBank commands, which are somewhat obscure and inconsistent with options, a single command "lcrc-qbank"is provided to query and set various data in the QBank database.

Users only have permissions to query and modify their own data unless they are Principal Investigators (PIs) for a project. Because administration of a project is complex, Principal Investigators should use the Fusion Project Management pages to query and set the project data.

Note on Reservations:

You can request to have a reservation of a certain amount of nodes for a time period, however you will be charged for the amount of corehours over the period of the reservation plus the hours while simulations on running. So if you ran a program on all the nodes for the entirety of the duration you would be charged at 2x the normal rate.

 
Usage: lcrc-qbank  
 
Query and set QBank allocation information.
 
Options:
  -h            print this message.
  -d            print lots of output.
  -p <project>  take action for project specified only.
 
 
  -s  default <project>
 
      default: set the default project. <project> must be the name of a
               valid project and must be the last word on the line.
 
  -q [default|balance|trans]
 
      default: print the current default project.
      balance: print the current balances for all projects unless
               -p option is used.
        trans: print the transactions for all projects unless
               -p option is used. To sort transactions, use
               the --sortby option.
 
  -b <MM/DD/YY> restrict transactions to those on or after specified date.
  -e <MM/DD/YY> restrict transactions to those on or prior to specified date.
 
 --sortby [date|jobid|user|none]  only valid with -q trans option.

Command Result
query balance Use to view current balances for all projects. The default project is marked with a *. 
 
[user]$ lcrc-qbank -q balance
Project:          Available (Nodehours)                            
----------------  ---------------------             
*startup-user               769.3864
chemproj                  10000.0000
query default Use to view current default project.
 
[user]$ lcrc-qbank -q default
Default Project: startup-user
query trans Use to view transactions. To see transactions for a specific project, use the -p <project> option, otherwise all transactions for all projects will be shown, grouped by project. To see only transactions after a specific date, use the -b option, otherwise all transactions will be shown. To see only transactions on or prior to a specific date, use the -e option, otherwise all transactions will be shown.
 
[user]$ lcrc-qbank -q trans
      
 
[user]$ lcrc-qbank -q trans -p chemproj
      
 
[user]$ lcrc-qbank -q trans -b "02/14/03" -e "02/15/03" -p chemproj
set default Use to set the default project to a different project. If a user does not specify a project at job submission, the resources used will be withdrawn from the default project at the time of job completion. The project must be a valid project and the user must be a member of the project. If the requested project is the same as the current default project, the request will be ignored.
 
[user]$ lcrc-qbank -s default chemproj
Previous Default Project: startup-user
     New Default Project: chemproj