Page tree
Skip to end of metadata
Go to start of metadata

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:

Videos that explain the silent installation process

The following videos illustrate how to install IT Data Analytics silently.

Note

The following videos display screens from an earlier version, however, the information provided in the videos is still relevant to the current version of the product.


Silent installation on a Windows platform

The following video (3:50) illustrates how to install IT Data Anaytics silently on Windows. https://youtu.be/tDlj9VvATSs

Silent installation on a Linux platform

The following video (4:20) illustrates how to install IT Data Anaytics silently on Linux. https://youtu.be/y5vyjPKkLN8

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:

TaskInstructions
Perform a typical installationUse one of the following sample options files, 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.

Perform a custom installation

Generate a custom file with the appropriate silent installation properties by performing these steps:

  • Navigate to Start > Run > CMD 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.

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.

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 SET=TYPICAL

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

Atrium Single Sign-On details

 Read more information about when these details are applicable

These details are only applicable while installing the Console Server.

Configuring Atrium Single Sign-On is an optional step. If you do not want to use Atrium 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, Atrium Single Sign-On configuration is not supported. However, you can manually configure the Atrium Single Sign-On server by using the enablesso CLI command.

-J enable_sso

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

Example: -J enable_sso=true

-J sso_protocol

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

This value must be set to HTTPS.

Example: -J sso_protocol=HTTPS

-J sso_host

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

Example: -J sso_host=SSOHost.bmc.com

-J sso_port

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

The default is 8443.

Example: -J sso_port=8445

-J sso.tenant

Indicates the name of the tenant (also known as Realm in Atrium 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 Atrium Single Sign-On without integrating with TrueSight Presentation Server, then provide the name of the tenant that is present on Atrium Single Sign-On.

Example: -J sso.tenant=BMCRealm

-J sso_username

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

The default Atrium Single Sign-On administrator user name is "amadmin".

Example: -J sso_username=amadmin

-J sso_password

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

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

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

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.