Preparing for the Presentation Server installation
Before installing the the Presentation Server, ensure that your environment is ready for the installation of the Presentation Server by reviewing and completing the following tasks.
Presentation Server compatibility matrix
The following table illustrates the compatibility between different versions of TrueSight Capacity Optimization and TrueSight Presentation Server.
|TrueSight Capacity Optimization version||TrueSight Presentation Server version||Remedy Single Sign-On version|
|11.0||9.1.03 or later|
Remedy Single Sign-On and Presentation Server
- The Presentation Server needs a Remedy Single Sign-On to be installed and configured to work with it.
- Remedy Single Sign-On can be installed as a standalone instance or in a high-availability environment to work with the Presentation Server.
- A single instance of Remedy Single Sign-On can support one or more Presentation Servers.
- You can also configure an existing Remedy Single Sign-On that is integrated with other BMC products to work the Presentation Server. However, it must be of the supported version.
- For a POC deployment of the Presentation Server with a Remedy Single Sign-On on the same machine, during installation of the Presentation Server ensure that you have assigned different port numbers for Tomcat and PostgreSQL.
Preinstallation tasks for the Presentation Server
- Confirm that the target computer meets the system requirements for the Presentation Server.
- Ensure that the Remedy Single Sign-On 9.1.03.001 or later system is installed.
Ensure that the Presentation Server is hosted on the same domain as the cookie domain configured on the Remedy Single Sign-On server.
For a successful authorization, the Presentation Server domain name and the the Remedy SSO cookie domain must belong to the same network domain or one of the parent domains.
- Example: Correct use of cookie domain
- Example: Wrong use of cookie domain
Ensure that you have the following privileges:
(Windows) Administrator privileges.
(Linux) A non-root user with modification permissions to the following directories and files. A user with root privileges cannot install the Presentation Server.
Permission File or Directory Execution /Linux/Disk1/setup.bin Read/Write and Execution
- Presentation Server installation directory
- /tmp directories.
Mount with exec option
Verify the filesystem that the /tmp directory resides in is mounted with exec option by running the findmnt command. If it shows noexec for /tmp, remount it with exec option. For example, mount -o remount,exec /tmp.
Read/Write and Execution /opt/bmc
The ProductRegistry.xml file is created in the /opt/bmc directory. Therefore, the /opt/bmc directory requires read/write and execution permissions. If the bmc directory does not exist, create the bmc directory with read/write execute permission.
- Presentation Server installation directory
- If you are installing with a non-root user, ensure that the non-root user who installs the product has the home directory on the computer where the product is installed. Ensure that the user's home directory contains the user profile file. This is required for the
TRUESIGHTPSERVER_HOMEenvironment variable to be set in the user profile file.
- Complete or review the installation planning worksheets.
- Review known and corrected issues
- If you are installing the Presentation Server on the same computer where an earlier installation existed, make sure that you completely uninstall the earlier installation. Make sure that any installed security software does not hamper the deletion of any *.war files.
- Ensure that you delete all files from the temporary directory.
- (Windows) %temp%
- (Linux) /tmp
- If you are installing the Presentation Server on an IPv6 Windows host, ensure that the IP helper service is started.
- Ensure that the system default locale is a UTF-8 locale.
- If you are installing the Presentation Server on a Suse Linux host, ensure that the glibc library version is 2.12 or above.
Configurations for TrueSight Presentation Server installing or upgrading in a Linux environment
You can change the required configurations either manually or by running the PreinstallConfig.sh script. The script uses
ulimit commands to perform the configuration changes.
The Truesight Presentation server installation or upgrade on a Linux host must be run as a non-root user.
The PreinstallConfig.sh script needs to be run with root user permissions.
After you run the script, re-login by opening a new Linux user session before launching the installer.This utility ensures that the minimum required system configurations are carried out for Truesight Presentation Server installation.
Add the properties as given in the following table to either the limits.conf file or theas specified.
Property Value Notes
/etc/security/limits.confNote: Ensure that the entries for open files and processes mentioned in the
/etc/security/limits.dfile is either blank or same as the limits in the
limits.conffile. If they are different, you may get an installation error.
soft nofile 65536
hard nofile 65536
The number of open files must be at least 65536.
soft nproc 2048
hard nproc 2048
The number of open processes must be at least 2048.
<TSPS_OWNER_NAME> soft memlock unlimited
<TSPS_OWNER_NAME> hard memlock unlimited
The memory lock should be set to unlimited.
soft as unlimited
hard as unlimited
The maximum Virtual memory should be unlimited.
To configure the value for non-root user, some operating systems require that root user should also have unlimited maximum virtual memory. In such instances, add the following lines:
root soft as unlimited
root hard as unlimited
Maximum Map Count is the maximum number of memory map areas a process may have.The virtual memory property
max_map_countmust be configured to at least 262144.
After making the configuration changes either manually or by running the script, log in by opening a new Linux user session and launch the installer.