Performing the Presentation Server installation silently

In a silent installation, you run the installation program from a command line, enabling you to install the product in situations where the operating system of the target computer does not support a graphical user interface (UI). Choose the silent installation method if you want to:

  • Run the product installer in the background instead of running it interactively.
  • Install on a remote computer that cannot display a graphical UI.
  • Maintain consistent installation configuration values across multiple computers.

You launch installation program from the command line and specify a preconfigured install configuration template file (config file) that contains details for all the parameters required to install the product. You can create a single config file and use it for multiple installations.

Use the values that you collected in your installation worksheets to update the configuration file.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.

For more information, see the following sections:

Related topics

System requirements

Installation worksheet for TrueSight Presentation Server

Preparing for the Presentation Server installation

Downloading the installation files

Installing the Presentation Server

Troubleshooting the silent installation of Presentation Server

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:

  1. Use a text editor to open the relevant (Windows) server-silent-options-windows.txt or (Linux) server-silent-options-linux.txt file.

  2. 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
  3. Under the Installation Features section is the Presentation Server component name.

    # Install TrueSight Presentation Server
    -A featureTrueSightPServer
  4. 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

    Parameter

    Description

    QUICK_INSTALL_MODEInstallation type setting, either Custom install or Advanced install. The default value is Advanced install.

    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 disabled.

    TrueSight_high_availability_type

    High availability 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_portNumber 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_portNumber 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_portElasticsearch client port number
    TrueSight_cell_gateway_portCell 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_usernameUser name for the PostgreSQL database
    TrueSight_database_passwordEncrypted user password
    TrueSight_database_confirm_passwordRe-enter the encrypted user password
    TrueSight_database_portNumber of the database port 
    TrueSight_sso_hostnameHost's Fully Qualified Domain Name (FQDN) for the Remedy Single Sign-On server
    TrueSight_sso_portNumber of the Remedy Single Sign-On port. Use the port number of the Remedy Single Sign-On server installed on the system. The default port number is 448.
    TrueSight_sso_protocolHTTPS or HTTP. By default, the HTTPS option is set. The Remedy SSO is installed by default in HTTPS mode.
    TrueSight_sso_passwordBMC Remedy Single Sign-On server encrypted super user password. The Single Sign-On super user name is Admin.
    IS_SSO_SERVER_CERTIFICATE
    Remedy Single Sign-On server high availability (HA) option. The default value (false) means that the Single Sign-On server is not in the high availability mode.
    SSO_CERTIFICATE_HOME
    Path of the Remedy Single Sign-On SSL certificate.
  5. 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

  1. In a command line, navigate to the Disk1 folder in the installation file structure.
  2. 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:
    • (WindowsC:\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)
  1. To open the Maintenance Tool, go to the temporaryDirectory/Disk1/utility directory.
    The temporaryDirectory is the place where you downloaded the installation files.
  2. Run the TrueSightPServerMaintenanceTool utility and click the Encrypt tab.
  3. Enter your password in the Password and Confirm Password fields and click Encrypt.
  4. 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)
  1. To open the Maintenance Tool, go to the temporaryDirectory\Disk1\utility directory.
    The temporaryDirectory is the place to which you downloaded the installation files.
  2. 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>'

  3. 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

Where to go from here

Verifying the Presentation Server installation and operation 


Was this page helpful? Yes No Submitting... Thank you

Comments