×
 
 
  •  
$helper.renderConfluenceMacro('{bmc-global-announcement:$space.key}')
BMC TrueSight Capacity Optimization 20.02 Installing

Installing the Presentation Server in the high-availability mode silently

Where you are in the Installation process

StepTask
1Complete the planning activities
2Preparing for TrueSight Capacity Optimization installation
3Install Remedy Single Sign-On
4Install TrueSight Presentation Server - Phase A (You are here)
Configure TrueSight Presentation Server for disaster recovery — Phase B 
5Install TrueSight Capacity Optimization Application Server and ETL Engine
6Install TrueSight Capacity Optimization Gateway Server
7Install TrueSight Capacity Optimization Capacity Agent
8Complete the post-installation activities

To install the Presentation Server in the high-availability mode using the silent installer

You need to perform the following tasks to install Presentation Server in a high-availability environment.

Step A: Install Presentation Server  on the primary computer

Do the following:

  1. Log in to the host computer (as a root user if you are using Linux) on which you want to install Presentation Server, and delete all the files from the temporary directory:

    • (Windows) %temp%

    • (Linux) /tmp

  2. Extract the downloaded files to a temporary location outside the following location to avoid any file sharing conflicts:

    • (Windows) C:\Program Files

    • (Linux) /opt

  3. You will need to type the database administrator password and the Remedy Single Sign-On password in an encrypted form in the server-silent-options-<operatingSystem>.txt in Step 5. You can encrypt these passwords using the TrueSightPServerMaintenanceTool through the wizard or command line interface:

    1. Open the TrueSightPServerMaintenanceTool by navigating to:
      • (Windows) <DownloadLocation>\Windows\Disk1\Utility
      • (Linux) <DownloadLocation>/Linux/Disk1/Utility
    2. Run the tool, and click the Encrypt tab.
    3. Type the password, confirm it, and click Encrypt.
    4. Note down the encrypted password. (Example: DES\:097133405e7ea7a6bcc58bbe70ece4c2)
    1. Navigate to the following directory:
      • (Windows) <DownloadLocation>\Windows\Disk1\Utility
      • (Linux) <DownloadLocation>/Linux/Disk1/Utility

    2. Run the following command:

      • (Windows)

        TrueSightPServerMaintenanceTool.cmd -silent -encrypt -encrypt -password=<password> -confirm_password=<password>

      • (Linux)

        ./TrueSightPServerMaintenanceTool.sh -silent -encrypt -encrypt -password=<password> -confirm_password=<password>

        Note

        (Linux) If the password contains special characters, enclose the password using single quotes as shown in the following example:

        ./TrueSightPServerMaintenanceTool.sh -silent -encrypt -encrypt -password='<password>' -confirm_password='<password>'

    3. Note down the encrypted password. (Example: DES\:097133405e7ea7a6bcc58bbe70ece4c2)

  4. Go to the extracted folder, and locate the server-silent-options-<operatingSystem>.txt file:

    • (Windows) <DownloadLocation>\Windows\Disk1\

    • (Linux) <DownloadLocation>/Linux/Disk1/

  5. Edit the the silent options file, add or modify property values, and save the file. 
    The silent options file is a text file that defines the installation properties in the form of a prefix tag followed by a property name and value pair.
     Some property values such as the host computer FQDN, the encrypted passwords, the database details, Remedy Single Sign-On server details and the high availability settings need to be specified in the silent options file. All other properties come with default values, which can be retained or changed as desired. 

    Prefix tags for silent installation properties:

    • -P: Precedes directory properties

    • -A: Precedes application features

    • -J: Precedes Java properties

    Property nameDescription
    Installation location
    -P installLocation


    You can retain the following default installation directory path or type a new path:

    • (Windows) C:\Program Files\BMC Software\TrueSightPServer
    • (Linux) /opt/bmc/TrueSightPServer

    Examples: 

    • (Windows) -P installLocation=C:\Program Files\BMC Software\TrueSightPServer
    • (Linux) -P installLocation=/opt/bmc/TrueSightPServer
    Installation features
    -A <feature name>

    Retain the default feature value. 

    Default value: featureTrueSightPServer

    Example:-A featureTrueSightRSSO

    TrueSight Presentation Server installer configuration
    -J QUICK_INSTALL_MODE

    Type false to choose Custom installation.

    Default value: true

    Example: -J QUICK_INSTALL_MODE=false

    -J ASSO_SERVER_MODE

    This is an internal property. BMC recommends not to delete this property and not to change the value.

    Default value: false

    Example: -J ASSO_SERVER_MODE=false

    -J TrueSight_localhost_fqdn

    Type the FQDN of the host computer on which you plan to install the Presentation Server. Ensure that the FQDN is accessible by the other TrueSight components in your environment.

    Example: -J TrueSight_localhost_fqdn=host1.bmc.com

    High-availability settings

    If you plan to change the default high availability port numbers, use port numbers between 1024 and 65535 only.

    -J TrueSight_high_availability_enabled

    Type 1. The value 1 indicates that the high-availability mode is enabled.

    Default value: 0

    Example: -J TrueSight_high_availability_enabled=1

    -J TrueSight_high_availability_type

    Retain the default value. The default value indicates that the primary server mode is enabled.

    Default value: 1

    Example: -J TrueSight_high_availability_type=1

    -J TrueSight_high_availability_server_pair_name

    Elasticsearch cluster name for a single node (server) or multiple nodes that hold all the data and provide federated indexing and search capabilities across all nodes.

    BMC recommends that you change this name to reflect the logical group name of the cluster. 

    Default value: truesight

    Example: -J TrueSight_high_availability_server_pair_name=truesight

    -J TrueSight_high_availability_primary_cache_port

    Port number of the Primary Cache Replication port.

    Retain the default or type a new value.

    Default value: 7800

    Example: -J TrueSight_high_availability_primary_cache_port=7800

    -J TrueSight_high_availability_primary_control_port

    Retain the default or type a new value.

    Default value: 8800

    Example: -J TrueSight_high_availability_primary_control_port=8800

    -J TrueSight_high_availability_secondary_server_fqdn

    Type the FQDN of the secondary (standby) server host name.

    Example: -J TrueSight_high_availability_secondary_server_fqdn=SHost.bmc.com

    -J TrueSight_high_availability_secondary_database_port

    Retain the default or type a new value.

    Default value: 5432

    Example: -J TrueSight_high_availability_secondary_database_port=5432

    -J TrueSight_high_availability_secondary
    _cache_replication_port

    Retain the default or type a new value.

    Default value: 7800

    Example: -J TrueSight_high_availability_secondary_cache_replication_port=7800

    -J TrueSight_high_availability_secondary_control_port

    Retain the default or type a new value.

    Default value: 8800

    Example: -J TrueSight_high_availability_secondary_control_port=8800

    -J TrueSight_high_availability_configuration_file

    Leave this value blank.

    This property is only applicable if you are installing Presentation Server on the secondary computer.

    Tomcat configuration details
    -J TrueSight_tomcat_http_port

    Retain the default or type a new value.

    Default value:

    • (Windows) 80
    • (Linux) 8080

    If you want to change the default port number, use port numbers only between:

    • (Windows) 1 and 65535.
    • (Linux) 1024 and 65535.

    Example:

    -J TrueSight_tomcat_http_port=80

    -J TrueSight_tomcat_https_port

    Retain the default or type a new value.

    Default value:

    • (Windows) 443
    • (Linux) 8043

    If you want to change the default port number, use port numbers only between:

    • (Windows) 1 and 65535.
    • (Linux) 1024 and 65535.

    Example:

    -J TrueSight_tomcat_https_port=443

    Elastic search and cell gateway port details
    -J TrueSight_ElasticSearch_rest_port

    Retain the default or type a new value.

    Default value: 9200

    If you want to change the default port number, use port numbers only between:

    • (Windows) 1 and 65535.
    • (Linux) 1024 and 65535.

    Example:

    -J TrueSight_ElasticSearch_rest_port=9200

    -J TrueSight_ElasticSearch_client_port

    Retain the default or type a new value.

    Default value: 9300

    If you want to change the default port number, use port numbers only between:

    • (Windows) 1 and 65535.
    • (Linux) 1024 and 65535.

    Example:

    -J TrueSight_ElasticSearch_client_port=9300

    -J TrueSight_cell_gateway_port

    Retain the default or type a new value.

    Default value: 1900

    If you want to change the default port number, use port numbers only between:

    • (Windows) 1 and 65535.
    • (Linux) 1024 and 65535.

    Example:

    -J TrueSight_cell_gateway_port=1900

    Presentation Server database settings
    -J TrueSight_database_username

    Type the PostgreSQL database user name.

    Example: -J TrueSight_database_username=tspsdb

    -J TrueSight_database_password

    Type the encrypted password value. To encrypt a password, refer Step 3.

    Example: -J TrueSight_database_password=
    DES\:e10f44c4d48825709b66f6bbcc800cc8474ca904178b3796

    -J TrueSight_database_confirm_password

    Re-type the encrypted password value that is set for the TrueSight_database_password property.

    Example:

    -J TrueSight_database_confirm_password=
    DES\:e10f44c4d48825709b66f6bbcc800cc8474ca904178b3796

    -J TrueSight_database_port

    Type the PostgreSQL database port number.

    Default value: 5432

    If you want to change the default port number, use port numbers only between:

    • (Windows) 1 and 65535
    • (Linux) 1024 and 65535

    Example: -J TrueSight_database_port=5432

    Remedy SSO configuration details
    -J TrueSight_sso_hostname

    Type the FQDN of Remedy SSO.

    Example: -J TrueSight_sso_hostname=host3.bmc.com

    -J TrueSight_sso_port

    Type the Remedy SSO server port number.

    Default value:

    (Windows) 448

    (Linux) 8048

    Example:

    -J TrueSight_sso_port=448

    -J TrueSight_sso_password

    Type the Remedy SSO server superuser password in an encrypted format. The Remedy SSO superuser name is Admin. To encrypt a password, refer Step 3.

    Example:

    -J TrueSight_sso_password=
    DES\:097133405e7ea7a641f019bca8781280e74e86a9fec4ad58

    -J TrueSight_sso_protocol

    Type the protocol in which Remedy SSO is configured.

    By default, Remedy SSO is configured in the HTTPS mode.

    Example:

    -J TrueSight_sso_protocol=https

    -J IS_SSO_SERVER_CERTIFICATE

    Type one of the following values:

    • false: Indicates that you can import the Remedy SSO certificate after the installation is completed.
      For details, see Applying Remedy Single Sign-On Server private certificate to the TrueSight Presentation Server. Open link
    • true: Indicates that you need to import the Remedy SSO private certificate during the TrueSight Presentation Server installation.
      You need to specify this value if the Remedy SSO server has a custom certificate.

    Default value: false

    Example: -J IS_SSO_SERVER_CERTIFICATE=false

    -J SSO_CERTIFICATE_HOME

    If you have set the IS_SSO_SERVER_CERTIFICATE property to true, type the complete path of the Remedy SSO certificate as the value of this property.

    Examples:

    • -J SSO_CERTIFICATE_HOME=<RSSO install directory>\rssocert.crt
    • -J SSO_CERTIFICATE_HOME=<RSSO install directory>\rssocert.cer

    -J BMC_TS_KEY_SZ

    By default, the TrueSight Presentation Server uses 256-bit encryption. However, AES 256-bit encryption is not allowed in some countries due to import regulations. You can select an appropriate encryption key size as per your requirement.

    Default value: 256

    Example: -J BMC_TS_KEY_SZ=128

    Note: By default, the TrueSight Presentation Server uses 256-bit encryption. However, AES 256-bit encryption is not allowed in some countries due to import regulations. You can change the default encryption key size when you invoke the installer.

  6. From the command prompt, run the following command to start the installation. Type the complete path to the server-silent-options-windows.txt  file in the command. If the path includes a blank space, enclose the path within double quotes.

    If you plan to use Presentation Server with the TrueSight Capacity Optimization component only:

    Environment type

    Command

    With the default encryption setting
    • (Windows) setup.exe -J MINIMAL=true -i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
    • (Linux - as a non-root user)./setup.bin -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt
      Ensure that you start a new session as a non-root user to run the installation. Do not use the su command to start a non-root session.

    Example

    • (Windows) setup.exe -J MINIMAL=true -i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
    • (Linux - as a non-root user)./setup.bin -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt
    With user-specified encryption setting
    • (Windows) setup.exe –J BMC_TS_KEY_SZ=<128/256> -J MINIMAL=true -i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
    • (Linux - as a non-root user)./setup.bin -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt
      Ensure that you start a new session as a non-root user to run the installation. Do not use the su command to start a non-root session.

    Example

    • (Windows) setup.exe –J BMC_TS_KEY_SZ=<128/256> -J MINIMAL=true -i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
    • (Linux - as a non-root user)./setup.bin -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt

    The parameter  -J MINIMAL=true  ensures that the Presentation Server installer skips the step of validating the minimum system requirements, which includes the check for 32 GB of RAM. When Presentation Server is used with TrueSight Capacity Optimization only, the minimum RAM or memory requirement is 8 GB. 
    For more information, see System requirements for the Presentation Server.

    If TrueSight Presentation Server is shared with TrueSight Operations Management, then ensure that the system requirements are met and do not specify the -J MINIMAL parameter in the command. Run the following command:

    Environment type

    Command

    With the default encryption setting
    • (Windows) setup.exe -i silent -DOPTIONS_FILE="<path_to_server-silent-options-windows.txt_file>"
    • (Linux)./setup.bin -i silent -DOPTIONS_FILE="<path_to_server-silent-options-linux.txt_file>"

    Example

    • (Windows - With space in the path) setup.exe -i silent -DOPTIONS_FILE="C:\temp folder\Disk1\server-silent-options-windows.txt"
    • (Linux- With space in the path)./setup.bin -i silent -DOPTIONS_FILE="/opt/temp folder/Disk1/server-silent-options-linux.txt"
    With user-specified encryption setting
      • (Windows) setup.exe –J BMC_TS_KEY_SZ=<128/256> -i silent -DOPTIONS_FILE="<path_to_server-silent-options-windows.txt_file>"
      • (Linux)./setup.bin –J BMC_TS_KEY_SZ=<128/256> -i silent -DOPTIONS_FILE="<path_to_server-silent-options-linux.txt_file>"

    Example

      • (Windows - With space in the path) setup.exe -i silent -DOPTIONS_FILE="C:\temp folder\Disk1\server-silent-options-windows.txt"
      • (Linux- With space in the path)./setup.bin -i silent -DOPTIONS_FILE="/opt/temp folder/Disk1/server-silent-options-linux.txt"

  7. The installation might take up to 15 minutes. After the installation is complete, the Installation Summary page is displayed. You can periodically check the installation status by checking the truesightpserver_install_log.txt file located at: 

    • (Windows) %temp%

    • (Linux)  /tmp

  8. Locate the following log message in the truesightpserver_install_log.txt file to ensure that the Presentation Server is installed successfully:

    Log message: TrueSight Presentation Server 11.3.01 install succeeded.

  9. Verify that the following environment variable points to the Presentation Server installation path: 

    • (Windows) %TRUESIGHTPSERVER_HOME%

    • (Linux) $TRUESIGHTPSERVER_HOME

  10. Run the following command to verify the TrueSight Presentation Server status:

    • (Windows) Navigate to the TrueSightPServer\truesightpserver\bin directory, and run tssh server status command.
    • (Linux) Navigate to the TrueSightPServer/truesightpserver/bin directory, and run ./tssh server status command.

    A list of Presentation Server processes are displayed as shown in the following example:

    Process status
    ================================
    Core Server     Running (13176)
    Index Server    Running (11028)
    Database Server Running (6052)

    If errors occur when you run tssh server status command, restart the Presentation Server by running the following command:

    • (Windows) tssh server start

    • (Linux) ./tssh server start

  11. (Linux only) Register the BMCTSPSSvc service by performing the following steps:

    1. As a root user, run the tssh service register <Non-RootUserName>. This command registers the BMCTSPSSvc service under the /etc/init.d folder.
    2. (SUSE Linux Enterprise Server only) Run the chkconfig --add BMCTSPSSvc command.

    If you restart the TrueSight Presentation Server  host without registering the BMCTSPSSvc service, the processes will not come up, and you will need to start the TrueSight Presentation Server manually.

    Verify whether the service is registered with the following steps:

    1. Ensure that you have read and write permissions for the installedDirectory\truesightpserver\logs\tssh.log file.
    2. Run the service BMCTSPSSvc status command.

    To start and stop the service, run the following commands:

    • service BMCTSPSSvc start
    • service BMCTSPSSvc stop  

  12. In an IPv6 environment, comment the following properties and restart the TrueSight Presentation Server:

    • #vm.args.system.26 in the installedDirectory\truesightpserver\conf\custom\csr.conf and installedDirectory\truesightpserver\conf\services\csr.conf files
    • #vm.args.system.18 in the  installedDirectory\truesightpserver\conf\custom\idxsrv.conf and installedDirectory\truesightpserver\conf\services\idxsrv.conf files

  13. (Applicable only if you plan to connect to the TrueSight Presentation Server with an alias name) The TrueSight Presentation Server validates all incoming requests to prevent Cross-Site Forgery (CSRF) attacks. If you plan to connect to the TrueSight Presentation Server with an alias or a proxy name, you must configure all hosts, aliases, or proxies for CSRF validation. Unless you do this, you cannot access TrueSight Presentation Server even if the installation completed successfully.

    Run the following commands to enable the CSRF filter for the alias names set:

    1. Navigate to the following location:
      • (Windows) TrueSightPServer\truesightpserver\bin
      • (Linux)TrueSightPServer/truesightpserver/bin

    2. Run the tssh properties set tspsProxyHosts <alias1>,<alias2>,<alias3> command.

      Example

      If you have set a single alias name for the TrueSight Presentation Server host:

      tssh properties set tspsProxyHosts HostHouston

      If you have set multiple alias names for the TrueSight Presentation Server host:

      tssh properties set tspsProxyHosts HostHouston,HostLondon,HostPune

    3. Run the tssh properties reload command.

    Note

    If implementing the CSRF validation degrades the performance of the UI, you can disable the CSRF filter. However, BMC strongly discourages this action.

    Run the following commands:

    1. Navigate to the following location:

      • (Windows) TrueSightPServer\truesightpserver\bin
      • (Linux) TrueSightPServer/truesightpserver/bin
    2. Run the tssh properties set csrfFilter false command.
    3. Run the tssh properties reload command.
  14. Copy the ha-shared.conf  file from the  <PresentationServerInstallationDirectory>\truesightpserver\conf  directory to an appropriate location on the secondary server. You will need to specify the location of this file while installing TrueSight Presentation Server  on the secondary server.
  15. When you restart the TrueSight Presentation Server, the system requirements are validated. The restart process fails if the requirements are not met. When you use the Presentation Server only with the TrueSight Capacity Optimization component, you can skip this validation by performing the following steps. After you perform these steps, the Presentation Server service is automatically started even if you restart the TrueSight Presentation Server host.

    1. Navigate to the following location:

      • For Windows: <installationDirectory>\truesightpserver\conf\custom
      • For Linux: <installationDirectory>/truesightpserver/conf/custom

    2. Edit the csr.conf file, add the following property, and save the file.
      skipResourceCheck=true

    3. Restart the product service.

    Alternatively, run the following command to forcefully start the Presentation Server service: tssh server start force 

    However, this method does not guarantee the automatic restart of the Presentation Server service after restarting the Presentation Server host.

Step B: Install TrueSight Presentation Server on the secondary computer

  1. Ensure that the Presentation Server is up and running on the primary computer.

  2. Log in to the host computer (as a root user if you are using Linux) on which you want to install Presentation Server, and delete all the files from the temporary directory:

    • (Windows) %temp%

    • (Linux) /tmp

  3. Extract the downloaded files to a temporary location outside the following location to avoid any file sharing conflicts:

    • (Windows) C:\Program Files

    • (Linux) /opt

  4. You will need to type the database administrator password and the Remedy Single Sign-On password in an encrypted form in the server-silent-options-<operatingSystem>.txt in Step 5. You can encrypt these passwords using the TrueSightPServerMaintenanceTool through the wizard or command line interface:

    1. Open the TrueSightPServerMaintenanceTool by navigating to:
      • (Windows) <DownloadLocation>\Windows\Disk1\Utility
      • (Linux) <DownloadLocation>/Linux/Disk1/Utility
    2. Run the tool, and click the Encrypt tab.
    3. Type the password, confirm it, and click Encrypt.
    4. Note down the encrypted password. (Example: DES\:097133405e7ea7a6bcc58bbe70ece4c2)
    1. Navigate to the following directory:
      • (Windows) <DownloadLocation>\Windows\Disk1\Utility
      • (Linux) <DownloadLocation>/Linux/Disk1/Utility

    2. Run the following command:

      • (Windows)

        TrueSightPServerMaintenanceTool.cmd -silent -encrypt -encrypt -password=<password> -confirm_password=<password>

      • (Linux)

        ./TrueSightPServerMaintenanceTool.sh -silent -encrypt -encrypt -password=<password> -confirm_password=<password>

        Note

        (Linux) If the password contains special characters, enclose the password using single quotes as shown in the following example:

        ./TrueSightPServerMaintenanceTool.sh -silent -encrypt -encrypt -password='<password>' -confirm_password='<password>'

    3. Note down the encrypted password. (Example: DES\:097133405e7ea7a6bcc58bbe70ece4c2)

  5. Go to the extracted folder, and locate the server-silent-options-<operatingSystem>.txt file:

    • (Windows) <DownloadLocation>\Windows\Disk1\

    • (Linux) <DownloadLocation>/Linux/Disk1/

  6. Edit the the silent options file, add or modify property values, and save the file. 
    The silent options file is a text file that defines the installation properties in the form of a prefix tag followed by a property name and value pair.
     Some property values such as the host computer FQDN, the encrypted passwords, the database details, Remedy Single Sign-On server details and the high availability settings need to be specified in the silent options file. All other properties come with default values, which can be retained or changed as desired.  

    Prefix tags for silent installation properties:

    • -P: Precedes directory properties

    • -A: Precedes application features

    • -J: Precedes Java properties

    Property nameDescription
    Installation location
    -P installLocation

    You can retain the following default installation directory path or type a new path:

    • (Windows) C:\Program Files\BMC Software\TrueSightPServer
    • (Linux) /opt/bmc/TrueSightPServer

    Examples: 

    • (Windows) -P installLocation=C:\Program Files\BMC Software\TrueSightPServer
    • (Linux) -P installLocation=/opt/bmc/TrueSightPServer

    Installation features
    -A <feature name>

    Retain the default feature value. 

    Default value: featureTrueSightPServer

    Example:-A featureTrueSightRSSO

    TrueSight Presentation Server installer configuration
    -J QUICK_INSTALL_MODE

    Type false to choose Custom installation.

    Default value: true

    Example: -J QUICK_INSTALL_MODE=false

    -J ASSO_SERVER_MODE

    This is an internal property. BMC recommends not to delete this property and not to change the value.

    Default value: false

    Example: -J ASSO_SERVER_MODE=false

    -J TrueSight_localhost_fqdn

    Type the FQDN of the host computer on which you plan to install the Presentation Server. Ensure that the FQDN is accessible by the other TrueSight components in your environment.

    Example: -J TrueSight_localhost_fqdn=host1.bmc.com

    High-availability settings

    If you plan to change the default high availability port numbers, use port numbers between 1024 and 65535 only.

    -J TrueSight_high_availability_enabled

    Type 1. The value 1 indicates that the high-availability mode is enabled.

    Default value: 0

    Example: -J TrueSight_high_availability_enabled=1

    -J TrueSight_high_availability_type

    Type 2. The value 2 indicates that the secondary server mode is enabled.

    Default value: 1

    Example: -J TrueSight_high_availability_type=2

    -J TrueSight_high_availability_server_pair_name

    Elasticsearch cluster name for a single node (server) or multiple nodes that hold all the data and provide federated indexing and search capabilities across all nodes.

    BMC recommends that you change this name to reflect the logical group name of the cluster. 

    Default value: truesight

    Example: -J TrueSight_high_availability_server_pair_name=truesight

    -J TrueSight_high_availability_primary_cache_port

    Port number of the Primary Cache Replication port.

    Retain the default or type a new value.

    Default value: 7800

    Example: -J TrueSight_high_availability_primary_cache_port=7800

    -J TrueSight_high_availability_primary_control_port

    Retain the default or type a new value.

    Default value: 8800

    Example: -J TrueSight_high_availability_primary_control_port=8800

    -J TrueSight_high_availability_secondary_server_fqdn

    Leave this value blank.

    Specifying this value is required only if you are installing Presentation Server on the primary computer.

    -J TrueSight_high_availability_secondary_database_port

    Retain the default or type a new value.

    Default value: 5432

    Example: -J TrueSight_high_availability_secondary_database_port=5432

    -J TrueSight_high_availability_secondary_cache_replication_port

    Retain the default or type a new value.

    Default value: 7800

    Example: -J TrueSight_high_availability_secondary_cache_replication_port=7800

    -J TrueSight_high_availability_secondary_control_port

    Retain the default or type a new value.

    Default value: 8800

    Example: -J TrueSight_high_availability_secondary_control_port=8800

    -J TrueSight_high_availability_configuration_file

    Specify the location of the ha-shared.conf  file that you copied from the primary server.

    Example: -J TrueSight_high_availability_configuration_file=C:\ConfFiles\ha-shared.conf

    Tomcat configuration details
    -J TrueSight_tomcat_http_port

    Retain the default or type a new value.

    Default value:

    • (Windows) 80
    • (Linux) 8080

    If you want to change the default port number, use port numbers only between:

    • (Windows) 1 and 65535.
    • (Linux) 1024 and 65535.

    Example:

    -J TrueSight_tomcat_http_port=80

    -J TrueSight_tomcat_https_port

    Retain the default or type a new value.

    Default value:

    • (Windows) 443
    • (Linux) 8043

    If you want to change the default port number, use port numbers only between:

    • (Windows) 1 and 65535.
    • (Linux) 1024 and 65535.

    Example:

    -J TrueSight_tomcat_https_port=443

    Elastic search and cell gateway port details
    -J TrueSight_ElasticSearch_rest_port

    Retain the default or type a new value.

    Default value: 9200

    If you want to change the default port number, use port numbers only between:

    • (Windows) 1 and 65535.
    • (Linux) 1024 and 65535.

    Example:

    -J TrueSight_ElasticSearch_rest_port=9200

    -J TrueSight_ElasticSearch_client_port

    Retain the default or type a new value.

    Default value: 9300

    If you want to change the default port number, use port numbers only between:

    • (Windows) 1 and 65535.
    • (Linux) 1024 and 65535.

    Example:

    -J TrueSight_ElasticSearch_client_port=9300

    -J TrueSight_cell_gateway_port

    Retain the default or type a new value.

    Default value: 1900

    If you want to change the default port number, use port numbers only between:

    • (Windows) 1 and 65535.
    • (Linux) 1024 and 65535.

    Example:

    -J TrueSight_cell_gateway_port=1900

    Presentation Server database settings
    -J TrueSight_database_username

    Type the PostgreSQL database user name.

    Example: -J TrueSight_database_username=tspsdb

    -J TrueSight_database_password

    Type the encrypted password value. To encrypt a password, refer Step 3.

    Example: -J TrueSight_database_password=
    DES\:e10f44c4d48825709b66f6bbcc800cc8474ca904178b3796

    -J TrueSight_database_confirm_password

    Re-type the encrypted password value that is set for the TrueSight_database_password property.

    Example:

    -J TrueSight_database_confirm_password=
    DES\:e10f44c4d48825709b66f6bbcc800cc8474ca904178b3796

    -J TrueSight_database_port

    Type the PostgreSQL database port number.

    Default value: 5432

    If you want to change the default port number, use port numbers only between:

    • (Windows) 1 and 65535
    • (Linux) 1024 and 65535

    Example: -J TrueSight_database_port=5432

    Remedy SSO configuration details
    -J TrueSight_sso_hostname

    Type the FQDN of Remedy SSO.

    Example: -J TrueSight_sso_hostname=host3.bmc.com

    -J TrueSight_sso_port

    Type the Remedy SSO server port number.

    Default value:

    (Windows) 448

    (Linux) 8048

    Example:

    -J TrueSight_sso_port=448

    -J TrueSight_sso_password

    Type the Remedy SSO server superuser password in an encrypted format. The Remedy SSO superuser name is Admin. To encrypt a password, refer Step 3.

    Example:

    -J TrueSight_sso_password=
    DES\:097133405e7ea7a641f019bca8781280e74e86a9fec4ad58

    -J TrueSight_sso_protocol

    Type the protocol in which Remedy SSO is configured.

    By default, Remedy SSO is configured in the HTTPS mode.

    Example:

    -J TrueSight_sso_protocol=https

    -J IS_SSO_SERVER_CERTIFICATE

    Type one of the following values:

    • false: Indicates that you can import the Remedy SSO certificate after the installation is completed.
      For details, see Applying Remedy Single Sign-On Server private certificate to the TrueSight Presentation Server. Open link
    • true: Indicates that you need to import the Remedy SSO private certificate during the TrueSight Presentation Server installation.
      You need to specify this value if the Remedy SSO server has a custom certificate.

    Default value: false

    Example: -J IS_SSO_SERVER_CERTIFICATE=false

    -J SSO_CERTIFICATE_HOME

    If you have set the IS_SSO_SERVER_CERTIFICATE property to true, type the complete path of the Remedy SSO certificate as the value of this property.

    Examples:

    • -J SSO_CERTIFICATE_HOME=<RSSO install directory>\rssocert.crt
    • -J SSO_CERTIFICATE_HOME=<RSSO install directory>\rssocert.cer

    -J BMC_TS_KEY_SZ

    By default, the TrueSight Presentation Server uses 256-bit encryption. However, AES 256-bit encryption is not allowed in some countries due to import regulations. You can select an appropriate encryption key size as per your requirement.

    Default value: 256

    Example: -J BMC_TS_KEY_SZ=128

    Note: By default, the TrueSight Presentation Server uses 256-bit encryption. However, AES 256-bit encryption is not allowed in some countries due to import regulations. You can change the default encryption key size when you invoke the installer.

  7. From the command prompt, run the following command to start the installation. Type the complete path to the server-silent-options-windows.txt  file in the command. If the path includes a blank space, enclose the path within double quotes.

    If you plan to use Presentation Server with the TrueSight Capacity Optimization component only:

    Environment type

    Command

    With the default encryption setting
    • (Windows) setup.exe -J MINIMAL=true -i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
    • (Linux - as a non-root user)./setup.bin -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt
      Ensure that you start a new session as a non-root user to run the installation. Do not use the su command to start a non-root session.

    Example

    • (Windows) setup.exe -J MINIMAL=true -i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
    • (Linux - as a non-root user)./setup.bin -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt
    With user-specified encryption setting
    • (Windows) setup.exe –J BMC_TS_KEY_SZ=<128/256> -J MINIMAL=true -i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
    • (Linux - as a non-root user)./setup.bin -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt
      Ensure that you start a new session as a non-root user to run the installation. Do not use the su command to start a non-root session.

    Example

    • (Windows) setup.exe –J BMC_TS_KEY_SZ=<128/256> -J MINIMAL=true -i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
    • (Linux - as a non-root user)./setup.bin -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt

    The parameter  -J MINIMAL=true  ensures that the Presentation Server installer skips the step of validating the minimum system requirements, which includes the check for 32 GB of RAM. When Presentation Server is used with TrueSight Capacity Optimization only, the minimum RAM or memory requirement is 8 GB. 
    For more information, see System requirements for the Presentation Server.

    If TrueSight Presentation Server is shared with TrueSight Operations Management, then ensure that the system requirements are met and do not specify the -J MINIMAL parameter in the command. Run the following command:

    Environment type

    Command

    With the default encryption setting
    • (Windows) setup.exe -i silent -DOPTIONS_FILE="<path_to_server-silent-options-windows.txt_file>"
    • (Linux)./setup.bin -i silent -DOPTIONS_FILE="<path_to_server-silent-options-linux.txt_file>"

    Example

    • (Windows - With space in the path) setup.exe -i silent -DOPTIONS_FILE="C:\temp folder\Disk1\server-silent-options-windows.txt"
    • (Linux- With space in the path)./setup.bin -i silent -DOPTIONS_FILE="/opt/temp folder/Disk1/server-silent-options-linux.txt"
    With user-specified encryption setting
      • (Windows) setup.exe –J BMC_TS_KEY_SZ=<128/256> -i silent -DOPTIONS_FILE="<path_to_server-silent-options-windows.txt_file>"
      • (Linux)./setup.bin –J BMC_TS_KEY_SZ=<128/256> -i silent -DOPTIONS_FILE="<path_to_server-silent-options-linux.txt_file>"

    Example

      • (Windows - With space in the path) setup.exe -i silent -DOPTIONS_FILE="C:\temp folder\Disk1\server-silent-options-windows.txt"
      • (Linux- With space in the path)./setup.bin -i silent -DOPTIONS_FILE="/opt/temp folder/Disk1/server-silent-options-linux.txt"

  8. The installation might take up to 15 minutes. After the installation is complete, the Installation Summary page is displayed. You can periodically check the installation status by checking the truesightpserver_install_log.txt file located at: 

    • (Windows) %temp%

    • (Linux)  /tmp

  9. Locate the following log message in the truesightpserver_install_log.txt file to ensure that the Presentation Server is installed successfully:

    Log message: TrueSight Presentation Server 11.3.01 install succeeded.

  10. Verify that the following environment variable points to the Presentation Server installation path: 

    • (Windows) %TRUESIGHTPSERVER_HOME%

    • (Linux) $TRUESIGHTPSERVER_HOME

  11. Run the following command to verify the TrueSight Presentation Server status:

    • (Windows) Navigate to the TrueSightPServer\truesightpserver\bin directory, and run tssh server status command.
    • (Linux) Navigate to the TrueSightPServer/truesightpserver/bin directory, and run ./tssh server status command.

    A list of Presentation Server processes are displayed as shown in the following example:

    Process status
    ================================
    Core Server     Running (13176)
    Index Server    Running (11028)
    Database Server Running (6052)

    If errors occur when you run tssh server status command, restart the Presentation Server by running the following command:

    • (Windows) tssh server start

    • (Linux) ./tssh server start

  12. (Linux only) Register the BMCTSPSSvc service by performing the following steps:

    1. As a root user, run the tssh service register <Non-RootUserName>. This command registers the BMCTSPSSvc service under the /etc/init.d folder.
    2. (SUSE Linux Enterprise Server only) Run the chkconfig --add BMCTSPSSvc command.

    If you restart the TrueSight Presentation Server  host without registering the BMCTSPSSvc service, the processes will not come up, and you will need to start the TrueSight Presentation Server manually.

    Verify whether the service is registered with the following steps:

    1. Ensure that you have read and write permissions for the installedDirectory\truesightpserver\logs\tssh.log file.
    2. Run the service BMCTSPSSvc status command.

    To start and stop the service, run the following commands:

    • service BMCTSPSSvc start
    • service BMCTSPSSvc stop  

  13. In an IPv6 environment, comment the following properties and restart the TrueSight Presentation Server:

    • #vm.args.system.26 in the installedDirectory\truesightpserver\conf\custom\csr.conf and installedDirectory\truesightpserver\conf\services\csr.conf files
    • #vm.args.system.18 in the  installedDirectory\truesightpserver\conf\custom\idxsrv.conf and installedDirectory\truesightpserver\conf\services\idxsrv.conf files

  14. (Applicable only if you plan to connect to the TrueSight Presentation Server with an alias name) The TrueSight Presentation Server validates all incoming requests to prevent Cross-Site Forgery (CSRF) attacks. If you plan to connect to the TrueSight Presentation Server with an alias or a proxy name, you must configure all hosts, aliases, or proxies for CSRF validation. Unless you do this, you cannot access TrueSight Presentation Server even if the installation completed successfully.

    Run the following commands to enable the CSRF filter for the alias names set:

    1. Navigate to the following location:
      • (Windows) TrueSightPServer\truesightpserver\bin
      • (Linux)TrueSightPServer/truesightpserver/bin

    2. Run the tssh properties set tspsProxyHosts <alias1>,<alias2>,<alias3> command.

      Example

      If you have set a single alias name for the TrueSight Presentation Server host:

      tssh properties set tspsProxyHosts HostHouston

      If you have set multiple alias names for the TrueSight Presentation Server host:

      tssh properties set tspsProxyHosts HostHouston,HostLondon,HostPune

    3. Run the tssh properties reload command.

    Note

    If implementing the CSRF validation degrades the performance of the UI, you can disable the CSRF filter. However, BMC strongly discourages this action.

    Run the following commands:

    1. Navigate to the following location:

      • (Windows) TrueSightPServer\truesightpserver\bin
      • (Linux) TrueSightPServer/truesightpserver/bin
    2. Run the tssh properties set csrfFilter false command.
    3. Run the tssh properties reload command.

  15. Verify the TrueSight Presentation Server HA installation by logging on to the primary and secondary computers. 
    The URL format is: http(s)://<TSPS_FQDN>:<tomcat_port>

    • On the primary computer: You must be able to view the application without any errors.
    • On the secondary computer: You must be able to see the following message:
      You accessed a system that is in standby mode. Contact you system administrator for assistance.
  16. When you restart the TrueSight Presentation Server, the system requirements are validated. The restart process fails if the requirements are not met. When you use the Presentation Server only with the TrueSight Capacity Optimization component, you can skip this validation by performing the following steps. After you perform these steps, the Presentation Server service is automatically started even if you restart the TrueSight Presentation Server host.

    1. Navigate to the following location:

      • For Windows: <installationDirectory>\truesightpserver\conf\custom
      • For Linux: <installationDirectory>/truesightpserver/conf/custom

    2. Edit the csr.conf file, add the following property, and save the file.
      skipResourceCheck=true

    3. Restart the product service.

    Alternatively, run the following command to forcefully start the Presentation Server service: tssh server start force 

    However, this method does not guarantee the automatic restart of the Presentation Server service after restarting the Presentation Server host.

Step C: Set up and configure the load balancer details

Set up the load balancer on a computer other than the primary and secondary computers.

Then, configure the load balancer name on the primary computer. 

To configure the load balancer name

  1. On the primary computer, navigate to the following location:
    • (Windows) TrueSightPServer\truesightpserver\bin
    • (Linux) TrueSightPServer/truesightpserver/bin
  2. Run the tssh properties set loadbalancername <loadbalancername> command.
  3. Run the tssh properties reload command.
  4. Run the following command to verify the high-availability deployment status:
    tssh ha status

Now that you have set up the Load Balancer, your TrueSight Presentation Server HA deployment is complete.

Next step in the Installation process

Now that you have successfully installed the Presentation Server, install TrueSight Capacity Optimization Application Server and ETL Engine.

Was this page helpful? Yes No Submitting... Thank you
Last modified by Alka Acharya on Jun 26, 2018
task installation tsps

Comments

Log in or register to comment.

Installing the Presentation Server in the high-availability mode using the wizard
Installing the Application Server and the ETL Engine using the wizard
© Copyright 2014 - 2020 BMC Software, Inc. © Copyright 2014 - 2020 BladeLogic, Inc.
Legal notices

Powered by Atlassian Confluence and Scroll Viewport

© Copyright 2005-2024 BMC Software, Inc. Use of this site signifies your acceptance of BMC’s Terms of Use . BMC, the BMC logo, and other BMC marks are assets of BMC Software, Inc. These trademarks are registered and may be registered in the U.S. and in other countries.