Click the Installing Presentation Server 10.7 tab to view the corresponding procedure.
The following sections provide instructions to install Presentation Server 10.5:
Complete the following items:
For the TrueSight Presentation Server installation on Linux systems, it is necessary to make changes to the ProductRegistry.xml file.
The non-root user must have modification permissions to the ProductRegistry.xml file, which is located in /opt/bmc, the Presentation Server installation directory.
On Linux computers, you can install the Presentation Server only as a non-root user. However, the root user must provide the read, write, and execute permissions to the non-root user for the following directories:
The Presentation Server uses 256-bit SSL encryption, by default. Due to import regulations in some countries, AES 256-bit encryption is not allowed. You select the appropriate encryption key size when you invoke the installer; otherwise, the installer uses the default 256-bit SSL encryption.
In a command line, navigate to the Disk1 folder in the installation file structure and enter the following command to change the encryption key size:
Windows
setup.exe –J BMC_TS_KEY_SZ=<128/256>
Linux
./setup.bin –J BMC_TS_KEY_SZ=<128/256>
128
is AES 128-bit encryption key256
is AES 256-bit encryption key
A typical installation is recommended for installing the Presentation Server with the default settings.
Note
During a typical installation, the Presentation Server is installed in the following default directory:
(Windows) \BMC Software\TrueSightPServer
(Linux) /opt/bmc/TrueSightPServer
(Windows) As an administrator user, navigate to Windows\Disk1 and double-click setup.exe.
(Linux) As a non-root user, navigate to Linux/Disk1 and run ./setup.bin.
Note
Ensure that you have set the DISPLAY environment variable.
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.
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.
The Installer creates a new database user using this user name and password.
Notes
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.
Review the installation details.
If the details are correct, click Install.
(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
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.
(Windows) Navigate to Windows\Disk1 and double-click setup.exe.
(Linux) As a non-root user, navigate to Linux/Disk1 and run ./setup.bin.
Note
Ensure that you have set the DISPLAY environment variable.
On the Installation Type page, select the installation type as Custom Install.
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.
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
On the TrueSight Presentation Server High Availability page, select Enabled to enter the required details; otherwise, select Disabled and click Next.
(Optional) If you enabled the High Availability option, Select Primary Server or upload a configuration for the Secondary Server and then click Next.
Field | Description |
---|---|
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 Port | Port number for the primary server cache replication. The default port is 7800. |
Control Port | Port 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 Port | Port number for the secondary server cache replication. The default port is 7800. |
Secondary Control Port | Port number for the secondary server control. The default port is 8800. |
Secondary Server | |
High Availability Configuration File | Path 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. Note If you have imported the Single Sign-On SSL certificate during the primary server installation, you must copy this certificate in the same file path of the HA configuration file. When you do this, the certificate is imported automatically during the secondary server installation.
|
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.
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
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.
The installer creates a new database user using this username and password.
Notes
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.
Review the installation details.
If the details are correct, click Install.
(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.
Click Done to exit the installation wizard.
Perform the following tasks after installing the Presentation Server:
./tssh service register <nonrootUserName>
service BMCTSPSSvc status
Role-based user access to the features and components that compose TrueSight Operations Management is enabled by persona-based authorization profiles. Each authorization profile is associated with one or more Atrium Single Sign-On (SSO) Server realms and comprises user groups, roles and permissions, and objects. These realms 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.
The following sections provide instructions to install Presentation Server 10.7:
Complete the following items:
On Linux computers, you can install the Presentation Server only as a non-root user. However, the root user must provide the read, write, and execute permissions to the non-root user for the following directories:
The Presentation Server uses 256-bit SSL encryption, by default. Due to import regulations in some countries, AES 256-bit encryption is not allowed. You select the appropriate encryption key size when you invoke the installer; otherwise, the installer uses the default 256-bit SSL encryption.
In a command line, navigate to the Disk1 folder in the installation file structure and enter the following command to change the encryption key size:
Windows
setup.exe –J BMC_TS_KEY_SZ=<128/256>
Linux
./setup.bin –J BMC_TS_KEY_SZ=<128/256>
128
is AES 128-bit encryption key256
is AES 256-bit encryption key
A typical installation is recommended for installing the Presentation Server with the default settings.
Note
During a typical installation, the Presentation Server is installed in the following default directory:
(Windows) \BMC Software\TrueSightPServer
(Linux) /opt/bmc/TrueSightPServer
(Windows) As an administrator user, navigate to Windows\Disk1 and double-click setup.exe.
(Linux) As a non-root user, navigate to Linux/Disk1 and run ./setup.bin.
Note
Ensure that you have set the DISPLAY environment variable.
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.
Make sure that you do not manually enter any IP address in the FQDN field.
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.
The Installer creates a new database user using this user name and password.
Notes
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.
Review the installation details.
If the details are correct, click Install.
(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
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.
(Windows) Navigate to Windows\Disk1 and double-click setup.exe.
(Linux) As a non-root user, navigate to Linux/Disk1 and run ./setup.bin.
Note
Ensure that you have set the DISPLAY environment variable.
On the Installation Type page, select the installation type as Custom Install.
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.
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
On the TrueSight Presentation Server High Availability page, select Enabled to enter the required details; otherwise, select Disabled and click Next.
(Optional) If you enabled the High Availability option, Select Primary Server or upload a configuration for the Secondary Server and then click Next.
Field | Description |
---|---|
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 Port | Port number for the primary server cache replication. The default port is 7800. |
Control Port | Port 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 Port | Port number for the secondary server cache replication. The default port is 7800. |
Secondary Control Port | Port number for the secondary server control. The default port is 8800. |
Secondary Server | |
High Availability Configuration File | Path 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. Note If you have imported the Single Sign-On SSL certificate during the primary server installation, you must copy this certificate in the same file path of the HA configuration file. When you do this, the certificate is imported automatically during the secondary server installation.
|
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.
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
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.
The installer creates a new database user using this username and password.
Notes
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.
Review the installation details.
If the details are correct, click Install.
(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.
Click Done to exit the installation wizard.
If you restart a Presentation Server Linux host without registering the BMCTSPSSvc service, the processes do not come up and you need to start the Presentation Server manually.
Perform the following tasks after installing the Presentation Server:
./tssh service register <nonrootUserName>
service BMCTSPSSvc status
Role-based user access to the features and components that compose TrueSight Operations Management is enabled by persona-based authorization profiles. Each authorization profile is associated with one or more Atrium Single Sign-On (SSO) Server realms and comprises user groups, roles and permissions, and objects. These realms 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.
3 Comments
Melody Locke
Kevin Joyce
Bharat Rajpal