Installing the Infrastructure Management Server in the standalone mode silently

Where you are in the Installation process

Step	Task
1	Complete the planning activities
2	Prepare for TrueSight Operations Management installation
3	Install Remedy Single Sign-On
4	Install TrueSight Presentation Server
5	Install TrueSight Infrastructure Management — Phase A (*You are here*)
5	Install TrueSight Infrastructure Management — Phases B and C
6	Install App Visibility Manager (If licensed)
7	Install Real End User Experience Monitoring Software Edition (If licensed)
8	Install TrueSight IT Data Analytics (If licensed)
9	Complete the post-installation activities

Infrastructure Management Server can be installed silently with Oracle or SAP SQL Anywhere as the database. By default, the Infrastructure Management is integrated and configured with SAP SQL Anywhere. If you want to install it with Oracle, you must configure the Oracle database details in the server_install.options file during installation.

Best practice

BMC recommends that you deploy the Oracle database and TrueSight Infrastructure Management Server on separate servers.

Note

Ensure that there are no Integration Services installed on the computer where the TrueSight Infrastructure Management Server will be installed. If any Integration Services are installed on this computer, the TrueSight Infrastructure Management Server installation fails.
If you are using the Remote Desktop Connection (RDC) to install the product, put the RDC in console mode.
If you are installing the Infrastructure Management Server with Oracle, ensure that port 7 is opened between the Server and the Oracle database system. If port 7 cannot be opened due to security restrictions, run the installer using the following option:
- (Windows) install.cmd -J SKIP_PING_VALIDATION_ERROR=true
- (Linux) ./install.sh -J SKIP_PING_VALIDATION_ERROR=true
BMC recommends that you use MobaXterm as the UI to install TrueSight Infrastructure Management on Linux computers.

To install the Infrastructure Management Server silently

Do the following:

Log in to the host computer (as a root user if you are using Linux) on which you want to install Infrastructure Management Server, and delete all the files from the temporary directory:
1. - (Windows) %temp%
  - (Linux) /tmp and /var/tmp
2. If you are reinstalling the Infrastructure Management Server due to a failure, you must delete all the existing installation directories and files.
Extract the downloaded zip files (the installer) to a temporary location outside the following location to avoid any file sharing conflicts:
- (Windows) C:\Program Files
- (Linux) /opt
(Linux) Apply executable rights to all the installation files by running the following command:
chmod -R 755 installationDirectoryFolderName
installationDirectoryFolderName is the name of the folder that contains all the installation files.
For example, chmod -R 755 Disk1
You will need to type the Oracle database administrator, user, and report user passwords in an encrypted form in the server_install.options. No password encryption is needed for SAP SQL Anywhere database. You can encrypt these passwords using the TrueSightPServerMaintenanceTool through the wizard or command line interface:
Encrypt password using the wizard
1. Open the TrueSightIMMaintenanceTool by navigating to:
  - (Windows) <DownloadLocation>\Windows\Disk1\utility
  - (Linux) <DownloadLocation>/Linux/Disk1/utility
2. Run the tool, and click the Encrypt tab.
3. Type the password, confirm it, and click Encrypt.
4. Note down the encrypted password (Example: DES\:097133405e7ea7a6bcc58bbe70ece4c2).
Encrypt password using the command line interface
1. Navigate to the following directory:
  - (Windows) <DownloadLocation>\Windows\Disk1\utility
  - (Linux) <DownloadLocation>/Linux/Disk1/utility
2. Run the following command:
  - (Windows) <DownloadLocation>\Disk1\utility\TrueSightIMMaintenanceTool.cmd -silent -encrypt -encrypt -password=<myPassword> -confirm_password=<myPassword>
  - (Linux) <DownloadLocation>/Disk1/utility/TrueSightIMMaintenanceTool.sh -silent -encrypt -encrypt -password=<myPassword> -confirm_password=<myPassword>
  Note: myPassword is the password that needs to be encrypted.
3. Note down the encrypted password (Example: DES\:097133405e7ea7a6bcc58bbe70ece4c2).
Note
Ensure that the following system requirements are met. If your target computer does not meet these requirements, you cannot proceed with the installation. However, in a test environment, you can skip the system requirements validation and run the installer by using the -J MINIMAL=true argument.
- Total RAM (in MB): 32,000
- Available RAM (in MB): 25,000
- Total swap space / page file (in MB): 8,000
- Available swap space / page file (in MB): 8,000
By default, the TrueSight Infrastructure Management Server uses 256-bit encryption. However, AES 256-bit encryption is not allowed in some countries due to import regulations. You can change the default encryption key size when you invoke the installer.
From the command prompt, navigate to the Disk1 folder:
- (Windows) <DownloadLocation>\TSIMServer\Disk1\
- (Linux) <DownloadLocation>/TSIMServer/Disk1/

Open (or edit) the server_install.options file and and customize the following properties:

Property details

This is a text file that defines the installation properties in the form of a prefix tag followed by a property name and value pair. You can either retain the default values or change them and save the file.

Prefix tags for silent installation properties:

-P: Precedes directory properties
-A: Precedes application features
-J: Precedes Java properties

Property name	Description
Installation location
`-P installLocation`	Retain the following default installation directory path. Default: (Windows) C:\Program Files\BMC Software\TrueSight (Linux) /opt/bmc/TrueSight Notes: In application high-availability mode `installLocation` should be a symbolic link pointing to shared disk. `InstallLocation` should not contain double quotes Examples: (Windows) `-P installLocation=C:\Program Files\BMC Software\TrueSight` (Linux) `-P installLocation=/opt/bmc/TrueSight`
Installing features
`-A <feature name>`	Retain the default feature value. The default value PRIMARY is applicable for a single server environment as well. Default: PRIMARY Example:`-A PRIMARY`
TrueSight Infrastructure Server installer configuration
`-J FIREWALL_CONFIGURATION_MODE`	Configure the firewall to create Inbound Rule for Infrastructure Management Processes for Windows OS. Type one of the two options: FIREWALL_AUTO_CONFIGURE or FIREWALL_MANUAL_CONFIGURE. Default: FIREWALL_AUTO_CONFIGURE Example:`-J FIREWALL_CONFIGURATION_MODE=FIREWALL_AUTO_CONFIGURE`
`-J DEPLOYMENT_ENVIRONMENT`	Configure the deployment environment options based on your installation type. The default value CHILD_SERVER is applicable for both single server and child server environments. Default: CHILD_SERVER Example:`-J DEPLOYMENT_ENVIRONMENT=CHILD_SERVER`
Optional Component Selection
`-J CONFIGURE_SERVER_PORTS -J CONFIGURE_DR_INFORMATION -J CONFIGURE_CELL_INFORMATION -J CONFIGURE_ADMIN_INFORMATION -J CONFIGURE_ORACLE_DATABASE -J CONFIGURE_CMDB_INTEGRATIONS -J CONFIGURE_CLOUD_VISTA_INTEGRATIONS -J CONFIGURE_DSIM`	Uncomment and set the value to true to enable the property. Default value: false Example: `-J CONFIGURE_SERVER_PORTS=true` You must uncomment `-J CONFIGURE_SERVER_PORTS` and set it to `true` if you want to customize the Port configuration details given below.
Port configuration details
`-J Apache_Port=80` `-J Apache_SSL_Port=443` `-J IBRSD_Port=3115` `-J IAS_PORT=3084` `-J RMI_Port=1099` `-J AgentController_Port=12123` `-J CACHE_SERVER_PORT=30235` `-J JBoss_JMS_Port=8093` `-J Tomcat_Port=8005`	You can use the default or custom port details as needed. You must uncomment `-J CONFIGURE_SERVER_PORTS` and set it to true (mentioned above) if you want to configure the port details. Note:The non-root user does not have the permissions to use ports below or equal to 1024. Therefore, while installing the Infrastructure Management server as a non-root user, the port numbers for Apache and Apache SSL must be between 1025 to 65535. Example: `-J Apache_Port=8088` `-J Apache_SSL_Port=4438` `-J IBRSD_Port=3115` `-J IAS_PORT=3084` `-J RMI_Port=1099` `-J AgentController_Port=12123` `-J CACHE_SERVER_PORT=30235` `-J JBoss_JMS_Port=8093` `-J Tomcat_Port=8005`
Oracle configuration options
`-J ORACLE_HOSTNAME` `-J ORACLE_PORT` `-J ORACLE_SID` `-J ORACLE_USER` `-J ORACLE_PASSWORD` `-J ORACLE_CONFIRM_PASSWORD` `-J ORACLE_REPORT_USERNAME` `-J ORACLE_REPORT_PASSWORD`	Specify the Oracle database details. For the password properties, type the encrypted passwords. Note: You must configure the Oracle options if you are installing a HA environment. SAP SQL Anywhere database is not applicable for HA. Example: `-J ORACLE_HOSTNAME=Oracle_hostname.fqdn.com` `-J ORACLE_PORT=1521 (Default port number)` `-J ORACLE_SID=TSIMDB` `-J ORACLE_USER=TSIMOraUser` `-J ORACLE_PASSWORD=DES\:2d83ab8b36c4deea8d7d64484b0c78fc` `-J ORACLE_CONFIRM_PASSWORD=DES\:2d83ab8b36c4deea8d7d64484b0c78fc` `-J ORACLE_REPORT_USERNAME=DES\:3d84ac8b36d4aefa8d7d64454c0c68de` `-J ORACLE_REPORT_PASSWORD=DES\:3d84ac8b36d4aefa8d7d64454c0c68de`
Oracle Real Application Cluster (RAC) configuration options
`-J INTEGRATE_ORACLE_RAC` `-J ORACLE_RAC_NODES_COUNT` `-J RAC_SCAN_HOSTNAME_OR_IP_ADDRESS_0` `-J RAC_SCAN_PORT_0` `-J ORACLE_RAC_HOST_PORT_LIST`	Specify the Oracle RAC details. If you set -`J INTEGRATE_ORACLE_RAC=true` and provide the SCAN hostname, the node count must be set to 1. Example: `-J INTEGRATE_ORACLE_RAC=true` `-J ORACLE_RAC_NODES_COUNT=1` `-J RAC_SCAN_HOSTNAME_OR_IP_ADDRESS_0=oracle_rac_hostname_fqdn.com` `-J RAC_SCAN_PORT_0=1521`
Oracle Tablespace and User create options
`-J CREATE_ORACLE_TABLESPACE` `-J TABLE_SPACE_NAME` `-J TEMP_TABLE_SPACE_NAME` `-J TABLE_SPACE_DATAFILE_NAME` `-J TEMP_TABLE_SPACE_DATAFILE_NAME` `-J BPPM_DB_DEPLOYMENT_TYPE` `-J DBA_USERNAME` `-J DBA_PASSWD` `-J CONFIRM_DBA_PASSWD`	Specify the Oracle tablespace and DB Administrator details. For the password property, type the encrypted password. Example: `-J CREATE_ORACLE_TABLESPACE=true` `-J TABLE_SPACE_NAME=TS_TBS` `-J TEMP_TABLE_SPACE_NAME=TS_TBS_TEMP` `-J TABLE_SPACE_DATAFILE_NAME=C:\app\Administrator\oradata\TSIMDB\TSIMLinuxDBF.DBF` `-J TEMP_TABLE_SPACE_DATAFILE_NAME=C:\app\Administrator\oradata\TSIMDB\TSIMLinuxTEMPDBF.DBF` `-J BPPM_DB_DEPLOYMENT_TYPE=medium` `-J DBA_USERNAME=sys` `-J DBA_PASSWD=DES\:4f84ac8b36d4aefa8d7d64454c0c76fe` `-J CONFIRM_DBA_PASSWD=DES\:4f84ac8b36d4aefa8d7d64454c0c76fe`
Fully qualified domain name
`-J TRUESIGHT_HOSTNAME_FQDN`	Type the Infrastructure Management host fully qualified domain name. Example: `-J TRUESIGHT_HOSTNAME_FQDN=tsim_host.fqdn.com`

From the command prompt, run one of the following commands to start the installation. Type the complete path to the server_install.options file in the command. If the path includes a blank space, enclose the path within double quotes. Installation-related information is not displayed when the silent installation begins. However, installation occurs in the background.

Environment type	Command
Production environment with the default encryption setting	(Windows) `install.cmd -i silent -DOPTIONS_FILE="<DownloadLocation>\server_install.options"` (Linux)`./install.sh -i silent -DOPTIONS_FILE="<DownloadLocation>/server_install.options"` Example (Windows - With space) `install.cmd -i silent -DOPTIONS_FILE="C:\temp folder\Disk1\server_install.options"` (Linux- With space)`./install.sh -i silent -DOPTIONS_FILE="/home/tsim user/Linux/Disk1/server_install.options"`
Production environment with user-specified encryption setting	(Windows) `install.cmd –J BMC_TS_KEY_SZ=<128/256> -i silent -DOPTIONS_FILE="<DownloadLocation>\server_install.options"` (Linux)`./install.sh -i silent -DOPTIONS_FILE="<DownloadLocation>/server_install.options"` Example (Windows - With space) `install.cmd –J BMC_TS_KEY_SZ=<128/256> -i silent -DOPTIONS_FILE="C:\temp folder\Disk1\server_install.options"` (Linux- With space)`./install.sh –J BMC_TS_KEY_SZ=<128/256> -i silent -DOPTIONS_FILE="/home/tsim user/Linux/Disk1/server_install.options"`
Test environment with the default encryption setting	(Windows) `install.cmd -J MINIMAL=true -i silent -DOPTIONS_FILE="<DownloadLocation>\server_install.options"` (Linux)`./install.sh -J MINIMAL=true -i silent -DOPTIONS_FILE="<DownloadLocation>/server_install.options"` Example (Windows) `install.cmd -J MINIMAL=true -i silent -DOPTIONS_FILE="C:\temp folder\Disk1\server_install.options"` (Linux)`./install.sh -J MINIMAL=true -i silent -DOPTIONS_FILE="/home/tsim user/Linux/Disk1/server_install.options"`
Test environment with user-specified encryption setting	(Windows) `install.cmd -J MINIMAL=true –J BMC_TS_KEY_SZ=<128/256> -i silent -DOPTIONS_FILE="<DownloadLocation>\server_install.options"` (Linux)`./install.sh -J MINIMAL=true –J BMC_TS_KEY_SZ=<128/256> -i silent -DOPTIONS_FILE="<DownloadLocation>/server_install.options"` Example (Windows) `install.cmd -J MINIMAL=true –J BMC_TS_KEY_SZ=<128/256> -i silent -DOPTIONS_FILE="C:\temp folder\Disk1\server_install.options"` (Linux)`./install.sh -J MINIMAL=true –J BMC_TS_KEY_SZ=<128/256> -i silent -DOPTIONS_FILE="/home/tsim user/Linux/Disk1/server_install.options"`

Note

Based on whether you are using SAP SQL Anywhere or Oracle, the TrueSight Infrastructure Managementinstallation may take between 20 to 60 minutes to complete.

After the installation is complete, the Installation Summary page is displayed. You can periodically check the installation status by checking the tsim_server_install_log.txt file located at:
- (Windows) %temp%
- (Linux) /tmp
  
  - You can open and check the log file while the installation is in progress. If the installation fails at any point with a warning or error messages, you must troubleshoot the problems and restart the installation from Step 1.
  - Based on the specific install script-level error and warning messages in the /tmp/tsim_server_install_log.txt file, you can refer to the /var/tmp/TrueSight_server_install.log file for additional details.
(Linux) Verify that the following environment variables are set.
- $BPPM_SERVER_HOME
- $BMC_PROACTIVENET_HOME
(Linux) If you installed Infrastructure Management Server as a non-root user, do the following:
Configure the TrueSight Infrastructure Management process to automatically start each time the TrueSight Infrastructure Management server is restarted. To do this, register the process as a service by running the script described in the following procedure. Running this script also results in copying the Integration Service security files required by the PATROL Agent to connect with the Integration Service.
1. Locate the script at <Infrastructure-Management-Installation-Directory>/pw/scripts.
2. Run the script in the following format:
  create_startup_script.sh [<Non-root-User-Name>]
  where, <Non-root-User-Name> refers to the non-root user name with which the process must be registered as a service.
  Providing the non-root user name is optional. If you do not provide the non-root user name, by default, the script uses the non-root user name used for installing TrueSight Infrastructure Management to register the service.
Run the following command to verify the Infrastructure Management installation:
- (Windows) # pw system status
- (Linux) # pw system status
  A list of pw server processes is displayed.
  (Windows) Sample list
  ------------------------
  Servers/Daemon Processes
  ------------------------
  services 4820
  httpd 6152
  jserver 10660
  pronet_agent 4680
  pronet_cntl 3968
  tunnelproxy 7792
  rate 3976
  dbsrv 6560
  mcell 4952
  pserver 4217
  (Linux) Sample list
  ------------------------
  Servers/Daemon Processes
  ------------------------
  pronet_agent 21256 services 21046
  httpd 10069 21446 24238 28619 30746
  jserver 21940
  mcell 20930
  pronet_cntl 21381
  tunnelproxy 21660
  rate 21540
  oracle Running on <host name>:<port number>
Apply the Infrastructure Management license.
Note
- Applying or updating the license restarts the JServer process and forces all active user sessions on the Infrastructure Management Server to log off.
- You must have root privileges to apply the license.
When you purchased the product, you would have received the following license files in a .zip file from your BMC Software representative:
- proactivenet.lic
- proactivenet.sign
To apply the license on Microsoft Windows systems
1. Copy the .zip file to the Infrastructure Management Server under the installationDirectory\pw\licenses directory. (Example: C:\Program Files\BMC Software\TrueSight\pw\licenses)
2. Unzip the file.
3. To load the license data, run the command: pw lic update.
4. Type y to restart JServer.
If the license update is successful, an empty command prompt is displayed.
To apply the license on Linux systems
1. In binary mode, copy the .zip file to the Infrastructure Management Server under the /usr/pw/licenses directory.
2. Unzip the file.
3. To load the license data, run the command: pw license update.
4. Type y to restart JServer.
If the license update is successful, an empty command prompt is displayed.
Do not move or delete the license file

- After loading the license, moving or changing the license files can cause a number of errors.
- When the Infrastructure Management is installed, a hidden .pbk file is created. It is recommended to save a back copy of this .pbk file. If the licence directory is removed and then re-created, the .pbk no longer exists. So the .pbk file must be re-added for Infrastructure Management licensing to function properly. This file can be captured from a backup of the installation (if a backup exists) or from another computer where Infrastructure Management is installed.
Register Infrastructure Management Server with the Presentation Server.
To register Infrastructure Management Server
1. In the TrueSight console, go to Administration > Components, select the action menu next to Components, and select Add Component.
2. Select Infrastructure Management Server as the component type.
3. Enter a valid Host Name in FQDN format.
  Notes
  
  If you plan to TrueSight Infrastructure Management in the high-availability or disaster recovery deployment, ensure that you specify a common alias name for both the primary and secondary servers.
  If the "Invalid Host Name or IP Address" message appears, re-enter a valid FQDN hostname. The name cannot start or end with a dash ( - ), contain any spaces, or exceed 63 characters.
  Adding an IP address of the TrueSight Infrastructure Management Server is no longer supported. With an IP address, the cross-launch to the TrueSight Infrastructure Management from the TrueSight console fails. Therefore, you must edit the hostnames of all the Infrastructure Management Servers that were added in the past after you upgrade the TrueSight Presentation Server.
4. Select the protocol.
5. Accept the default port number (443), or enter a new value.
6. Select any of the listed tenants.
  The list includes each tenant defined in the Remedy Single Sign-On system.
7. Enter a value between 1 and 10 for the Component Initialization Timeout (minutes) period.
  This is the time period for which the TrueSight Presentation Server tries to initialize a connection to the component. If the connection is not completed within the time period, the connection fails.
  Tip
  
  If the Infrastructure Management server contains a large number of groups, set the Component Initialization Timeout (minutes) period to 5 minutes.
8. Clear the Propagate Events box to stop propagation of events from the Infrastructure Management server to the TrueSight Presentation Server.
  Note
  
  To enable propagation of events at a later time, delete the Infrastructure Management server and re-add it with the Propagate Events box checked.
9. Click Save.
  Note
  
  In an Infrastructure Management Server high-availability deployment, ensure that the configured cluster name and host names of the primary and secondary Infrastructure Management servers are resolved with the proper FQDN host name and reachable from the computer that hosts the TrueSight Presentation Server.
Use the following format to define the Infrastructure Management Server URL, and launch the application in a browser.
- (Windows) http(s)://<Infrastructure_Managament_host_FQDN>
- (Linux) http(s)://<Infrastructure_Managament_host_FQDN:Port_number>
Type the default Admin credentials (User name: admin, Password: admin12345), and click Log In.
The Infrastructure Management console opens.

Important

The system requirements are validated every time you restart the host computer or product services. If the system requirements are not met, the product services are not started. To force-start the product services, see Starting and stopping the TrueSight Operations Management components.

Troubleshooting installation issues

If you face issues during installation, see Troubleshooting the Infrastructure Management deployment.

Next step in the Installation process

Step 5 Phase B — Now that you have successfully installed the Infrastructure Management Server, you must install the Integration Service and Remote Cell.