Installing the Presentation Server in the standalone mode silently

Where you are in the Installation process

You can install the Presentation Server using one of these settings:

• Typical: Installs the Presentation Server using the default settings.
• Custom: Allows you to customize the settings. 

To perform a typical installation of the TrueSight Presentation Server in the silent mode

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:
   

    Encrypt password using the wizard

   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)
    Encrypt password using the command line interface

   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. Open and edit the server-silent-options-<operatingSystem>.txt file. This is a text file that defines the installation properties in the form of a prefix tag followed by a property name and value pair. You can either retain the default values or change them and save the file.

    Property details

   Prefix tags for silent installation properties:

   • -P: Precedes directory properties

   • -A: Precedes application features

   • -J: Precedes Java properties

   
   

   Property name	Description
   Installation location
   -P installLocation	Retain the following default installation directory 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
   Installing 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 true to choose Typical installation. Default value: true Example: -J QUICK_INSTALL_MODE=true
   -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
   -J TrueSight_high_availability_enabled	Type 0. The value 0 indicates that the high-availability mode is disabled. Default value: 0 Example: -J TrueSight_high_availability_enabled=0 You can ignore the rest of the high availability properties.
   Tomcat configuration details
   -J TrueSight_tomcat_http_port	Retain the default value. Default value: (Windows) 80 (Linux) 8080 Example: -J TrueSight_tomcat_http_port=8080
   -J TrueSight_tomcat_https_port	Retain the default value. Default value: (Windows) 443 (Linux) 8043 Example: -J TrueSight_tomcat_https_port=8043
   Elasticsearch and cell gateway port details
   -J TrueSight_ElasticSearch_rest_port	Retain the default value. Default value: 9200 Example: -J TrueSight_ElasticSearch_rest_port=9200
   -J TrueSight_ElasticSearch_client_port	Retain the default value. Default value: 9300 Example: -J TrueSight_ElasticSearch_client_port=9300
   -J TrueSight_cell_gateway_port	Retain the default value. Default value: 1900 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. 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

   Ensure that the following system requirements are met. If your target computer does not meet these requirements, you cannot proceed with the installation. However, in a test environment, you can skip the system requirements validation and run the installer by using the -J MINIMAL=true argument.

   • Total RAM (in MB): 32,000
   • Available RAM (in MB): 25,000
   • Total swap space / page file (in MB): 8,000
   • Available swap space / page file (in MB): 8,000

   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 one of the following commands to start the installation. Type the complete path to the server-silent-options-<operatingSystem>.txt file in the command. If the path includes a blank space, enclose the path within double quotes. However, installation occurs in the background.

   Environment type	Command
   Production environment 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"
   Production environment 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"
   Test environment 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
   Test environment 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

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.
     To disable the CSRF filter

    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. Define the Presentation Server URL using this format, and launch the application in a browser: 

    • (Windows) http(s)://<TSPS_FQDN>

    • (Linux) http(s)://<TSPS_FQDN>:<tomcat_port>
15. Type the default Admin credentials (User name: admin, Password: admin12345) , and click Log In.
    The TrueSight console opens.

To perform a custom installation of the TrueSight Presentation Server in the silent mode

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:
   

    Encrypt password using the wizard

   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)
    Encrypt password using the command line interface

   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. Open and edit the server-silent-options-<operatingSystem>.txt file. You can either retain the default values for the properties or change them, and save the file. The server-silent-options-<operatingSystem>.txt is a text file that defines the installation properties in the form of a prefix tag followed by a property name and value pair. 

    Property details

   Prefix tags for silent installation properties:

   • -P: Precedes directory properties

   • -A: Precedes application features

   • -J: Precedes Java properties

   Property name	Description
   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
   Installing 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
   -J TrueSight_high_availability_enabled	Type 0. The value 0 indicates that the high-availability mode is disabled. Default value: 0 Example: -J TrueSight_high_availability_enabled=0 You can ignore the rest of the high availability properties.
   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. 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. 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. true: Indicates that you need to import the Remedy SSO private certificate during the TrueSight Presentation Server installation. 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. Example: -J SSO_CERTIFICATE_HOME=<RSSO install directory>\rssocert.crt
   -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

   Ensure that the following system requirements are met. If your target computer does not meet these requirements, you cannot proceed with the installation. However, in a test environment, you can skip the system requirements validation and run the installer by using the -J MINIMAL=true argument.

   • Total RAM (in MB): 32,000
   • Available RAM (in MB): 25,000
   • Total swap space / page file (in MB): 8,000
   • Available swap space / page file (in MB): 8,000

   By default, the TrueSight Infrastructure Management 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 one of the following commands to start the installation. Type the complete path to the server-silent-options-<operatingSystem>.txt file in the command. If the path includes a blank space, enclose the path within double quotes. However, installation occurs in the background.

   Environment type	Command
   Production environment 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"
   Production environment 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"
   Test environment 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
   Test environment 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

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.
     To disable the CSRF filter

    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. Define the Presentation Server URL using this format, and launch the application in a browser: 

    • (Windows) http(s)://<TSPS_FQDN>

    • (Linux) http(s)://<TSPS_FQDN>:<tomcat_port>
15. Type the default Admin credentials (User name: admin, Password: admin12345) , and click Log In.
    The TrueSight console opens.
    
    

Troubleshooting installation issues

If you face issues during installation, see Troubleshooting the Presentation Server deployment .

Next step in the Installation process

Now that you have successfully installed the Presentation Server, do one of the following:

• (Optional) Configure disaster recovery. For instructions, see Configuring the Presentation Server in the standalone and disaster recovery mode.
• Install the other TrueSight components as per your license entitlements. For instructions, see Installation process.