Chapter 9. Troubleshooting IdM server installation

Procedure

1. Use the tail command to display the last lines of a log file. The following example displays the last 10 lines of /var/log/ipaserver-install.log.

   [user@server ~]$ sudo tail -n 10 /var/log/ipaserver-install.log
   [sudo] password for user:
   value = gen.send(prev_value)
   File "/usr/lib/python3.6/site-packages/ipapython/install/common.py", line 65, in _install
   for unused in self._installer(self.parent):
   File "/usr/lib/python3.6/site-packages/ipaserver/install/server/init.py", line 564, in main
   master_install(self)
   File "/usr/lib/python3.6/site-packages/ipaserver/install/server/install.py", line 291, in decorated
   raise ScriptError()
   
   2020-05-27T22:59:41Z DEBUG The ipa-server-install command failed, exception: ScriptError:
   2020-05-27T22:59:41Z ERROR The ipa-server-install command failed. See /var/log/ipaserver-install.log for more information

   Copy to Clipboard Toggle word wrap

2. To review a log file interactively, open the end of the log file using the less utility and use the ↑ and ↓ arrow keys to navigate. The following example opens the /var/log/ipaserver-install.log file interactively.

   [user@server ~]$ sudo less -N +G /var/log/ipaserver-install.log

   Copy to Clipboard Toggle word wrap

3. Gather additional troubleshooting information by repeating this review process with the remaining log files.

   [user@server ~]$ sudo less -N +G /var/log/httpd/error_log
   
   [user@server ~]$ sudo less -N +G /var/log/dirsrv/slapd-INSTANCE-NAME/access
   
   [user@server ~]$ sudo less -N +G /var/log/dirsrv/slapd-INSTANCE-NAME/errors

   Copy to Clipboard Toggle word wrap

Procedure

1. To review a log file interactively, open the end of the log file using the less utility and use the kbd:[] arrow keys to navigate, while searching for ScriptError entries. The following example opens /var/log/pki/pki-ca-spawn.$TIME_OF_INSTALLATION.log.

   [user@server ~]$ sudo less -N +G /var/log/pki/pki-ca-spawn.20200527185902.log

   Copy to Clipboard Toggle word wrap
2. Gather additional troubleshooting information by repeating this review process with all the log files listed above.

Procedure

1. Uninstall the IdM server software from the host you are trying to configure as an IdM server.

   [root@server ~]# ipa-server-install --uninstall

   Copy to Clipboard Toggle word wrap

2. If you continue to experience difficulty installing an IdM server because of repeated failed installations, reinstall the operating system.

   One of the requirements for installing an IdM server is a clean system without any customization. Failed installations may have compromised the integrity of the host by unexpectedly modifying system files.