Chapter 3. Checking disk space using IdM Healthcheck


You can monitor the Identity Management server’s free disk space using the Healthcheck tool.

Prerequisites

  • The Healthcheck tool is only available on RHEL 8.1 and newer.

3.1. Disk space healthcheck test

The Healthcheck tool includes the FileSystemSpaceCheck test for checking available disk space. The test checks the following:

  • The minimum raw free bytes needed.
  • The percentage — the minimum free disk space is hardcoded to 20%.

The test checks the following paths:

Table 3.1. Tested paths
Paths checked by the testMinimal disk space in MB

/var/lib/dirsrv/

1024

/var/lib/ipa/backup/

512

/var/log/

1024

var/log/audit/

512

/var/tmp/

512

/tmp/

512

Insufficient free disk space can cause issues with the following:

  • Logging
  • Execution
  • Backups

You can find the FileSystemSpaceCheck test by running the ipa-healthcheck --list-sources command and identifying the ipahealthcheck.system.filesystemspace section in the output.

3.2. Screening disk space using the Healthcheck tool

Follow this procedure to run a standalone manual test of available disk space on an Identity Management (IdM) server using the Healthcheck tool.

Procedure

  • Enter:

    Copy to Clipboard Toggle word wrap
    # ipa-healthcheck --source=ipahealthcheck.system.filesystemspace
    • The --source=ipahealthcheck.meta.services option ensures that IdM Healthcheck only performs the disk space test.

A successful test displays empty brackets:

Copy to Clipboard Toggle word wrap
[]

As an example, a failed test can display:

Copy to Clipboard Toggle word wrap
{
  "source": "ipahealthcheck.system.filesystemspace",
  "check": "FileSystemSpaceCheck",
  "result": "ERROR",
  "kw": {
    "msg": "/var/lib/dirsrv: free space under threshold: 0 MiB < 1024 MiB",
    "store": "/var/lib/dirsrv",
    "free_space": 0,
    "threshold": 1024
  }
}

This failed test informs you that no space is available in the /var/lib/dirsrv directory.

Note

Run this test on all IdM servers when trying to discover issues.

Additional resources

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat, Inc.