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

  • 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:
    • (On Windows) Administrator privileges or permissions.

    • (On 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 and /Linux/Disk1/install.sh files.
      • Read, write, and execute permissions for the TrueSight Presentation Server installation and /tmp directories.
      • 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 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.

      - (Optional) After the installation is complete, you can revoke the write permission only on the /opt directory.

  • (On 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:

  • (On Linux) On the target host, ensure that umask is set to 022.
  • (On Linux) Verify and ensure that you have the fontconfig-2.13.0-4.3.el7.x86_64.rpm font file has been installed as follows:
    1. Run the fc-list : file command to verify if the font exists. 
    2. (If the font is not present) Download the fontconfig-2.13.0-4.3.el7.x86_64.rpm file.
    3. Run the yum install -y dejavu-serif-fonts command to install the font.

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 required system configurations are met by doing one of the following:

  • Configure the System settings by running the PreinstallConfig.sh 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.

      • 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.
      • Running the script gives 777 permissions automatically to the following folders:
        • /opt
        • /opt/bmc
        • /tmp
      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 System settings manually

    1. As a root user, add the properties as listed in the System configuration settings table to the limits.conf or limits.d 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

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. 



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*