This topic provides instructions for performing a silent installation of the BMC 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).
This topic contains the following information:
Note
This information applies to both single-server and distributed-server environments.
Before performing the installation, you must generate an options file with the necessary silent installation properties:
Task | Instructions |
---|---|
Perform a typical installation | Use one of the following sample options files, depending on your platform: Note: By default, the following is the installation location:
To install the product in a different location, ensure that you change the value of the |
Perform a custom installation | Generate a custom file with the appropriate silent installation properties by performing these steps:
|
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.
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.
The following table lists the prefix tags that precede the installation properties.
Prefix tags for silent installation properties
Property flag | Description |
---|---|
-J | Precedes Java properties |
-P | Precedes directory properties |
-A | Precedes application features |
The following table lists the installation properties that succeed the prefix tags.
Installation properties
Property name | Description |
---|---|
Installation | |
| Specifies the full path to the installation directory. Default value:
-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 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 | |
| Specifies the installation type: typical or custom. Example:
|
Pinning the product to Start menu and starting services | |
| Specifies whether you want to pin the product to the Start menu on your computer (Windows only). Example: |
| Specifies whether you want to start the product services immediately after the installation is complete. Example: |
Skipping port 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: Note: This feature is only available for silent installation. If you do not add this property or set the value of this property to |
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.indexingport | Indicates the port number of the computer where you want to install the Indexer. The default is 9300. Example: |
-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: |
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.configdbport | Indicates the port number of the computer where you want to install the configuration database The default is 9999. Example: |
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.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.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.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.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 agent.pool.name | Specifies whether you want to implement data collection redundancy. For more information, see Data collection redundancy. If you specify the value as Example: |
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.searchengineport | Indicates the port number of the computer where you want to install the Search component. The default is 9797. Example: |
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.consoleserverport | Indicates the port number of the computer where you want to install the Console Server component. The default is 9797. Example: |
BMC Atrium Single Sign-On details | |
| |
-J enable_sso | Specifies whether you want to use BMC Atrium Single Sign-On as an authentication mechanism. For more information, see User authentication options. Example: |
-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_host | Indicates the fully Qualified Domain Name (FQDN) of the BMC Atrium Single Sign-On server. Example: |
-J sso_port | Indicates the port number of the BMC Atrium Single Sign-On server. The default is 8443. Example: |
-J sso.tenant | Indicates the name of the tenant (also known as Realm in BMC Atrium Single Sign-On) that you configured while integrating IT Data Analytics with BMC TrueSight Operations Management. For more information, see Integrating with TrueSight Presentation Server. If you want to use BMC Atrium Single Sign-On without integrating with TrueSight Presentation Server, then provide the name of the tenant that is present on BMC Atrium Single Sign-On. Example: |
-J sso_username | Indicates the user name for connecting with the BMC Atrium Single Sign-On server. The default Atrium Single Sign-On administrator user name is "amadmin". Example: |
-J sso_password | Indicates the password for connecting with the BMC Atrium Single Sign-On server. The password corresponding to the default user name is the same as what you provided while installing BMC Atrium Single Sign-On. Example: |
(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:
2 Comments
Scott Bleasdell
Priyanka Nanwani