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 for Presentation Server.
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 for the Presentation Server. The default values used during the installation process are entered in the installation worksheet.
Prepare an encrypted password for the database and Remedy 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 (Windows) server-silent-options-windows.txt or (Linux) server-silent-options-linux.txt file.
Under the TrueSight Presentation Server Installation Location section, retain a default installation directory or specify a valid 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 QUICK_INSTALL_MODE=true
-J ASSO_SERVER_MODE=false
-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=448
-J TrueSight_sso_password=
-J TrueSight_sso_protocol=https
-J IS_SSO_SERVER_CERTIFICATE=false
-J SSO_CERTIFICATE_HOME=
Presentation Server configuration descriptions
Save and close the server-silent-options-windows.txt or server-silent-options-linux.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 QUICK_INSTALL_MODE=true
-J ASSO_SERVER_MODE=false
-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=rsso.bmc.com
-J TrueSight_sso_port=448
-J TrueSight_sso_protocol=https
-J TrueSight_sso_password=DES\:097133405e7ea7a6bcc58bbe70ece4c2
-J IS_SSO_SERVER_CERTIFICATE=true
-J SSO_CERTIFICATE_HOME=\home\bmc\cert.crt

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="<fullyqualifiedpath>\server-silent-options-windows.txt"
  where fullyQualifiedPath indicates the complete path where you have saved the server_install.options file. If the fullyQualifiedPath parameter contains a space in it, the path must be enclosed within double quotes.
- (Linux)
  ./setup.bin -i silent -DOPTIONS_FILE="<fullyqualifiedpath>/server-silent-options-linux.txt"
  where fullyQualifiedPath indicates the complete path where you have saved the server_install.options file. If the fullyQualifiedPath parameter contains a space in it, the path must be enclosed within double quotes.

Notes

If the installation fails, you must uninstall what has been installed before rerunning the installation.

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 Presentation Server silent 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-windows.txt or server-silent-options-linux.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:
  ./{{code language="none"}}
  TrueSightPServerMaintenanceTool
  {{/code}}.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

Post-installation tasks

Perform the following tasks after installing the TrueSight Presentation Server:

After installing the component products, you must identify data providers as components in the TrueSight Presentation Server. This connection enables the TrueSight Presentation Server to receive data from its component parts. You can connect components as you add them, or when you finish adding all components.
(Linux) Register the TrueSight Presentation Server service for non-root users:
1. Log in as a root user on the computer on which the TrueSight Presentation Server is installed.
2. From the <installedDirectory>/truesightpserver/bin directory, run the following command to register the service:
  ./tssh service register <nonrootUserName>
3. (SUSE Linux Enterprise Server only) In addition, run the following command:
  chkconfig --add BMCTSPSSvc
  The BMCTSPSSvc service is located at /etc/init.d
4. Ensure that you have read and write permissions for the installedDirectory\truesightpserver\logs\tssh.log file before you run the following commands.
5. Check whether the service is registered by running the following command:
  service BMCTSPSSvc status
6. To start and stop the service, run the following commands:
  service BMCTSPSSvc start
  service BMCTSPSSvc stop
(Optional) On a multi-tenant TrueSight Presentation Server environment, you must enable the msp-deployment parameter. To enable, do the following:
1. Navigate to the folder based on the operating system on which you installed the TrueSight Presentation Server:
  - (Windows) <Install_Directory>\truesightpserver\modules\tomcat\webapps\ROOT\WEB-INF\classes
  - (Linux) <Install_Directory>/truesightpserver/modules/tomcat/webapps/ROOT/WEB-INF/classes
2. Open the rsso-agent.properties file.
3. Uncomment the msp-deployment=true parameter and save.
4. Navigate to the folder.
  - (Windows) <install_Directory>\truesightpserver\bin
  - (Linux) <install_Directory>/truesightpserver/bin
5. Run the following commands to restart the TrueSight Presentation Server:tssh server stop
  tssh server start
Notes
- The msp-deployment=true parameter is commented by default after installing or upgrading a single tenant TrueSight Presentation Server.
- The msp-deployment=true parameter is enabled by default after upgrading an existing multi-tenant TrueSight Presentation Server.
- The msp-deployment=true parameter must be uncommented (enabled) after installing a multi-tenant TrueSight Presentation Server.
Role-based user access to the features and components that compose TrueSight Operations Management is enabled by persona-based authorization profiles. Each authorization profile is associated with one or more Remedy Single Sign-On 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.

If you have installed the TrueSight Presentation Server in the high-availability mode, you can configure aliases and hosts to access the TrueSight Presentation Server. For more information, see Configuring-the-Presentation-Server-for-high-availability.

Troubleshooting the silent installation

If a problem occurs during the silent installation, see the following topic: Error-message-displayed-during-silent-installation-of-Presentation-Server

Where to go from here

Verify the Presentation Server installation and operation