Saldo Command

The CSC computing 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 together.

Using the saldo command

To run saldo in the CSC computing environment, give the command saldo in the terminal. The saldo utility prints the total usage of computing resources and project members' monthly usage for all projects the user is member of. The monthly usage is printed for each service that has been used.

Below is shown the output of saldo -p 2000010 (or alternatively saldo -p 2000010 -m 12), run on 13.12.2018 at 8:15 AM. The project's number 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 30.1.2020. The last grant of computing resources was made on 1.12.2018.

-----------------------------------------------------------------
Saldo for year 2018 month 12
Report updated 13.12.2018 8:15
-----------------------------------------------------------------
Project 2000010   New models from wire   Pekka Investigator
start 07.08.2017      end: 30.01.2020       budget: 01.12.2018
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
 

Below the project details, saldo prints usage figures:

  • CSC budget: Project's total computing quota in CSC billing units (BUs)
  • used: Used BUs
  • remain: Remaining BUs at the time saldo was updated
  • Usage (monthly listing per user and per service):
    • The monthly usage of all active members of the project: project number, username, their usage in core or memory seconds (Core/mem secs), and billing units (Bu), and the used service (taito, sisu, pouta)
    • At the bottom is shown the project's monthly total usage in Core/mem secs and BUs

Note: For historical reasons, the resources granted and used before 1.1.2018 are not included in CSC budget and used figures.

Options of saldo command

Saldo has the following options available:

  • -p projnum 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. For example saldo -p 2000010 -m 1 prints the project's usage of January.
  • -h filename generates an HTML file of the report.

Synopsis: saldo [ -m month] [ -p projnum] [ -h filename]

Saldo updates every hour

In the CSC computing environment, the computing quotas of projects are updated hourly. This means that the allocated resources are not added immediately, but within an hour. The report only contains data from completed batch jobs. Running jobs and jobs waiting in the batch queue are not included in the report until they have finished.

Using up computing resources

When the remaining computing quota is below 10% of the total quota, you get the following warning at login:

WARNING: You belong to the project 2000010, which has used over 90% of its quota.
Please apply for more CPU time, the instructions are at: https://research.csc.fi/applying-for-computing-resources
 

It is advisable to apply for more resources for your project well before the current compute resources are used up. However, if you have any jobs running, those jobs are completed, even though the project's 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