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:

        ./{{code language="none"}}
        TrueSightPServerMaintenanceTool
        {{/code}}.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

   
   
   NoteEnsure 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.Excerpt named installupgradereq was not found in document xwiki:IT-Operations-Management.Operations-Management.TrueSight-Operations-Management.tsomd11307.Planning.Planning-the-Presentation-Server-deployment.System-requirements-for-Presentation-Server.WebHome.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.

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.07 install succeeded.

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

   • (Windows) %TRUESIGHTPSERVER_HOME%
   • (Linux) $TRUESIGHTPSERVER_HOME

   Note: (Optional) After the installation is complete, you can revoke the write permission on the /opt directory.

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 service by performing the following steps:

    Note: The systemd service BMCTSPSSvc.service is supported only from version 11.3.04. For more information on this service, see Starting-and-stopping-the-TrueSight-Operations-Management-components.

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

    If you restart the TrueSight Presentation Server  host without registering the BMCTSPSSvc.service 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 systemctl status BMCTSPSSvc.service command.

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

    • systemctl start BMCTSPSSvc.service
    • systemctl stop BMCTSPSSvc.service

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.

       ExampleIf 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

    NoteIf 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:./{{code language="none"}}
        TrueSightPServerMaintenanceTool
        {{/code}}.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

   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.

   Excerpt named installupgradereq was not found in document xwiki:IT-Operations-Management.Operations-Management.TrueSight-Operations-Management.tsomd11307.Planning.Planning-the-Presentation-Server-deployment.System-requirements-for-Presentation-Server.WebHome.

   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. Navigate to the Disk1 directory of the extracted folder, use one of the following options to run the installer.BMC recommends that you run the installer by using install.cmd and not setup.exe.You must right-click on install.cmd and select Run as administrator.
7. Review the welcome page, and click Next.
8. Read the license agreement, agree to the terms, and click Next. 
9. (Windows) Start the Windows Firewall service from services.msc and run the following commands:
   • 
     
     • (Microsoft Windows 2012 R2) netsh advfirewall set allprofiles state on
     • (Microsoft Windows 2012) netsh firewall set opmode mode = ENABLE
   NoteIf you turn on the firewall when Remote Desktop Protocol (RDP) is running, the RDP session may get disconnected if it is blocked by the firewall.
10. (Windows) On the Configuring Firewall Rules page, perform one of the following tasks, and click Next.
    • Select Automatically configure the Windows Firewall rules.
    • The Windows Firewall inbound rules are configured. 
    • Select I will manually configure Windows Firewall Rules now before proceeding further and configure inbound rules for the pw processes that are listed on the page.
      If you prefer to use a third party firewall application that is installed on your computer, you must manually create the firewall inbound rules. For more information about creating firewall inbound rules, refer to the documentation of the third party firewall application.
11. The default installation directory is:
    • (Windows) C:\Program Files\BMC Software\TrueSight
    • (Linux) /opt/bmc/TrueSight
    Notes
    
    • (Windows) Do not install TrueSight Infrastructure Management Server in the root directory (for example C: or D: ), on a shared drive, or in the Documents and Settings folder.
    • (Windows) While installing TrueSight Infrastructure Management Server on a 64-bit Windows computer, ensure that you do not install it in the Program Files (x86) directory path.
    • (Linux) Do not install TrueSight Infrastructure Management Server in the root directory.
    • (Linux) The directory in which the TrueSight Infrastructure Management Server is installed and all its parent directories must have 755 permissions (read, write, and execute permissions to owner, groups, and others) and must be owned by root as well as the other group. Without these permissions and ownership, you will not be able to log in to the TrueSight Infrastructure Management Server.
    • (Linux, as a non-root user) To avoid problems related to user permissions, ensure that you log in to a new session as a non-root user (without using the su command).
    • For Chinese, Korean, and Japanese installations, ensure that the system default locale is a UTF-8 locale. This enables the Input Method feature in the administration console.
12. 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
    Confirm this, and click Next. 
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.

       ExampleIf 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

    NoteIf 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. Select the configuration tasks that you want to perform, and click Next.
    
15. (Optional) Based on your selection, the applicable configuration pages are displayed. Type the appropriate details, and click Next.
    1. Configure TrueSight Infrastructure Server for Disaster Recovery Mode

       Type a valid host name alias to configure disaster recovery, and click Next. The default host name alias is pronet.
    2. Configure TrueSight Infrastructure Server default Cell

       
       

       Field	Description
       Cell details
       Instance Name	Name of the cell instance. The default is pncell_hostname.
       Port	Port number in the range of 1024 to 65535. The default port for the cell is 1828.
       Encryption Key	Encryption key for the cell. The default is mc. No special characters are allowed.

    3. Change TrueSight Infrastructure Server default ports

       Port name	Description
       Apache Port	Used by the operator console and web services. The default port number is 80. (Linux) If you are installing as a non-root user, use a port number that must be between 1025 and 65535.
       Apache SSL Port	Used by the operator console for secure channel access. The default port number is 443. (Linux) If you are installing as a non-root user, use a port number that must be between 1025 and 65535.
       AgentController Port	Used by the Agent Controller. The default port number is 12123.
       BMC Impact Admin Server Port	Used by BMC Impact Admin Server clients to communicate with BMC Impact Admin Server. The default port number is 3084.
       Remote Method Invocation Port	Used by the operator console. The default port is 1099.
       Service Desk Integration Port	Used by the Integration for Service Desk Integration service if BMC Atrium CMDB integration is enabled. The default port number is 3115.
       Tomcat Port	Used by the Tomcat process
       JBoss JMS Port	Used by the JBoss process
       Cache Server Port	Used by the Cache Manager process

    4. Administrator e-mail from TrueSight Infrastructure Management — Change defaults

       These details are required to receive e-mail notifications from the TrueSight Infrastructure Management Server.

       Field	Description
       Sender E-mail ID	Email address that you specify as the sender of notification messages. The format must be hostName@company.com The administrator receiving the email message will be able to identify the host that has disk space problems or other issues that send notifications. The default value is blank.
       Administrator E-Mail ID	Fully qualified e-mail address of the administrator of the TrueSight Infrastructure Management Server. The format must be user@company.com. The default value is blank.
       Name or IP Address of SMTP Server	Name or IP address of the SMTP server. The default value is blank.

    5. DSIM — Enable and Configure

       Based on your TrueSight Infrastructure Management environment, select any one of the following:

       • Select Single Server Environment Installation option to install the TrueSight Infrastructure Management Server as a standalone server.

       • Select any of the following options under Multiple Server Environment Installation.
         • Select BMC TrueSight Operations Management Central Server option to install this instance as a central server.
         • Enter the following Server Router details for BMC TrueSight Operations Management Child Server:

       Field	Description
       Host Name/IP Address	FQDN name and IP address of the Central Server Router.
       Protocol	Protocol with which to communicate to the Central Server Router. It can be either HTTP or HTTPS.
       HTTP Port	Port number with which to communicate to the Central Server Router. The default port number are 80 for HTTP and 443 for HTTPS.

    
    
    

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.