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
  • To configure the Terminal Server options on Windows
  • Preinstallation tasks for the Presentation Server
  • Where to go from here

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.

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.

• 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.

  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

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

     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.

     The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
     This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.

  2. After configuring the virtual memory, run the following command to refresh with the new configuration:

     sysctl -p

Where to go from here

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

• Performing-the-Presentation-Server-installation
• Performing the Presentation Server installation silently