7.0 Troubleshooting Identity Manager

Action: If errors occur during Idenity Manager installation, ensure that you refer to the log files depending on your platform:

Action: For detecting typical failures, see the ii_install.log file for installation issues, ii_configure.log file for configuration issues, and ii_uninstall.log file for uninstallation issues. In the log files, look for text exitValue = xxx. If the value is not 0, a particular command execution has failed which in turn generates a log file. Refer to that log file for further details on the failure.

For example,

"/home/siva/build/products/Reporting/IDMReport.bin" -DIA_USER_JRE_HOME="/opt/nov
ell/idm/jre" -i silent -f "/tmp/idmreporting_configure.properties"
execute command
  exitValue = 1
log file location   :/tmp/idmreporting_configure.properties
log file location   :/opt/novell/idm/rbpm/IDMReporting//RPT_Install.log

The above snippet from the ii_install.log file indicates that the command has failed, because the exitValue is 1 (non-zero). For further analysis, refer to the /opt/novell/idm/rbpm/IDMReporting/RPT_Install.log as displayed in the command.

Source: During configuration, the installer might display the following error message after the configuration parameters are specified:

Some of the inputs are not proper. They are highlighted in Red.

Possible Cause: Based on the highlighted parameter, the cause of the error message could be one of the following:

Action: Do the following:

Possible Cause: If the /etc/hosts file has an entry with the 127.0.0.2 loopback address, the default IP certificate is created for the 127.0.0.2 loopback address.

Action: Do the following:

Edit the /etc/hosts file if the hosts file has an entry with the 127.0.0.2 loopback address.

For example, 127.0.0.2 hostname. Comment it and make sure that the real IP address entry is in the file.

Possible Cause: If the systems tmp directory is not present, the installer throws this exception soon after invoking the installer.

Action: Create the systems tmp directory.

Possible Cause: An error message displays when integrated installer is invoked in the GUI mode if the required RPMs are not present in the system. The integrated installer automatically switches to the console mode, which is not supported.

Action: Install the required RPMs before invoking the Identity Manager installer.

See Identity Manager 4.0.1 Readme for a list of RPMs required for a successful installation and configuration of Identity Manager.

Source: The integrated installer tries to automatically generate the tree name if that tree name already exists.

Explanation: The integrated installer adds the replica holding the server object on all secondary server installations. It waits for the replica to turn on.

Explanation: Some services might not run because the ports required by them are occupied.

Action: Ensure that the following ports are free before you start the installation. Run the netstat -anp | egrep command to check if these ports are free.

netstat -anp | egrep
':(524|389|636|8028|8030|8090|8000|7707|8006
|8009|8081|8443|8009|8080|8443|1199|1198|119
0|3973|4544|4545|4546|4557|4812|4813|8109|81
83|8180|8543|29007|37022|8180|10013|10014|61
616|61617|1514|15432|5556|1289|1443|1468)'

For more information, see Section 3.3, Ports Used by the Identity Manager Services.

Explanation: Ensure that you back up the installer state file. The integrated state file is an important configuration file used by the installer for information including the current state of the system, installed components, configured components, or uninstalled components.

Action: Locate the state file, then take a back up of the file.

Possible Cause: The installer tries to stop all the dependent services before uninstalling Identity Manager. Sometimes installer might not be able to stop the DHost service because some services depend on DHost.

Action: Do the following steps to check whether the installer hanged during the Identity Vault uninstallation:

Explanation: The Metadirectory installation fails with the following message in the <Install Location>\ii_install.log file:

:\Users\Administrator\IDM4\products\eDirectory\x64\windows\x64\redist_pkg\vcredist_x86.exe" /q:a /c:"msiexec /i vcredist.msi /qn /l C:\Users\ADMINI~1\AppData\Local\Temp\vcredist32_Windows_x64_Install.log"
execute command exitValue = 3010 

Action: The 3010 error code returned by the vcredist executable is a success, which means that you must reboot the Windows machine. After the rebooting process, relaunch the installer and the installation continues normally. Rebooting the machine does not affect the earlier successful installations.

Explanation: The Identity Manager 4.0.1 integrated installer fails to configure if the ISO is extracted through third-party ISO extraction tools on UNIX.

Action: For successful configuration, use the mount -o loop command.

Possible Cause: With XDAS event logging enabled, Identity Manager engine performance is degraded without SLP configuration.

Action: SLP should be correctly configured and running to ensure that performance is not affected.

Source: During uninstallation if one or more components fail to uninstall, the Uninstall option is disabled if you retry uninstallation. One of the reasons for the uninstallation failure on Windows could be that the JAVA_HOME and PATH variables are not set.

Action: Execute the individual component uninstallers as follows: