sacctmgrs

Sacctmgrs, in common usage, refers to the sacctmgr command and its suite of subcommands used within the Slurm Workload Manager to administer the Slurm accounting database. There is no separate program named sacctmgrs; sacctmgr is the canonical command-line tool, and the plural form is sometimes used informally to describe the set of sacctmgr operations.

Overview

Sacctmgr is an administrative utility for managing Slurm’s accounting data stored in the accounting database, typically accessed via the slurmdbd daemon. It allows system administrators to configure and maintain accounting objects and their relationships, enabling the tracking and enforcement of resource usage across users, projects, and queues.

Key capabilities

Sacctmgr can create, modify, delete, and query core accounting objects. These include accounts (organizational units for grouping users and resources), users, and associations (bindings of users to accounts with optional roles and default settings). It also manages quality-of-service (QOS) definitions, limits, and other accounting policies that influence job accounting and reporting. The tool supports showing current configurations, writing changes to the database, and validating relationships between objects.

Typical usage

Administrators invoke sacctmgr to perform operations such as adding or updating accounts, users, or associations, configuring QOS constraints, and adjusting resource quotas. Commands generally follow a structure that specifies the operation (add, update, delete, show) and the target object (account, user, assoc, qos, etc.). Changes are written to the Slurm accounting database, which is typically maintained by slurmdbd and backed by a SQL database such as MySQL, MariaDB, or PostgreSQL.

Access and safety

Access to sacctmgr is restricted to authorized administrators. Because changes affect accounting data and resource governance, they are typically performed on admin or management nodes with secure credentials and appropriate Slurm configuration (accounting storage type and database settings) in place.

See also

Slurm, slurmdbd, sacct, accounting in Slurm.