Chapter 24. Installing and running the IdM Healthcheck tool

Learn more about the IdM Healthcheck tool and how to install and run it.

24.1. Healthcheck in IdM

The Healthcheck tool in Identity Management (IdM) helps find issues that may impact the health of your IdM environment.

Note

The Healthcheck tool is a command line tool that can be used without Kerberos authentication.

Modules are Independent

Healthcheck consists of independent modules which test for:

Two output formats

Healthcheck generates the following outputs, which you can set using the output-type option:

You can specify a different file destination with the --output-file option.

Results

Each Healthcheck module returns one of the following results:

Follow this procedure to install the IdM Healthcheck tool.

Procedure

Install the ipa-healthcheck package:

[root@server ~]# dnf install ipa-healthcheck

Verification

Use the --failures-only option to have ipa-healthcheck only report errors. A fully-functioning IdM installation returns an empty result of [].
```
[root@server ~]# ipa-healthcheck --failures-only
[]
```

Additional resources

Healthcheck can be run manually or automatically using log rotation

Prerequisites

Procedure

To run healthcheck manually, enter the ipa-healthcheck command.
```
[root@server ~]# ipa-healthcheck
```

Additional resources

For all options, see the man page: man ipa-healthcheck.