Server installation and uninstallation return codes

Edit online

If the server installation or uninstallation fails, check the return code to learn about the reason of the problem and possible solutions.

Table 1. Server installation and uninstallation return codes
Return code Possible cause and solutions
0 The server was installed successfully.
5 An unexpected error occurred. Contact IBM support.
6 An unexpected exception occurred. Contact IBM support.
7 An internal error occurred. The installer failed to save the file with information that was collected or generated during the pre-installation stage. Contact IBM support.
8 The installation was canceled.
9 A post-installation step was terminated before it was finished. Problems with resuming the installation might occur. Remove the installation and try again. If the error is returned during the upgrade, roll back the upgrade.
11 Validation of communication ports failed. Either the same port is specified for more than one parameter or the specified port is in use. If you want to specify a port that is temporarily used but will be available later, set the RSP_DISABLE_COMMUNICATION_WARNINGS parameter to true. For more information, see: Server installation response file (BigFix scenario).
13 Validation of the license agreement failed. Either the license agreement was not accepted, the path to the installation response file is not absolute, or the command is too long. To accept the license agreement, set the RSP_LICENSE_ACCEPTED parameter to true.

If the problem persists, ensure that you provide an absolute path to the response file, or move the files to a different directory to shorten the command, for example /root/LMT or C:\LMT.
14 There is not enough space for the installation. To check how much free disk space is required to proceed with the installation, see the LMT_9.2.37.0_timestamp_logs.tar.gz log. The log is in the installation directory of License Metric Tool or in the user home directory.
18 Validation of the installation path failed. The specified path is incorrect or the installation directory is read-only.
20 An unknown response file parameter was specified. Remove the parameter from the installation response file.
21 The response file was not found. It is either empty or contains Windows line endings instead of UNIX ones. To solve the problem, provide an absolute path to the response file and ensure that it contains proper line endings.
23 The command-line interface or another application from the License Metric Tool installation path is still running. End the process manually or set the RSP_AUTO_CLOSE_PROCESSES parameter to true.
25 The installation was started by a user that is not an Administrator. Start the installation by a user that is an Administrator.
26 An internal error occurred. Creation of the log directory failed. Contact IBM support.
27 It was impossible to recognize the environment, for example, installed products. Contact IBM support.
28 The upgrading scenario is not supported.
29 A part of License Metric Tool that is already installed, is corrupted. Reinstall the License Metric Tool server. For more information, see: Reinstalling License Metric Tool with an existing database.
30 The uninstallation wizard could not find product information in registries. License Metric Tool was already uninstalled.
31 The host name was not obtained. To verify the host name, enter the following command in the command-line interface. 
nslookup host_name
Ensure that the host name is correctly recognized. Then, rerun the installation.
32 An exception was detected while reading the setup.ini file. Contact IBM support.
33 An attempt of creating a log directory in the installation path failed because a file called <user_home_dir>/LMT9.2.37.0 already exists. To proceed with the installation, delete the file.
34 The following log directory is read-only: <user_home_dir>/LMT9.2.37.0. Make the directory writable.
35 The system TEMP environment variable does not point to a valid directory. Edit the variable so that it points to a valid directory.
36 Installation in console mode is not supported. Use interactive or silent mode.
37 The required resources could not be extracted from the installation image. Contact IBM support.
38 The required resources could not be found in the installation image. Contact IBM support.
41 The post-installation failed. Resume the installation. For more information, see: Resuming a stopped or failed installation (BigFix scenario).
42 Another instance of the installer is already running. Close other instances of the installer before you run it again.
46 The post-installation was interrupted. Reinstall the server. For more information, see: Reinstalling License Metric Tool with an existing database.
54 Uninstallation failed. Contact IBM support.
55 All elements of the infrastructure are already installed.
57 Post-installation was suppressed. Resume the installation. For more information, see: Resuming a stopped or failed installation (BigFix scenario).
59 An internal error occurred. Contact IBM support.
63 Installation of DB2 failed. Review installation logs with details related to DB2 installation. Clean the environment after a failed installation and rerun the installer. For more information, see: Removing all components after a failed installation (BigFix scenario).
64 Installation of BigFix® failed. Review installation logs with details related to BigFix installation. Clean the environment after a failed installation and rerun the installer. For more information, see: Removing all components after a failed installation (BigFix scenario).
65 Path to the directory with BigFix license files is invalid. Provide a valid path. The code is returned only in case of an offline installation.
66 Credentials that you specified for the License Metric Tool administrator do not meet the requirements. Ensure that the password that you specify meets the following requirements.
  • The password is at least 8 characters long.
  • The password contains at least one lowercase character, one uppercase character, and one digit.
67 Installation prerequisites are missing. Check the installation log to learn which prerequisites are missing.
68 Invalid parameters of BigFix installation. Ensure that parameters that are provided in the install_response.txt file are valid.
69 Invalid parameters of DB2 installation. Ensure that parameters that are provided in the install_response.txt file are valid.
70 Generation of BigFix license files failed. Try generating the license files in offline mode. For more information, see: Optional: Creating the license files (BigFix scenario).
72 Recognizing the installation type failed. Verify the value of the RSP_INSTALL_IEM parameter that you provided in the response file.
73 Credentials that you provided for registering the License Metric Tool server as a service are invalid. Ensure that values of the RSP_USER_ACCOUNT and RSP_USER_ACCOUNT_PWD parameters are correct.
74 Upgrade prerequisites are missing. To solve the problem, check the following items. Then, rerun the upgrade.
  • Ensure that no files or directories in the License Metric Tool installation directory are open in an external program. For example, that no log files are open in a text editor.
  • The following programs were confirmed to interrupt the upgrade of the server. If you use any of these programs, disable it for the period of the upgrade.
    • Arcserve Backup
    • Dynatrace OneAgent
    • VMware CarbonBlack
  • The installer stops the License Metric Tool server and attempts to move the installation directory to check if any external process are running in the directory. If the automatic check fails, close all processes that might handle files or directories in the License Metric Tool installation directory or restart the machine on which you are running the installation.
  • The installer attempts to rename the License Metric Tool installation directory to <dir_name>_installer_backup_<timestamp>. If the directory is not successfully renamed back, change its name manually.
    Note: To further troubleshoot the issue, you can use Process Monitor and Process Explorer to trace access to the mentioned folders during the failing move operation.
127 The installation was intentionally stopped on a specified step by the user.
208 The installation could not finish because the NOEXEC option is set on the tmp directory. If all installation steps are completed, no further action is required. Otherwise, perform one of the following steps and rerun the installation:
  • Remove the NOEXEC option from the tmp directory.
  • Specify a new temporary directory in the IATEMPDIR environment variable. For example, mkdir /root/Install_tmp; export IATEMPDIR=/root/Install_tmp.
    Note: This solution does not work if you are using the All-in-One installer.
214 The uninstallation process could not connect to the X server. Verify that the DISPLAY variable is properly set and points to a working X server.
233 Ensure that the path to the response file is absolute. For example: /root/ILMT_installer/install_response.txt instead of./install_response.txt.
777 Adding the DB2 license failed. Try re-running the installation or installing License Metric Tool by using separate installers. For more information, see: Installing the components on Linux with separate installers (BigFix scenario). If the problem persists, contact IBM support.