Performing the Presentation Server installation silently

You can install the TrueSight Presentation Server unattended (a silent installation), which requires no user interaction during installation. You can perform a silent installation, as described in this topic, or you can use the installation wizard.

The following files are used to configure the silent installation of Presentation Server:

(Windows) server-silent-options-windows.txt
(Linux) server-silent-options-linux.txt

These files are located in the Disk1 directory of the Presentation Server installation file structure.

The following topics are included:

Before you begin

Before you begin the silent installation, complete the following items:

Ensure that the computer on which you are installing the product adheres to the hardware, operating system, platform, and software requirements listed in System requirements.
Ensure that the computer on which you are installing the product adheres to the requirements described in Preparing for the Presentation Server installation.
Complete or review the information in the installation worksheet. The default values used during the installation process are entered in the installation worksheet.
Prepare an encrypted password for the database and Atrium Single Sign-On server.

To configure the silent install file

On the system where you want to install the Presentation Server, complete the following procedure:

Use a text editor to open the relevant server-silent-options.txt file.
Specify a valid installation directory for the Presentation Server:
```
-P installLocation=<directory>
```
The <directory> is the installation location.
Examples
(Windows) -P installLocation=C:\Program Files\BMC Software\TrueSightPServer
(Linux) -P installLocation=/opt/bmc/TrueSightPServer
Under the Installation Features section is the Presentation Server component name.
```
# Install TrueSight Presentation Server
-A featureTrueSightPServer
```

Under the Installer Configuration section, enter the TrueSight Server installation configuration information.

If required, change the default port numbers. Ensure that the port number you enter is available.

-J TrueSight_localhost_fqdn=
-J TrueSight_high_availability_enabled=0
-J TrueSight_high_availability_type=1
-J TrueSight_high_availability_server_pair_name=truesight
-J TrueSight_high_availability_primary_cache_port=7800
-J TrueSight_high_availability_primary_control_port=8800
-J TrueSight_high_availability_secondary_server_fqdn=
-J TrueSight_high_availability_secondary_database_port=5432
-J TrueSight_high_availability_secondary_cache_replication_port=7800
-J TrueSight_high_availability_secondary_control_port=8800
-J TrueSight_high_availability_configuration_file=
-J TrueSight_tomcat_http_port=80
-J TrueSight_tomcat_https_port=443
-J TrueSight_ElasticSearch_rest_port=9200
-J TrueSight_ElasticSearch_client_port=9300
-J TrueSight_cell_gateway_port=1900
-J TrueSight_database_username=
-J TrueSight_database_password=
-J TrueSight_database_confirm_password=
-J TrueSight_database_port=5432
-J TrueSight_sso_hostname=
-J TrueSight_sso_port=8443
-J TrueSight_sso_password=

Presentation Server configuration descriptions

Parameter	Description
TrueSight_localhost_fqdn	System's localhost Fully Qualified Domain Name (FQDN)
TrueSight_high_availability_enabled	Presentation Server High Availability (HA) option The default value (0) means that the HA option is enabled.
TrueSight_high_availability_type	HA option setting, either Primary Server mode or Secondary Server mode. The default value (1) means that the Primary Server mode is enabled. The value (2) means that the Secondary Server mode is enabled. The Secondary server maintains a constantly updated cache memory of the Presentation Server activity.
TrueSight_high_availability_server_pair_name	Elasticsearch cluster name for one node (server), or more nodes, that holds all of the data, and provides federated indexing and search capabilities across all nodes. The default value for the cluster name is "truesight". It is recommended that you change this name to reflect the logical group name of the cluster.
Note If you do not use the default High Availability port numbers, only use port numbers between 1024 and 65535.
TrueSight_high_availability_primary_cache_port	Number of the Primary Cache Replication port
TrueSight_high_availability_primary_control_port	Number of the Primary Control port
TrueSight_high_availability_secondary_server_fqdn	Secondary (standby) server host name Only applicable when set to Primary Server mode (TrueSight_high_availability_type =1).
TrueSight_high_availability_secondary_database_port	Number of the Secondary Server database port
TrueSight_high_availability_secondary_cache_replication_port	Number of the Secondary Server Cache Replication port
TrueSight_high_availability_secondary_control_port	Number of the Secondary Server Control port
TrueSight_high_availability_configuration_file	Secondary server configuration file Only applicable when set to Secondary server mode (TrueSight_high_availability_type =2). This file is the HA configuration file that is uploaded during the Presentation Server installation.
Notes For Windows systems, if you do not use the default port numbers, only use port numbers between 1 and 65535. For Linux systems, if you do not use the default port numbers, only use port numbers between 1024 and 65535.
TrueSight_tomcat_http_port	Apache Tomcat HTTP port number
TrueSight_tomcat_https_port	Apache Tomcat HTTPS port number
TrueSight_ElasticSearch_rest_port	Elasticsearch Representational state transfer (REST) port number
TrueSight_ElasticSearch_client_port	Elasticsearch client port number
TrueSight_cell_gateway_port	Cell Gateway port number
Notes The database user name and password cannot exceed 30 characters. For Windows systems, if you do not use the default database port number, only use port numbers between 1 and 65535. For Linux systems, if you do not use the default database port number, only use port numbers between 1024 and 65535.
TrueSight_database_username	User name for the PostgreSQL database
TrueSight_database_password	Encrypted user password
TrueSight_database_confirm_password	Re-enter the encrypted user password
TrueSight_database_port	Number of the database port
TrueSight_sso_hostname	Host's Fully Qualified Domain Name (FQDN) for the BMC Atrium Single Sign-On (SSO) server
TrueSight_sso_port	Number of the BMC Atrium Single Sign-On port. Use the port number of the Atrium Single Sign-On server installed on the system. The default port number is 8443.
TrueSight_sso_password	BMC Atrium Single Sign-On server encrypted super user password. The Single Sign-On super user name is amadmin.

Save and close the server-silent-options.txt file.

Example

The following example illustrates the settings of a silent installation configuration for the Presentation Server on a Windows operating system.

-P installLocation="C:\Program Files\BMC Software\TrueSightPServer"
-A featureTrueSightPServer
-J TrueSight_localhost_fqdn=system
-J TrueSight_high_availability_enabled=0
-J TrueSight_high_availability_type=1
-J TrueSight_high_availability_server_pair_name=truesight
-J TrueSight_high_availability_primary_cache_port=7800
-J TrueSight_high_availability_primary_control_port=8800
-J TrueSight_high_availability_secondary_server_fqdn=
-J TrueSight_high_availability_secondary_database_port=5432
-J TrueSight_high_availability_secondary_cache_replication_port=7800
-J TrueSight_high_availability_secondary_control_port=8800
-J TrueSight_high_availability_configuration_file=Config_File.txt
-J TrueSight_tomcat_http_port=80
-J TrueSight_tomcat_https_port=443
-J TrueSight_ElasticSearch_rest_port=9200
-J TrueSight_ElasticSearch_client_port=9300
-J TrueSight_cell_gateway_port=1900
-J TrueSight_database_username=admin
-J TrueSight_database_password=DES\:097133405e7ea7a6bcc58bbe70ece4c2
-J TrueSight_database_confirm_password=DES\:097133405e7ea7a6bcc58bbe70ece4c2
-J TrueSight_database_port=5432
-J TrueSight_sso_hostname=11.22.33.22
-J TrueSight_sso_port=8443
-J TrueSight_sso_password=DES\:097133405e7ea7a6bcc58bbe70ece4c2

To install the Presentation Server silently

In a command line, navigate to the Disk1 folder in the installation file structure.

Enter the following command:

Windows

setup.exe -i silent -DOPTIONS_FILE=<Full File Path>\server-silent-options-windows.txt

Linux

./setup.bin -i silent -DOPTIONS_FILE=<Full File Path>/server-silent-options-linux.txt

Notes

If the installation fails, you must uninstall what has been installed before rerunning the installation. For more information about the uninstall process, see Performing the Presentation Server uninstallation

The Presentation Server installation log files are located in the following directories:
- (Windows) C:\Users\<user>\AppData\Local\Temp\truesightpserver_install_log.txt
- (Linux) /tmp/truesightpserver_install_log.txt

Encrypting a password for silent Presentation Server installation

The Maintenance Tool enables you to create an encrypted password that the Presentation Server requires for importing a KeyStore. You must use an encrypted password so that the KeyStore password is not exposed in the server-silent-options.txt file.

You can run the Maintenance Tool in a GUI or from the command line interface (CLI).

To encrypt a password by using the Maintenance Tool in a GUI (click here to expand steps)

To open the Maintenance Tool, go to the temporaryDirectory/Disk1/utility directory.
The temporaryDirectory is the place where you downloaded the installation files.
Run the TrueSightPServerMaintenanceTool utility and click the Encrypt tab.
Enter your password in the Password and Confirm Password fields and click Encrypt.
Copy and paste the value from the Encrypted Password field to the server-silent-options.txt file for the TrueSight_database_password parameter.
For example, if the encrypted password output is DES\:d70cbe3669602717ce66af37cce7ecf0, modify the TrueSight_database_password parameter as follows:
-J TrueSight_database_password=DES\:d70cbe3669602717ce66af37cce7ecf0

To encrypt a password by using the Maintenance Tool in the CLI (click here to expand steps)

To open the Maintenance Tool, go to the temporaryDirectory\Disk1\utility directory.
The temporaryDirectory is the place to which you downloaded the installation files.
Run the following command, entering your password for the -password and -confirm_password options:
- Windows
  TrueSightPServerMaintenanceTool.cmd -silent -encrypt -encrypt -password=<password> -confirm_password=<password>
- Linux
  ./TrueSightPServerMaintenanceTool.sh -silent -encrypt -encrypt -password=<password> -confirm_password=<password>
  Note
  
  For Linux installations, any password that includes special characters requires single quotation marks before and after the password. For example:
  ./TrueSightPServerMaintenanceTool.sh -silent -encrypt -encrypt -password='<password>' -confirm_password='<password>'
Copy and paste the encrypted password output to the server-silent-options.txt file for your silent installation.
For example, if the encrypted password output is DES\:d70cbe3669602717ce66af37cce7ecf0, modify the TrueSight_database_password parameter as follows:
-J TrueSight_database_password= DES\:d70cbe3669602717ce66af37cce7ecf0

Postinstallation tasks

Perform the following tasks after installing the Presentation Server:

For Linux systems, register the Presentation Server service for non-root users:
1. Log in as a root user on the computer on which the Presentation Server is installed
2. Open a CLI command prompt, navigate to the <installedDirectory>/truesightpserver/bin directory, run the following command to register the service:
  
  ./tssh service register <nonroot user name>
3. Check whether the service is registered by running the following command:
  service BMCTSPSSvc status
  The Core Server, Index Server, and Database Server processes should be listed as running.
If you want to install the Integration Service and administrator console software using Central Monitoring Administration, after downloading the Infrastructure Management installer files from EPD , manually copy the TSIMAdmin and the TSIMAgent folders from the installationDirectory\os directory in Infrastructure Management to the installationDirectory\BMCSoftware\truesightpserver\modules\cma\download\<os_agent> directory in Operations Management. Otherwise, the installation files will not be visible in Central Monitoring Administration.

After you install the basic components of the Operations Management system, you must identify data providers as components in the Presentation Server. This connection enables the Presentation Server to receive data from its component parts. You can connect components as you add them, or when you finish adding all components.
Role-based user access to the features and components that compose BMC TrueSight Operations Management is enabled by persona-based authorization profiles. Each authorization profile is associated with one or more BMC Atrium Single Sign-On (SSO) Server realms and comprises user groups, roles and permissions, and objects. These authorization profiles determine the features and objects that users can access and monitor. You can use the default authorization profiles as is, or you can modify their attributes. If necessary, you can also create authorization profiles.

Page tree

Before you begin

To configure the silent install file

To install the Presentation Server silently

Encrypting a password for silent Presentation Server installation

Postinstallation tasks

Related topic

2 Comments

Leo Osborn

Manisha Moon