Ce contenu n'est pas disponible dans la langue sélectionnée.
Chapter 30. Installing and running the IdM Healthcheck tool
Learn more about the IdM Healthcheck tool and how to install and run it.
- The Healthcheck tool is only available on RHEL 8.1 or later.
 
30.1. Healthcheck in IdM Copier lienLien copié sur presse-papiers!
					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.
				
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.
 
30.2. Installing IdM Healthcheck Copier lienLien copié sur presse-papiers!
Learn how you can install the IdM Healthcheck tool.
Prerequisites
- 
							You are logged in as 
root. 
Procedure
Install the
ipa-healthcheckpackage:yum install ipa-healthcheck
[root@server ~]# yum install ipa-healthcheckCopy to Clipboard Copied! Toggle word wrap Toggle overflow NoteOn RHEL 8.1 and 8.2 systems, use the yum install /usr/bin/ipa-healthcheck command instead.
Verification
Perform a basic Healthcheck test:
ipa-healthcheck
[root@server ~]# ipa-healthcheck []Copy to Clipboard Copied! Toggle word wrap Toggle overflow The empty square brackets
[]indicate a fully-functioning IdM installation.
30.3. Running IdM Healthcheck Copier lienLien copié sur presse-papiers!
You can execute Healthcheck tests in one of the following ways:
- Manually
 - Automatically by using log rotation.
 
This section describes how to execute the tests manually.
Prerequisites
- The Healthcheck tool is installed. See Installing IdM Healthcheck.
 
Procedure
[Optional] To display a list of all available Healthcheck tests, enter:
ipa-healthcheck --list-sources
[root@server ~]# ipa-healthcheck --list-sourcesCopy to Clipboard Copied! Toggle word wrap Toggle overflow To run the Healthcheck utility, enter:
ipa-healthcheck
[root@server ~]# ipa-healthcheckCopy to Clipboard Copied! Toggle word wrap Toggle overflow