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:
Before you begin
- Read the Planning topic.
- Verify that your environment meets the system requirements.
- Download and unzip (for Windows) or unzip and extract (for Linux) the TrueSight IT Data Analytics zipped files (the installer) at your preferred location.
- Depending on your installation scenario, use the sample options file or generate a custom file. For more information, see Generating an options file with silent installation properties.
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
wherepathToOptionsFile
is the path including the name of the file into which you want to copy the silent installation properties.
- Windows:
- 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
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 | Use one of the following sample options files for custom installation, 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 |
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
- 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
- Run one of the following commands, based on your operating system:
Windows: encryptpwd.bat
Linux:./encryptpwd.sh
- Enter your password when you are prompted for it and press Enter to generate an encrypted password.
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
- Log on to the computer on which you want to perform the silent installation.
- 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.
- Windows:
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 flag | Description |
---|---|
-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 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: |
-J STARTSERVICES_ITDA | 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 |
Allowing BMC to collect product usage information | |
| 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: 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.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 Collection Station 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: |
Remedy Single Sign-On details | |
| |
-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 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_host | Indicates the fully Qualified Domain Name (FQDN) of the Remedy Single Sign-On server. Example: |
-J rsso_port | Indicates the port number of the Remedy Single Sign-On server. The default is 448. Example: |
-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_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_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 tsps_host | Indicates the fully Qualified Domain Name (FQDN) of the TrueSight Presentation server. Example: 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: |
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.
Comments
Log in or register to comment.