Installing silently

This topic provides instructions for performing a silent installation of the TrueSight IT Data Analytics product. A silent (or unattended) installation obtains the required user input or installation settings from an options file. You can create an options file to perform an installation of the product in the silent mode. This file defines installation settings such as the type of installation, the components to install, the installation location for the components, and so on. You can use silent mode to perform the product installation in a headless environment (on a system that has no display device, keyboard, or mouse).

Note

This information applies to both single-server and distributed-server environments.

This topic contains the following information:

Related topics

Uninstalling

Wizard based installation in a single-server environment

Wizard based installation in a multiple-server environment

Installing the standalone Collection Agent silently

Migrating internal user data from Atrium Single Sign-On to Remedy Single Sign-On Open link

Before you begin

Generating an options file with silent installation properties

Before performing the installation, you must generate an options file with the necessary silent installation properties. Generate a custom file with the appropriate silent installation properties by performing these steps:

  • Navigate to Start > Run > CMD. When the command prompt opens, navigate to <INSTALLATION_DIRECTORY>/ Disk1 and depending on your platform run the following command:
    • Windows: setup.exe –DGENERATE_OPTIONS_FILE=pathToOptionsFile
    • Linux: setup.bin –DGENERATE_OPTIONS_FILE=pathToOptionsFile
      where pathToOptionsFile is the path including the name of the file into which you want to copy the silent installation properties.
  • Specify the required components (properties) for the silent installation and generate the file.
    For more information, see Silent installation properties.
  • Encrypt the administrator password for the target computer. For more information, see Encrypting passwords for Remedy Single Sign-On enabled silent installations .

Sample options files

TaskInstructions
Perform a typical installation
Perform a custom installation

Use one of the following sample options files for custom installation, depending on your platform:

Note: By default, the following is the installation location:

  • Windows: C:\Program Files\BMC Software\TrueSight\ITDA
  • Linux: /opt/bmc/TrueSight/ITDA

To install the product in a different location, ensure that you change the value of the installLocation property.

Encrypting passwords for Remedy Single Sign-On enabled silent installations

The options file for TrueSight IT Data Analytics must contain the administrator password for the target computer. The EncryptPWD utility enables you to create an encrypted password that you can paste into the options file.

To encrypt a password for a silent installation

  1. On the computer on which you downloaded TrueSight IT Data Analytics, browse to the following directory:
    • Windows: <INSTALLER_LOCATION>\BMC-TrueSight-IT-Data-Analytics\Disk1\utility\EncryptPWD
    • Linux: <INSTALLER_LOCATION>\BMC-TrueSight-IT-Data-Analytics\Disk1\utility\EncryptPWD
  2. Run one of the following commands, based on your operating system:
    • Windows: encryptpwd.bat

    • Linux:./encryptpwd.sh

  3. Enter your password when you are prompted for it and press Enter to generate an encrypted password.
  4. Copy and paste the encrypted password into the field  rsso_password of the options.txt file for your silent installer.
    For example, if you run the command in step 2 and the output as described in step 3 is  <encrypted password>, enter the following strings in the options.txt file:

    -J rsso_password=<encrypted password>

Installing TrueSight IT Data Analytics silently

  1. Log on to the computer on which you want to perform the silent installation.
  2. Run the following command, as appropriate:
    • Windows: setup.exe -silent -DOPTIONS_FILE=pathToOptionsFile
    • Linux: setup.bin -silent -DOPTIONS_FILE=pathToOptionsFile

      In the preceding command syntax, pathToOptionsFile refers to the path including the name of the file into which you want to copy the silent installation properties. If the file name or path includes a space, then enclose the file path in double quotes.

      Note

      On the Windows platform, after the installation completes, press Enter to return to the command prompt.

      If you are installing on a Linux Platform, to enable TrueSight IT Data Analytics services to start automatically every time that the machine is restarted, you must register the services. To enable automatic restarting of IT Data Analytics services after server reboot, run the utility $BMC_ITDA_HOME/bin/itdaservices.sh with root user credentials.

Silent installation properties

This section provides information about property values listed in the silent installation options file. This file is a text file that defines the type of installation, the components to install, the installation location, and the configuration settings for the components. The installation properties are in the form of a prefix tag followed by a property name and value pair.

Prefix tags

The following table lists the prefix tags that precede the installation properties.

Prefix tags for silent installation properties

Property flagDescription

-J

Precedes Java properties

-P

Precedes directory properties

-A

Precedes application features

Installation properties

The following table lists the installation properties that succeed the prefix tags.

Installation properties

Property nameDescription
Installation

-P installLocation

Specifies the full path to the installation directory.

Default value:

  • Windows: C:\Program Files\BMC Software\TrueSight\ITDA
  • Linux: /opt/bmc/TrueSight/ITDA
Example: -P installLocation=C:\Program Files\BMC Software\TrueSight\ITDA
Feature selection
-A <Feature-Name>

Specifies the features that you want to install. The product is bundled with various features (components), and a typical installation consists a list of all features, as shown in the following example.

For a custom installation, you can specify particular feature names when generating an options file.

Note: The TomcatHiddenProduct feature is only required if you want to install the Search component or the Console Server component.

Example:

# Install Indexer
-A Indexer
# Install Configuration Database
-A Configuration Database
# Install Collection Station
-A Collection Station
# Install Console Server
-A Console Server
# Install Search
-A Search
# Install Tomcat Hidden Product
-A TomcatHiddenProduct
Installation type
-J INSTALL_SET

Specifies the installation type: typical or custom.

Example:

  • -J INSTALL_SET=TYPICAL
  • -J INSTALL_SET=CUSTOM
Pinning the product to Start menu and starting services

-J STARTMENU_SHORTCUT

Specifies whether you want to pin the product to the Start menu on your computer (Windows only).

Example: -J STARTMENU_SHORTCUT=true

-J STARTSERVICES_ITDA

Specifies whether you want to start the product services immediately after the installation is complete.

Example: -J STARTSERVICES_ITDA=true

Skipping port validation
-J SKIP_VALIDATION

Specifies whether you want to skip port validation during installation.

You might want to use this property if you know that the ports used for the installation are available before starting the installation. For more information about default ports, see Communication ports and protocols.

Example: -J SKIP_VALIDATION=true

Note: This feature is only available for silent installation. If you do not add this property or set the value of this property to false, and if the defaults ports are in use, then the installation will fail.

Allowing BMC to collect product usage information
-J enable_feature_tracking

Specifies whether you want to enable BMC to collect product usage information.

By sharing usage information, you can help BMC improve the product in ways that are more relevant to your needs.

Example: -J enable_feature_tracking=true

For more information, see Information notice on product usage.

Indexer details
-J itda.indexinghost

Indicates the host name of the computer where you want to install the Indexer.

The default is your local host name.

Example: -J itda.indexinghost=Indexer.bmc.com

-J itda.indexingport

Indicates the port number of the computer where you want to install the Indexer. The default is 9300.

Example: -J itda.indexingport=9300

-J itda.indexing.unicast.hosts
If you want to install an Indexer that must function as the master, leave this value blank.

If you are installing an Indexer that must function as a peer or a component that communicates with the master Indexer, provide the fully qualified host name and port number of the master Indexer, installed on the primary node. This value must be in the format, hostName1:Port.

Example: -J itda.indexing.unicast.hosts=
MasterIndexer.bmc.com:9300

Configuration Database details
-J itda.configdbhost
Indicates the host name of the computer where you want to install the configuration database.

The default is your local host name.

Example: -J itda.configdbhost=ConfigDB.bmc.com

-J itda.configdbport

Indicates the port number of the computer where you want to install the configuration database

  The default is 9999.

Example: J itda.configdbport=9999

Collection Station details
-J itda.stationinstancename

Indicates the name of the Collection Station as it must be displayed under the Administration > Hosts tab.

Example: -J itda.stationinstancename=
Collection-Station.bmc.com

-J itda.stationhttpbindaddress

Indicates the HTTP service bind address that the Collection Agent and the Console Server must use to connect with the Collection Station.

The default is 0.0.0.0.

Example: -J itda.stationhttpbindaddress=0.0.0.0

-J itda.stationhttpbindport

Indicates the HTTP service bind port number that the Collection Agent and the Console Server must use to connect with the Collection Station.

The default is 8080.

Example: -J itda.stationhttpbindport=8080

-J itda.stationpayloadbindaddress
Indicates the Payload Service bind address that the Collection Station must use for listening to incoming data.

The default is 0.0.0.0.

Example: -J itda.stationpayloadbindaddress=0.0.0.0

-J itda.stationpayloadbindport

Indicates the Payload Service bind port number that the Collection Station must use for listening to incoming data.

The default is 41414.

Example: -J itda.stationpayloadbindport=41414

-J agent.pool.name

Specifies whether you want to implement data collection redundancy. For more information, see Collection Station redundancy.

If you specify the value as true, it implies that the Collection Station installed will be added to a common pool. If this Collection Station goes down, Collection Agents communicating with the Collection Station are moved to another Collection Station in the pool.

Example: -J agent.pool.name=true

Search details
-J itda.searchenginehost

Indicates the host name of the computer where you want to install the Search component.

The default is your local host name.

Example: -J itda.searchenginehost=Indexer.bmc.com

-J itda.searchengineport

Indicates the port number of the computer where you want to install the Search component.

The default is 9797.

Example: -J itda.searchengineport=9797

Console Server details
-J itda.consoleserverhost

Indicates the host name of the computer where you want to install the Console Server component.

The default is your local host name.

Example: -J itda.consoleserverhost=ConsoleServer.bmc.com

-J itda.consoleserverport

Indicates the port number of the computer where you want to install the Console Server component.

The default is 9797.

Example: -J itda.consoleserverport=9797

Remedy Single Sign-On details


These details are only applicable while installing the Console Server.

Configuring Remedy Single Sign-On is an optional step. If you do not want to use Remedy Single Sign-On as your authentication mechanism or if you want to install a standalone instance of IT Data Analytics, you can skip these details.

If you are upgrading from an earlier version of the product, Remedy Single Sign-On configuration is not supported. However, you can manually configure the Remedy Single Sign-On server by using the enablesso CLI command.

-J enable_rsso

Specifies whether you want to use Remedy Single Sign-On as an authentication mechanism. For more information, see User authentication options.

Example: -J enable_rsso=true

-J rsso_protocol


Indicates the protocol used for connecting with the Remedy Single Sign-On server.

The default value is HTTPS. It can be set to HTTP or HTTPS.

Example: -J rsso_protocol=HTTPS 

-J rsso_host

Indicates the fully Qualified Domain Name (FQDN) of the Remedy Single Sign-On server.

Example: -J rsso_host=RSSOHost.bmc.com

-J rsso_port

Indicates the port number of the Remedy Single Sign-On server.

The default is 448.

Example: -J rsso_port=448

-J rsso.tenant

Indicates the name of the tenant (also known as Realm in Remedy Single Sign-On) that you configured while integrating IT Data Analytics with TrueSight Operations Management. For more information, see Integrating with TrueSight Presentation Server.

If you want to use Remedy Single Sign-On without integrating with TrueSight Presentation Server, then provide the name of the tenant that is present on Remedy Single Sign-On.

Example: -J rsso.realm=*

-J rsso_username

Indicates the user name for connecting with the Remedy Single Sign-On server.

The default Remedy Single Sign-On administrator user name is "Admin".

Example: -J rsso_username=Admin

-J rsso_password

Indicates the password for connecting with the Remedy Single Sign-On server.

The password corresponding to the default user name is the same as what you provided while installing Remedy Single Sign-On.

Example: -J rsso_password=6G0MnPoXCyHIJ/abMcoHwQ==

-J tsps_host

Indicates the fully Qualified Domain Name (FQDN) of the TrueSight Presentation server.

Example: -J tsps_host=TSPSHost.bmc.com

In case of TrueSight Presentation server High Availability, the FQDN of the Load Balancer should be provided.

-J tsps_port

Indicates the port number of the Presentation server.

The default is 443 for Windows (HTTPS) and 8043 for Linux (HTTPS).

Example: -J tsps_port=443

Where to go from here

(Optional) Verify if the installation completed successfully.

Access the product by using the Start menu.

While running the installer, if you did not have the product start services immediately, then manually start the services.

Perform configurations such as enabling security for the product, configuring the email setting, and configurations required before scaling up.

Start data collection immediately after installation, by making the following configurations:

  • (Optional) Create Data patterns to define how the data collected must be indexed and displayed.
  • Create data collectors to define the type of data to be collected and how it must be collected, and to start the data-collection process.
Was this page helpful? Yes No Submitting... Thank you

Comments