Installing and configuring the Infrastructure Management server for application high-availability silently

Where you are in the Installation process

You need to perform the following tasks to install and configure TrueSight Infrastructure Management in an application high-availability environment silently.

Step A: Install TrueSight Infrastructure Management on the primary computer silently

Application high-availability is supported only with the Oracle database. Install theTrueSight Infrastructure Managementserver on the primary computer. you must configure the Oracle database details in the server_install.options file during installation. If you have a supported earlier version of theTrueSight Infrastructure Managementserver, upgrade it to the latest version. See Upgrading the Infrastructure Management Server. 

Do the following:

1. 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.

2. 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

3. (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

4. You will need to type the Oracle database administrator, user, and report user passwords in an encrypted form in the server_install.options. 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).

5. 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.

6. From the command prompt, navigate to the Disk1 folder:
   • (Windows) <DownloadLocation>\TSIMServer\Disk1\
     
   • (Linux) <DownloadLocation>/TSIMServer/Disk1/

7. 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_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. 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

   
   

8. 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

   The TrueSight Infrastructure Managementinstallation may take between 20 to 60 minutes to complete.

9. 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
     
     

     Tip

     - 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.

10. (Linux) Verify that the following environment variables are set.

    • $BPPM_SERVER_HOME

    • $BMC_PROACTIVENET_HOME

11. (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.

12. 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>

      BMCTrueSight.service (Applicable only to version 11.3.04 and later on Linux)

      You can use the systemd service BMCTrueSight.service located in the /etc/systemd/system directory to start and stop the Infrastructure Management server on Linux. For more information, see Starting and stopping the TrueSight Operations Management components.

13. 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 a temporary directory on the Infrastructure Management Server (Example: C:\Program Files\BMC Software\licenses\TSIM).
    2. Unzip the file.
    3. Copy only the proactivenet.lic and proactivenet.sign files to the C:\Program Files\BMC Software\pw\licenses directory.
    4. To load the license data, run the command: pw lic update.
    5. 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 a temporary directory on the Infrastructure Management Server (Example: /opt/bmc/licenses/TSIM).
    2. Unzip the file.
    3. Copy only the proactivenet.lic and proactivenet.sign files to the /usr/pw/licenses directory.
    4. To load the license data, run the command: pw license update.
    5. 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.

Step B: Install TrueSight Infrastructure Management on the secondary computer silently

Do the following:

1. 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.

2. 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

3. (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

4. If you are using a single Oracle instance and already created the users as specified at Complete the preinstall tasks for application high-availability mode, enter details of the primary server Oracle instance with the proact and reporting user username and passwords specified for the secondary server. You will need to type the Oracle database administrator, user, and report user passwords in an encrypted form in the server_install.options. 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).

5. 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.

6. From the command prompt, navigate to the Disk1 folder:
   • (Windows) <DownloadLocation>\TSIMServer\Disk1\
     
   • (Linux) <DownloadLocation>/TSIMServer/Disk1/

7. 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_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. 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

   
   

8. 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

   The TrueSight Infrastructure Managementinstallation may take between 20 to 60 minutes to complete.

9. 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
     
     

     Tip

     - 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.

10. (Linux) Verify that the following environment variables are set.

    • $BPPM_SERVER_HOME

    • $BMC_PROACTIVENET_HOME

11. (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.

12. 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>

      BMCTrueSight.service (Applicable only to version 11.3.04 and later on Linux)

      You can use the systemd service BMCTrueSight.service located in the /etc/systemd/system directory to start and stop the Infrastructure Management server on Linux. For more information, see Starting and stopping the TrueSight Operations Management components.

13. 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 a temporary directory on the Infrastructure Management Server (Example: C:\Program Files\BMC Software\licenses\TSIM).
    2. Unzip the file.
    3. Copy only the proactivenet.lic and proactivenet.sign files to the C:\Program Files\BMC Software\pw\licenses directory.
    4. To load the license data, run the command: pw lic update.
    5. 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 a temporary directory on the Infrastructure Management Server (Example: /opt/bmc/licenses/TSIM).
    2. Unzip the file.
    3. Copy only the proactivenet.lic and proactivenet.sign files to the /usr/pw/licenses directory.
    4. To load the license data, run the command: pw license update.
    5. 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.

Step C: Configure application high-availability

1. Stop the Infrastructure Management process on both servers.
   From the pw command prompt, run the following command:
   pw sys stop
   

2. On the primary server:

   1. Run the following command from the pw command prompt:
pw ha enable
For details about the command, see  pw ha enable command
      The command generates the HA configuration file ha-generated.conf in the installedDirectory\pw\pronto\tmp directory.
   2. Go to the installedDirectory/pw/server/etc/<CellName>/mcell.conf, add the following property to indicate the Infrastructure Management host name, and save the file.
      

      ServerHostName=<InfrastructureManagementHostName>

   3. Copy the ha-generated.conf file to the secondary server.
      
      

3. On the secondary server: 

   1. Run the following command from the pw command prompt:

      pw ha enable standby file=<path of the ha-generated.conf file>

      For details about the command, see  pw ha enable standby command

   2. Go to the installedDirectory/pw/server/etc/<CellName>/mcell.conf, add the following property to indicate the Infrastructure Management host name, and save the file.
      ServerHostName=<InfrastructureManagementHostName>
      
      
4. Copy the installedDirectory\TrueSight\pw\pronto\tmp\addremoteagent file to the primary server.
5. Copy the installedDirectory\TrueSight\pw\server\var\pncell_<host name>#1 folder from the primary server to the same location on the secondary server.

6. On the secondary server, rename the folder that you copied from the primary server to:
   pncell_<host name>#2

7. Restart the primary server and then restart the secondary server.
   From the pw command prompt, run the following command:
   pw sys start
8. Run the following command from the primary and secondary server to verify the high availability status:
   pw ha status
9. On the primary server, run the addremoteagent file.

10. (Optional - to configure remote cells)

    1. On the primary server, add each remote cell entry to the installedDirectory/server/etc/mcell.dir file in the following format:
       cell <cell name> <encryption key> <cell host>:<cell port>
       For example, cell aaa-test-bmc1 mc aaa-test-bmc1:1828
    2. On the primary server, run the iadmin command from the installedDirectory\pw\server\bin directory to register the remote cell:
       iadmin -ac name=<cell name>:key=<encryption key>:primaryHost=<cell host name>:primaryPort=<cell port>:environment=Production:usergroups=*

    3. Perform the preceding steps on the secondary server.

    4. On the primary server, run the mcontrol command from the installedDirectory\pw\server\bin directory to reload the cell configuration:
       mcontrol -n <pncell name> reload dir

11. Register TrueSight Infrastructure Managementwith the Presentation 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 the Host Name configured in the load balancer in FQDN format.

12. (Optional) Delete the Oracle database schema (or Oracle instance, if you created a separate instance) of the secondary node, since it is no longer required after application high-availability is configured.

Troubleshooting installation issues

Next step in the Installation process