Running the preinstallcheck utility


You can validate the readiness of BMC TrueSight Infrastructure Management Server installation environment by using the command-driven preinstallcheck utility. This preinstallation utility scans the computer on which you are installing the Infrastructure Management Server and validates it to avoid any potential issues that might occur during the installation. 

This utility checks whether the computer meets the required system and hardware requirements such as memory, disk space, and required libraries.


To locate the preinstallcheck utility

On the computer where the Infrastructure Management Server will be installed, access the installation program by using one of these methods:

The preinstallcheck utility is located at:

  • Windows<installationDirectoryFolderName>\Windows\Utilities\preinstallutility
  • Linux<installationDirectoryFolderName>/Linux/Utilities/preinstallutility

installationDirectoryFolderName is the name of the folder that contains all the installation files. 

Command syntax

  • Windowspreinstallcheck.cmd <INSTALL_TYPE> <INSTALL_DIRECTORY>
  • Linuxpreinstallcheck.sh <INSTALL_TYPE> <INSTALL_DIRECTORY>

Where,

<INSTALL_TYPE> -  The value for <INSTALL_TYPE> is infrastructure_management_server.

<INSTALL_DIRECTORY> - Path of the destination directory where you will be installing the component. 

Before you begin

Set the JAVA_Home variable with the JRE 1.6 version and above. 

To perform the preinstallation check 

  1. On the computer where the component will be installed, open the command prompt and navigate to the directory that contains the preinstallcheck utility. 
  2. From the preinstallutility directory, run the following command:

    • Windows: preinstallcheck.cmd <INSTALL_TYPE> <INSTALL_DIRECTORY>
    • Linux: preinstallcheck.sh <INSTALL_TYPE> <INSTALL_DIRECTORY>

      Example: preinstallcheck.sh infrastructure_management_server /opt/bmc

     

  3. Review the validation report generated on the command prompt.
    The same report is also generated in the (Windows) %tmp% or (Linux) /tmp directory as the tsim_preinstall_validations.txt file.

Report details

The report file includes the following fields:

Field

Description

Configuration

Type of configuration such as RAM, Disk

Actual Value

Actual value of the configuration

Recommended Configuration

Recommended configuration for the install

Pre Install Status

Status whether Ok or Not-Ok

Example report file:

Windows:

Configuration: minimumRAM_MB
Actual Value: 8589
Recommended Configuration: 8000
Pre Install Status: Ok

Configuration: minimumDisk_GB
Actual Value: 68
Recommended Configuration: 12
Pre Install Status: Ok

Configuration: Minimum Virtual Memory (GB)
Actual Value: 2
Recommended Configuration: 1
Pre Install Status: Ok
 
Configuration: disabledTerminalServerFlags
Actual Value: [PerSessionTempDir=00000000, DeleteTempDirsOnExit=00000000]
Recommended Configuration: PerSessionTempDir;DeleteTempDirsOnExit
Pre Install Status: Ok

Linux:

Configuration: minimumDisk_GB
Actual Value: 91
Recommended Configuration: 12
Pre Install Status: Ok
 
Configuration: Minimum Virtual Memory (GB)
Actual Value: 2
Recommended Configuration: 1
Pre Install Status: Ok
 
Configuration: folderAccess
Actual Value: [/etc/profile, /etc/init.d, /etc/csh.cshrc, /etc/.login, /etc/bmc.profile]
Recommended Configuration: /etc/profile;/etc/init.d;/etc/csh.cshrc;/etc/.login;/etc/bmc.profile
Pre Install Status: Ok

Configuration: requiredLibraries
Actual Value: [glibc-2.12.x86_64, glibc.i686, libstdc++.i686, compat-libstdc++-33.i686, pam.i686]
Recommended Configuration: glibc-2.12.x86_64;glibc.i686;libstdc++.i686;compat-libstdc++-33.i686;pam.i686;libfreebl3.so
Pre Install Status: Not-Ok

Where to go from here

After successfully running the preinstallcheck utility, you can install the Infrastructure Management Server as described in Installing-the-Infrastructure-Management-Server.

 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*