Projects and charges

Listing project codes | Changing project codes | Charging formula

Project codes

Every HPSS user has a default project code. This code ties your usage to a related "account number" and allocation.

SAM image
Click for the Systems Accounting Manager.

Unless you specify otherwise, your default project code is used for the purpose of charging for HPSS storage. If you have a project code for charging jobs on computing resources, you can usually use the same project code for HPSS charges.

Some users have access to project codes for more than one project. To get a list of your available project codes and determine which one is your default, see the Systems Accounting Manager (SAM).

You can also use SAM to change your default project code should you need to at some point, such as when a project expires.

Below are some HSI commands that will help you ensure that resource usage is charged to the correct project.

Listing project codes

To display your account number and current project code in an HSI session, enter newacct with no argument.

 [HSI]/home/username-> newacct 

The output shows your account number followed by your project code in parentheses, as in this example.

 Current account is: 11111111(UABC0001) 

To list files with their associated project codes, use ls -U.

Example: List the project code associated with "myfile."

 [HSI]/home/username-> ls -U myfile 

Sample output:

 -rwx------ 1 username ncar    1011       UABC0001 TAPE     471 Jul 27 2017 23:05 myfile 

Changing project codes for files

To change the project code associated with a file—for example, to associate "myfile" with UABC0001—use the chacct command:

[HSI]/home/username-> chacct UABC0001 myfile

If you are unable to change a file’s project code, either because you do not have permissions or because you are attempting to use a project code that you are not authorized to use, you will receive the following error message:

 *** chacct: Permission denied [-1: HPSS_EPERM] 

Be sure you are using the correct project code and confirm with your project lead that you are or should be authorized to make such a change.

Changing project code for an HSI session

To associate an individual HSI session with a non-default project code, do one of the following.

  • After you’ve signed in to HSI, enter the newacct command and the desired project code:
[HSI]/home/username-> newacct UABC0001
  • Or, on your command line, enter this to start a session:
hsi -a UABC0001

In those cases, the newacct value will apply for the duration of your HSI session or until you change it again. When the session ends, your project code will revert to the default.

  • As an alternative, you can include the -a option in an individual HSI transfer command so your specified project code is used. Follow this example:
hsi -a UABC0001 cput xxx : yyy

Changing project code for an HTAR transfer

To apply a specified project code to an HTAR transfer, follow this example:

htar -H acct=UABC0001 -cv -f myncfile.tar *.nc

Charging formula

HPSS allocations are made in terms of terabyte-years, and HPSS charges are assessed in terabyte-years using this formula:

# terabytes × # years

Terabytes is the total number of terabytes held on storage media at the time of the weekly accounting run.

Years is the fraction of a year until the next accounting run, which typically is seven days.

Reads and writes do not incur charges.

Example

A project has 25 TB of data stored on HPSS. When accounting records are generated that week, the weekly charge will be:

25 × (7/365) = 0.48 TB-years

Storing 25 TB for one year would result in charges of 25 TB-years.

You can view your HPSS charges in the CISL Systems Accounting Manager (SAM).

Controlling HPSS charges

There are several ways to control which project is charged for storage of a file or files, as described above.

To stop charges from accruing, there are three methods:

  • Transfer the files from HPSS to local resources.
  • The project lead can request that orphaned files be deleted for users whose accounts have been closed.
  • CISL can assist in copying HPSS files to external media. To learn about charges for copying your files to external media, send a list of the files to be copied, and your preference for external media (for example, CD, DVD, USB2 device), to cislhelp@ucar.edu.

Related training courses