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.

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 on the same host as the Presentation Server or a different host.
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 9.1.03.001 or later.
Review the preinstallation requirements before installing the Remedy Single Sign-On.

To configure the Terminal Server options on Windows

If you are planning to install Remedy SSO on a host computer with Windows, configure the following Terminal Server options that pertain to temporary folders. Doing this enables you to run the installation utility through a Terminal Services connection or a remote desktop session.

Note

You need to configure the Terminal Server options only once on a host computer running on Windows.
You do not have to configure the options if you are planning to install Remedy SSO on running on Linux or you are reinstalling a TrueSight product on the same host computer running on Windows.

On the host computer, from Start, type Run and press Enter, and type gpedit.msc and press Enter.
The Local Group Policy Editor is opened.
From the Local Group Policy Editor, navigate to Computer Configuration > Administrative Templates > Windows Components > Remote Desktop Services > Remote Desktop Session Host > Temporary folder.
Double-click the following options and set each to Enabled:

Do not delete temp folder upon exit.
Do not use temporary folders per session.

Back up the Windows registry and avoid receiving notification about Terminal Server configuration at the time of product installation:
1. On the host computer, from Start, type Run and press Enter, and type regedit and press Enter.
  The Registry Editor is opened.
2. From the Registry Editor, navigate to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server.
3. Set the value for PerSessionTempDir and DeleteDeleteTempDirsOnExit to 0.
  Note
  
  You can revert these changes after you complete the installation process.
Restart the host computer.

Preinstallation resources

System requirements for Presentation Server

Performing Remedy SSO installation in standalone mode with the Remedy installer

Performing Remedy SSO installation for high-availability with Remedy installer

Sizing considerations for the Presentation Server

Planning worksheets for Operations Management

Known and corrected issues

Uninstalling the Presentation Server

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
  - xyz.com is the cookie domain of Remedy SSO
  - <tspshostname>.abc.xyz.com is the Presentation Server FQDN
- Example: Wrong use of cookie domain
  - xyz.com is the cookie domain of Remedy SSO
  - <tspshostname>.abc.lmn.com is the Presentation Server FQDN

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.

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_HOME environment 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.

To configure the properties by running the PreinstallConfig.sh script located in the Utility folder

Navigate to the folder where you have downloaded the TrueSight Presentation Server installation file and run the PreinstallConfig.sh script with the root user permissions. The script changes the system configurations automatically to the values as mentioned in the above table under the manual configuration steps.
Important

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.
Linux/Disk1/utility/PreinstallConfig.sh
Example input

sh PreinstallConfig.sh <TSPS_OWNER_NAME>

<TSPS_OWNER_NAME> is the non-root username with which you want to install Truesight Presentation Server.
System configuration file settings override the user settings, so you must check them to avoid getting an error message instructing to run the PreInstall.sh script again even after running the script.
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.

To configure the properties in the configuration files manually

Add the properties as given in the following table to either the limits.conf file or the sysctl.conf as specified.

Important

You must configure the values given in the table with the root user permissions.

<TSPS_OWNER_NAME> is the non-root username with which you want to install Truesight Presentation Server.

Property	Value	Notes
`/etc/security/limits.conf` Note: Ensure that the entries for open files and processes mentioned in the `/etc/security/limits.d` file is either blank or same as the limits in the `limits.conf` file. If they are different, you may get an installation error.	`<TSPS_OWNER_NAME>` `soft nofile 65536` `<TSPS_OWNER_NAME>` `hard nofile 65536`	The number of open files must be at least 65536.
	`<TSPS_OWNER_NAME>` `soft nproc 2048` `<TSPS_OWNER_NAME>` `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.
	`<TSPS_OWNER_NAME>soft as unlimited` `<TSPS_OWNER_NAME>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
`/etc/sysctl.conf`	`vm.max_map_count=262144`	Maximum Map Count is the maximum number of memory map areas a process may have.The virtual memory property `max_map_count` must be configured to at least 262144.

After configuring the virtual memory, run the following command to refresh with the new configuration:
sysctl -p

Tip

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.

Where to go from here

Use one of the following methods to install the TrueSight Presentation Server: