Saldo Command

The CSC environment offers the saldo command for monitoring your project's usage of CSC's computing resources. Computing resources are shared by the project, i.e. members of the project use resources in common.

Using the saldo command

To run saldo in the CSC computing environment, give the unix command saldo. The saldo utility prints user's projects' total usage of computing resources, and project members' monthly usage on each server.

Below is shown the output of saldo, which shows the usage of a sample project on 13.12.2017 at 8:15 AM. The project's code is 2000010, and name New models from wire. The project manager is Pekka Investigator, and the users are pinvest, ppostdoc and astudent (if the user has not used any resources, their usage is not printed). The project has started on 7.8.2017, and will end on 7.8.2019. The last grant of computing resources was made on 1.12.2017.

saldo (or alternatively: saldo -p 2000010 -m 12)
-----------------------------------------------------------------
Saldo for year 2017 month 12
Report updated 13.12.2017 8:15
-----------------------------------------------------------------
Project 2000010   New models from wire   Pekka Investigator
start 07.08.2017      end: 07.08.2019       budget: 01.12.2017
CSC budget: 2557574   used: 1797834         remain: 759740
-----------------------------------------------------------------
         Usage            Core/mem secs     Bu
                         -------------------
2000010  pinvest            24066000  13370 taito
         pinvest    Tot     24066000  13370

2000010  ppostdoc          979023600 543902 sisu
         ppostdoc   Tot    979023600 543902

2000010  astudent          128622600  71457 pouta
         astudent   Tot    128622600  71457

         Core/mem   total  1131712200 628729

Figure: Saldo print for the project 2000010 (on 13.12.2017). It is advisable that Pekka Investigator applies for more CPU time for his project, because the current compute resources will be used up soon.

Contents of the saldo print:

  • CSC budget: Cumulative project quota from the beginning of the year (2557574 billing units, bu)
  • used: Cumulative project usage from the beginning of the year (1797843 bu)
  • remain: Remaining computing resources of the project at the time saldo was updated (759740 bu)
  • Usage (monthly listing per user and per server):
    • The monthly usage of all active members of the project: project code, userid, their usage in Core or memory seconds (Core/mem secs) and billing units (Bu), and the used server
    • At the bottom is shown the project's monthly total usage in Core/mem seconds and billing units.
 

Monitoring the core and memory usage

Billing unit (bu) is the reference point of the CSC computing environment for academic use, and is based on one CPU hour of the old Cray XT4/XT5 supercomputer (louhi.csc.fi). Billing units in the CSC environment are derived from benchmark testing of servers.

  • On old Cray XT4/XT5 a job that used one processor core and lasted one hour consumed one billing unit (bu), i.e., 1 core-h = 1 bu.
  • Sisu, Taito and cPouta consume two billing units per core hour, i.e. 1 core-h on Sisu, Taito or Pouta = 2 bu.
  • Memory is billed on Taito: billing units = 2 x max (number of reserved cores, ceiling(amount of reserved memory in GB / 4)) x runtime in hours

Note that accounting is based on reserved cores and memory.

For Taito, the basis of billing is either the number of cores or the number (rounded up to the nearest integer) of 4 GB blocks of memory, depending which is larger. For example,

  • an 8 core job with 16 GB of memory will be billed with 2 x 8 = 16 billing units per hour
  • an 8 core job with 64 GB of memory will be billed with 2 x 16 = 32 billing units per hour

 

Saldo command options

Saldo has the following options available:

  • -p projid prints a saldo report for the selected project. This option is helpful if you belong to several projects.
  • -m month can have values between 1–12. You can print the usage of the selected month up to one year backwards. E.g. saldo -p 2000010 -m 1 prints the project usage from January.
  • -h filename generates an HTML file of the report.

Synopsis:

saldo [ -m month ] [ -p projid ] [ -h filename ]

Saldo updates every hour

In the CSC environment, the saldos of customer projects are updated hourly. This means that the allocated resources are not added immediately, but within an hour.

Saldo report only contains data from completed batch jobs. The jobs in batch queue or running are not yet included in the report.

Using up computing resources

When the project's compute resources drop below 20% of the cumulative CSC budget, you will receive an automatic warning:

ATTENTION: You have less than 20% CPU time quota left on your default
account. Please apply for more CPU time quota.

It is advisable to apply for more CPU time for your project well before the current compute resources are used up. However, those jobs that are already running are completed, even though the project quota becomes negative during the run. When the quota is negative, new batch jobs cannot be submitted until you have applied for and have been granted new computing quota.

See also