Page tree
Skip to end of metadata
Go to start of metadata

You can use this procedure to install the Presentation Server with the installation wizard, or you can perform a silent installation.

The following topics are included:

Before you begin

Complete the following items:

Permissions required for a nonroot user on Linux

On Linux computers, you can install the Presentation Server only as a non-root user. However, you must provide certain permissions to the nonroot user as a root user. To provide these permissions, perform the following steps: 

  1. Log on as a root user.
  2. Provide ownership rights to the nonroot user for all the installation files by running the following command: 

    chown -R <nonrootuser> installationDirectoryFolderName

    nonrootuser is the name of the nonroot user
    installationDirectoryFolderName
     is the name of the folder that contains all the installation files. 

    For example,  chown -R nonroot /Linux/Disk1

  3. Provide ownership rights to the nonroot user for the destination directory and temporary directory by running the following command: 

    chown -R <nonrootuser> /opt/bmc
    chown -R <nonrootuser> /tmp
    chown -R <nonrootuser> /etc
  4. Apply executable rights to the installation files by running the following command:

    chmod -R 755 installationDirectoryFolderName

    For example, chmod -R 755 /Linux/Disk1 

To install the Presentation Server

On the system where you want to install the Presentation Server, complete the following procedure:

  1. Launch the installation wizard:
    • Windows

      Navigate to Windows\Disk1 and double-click setup.exe.

    • Linux

      As a nonroot user, navigate to Linux/Disk1 and run ./setup.bin.

      Note

      Ensure that you have set the DISPLAY environment variable.

  2. On the Welcome page, click Next.
  3. On the License Agreement page, read the agreement and select the I agree to the terms of the license agreement option, and click Next
    If you do not agree to the terms of the license agreement, the installation process will not continue.

    On the Directory Selection page, the system displays the available space on the current drive and the amount of space required. The Destination Directory box displays the default path for the installation directory.

  4. Retain the default directory or click Browse to select a directory, and click Next.
    Ensure that the path for the installation directory does not exceed 125 characters, and the directory is empty.

    • Windows

      Default directory: \BMC Software\TrueSightPServer

    • Linux

      Default directory: /opt/bmc/TrueSightPServer

    Tip

    On Linux computers, BMC recommends using the default installation directory to avoid issues related to permissions and access.

  5. On the Listening Address Configuration page, confirm the Fully Qualified Domain Name (FQDN) of your localhost.
    This
     Fully Qualified Domain Name (FQDN) is detected by the installer. You can enter an alternative, local FQDN, but this field cannot be empty to continue with the installation. Other TrueSight components use the FQDN to connect with the Presentation Server. 
  6. On the TrueSight Presentation Server High Availability page, select Enabled to enter the required details; otherwise, select Disabled and click Next.

  7. (Optional) If you enabled the High Availability option, you must also select to use the Primary Server or upload a configuration for the Secondary Server. Then, Click Next.

    FieldDescription

    Primary Server

    Note

    If you do not use the default High Availability port numbers, only use port numbers between 1024 and 65535.

    Server Pair Name

    Elasticsearch cluster name for one node (server), or more nodes, that holds all of the data, and provides federated indexing and search capabilities across all nodes.

    The default value for the cluster name is "truesight". You can change this name to reflect the logical group name of the cluster.

    Cache Replication PortPort number for the primary server cache replication. The default port is 7800.
    Control PortPort number for the primary server control. The default port is 8800.
    Secondary Server FQDN

    Fully Qualified Domain Name for the secondary server host. The Secondary Server maintains a constantly updated cache memory of the Presentation Server activity.

    Secondary Server Database Port

    Port number for the secondary server database port. The default port is 5432.

    Note

    Ensure that you use the same database port number for both the primary and secondary servers.

    Secondary Cache Replication PortPort number for the secondary server cache replication. The default port is 7800.
    Secondary Control PortPort number for the secondary server control. The default port is 8800.
    Secondary Server
    High Availability Configuration FilePath to upload the HA configuration file. The ha-shared.conf file is generated in the <Primary Server installation directory>\truesightpserver\conf directory. Copy this file from the primary server host to the secondary server host. Enter or browse to the file path.

     

    Any event raised in the Presentation Server is set in the Primary Server. The Secondary Server maintains a constantly updated cache memory of the Presentation Server activity.

  8. On the TrueSight Presentation Server Port Settings page, use the default settings for the Tomcat Apache Server, Elasticsearch, and Event Ingress ports and then click Next.
    You can enter different port settings, but confirm that the new ports are available. 

    Notes

    • For Windows systems, if you do not use the default port numbers, only use port numbers between 1 and 65535.
    • For Linux systems, if you do not use the default port numbers, only use port numbers between 1024 and 65535.
  9. On the database installation credentials page, enter a unique name for the user and set a password for the PostgreSQL database, and then click Next. Installer creates a new database user using this username and password. 

    Notes

    • The database user name and password cannot exceed 30 characters.
    • For Windows systems, if you do not use the default database port number, only use port numbers between 1 and 65535.
    • For Linux systems, if you do not use the default database port number, only use port numbers between 1024 and 65535.
  10. On the BMC Atrium Single Sign-On (SSO) Server Settings page, enter the following details for the Atrium Single Sign-On server and then click Next

    • Enter the Fully Qualified Domain Name (FQDN) of the Atrium Single Sign-On server installed on the system.
    • Use the port number of the Atrium Single Sign-On server installed on the system. The default port number is 8443.
    • Enter the Atrium Single Sign-On server super user password. The Single Sign-On super user name is amadmin.
  11. Review the installation details.

    • If any of the details need to be changed, click Previous to view previous screens and change the relevant details.
    • If the details are correct, click Install.

  12. (Optional) On the Installation Summary page, you can click View Log to view the installation logs, or go to

    • Windows

      Default directory: \Temp\truesightpserver_install_log.txt

    • Linux

      Default directory: /tmp/truesightpserver_install_log.txt.

  13. Click Done to exit the installation wizard.

Note

If the installation fails, you must uninstall what has already been installed before rerunning the installation wizard. For more information about the uninstallation process, see Performing the Presentation Server uninstallation.

Postinstallation tasks

Perform the following tasks after installing the Presentation Server:

  • For Linux systems, register the Presentation Server service for non-root users:
    1. Log in as a root user on the computer on which the Presentation Server is installed
    2. Open a CLI command prompt, navigate to the <installedDirectory>/truesightpserver/bin directory, run the following command to register the service:

      ./tssh service register <nonroot user name>
    3. Check whether the service is registered by running the following command:
      service BMCTSPSSvc status
      The Core Server, Index Server, and Database Server processes should be listed as running.
  • If you want to install the Integration Service and administrator console software using Central Monitoring Administration, after  downloading the Infrastructure Management installer files from EPD , manually copy the TSIMAdmin and the TSIMAgent folders from the installationDirectory\os directory in Infrastructure Management to the installationDirectory\BMCSoftware\truesightpserver\modules\cma\download\<os_agent> directory in Operations Management. Otherwise, the installation files will not be visible in Central Monitoring Administration.
  • After you install the basic components of the Operations Management system, you must identify data providers as components in the Presentation Server. This connection enables the Presentation Server to receive data from its component parts. You can connect components as you add them, or when you finish adding all components.
  • Role-based user access to the features and components that compose BMC TrueSight Operations Management is enabled by persona-based authorization profiles. Each authorization profile is associated with one or more BMC Atrium Single Sign-On (SSO) Server realms and comprises user groups, roles and permissions, and objects. These authorization profiles determine the features and objects that users can access and monitor. You can use the default authorization profiles as is, or you can modify their attributes. If necessary, you can also create authorization profiles.

Related topic

Verifying the Presentation Server installation and operation 

 

7 Comments

  1.  

    1.  

  2.  

  3.  

  4. Where High Availability Configuration File is located after installation? There is no option to define this during installation.

    edit: I found this file - it is automatically stored in :installation dir/truesightpserver/conf/ha/ha.conf 

  5.  

  6. For TSPS HA Configuration, please follow KB - This is applicable for TSPS 10.1.

    More details around what issues can occur refer - https://communities.bmc.com/thread/158117