Installing the Presentation Server in the standalone mode using the wizard

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

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

  • Typical: Installs the Presentation Server using the default settings for the installation directory and the Tomcat Apache Server, Elasticsearch, and Event Ingress ports.
  • Custom: Allows you to customize these settings. 

To perform a typical installation of the TrueSight Presentation Server in the wizard-based 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. (Linux) Set the DISPLAY environment variable to ensure that the wizard-based installer launches the screens appropriately:

    export DISPLAY=<IP address of the host computer>:0.0


    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.
  4. Navigate to the Disk1 directory of the extracted folder and use one of the following options to run the installer.
    If you plan to use Presentation Server with the TrueSight Capacity Optimization component only, run the following command:

    Environment typeCommand
    With the default encryption setting

    (Windows) setup.exe –J BMC_TS_KEY_SZ=<128/256> -J MINIMAL=true

    (Linux - as a non-root user) ./setup.bin –J BMC_TS_KEY_SZ=<128/256> -J MINIMAL=true

    With user-specified encryption setting

    (Windows)  Run setup.exe -J MINIMAL=true 

    (Linux) As a non-root user, run ./setup.bin -J MINIMAL=true

    The parameter  -J MINIMAL=true  ensures that the Presentation Server installer proceeds with the installation without 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 Hardware requirements.

    If the Presentation Server component is shared with Truesight Operations Management, ensure that the system requirements are met and do not specify the  -J MINIMAL  parameter in the command, unless you plan to install for experimentation purpose. Run one of the following command based on your environment type:

    Environment typeCommand
    With the default encryption setting

    (Windows) setup.exe –J BMC_TS_KEY_SZ=<128/256>

    (Linux - as a non-root user) ./setup.bin –J BMC_TS_KEY_SZ=<128/256>

    With user-specified encryption setting

    (Windows)  Run setup.exe 

    (Linux) As a non-root user, run ./setup.bin

  5. Review the welcome page, and click Next.
  6. Read the license agreement, agree to the terms, and click Next
  7. Select the Typical installation type. 

  8. The installer detects the FQDN of the host computer and populates the FQDN field automatically. Ensure that the FQDN is accessible by the other TrueSight components in your environment.  

    If you modify the FQDN:

    • Do not manually type any IP address in the FQDN field. 

    • Do not leave this field empty.

    • Ensure that the host computer belongs to the same network domain as that of Remedy Single Sign-On (Remedy SSO) cookie domain.

    Confirm this, and click Next.

  9. Type the PostgreSQL database details such as the user name, password, and port number. Click Next.

    • The database username and password must not exceed 30 characters.
    • If you want to change the default port number (5432), use port numbers only between:
      • (Windows) 1 and 65535
      • (Linux) 1024 and 65535

    The Installer creates a new database user using these values.

  10. Provide the following details for Remedy SSO, and click Next

    Note: If you have configured a Load Balancer for Remedy SSO, you must type the corresponding load balancer details.

    1. Type the FQDN of the host computer on which you have installed Remedy SSO or the load balancer URL.
    2. Type the tomcat port number that you have configured while installing Remedy SSO or the load balancer port number. The default port number for Remedy SSO is:
      • (Windows) HTTPS: 448 and HTTP: 88
      • (Linux) HTTPS: 8048 and HTTP: 8088
    3. Type the Remedy SSO server superuser password. The Remedy SSO superuser name is Admin.
    4. Select HTTP or HTTPS depending on the Remedy SSO configuration . By default, Remedy SSO is configured in the HTTPS mode.

    5. Select Yes or No to import the Remedy SSO private certificate. If you select:
      • Yes: Specify the directory where the Remedy SSO private certificate is stored. 
      • No: 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.
  11. Preview the details, and verify the configurations.
  12. Click Install to start the installation. A local installation may take up to 15 minutes.
    After the installation is complete, the Installation Summary page is displayed.
  13. Click View Log to view the installation log details on the screen. From the log view, you can expand and view the log messages. You can also navigate to the following default location of logs:

    • (Windows) \Temp\truesightpserver_install_log.txt
    • (Linux) /tmp/truesightpserver_install_log.txt
  14. Click Done to exit the installation program.
  15. Verify that the following environment variable points to the TrueSight Presentation Server installation path:

    • (Windows) %TRUESIGHTPSERVER_HOME%

    • (Linux) $TRUESIGHTPSERVER_HOME

  16. 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 the tssh server status command, restart the Presentation Server by running the following command:

    • (Windowstssh server start

    • (Linux./tssh server start
  17. (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 do 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. Running the service BMCTSPSSvc status command.

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

    • service BMCTSPSSvc start
    • service BMCTSPSSvc stop  
  18. 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
  19. (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:
      • (WindowsTrueSightPServer\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:

      • (WindowsTrueSightPServer\truesightpserver\bin
      • (Linux) TrueSightPServer/truesightpserver/bin
    2. Run the tssh properties set csrfFilter false command.
    3. Run the tssh properties reload command.
  20. Define the Presentation Server URL using the following format, and launch the application in a browser:

    • (Windowshttp(s)://<TSPS_FQDN>

    • (Linuxhttp(s)://<TSPS_FQDN>:<tomcat_port>
  21. Type the default Admin credentials (User name: admin, Password: admin12345), and click Log In.

    The TrueSight console opens.

    Your installation is complete.

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

To perform a custom installation of the TrueSight Presentation Server in the wizard-based 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. (Linux) Set the DISPLAY environment variable to ensure that the wizard-based installer launches the screens appropriately:

    export DISPLAY=<IP address of the host computer>:0.0


    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.
  4. Navigate to the Disk1 directory of the extracted folder and use one of the following options to run the installer.
    If you plan to use Presentation Server with the TrueSight Capacity Optimization component only, run the following command:

    Environment typeCommand
    With the default encryption setting

    (Windows) setup.exe –J BMC_TS_KEY_SZ=<128/256> -J MINIMAL=true

    (Linux - as a non-root user) ./setup.bin –J BMC_TS_KEY_SZ=<128/256> -J MINIMAL=true

    With user-specified encryption setting

    (Windows)  Run setup.exe -J MINIMAL=true 

    (Linux) As a non-root user, run ./setup.bin -J MINIMAL=true

    The parameter  -J MINIMAL=true  ensures that the Presentation Server installer proceeds with the installation without 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 Hardware requirements.

    If the Presentation Server component is shared with Truesight Operations Management, ensure that the system requirements are met and do not specify the  -J MINIMAL  parameter in the command, unless you plan to install for experimentation purpose. Run one of the following command based on your environment type:

    Environment typeCommand
    With the default encryption setting

    (Windows) setup.exe –J BMC_TS_KEY_SZ=<128/256>

    (Linux - as a non-root user) ./setup.bin –J BMC_TS_KEY_SZ=<128/256>

    With user-specified encryption setting

    (Windows)  Run setup.exe 

    (Linux) As a non-root user, run ./setup.bin

  5. Review the welcome page, and click Next.
  6. Read the license agreement, agree to the terms, and click Next
  7. Select the Custom installation type, and click Next.
  8. Review the disk space requirements. The default installation directory is:

    • (Windows) C:\Program Files\BMC Software\TrueSightPServer

    • (Linux) /opt/bmc/TrueSightPServer

    You can change the default directory, if required, and click Next.

  9. Type the PostgreSQL database details such as the user name, password, and port number. Click Next.

    • The database username and password must not exceed 30 characters.
    • If you want to change the default port number (5432), use port numbers only between:
      • (Windows) 1 and 65535
      • (Linux) 1024 and 65535

    The Installer creates a new database user using these values.

  10. Disable the high-availability configuration settings. 
  11. Retain the following default values for Tomcat Apache Server, Elasticsearch, and Event Ingress ports, or type new values, and click Next.

    • Tomcat port: HTTPS: 443, HTTP: 80
    • Elasticsearch ports: REST: 9200, Java/Node Client: 9300
    • Event Ingress port: 1900

    If you want to change these default port numbers, use numbers between: 

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

  12. Type the PostgreSQL database details such as the user name, password, and port number. Click Next.

    • The database username and password must not exceed 30 characters.
    • If you want to change the default port number (5432), use port numbers only between:
      • (Windows) 1 and 65535
      • (Linux) 1024 and 65535

    The Installer creates a new database user using these values.

  13. Provide the following details for Remedy SSO, and click Next

    Note: If you have configured a Load Balancer for Remedy SSO, you must type the corresponding load balancer details.

    1. Type the FQDN of the host computer on which you have installed Remedy SSO or the load balancer URL.
    2. Type the tomcat port number that you have configured while installing Remedy SSO or the load balancer port number. The default port number for Remedy SSO is:
      • (Windows) HTTPS: 448 and HTTP: 88
      • (Linux) HTTPS: 8048 and HTTP: 8088
    3. Type the Remedy SSO server superuser password. The Remedy SSO superuser name is Admin.
    4. Select HTTP or HTTPS depending on the Remedy SSO configuration . By default, Remedy SSO is configured in the HTTPS mode.

    5. Select Yes or No to import the Remedy SSO private certificate. If you select:
      • Yes: Specify the directory where the Remedy SSO private certificate is stored. 
      • No: 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.
  14. Preview the details, and verify the configurations.
  15. Click Install to start the installation. A local installation may take up to 15 minutes.
    After the installation is complete, the Installation Summary page is displayed.
  16. Click View Log to view the installation log details on the screen. From the log view, you can expand and view the log messages. You can also navigate to the following default location of logs:

    • (Windows) \Temp\truesightpserver_install_log.txt
    • (Linux) /tmp/truesightpserver_install_log.txt
  17. Click Done to exit the installation program.
  18. Verify that the following environment variable points to the TrueSight Presentation Server installation path:

    • (Windows) %TRUESIGHTPSERVER_HOME%

    • (Linux) $TRUESIGHTPSERVER_HOME

  19. 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 the tssh server status command, restart the Presentation Server by running the following command:

    • (Windowstssh server start

    • (Linux./tssh server start
  20. (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 do 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. Running the service BMCTSPSSvc status command.

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

    • service BMCTSPSSvc start
    • service BMCTSPSSvc stop  
  21. 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
  22. (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:
      • (WindowsTrueSightPServer\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:

      • (WindowsTrueSightPServer\truesightpserver\bin
      • (Linux) TrueSightPServer/truesightpserver/bin
    2. Run the tssh properties set csrfFilter false command.
    3. Run the tssh properties reload command.
  23. Define the Presentation Server URL using the following format, and launch the application in a browser:

    • (Windowshttp(s)://<TSPS_FQDN>

    • (Linuxhttp(s)://<TSPS_FQDN>:<tomcat_port>
  24. Type the default Admin credentials (User name: admin, Password: admin12345), and click Log In.

    The TrueSight console opens.

    Your installation is complete.

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


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

Comments