Preparing to install the Presentation Server

Before installing the TrueSight Presentation Server ,ensure that your environment meets the installation requirements, and complete the tasks described in this section.

Complete the pre-installation tasks for the Presentation Server

  • Ensure that the target computer meets the  system requirements  for TrueSight Presentation Server.

  • Review the  Known and corrected issues  issues section for any installation-related issues.
  • Ensure that the  compatible version  of Remedy Single Sign-On is installed.

  • Plan to host the TrueSight Presentation Server 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 or permissions.
    • (Linux) Non-root user permissions. To be able to perform the installation, a non-root user needs the following permissions:

      • Execute permission for the /Linux/Disk1/setup.bin file.
      • Read, write, and execute permissions for the TrueSight Presentation Server installation directory.
      • Read and write permissions for the /opt/bmc directory.

      Note

      The ProductRegistry.xml file is created in the /opt/bmc directory. Therefore, the /opt/bmc directory requires read and write permissions. If the bmc directory does not exist, create it with read and write permissions.

  • (Linux) Ensure that the non-root user who installs the product has the home directory and it contains the user profile file on the host computer where TrueSight Presentation Server is to be installed. This is required for setting the TRUESIGHTPSERVER_HOME environment variable in the user profile file.
  • If you are installing the TrueSight Presentation Server on the same computer where an earlier installation existed, you must uninstall the earlier installation completely.
  • Ensure that any installed security software does not hamper the deletion of any *.war files.
  • If you are installing the TrueSight Presentation Server on an IPv6 Windows host, ensure that the IP helper service has been started.
  • Ensure that the system default locale set to UTF-8 locale.
  • If you are installing the TrueSight Presentation Server on a SuSE Linux host, ensure that the glibc library version is 2.12 or later.
  • Ensure that you do not select a mount point as the installation directory. If the existing TrueSight Presentation Server installation directory is a mount point, you might have problems associated with the upgrade process when attempting to rename directories. Allocate a directory for the existing environment that is not a mount point.
  • Ensure that the computer where you are installing TrueSight Presentation Server complies with the following requirements:

    ParameterValue
    Total Physical Memory32000 MB (32 GB)
    Available Physical Memory28000 MB (28 GB)
    Total Swap Space8000 MB (8 GB)
    Available Swap Space8000 MB (8 GB)
    Available Disk Space2000 MB (2 GB)

Configure the Terminal Server options in Windows

On Windows, to run the installation utility through a Terminal Services connection or a remote desktop session, configure the Terminal Server options that pertain to temporary folders.

Note

You must configure the Terminal Server options only once on a host computer. You do not have to configure the options if you reinstall a TrueSight product on the same host computer.

Do the following:

  1. On the host computer, open the Local Group Policy Editor by selecting Start > Run, and type gpedit.msc.
  2. Expand the following folder: Computer Configuration > Administrative Templates > Windows Components > Remote Desktop Services > Remote Desktop Session Host > Temporary folders.
  3. Double-click the following options to set them to Enabled:
    • Do not delete temp folder upon exit
    • Do not use temporary folders per session
  4. On the host computer, open the Registry Editor by selecting Start > Run and typing regedit.
  5. Expand the following folder: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server.
  6. Set the value for PerSessionTempDir and DeleteTempDirsOnExit to 0.
  7. Restart the computer.

You can revert these changes after you complete the installation process. You might need to restart the computer.

Configure the environment in Linux

As a root user, you can change the configurations either manually or by running the PreinstallConfig.sh script. The script uses ulimit commands to perform the configuration changes.

Ensure that the minimum system configurations required are met by doing one of the following:

  • Configure the properties by running the script

    1. On the host computer, navigate to the <Download location>/Linux/Disk1/utility/ folder, and run the PreinstallConfig.sh script:

      sh PreinstallConfig.sh <TSPS_OWNER_NAME>

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

      Important

      • The TrueSight Presentation Server installation or upgrade on a Linux host must be run as a non-root user.
      • System configuration file settings override the user settings. In case of an error that instructs you to run the PreInstallConfig.sh script again, ensure that you modify these configuration settings as per the error message before you rerun the script.

      The script changes the system configurations automatically to the values as listed in the System configuration settings table.

    2. After you run the script, open a new Linux user session and log in as a non-root user before launching the TrueSight Presentation Serverinstaller.

  • Configure the properties manually

    1. As a root user, add the properties as listed in the System configuration settings table to the limits.conf file and the sysctl.conf file.

      Important

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

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

      sysctl -p

    3. Open a new Linux user session, and log in as a non-root user before launching the TrueSight Presentation Serverinstaller.

System configuration settings

File nameProperty and ValueNotes





/etc/security/limits.conf

<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 4096

<TSPS_OWNER_NAME> hard nproc 4096

The number of open processes must be at least 4096.

<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.confvm.max_map_count=262144Maximum 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.

Where to go from here

If you are installing the product, perform the other preinstallation tasks listed in the Preparing to install the TrueSight Operations Management solution page. 

Was this page helpful? Yes No Submitting... Thank you

Comments