Installing the Integration Service and Remote Cell silently

Where you are in the Installation process

Installing the Integration Service and Remote Cell on Microsoft Windows silently

Do the following:

1. Navigate to the downloaded TSIMAgent.zip file and extract its contents. 

2. Open and edit the bmc_tsim_is_install.options file. You can either retain the default values for the properties or change them, and save the file. The file defines the installation properties in the form of a prefix tag followed by a property name and value pair. 

    Property details

   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	You can retain the following default installation directory path or enter a new path: Example: (Windows)-P installLocation=C:\Program Files\BMC Software\TSIMAgent (Linux)-P installLocation=/opt/bmc/TSIMAgent
   Installing features
   -A IM	Impact Manager. Uses selectors to match incoming events and to make them available to subscribing clients.
   -A IEA	Impact Event Adapter. Prepares the source event data for processing by the Cell event processor.
   -A IELA	Impact Event Log Adapter. Collects source events from the Windows Event Log.
   Integration Service installer configuration
   -J IS_INSTALL_INTEGRATION_SERVICE	Retain the default value. Default value: true Example: -J IS_INSTALL_INTEGRATION_SERVICE=true
   -J IS_INSTALL_REMOTE_CELL	Retain the default value. Default value: true Example: -J IS_INSTALL_REMOTE_CELL=true
   -J AGENT_PORT	Retain the default or type a new value. Default value: 12124 Example: -J AGENT_PORT=12124
   -J PATROL_STAGING_ADAPTER_PORT	Retain the default or type a new value. Default value: 3183 Example: -J PATROL_STAGING_ADAPTER_PORT=3183
   High-availability settings
   -J HA_MODE_SELECTED	False. The value false indicates that the high-availability mode is disabled. Default value: false Example: -J HA_MODE_SELECTED = false You can ignore the rest of the high availability properties. If HA_MODE_SELECTED is true then CELL_MODE is mandatory as either primary or secondary to install Cell as primary server or secondary server. If HA_MODE_SELECTED is false then do not provide CELL_MODE.
   -J CELL_MODE	Type either primary or secondary. Example: -J CELL_MODE=primary
   -J CELL_PRIMARY_HOST	Provide the host name of primary server if CELL_MODE is Secondary
   -J CELL_SECONDARY_HOST	Provide the host name of secondary server if CELL_MODE is Primary
   -J CELL_TYPE	Provide the Cell type. Example: EM (Event Manager), SIM (Service Impact Manager).
   -J CELL_NAME	Name of the Cell instance. The host name is the default Cell instance name.
   -J CELL_PORT	Port number for the Cell. The range is between 1024 and 65535. The default port number for the Cell is 1828. Ensure that the specified port is free.
   -J CELL_KEY	Encryption key for the Cell. The default value is mc, and special characters are not allowed.

3. Open the command prompt with the Run as administrator option. Navigate to the install.cmd file, which is available in the extracted zipped folder.

4. Run the following command:
   install.cmd -i silent -DOPTIONS_FILE="<fullyQualifiedPath>\bmc_tsim_is_install.options"

where fullyQualifiedPath indicates the complete path where you have saved the bmc_tsim_is_install.options file. If the fullyQualifiedPath parameter contains a space in it, the path must be enclosed within double quotes.

   Example

   install.cmd -i silent -DOPTIONS_FILE="C:\Temp\bmc_tsim_is_upgrade.options"


   The installation progress is not displayed on the console. However, installation occurs in the background. The installation progress is logged in a temporary folder. 

5. Go to Start > Run, enter %temp% in the Open box, and view the tsim_agent_install.log file. 

Installing the Integration Service on Linux and Remote Cell on Linux silently 

BMC recommends that you use MobaXterm as the UI to install the Integration Service on Linux computers.

Do the following:

1. Navigate to the downloaded TSIMAgent.zip file and extract its contents. 

2. Apply executable rights to all the installation files by running the following command: 

   chmod -R 755 installationDirectoryFolderName 

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

   For example, chmod -R 755 Disk1

3. Open and edit the bmc_tsim_is_install.options file. You can either retain the default values for the properties or change them, and save the file. The file defines the installation properties in the form of a prefix tag followed by a property name and value pair.

    Property details

   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	You can retain the following default installation directory path or enter a new path: /opt/bmc/TSIMAgent Example: -P installLocation=/opt/bmc/TSIMAgent
   Installing features
   -A IM	Impact Manager. Uses selectors to match incoming events and to make them available to subscribing clients.
   -A IEA	Impact Event Adapter. Prepares the source event data for processing by the Cell event processor.
   -A IELA	Impact Event Log Adapter. Collects source events from the Windows Event Log.
   Integration Service installer configuration
   -J IS_INSTALL_INTEGRATION_SERVICE	Integration Service is not supported on AIX and Solaris OS platforms. The below property needs to be set to false for these OS platforms. -J IS_INSTALL_INTEGRATION_SERVICE=false Also, the property values below are not considered for AIX and Solaris -J AGENT_PORT=12124 -J PATROL_STAGING_ADAPTER_PORT=3183
   -J IS_INSTALL_INTEGRATION_SERVICE	Retain the default value. Default value: true Example: -J IS_INSTALL_INTEGRATION_SERVICE=true
   -J IS_INSTALL_REMOTE_CELL=true	Retain the default value. Default value: true Example: -J IS_INSTALL_REMOTE_CELL=true
   -J AGENT_PORT	Retain the default or type a new value. Default value: 12124 Example: -J AGENT_PORT=12124
   -J PATROL_STAGING_ADAPTER_PORT	Retain the default or type a new value. Default value: 3183 Example: -J PATROL_STAGING_ADAPTER_PORT=3183
   High-availability settings
   -J HA_MODE_SELECTED	False. The value false indicates that the high-availability mode is disabled. Default value: false Example: -J HA_MODE_SELECTED = false You can ignore the rest of the high availability properties. If HA_MODE_SELECTED is true then CELL_MODE is mandatory to provide as either primary or secondary inorder to install cell as primary server or secondary server. If HA_MODE_SELECTED is false then do not provide CELL_MODE.
   -J CELL_MODE	Type either primary or secondary. Example: -J CELL_MODE=primary
   -J CELL_PRIMARY_HOST	Provide the host name of primary server if CELL_MODE is Secondary
   -J CELL_SECONDARY_HOST	Provide the host name of secondary server if CELL_MODE is Primary
   -J CELL_TYPE	Provide the Cell type. Example: EM (Event Manager), SIM (Service Impact Manager).
   -J CELL_NAME	Provide the name of the Cell instance. The host name is the default Cell instance name.
   -J CELL_PORT	Port number for the Cell. The range is between 1024 and 65535. The default port number for the Cell is 1828. Ensure that the specified port is free.
   -J CELL_KEY	Encryption key for the Cell. The default value is mc, and special characters are not allowed.

4. Run the following command:
   ./install.sh -i silent -DOPTIONS_FILE="<fullyQualifiedPath>/bmc_tsim_is_install.options"

   where fullyQualifiedPath indicates the complete path where you have saved the bmc_tsim_is_install.options file. If the fullyQualifiedPath parameter contains a space in it, the path must be enclosed within double quotes.

   Example

   ./install.sh -i silent -DOPTIONS_FILE="/opt/bmc/TSIM_Linux_Builds/Linux/TSIM Agent/Linux/Disk1/bmc_tsim_is_install.options"

   The installation progress is not displayed on the console. However, installation occurs in the background. The installation progress is logged in a temporary folder. 

5. Open /tmp or /var/tmp and view the tsim_agent_install_log.txt file.

   Do the following after you complete installing as a non-root user on a Linux operating system:

   • Manually copy the S81pronto.<User_ID>.<Agent_Instances> file from the /pw/pronto/bin directory to the /etc/rc.d/rc<Runlevel_Directory>.d directory.

     User_ID - User ID of the logged-in user

     Agent_Instances - Number of Integration service instances on the computer

     Runlevel_Directory - Number of runlevel directory

   • Open the /etc/rc.d/rc.local file, comment the pre-existing S81pronto file entries, and add a fresh entry of S81pronto.<User_ID>.<Agent_Instances> in the /etc/rc.d/rc.local file as shown in the following example:
     

     #/etc/rc2.d/S81pronto.0.2
#/etc/rc2.d/S81pronto.0.2
#/etc/rc2.d/S81pronto.0.2
/etc/rc2.d/S81pronto.1004.1

   • Revoke the write permissions for the non-root users from the following directories:
     • /etc/patrol.d
     • /etc/init.d, /etc/rc.d/rc0.d, /etc/rc.d/rc1.d, /etc/rc.d/rc3.d, and /etc/rc.d/rc5.d

   
   

Next step in the Installation process

Step 5 Phase C Task 1 — Now that you have successfully installed the Integration Service and Remote Cell, you must download and deploy monitoring solutions.