Installing the Integration Service and Remote Cell 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 Infrastructure Management — Phase A
Install Infrastructure Management — Phase B (You are here)
Install Infrastructure Management — Phase C
6 Install Application 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

This page provides information about:

Recommendations for installing Integration Service and Remote Cell

  • Do not install Integration Service on the same computer where you have installed the Infrastructure Management Server.

    The Infrastructure Management Server is the central system for all the Infrastructure Management functions. Therefore, the performance of the Infrastructure Management Server must be at its peak. The Infrastructure Management Server has its own Self-Monitoring Service that monitors the health of the Infrastructure Management system.

    Installing the Integration Service on the same computer pulls resources away from the Infrastructure Management Server components. If multiple Integration Services are installed on the same computer where the Infrastructure Management Server is installed, the additional services will interfere with some of the server commands.
  • (For IT Data Analytics users) Do not install Integration Service on the same computer where you have installed or plan to install the IT Data Analytics. Installing both on the same computer stops the TrueSight Infrastructure Management event collection in IT Data Analytics. However, you can install the IT Data Analytics Collection Agent and Integration Service on the same computer if you are monitoring only the log collection and not event collection.
  • If you want to install both cell and Integration Service on the same computer on which you have installed only the cell, then you should provide a different location for installing cell and Integration Service. If you provide the same location where you installed the cell (C:\ProgramFiles\BMC Software\TSIMAgent), then the cell entries are removed from the system.
  • (Microsoft Windows) If you want to integrate Infrastructure Management with SCOM 2007 and 2012, ensure that .NET Framework version 3.0 is installed. If you are installing it on Windows 2008 R2, use the Role Management tool. For more information about installing .NET Framework, see the Microsoft website. 

  • (Linux) Although you can install the Integration Service as a root user or a non-root user, BMC recommends that you install the Integration Service as a root user. You need root user permissions or root privileges for a non-root user to install the Integration Service. 
      Permissions required by a non-root user

    (Linux) You can install the Integration Service as a root user as well as a non-root user. However, to enable non-root users to install the Integration Service, as a root user, you need to provide the following permissions to the the non-root user. 

    • Provide read, write, and execute permissions for the following directories:
      • Installation directory (destination directory where you are planning to install the product)
      • /opt/bmc directory to create ProductRegistry.xml file
      • /etc directory to set environment variable
      • /etc/patrol.d directory to create patrol security
      • /etc/init.d/etc/rc.d/rc0.d/etc/rc.d/rc1.d/etc/rc.d/rc3.d, and /etc/rc.d/rc5.d directories to create service
      • /tmp and /var/tmp directories
    • Provide read and write permissions for the following files and directories:
      • /etc/csh.cshrc file
      • /etc/profile directory to set environment variable permission 
      • (Remote cell on AIX only/home directory
    • If the init file is not copied to the /etc/rc3.d directory, the Integration Service corresponding to the init file is not listed as installed (in the list of existing Integration Service installations) during installation of other integration services.
    • Ensure that you remove the /etc/bmc.cshrc and /etc/bmc.profile files if they already exist. 

    Note

    Installing the Integration Service with the non-root user is supported only on the Linux operating system. It is not supported on the Solaris or AIX operating system.

  • (Linux) Integration Service is not supported on Solaris and AIX operating systems. When you run this installer on a Solaris or AIX computer, the option for the Integration Service component is disabled. (You can install only the Remote Cell on these operating systems). The Integration Service is supported on computers running Linux as a guest operating system installed by using VMware.
  • The Remote Cell is not supported on the Solaris Intel x86 platform. 
  • (Linux) BMC recommends that you use MobaXterm as the UI to install TrueSight Infrastructure Management on Linux computers.

Installing the Integration Service and Remote Cell on Microsoft Windows silently

Do the following:

  1. Navigate to the TSIMAgent.zip file available in the installationDirectory\pw\pronto\web\html\download\win32_agent directory 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:

    C:\Program Files\BMC Software\TSIMAgent

    Example: -P installLocation=C:\Program Files\BMC Software\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:\Users\Administrator\Downloads\Windows_11.3.01_241433081\Windows\TSIM Agent\Windows\TSIMAgent\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. 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, IBM AIX, or Solaris silently 

Do the following:

  1. Navigate to the TSIMAgent.zip file available in the following directory and extract its contents:
    • (Linux) installationDirectory/pw/pronto/web/html/download/linux_agent
    • (Solaris) installationDirectory/pw/pronto/web/html/download/solaris_agent
    • (AIX) installationDirectory/pw/pronto/web/html/download/aix_agent
  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 (as a root user or a non-root user):
    ./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.

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.

Was this page helpful? Yes No Submitting... Thank you

Comments