Este contenido no está disponible en el idioma seleccionado.

Chapter 27. Installing and running the IdM Healthcheck tool


Install and run the IdM Healthcheck tool to help find issues that can impact the performance of your IdM environment.

27.1. Healthcheck in IdM

The Healthcheck command line tool in Identity Management (IdM) helps find issues that can impact the performance of your IdM environment. Using Healthcheck, you can identify an issue in advance so that you can correct it before it becomes critical.

Note

You can use Healthcheck without obtaining a Kerberos ticket.

Modules are independent

Healthcheck consists of independent modules which check for:

  • Replication issues
  • Certificate validity
  • Certificate authority infrastructure issues
  • IdM and Active Directory trust issues
  • Correct file permissions and ownership settings

Output formats and destination

You can set the following types of output for Healthcheck to generate by using the output-type option:

  • json: Machine-readable output in JSON format (default)
  • human: Human-readable output

You can specify a file to store the output by using the --output-file option.

Results

Each Healthcheck module returns one of the following results:

SUCCESS
The system is configured as expected.
WARNING
It is advisable to monitor or evaluate the configuration.
ERROR
The system is not configured as expected.
CRITICAL
The configuration is not as expected, with a significant potential to impact the functioning of your IdM deployment.

27.2. Installing IdM Healthcheck

You can install the IdM Healthcheck tool to help find issues that can impact the performance of your IdM environment.

Prerequisites

  • You are logged in as root.

Procedure

  • Install the ipa-healthcheck package:

    # dnf install ipa-healthcheck

Verification

  • Perform a basic Healthcheck test:

    # ipa-healthcheck
    []

    The empty square brackets [] indicate a fully-functioning IdM installation.

27.3. Running IdM Healthcheck manually

You can execute Healthcheck tests either manually on the CLI or automatically by using a timer. You can manually run IdM Healthcheck tests from the command line to diagnose and monitor the health of your environment.

Prerequisites

Procedure

  1. Optional: To display a list of all available Healthcheck tests, enter:

    # ipa-healthcheck --list-sources
  2. To run the Healthcheck utility, enter:

    # ipa-healthcheck
Red Hat logoGithubredditYoutubeTwitter

Aprender

Pruebe, compre y venda

Comunidades

Acerca de la documentación de Red Hat

Ayudamos a los usuarios de Red Hat a innovar y alcanzar sus objetivos con nuestros productos y servicios con contenido en el que pueden confiar. Explore nuestras recientes actualizaciones.

Hacer que el código abierto sea más inclusivo

Red Hat se compromete a reemplazar el lenguaje problemático en nuestro código, documentación y propiedades web. Para más detalles, consulte el Blog de Red Hat.

Acerca de Red Hat

Ofrecemos soluciones reforzadas que facilitan a las empresas trabajar en plataformas y entornos, desde el centro de datos central hasta el perímetro de la red.

Theme

© 2026 Red Hat
Volver arriba