General OS requirements

Caution: Certain UNIX system parameters may need to be modified and certain OS patches may need to be applied for your particular hardware platform. Failure to meet these requirements might cause the installation to fail.

Disk space requirements

  • Installation disk space requirement: 8 GB

    If you install Deployment Automation (DA), another 500 MB is required.

  • Temporary working space requirement (verified by the installer): 5 GB

    Location: /tmp/istempXXXXXX

    You may safely remove this folder post-installation.

    The temporary folder /tmp/serena_ra_agent_install (generated while a DA agent is installed) may also be removed.

  • Software inventory information is less than 4 MB and is written to:

    /var/opt/serena

C++ runtime library versions

Ensure that you have the latest compatible C++ runtime libraries for the Dimensions CM executables to run correctly. This is normally the case for a newly installed OS but may not be after an upgrade. Consult the OS vendor if you need to obtain the correct versions.

OS patches

On the Dimensions CM UNIX platforms, Dimensions CM has only been tested for use if the operating system patches (if any) identified in the readme file have been applied. If these operating systems are not at the identified patch level, the Dimensions CM installation may fail—consult your UNIX System Administrator if you need further assistance.

Note: Platform manufacturers routinely update and renumber their patches. Your platform manufacturer's Customer Service Representative has the latest patch information.

Increase the open file descriptors limit

For each client session the Dimensions CM Pool Manager typically consumes a total of 10 file descriptors. Therefore, to enable your Dimensions CM server to serve a maximum of N user sessions, your OS needs to allow for a maximum of 10*N file descriptors to be open by a single process. To set and modify the current maximum limit on the number of open file descriptors, contact your UNIX system administrator.

For example, the command ulimit -n displays the current limit. To modify the limit, edit /etc/system and add the line:

set rlim_fd_max=4096

This sets the maximum limit to 4096 and enables Dimensions CM to serve over 400 users.

Please consult your UNIX documentation for other flavors of UNIX.

Linux requirements

SuSE Linux Enterprise Server

Perform a software update from the YAST2 control center software options.

Red Hat Enterprise Linux

Perform a software update using the Update Agent (up2date).

Prerequisites for Linux 64-bit

The pre-requisites for installing a Dimensions CM server and agent on Linux 64-bit are:

  • Open Motif

  • C & C++ 32-bit and 64-bit O/S libraries (for compatibility)

System parameters

ulimit

If you have a UNIX system other than one originally based on BSD UNIX, please ensure that the UNIX system parameter ulimit (which defines the maximum size of any file) is set to a value that are sufficient to allow the creation of large RDBMS database files.

uname

Ensure that the search path for user root includes the location of the program uname.

Memory and swapping

Memory and swapping are key factors that Dimensions CM performance is dependent upon. For memory requirements for Dimensions CM, see the Dimensions CM Support Matrix.

Support for large files

Support for files up to 4GB in size is available. See the pcms_item_data published view in the Reports Guide for details.

Reinstall CM

If you reinstall CM on a Solaris, AIX, or Linux system, you must first ensure that the files under the following directory have been deleted:

/var/opt/serena/

Failure to do this may cause your installation to terminate with an error condition.

Run the installer on AIX

Before installing on AIX, run these commands to configure your environment:

export EXTSHM=MSEG

ulimit -f unlimited -n unlimited -s unlimited -m unlimited -t unlimited -v

unlimited -d unlimited

umask 022

Note: You can determine the ulimit settings appropriate for your system and use them instead of the unlimited values. For details, see Change the AIX memory limit‌.

Run the installer with:

LDR_CNTRL=MAXDATA=0X0000000@DSA ./Dimensions_<application>_<platform>.bin<optional parameters>

For example:

LDR_CNTRL=MAXDATA=0X0000000@DSA ./Dimensions_Server_AIX64.bin <optional parameters>