Install Dimensions CM

This topic provides guidelines and considerations for installing and upgrading Dimensions CM on a Windows or UNIX system.

Installation overview

Use this information to prepare for installing or upgrading Dimensions CM.

Before you install
Install and upgrade

For instructions on installing and upgrading Dimensions CM, see the following guides:

Note: For UNIX, there are separate installers for servers, agents, and clients.

Manage licenses

To use AutoPass License Server (APLS), see Dimensions CM licensing.

To use License Manager (SLM), see Administering Licenses and the License Server in the Administration Guide.

Optimize and scale For details about hardware scaling requirements, see the Architecture and Optimization Guide.
Get more support See the Micro Focus Support portal for support, expertise, and resources.

Back to top

Installation and upgrade considerations

Review these considerations before you begin installing or upgrading Dimensions CM.

Update operating systems

Apply the latest updates for your operating system.

AIX: You must install the latest version of the OS package: bos.rte.libc.

Windows 8.1 and Windows Server 2012 R2: You must install the following updates:

Install on Winsdows Before installing on Windows, ensure that you have at least 15 Gb of free space on the main disk (usually C:).
Red Hat 8.x prerequisites

In addition to the packages listed in the installation guide, you need to add the following files:

  • libnsl.x86_64

  • libnsl.i686

  • libxcrypt.i686

Red Hat 8.2 and CentOS 8.2 prerequisites

Verify that the following packages are installed before you install Dimensions CM:

  • libxcrypt.x86_64

  • libxcrypt.i686

  • libstdc++.i686

  • motif.i686

  • nss-softokn-freebl.x86_64

  • nss-util.x86_64

  • libXp.i686

  • libXp.x86_64

  • libXpm.x86_64

Unable to connect to database when installing

If an error message is displayed during installation, stating that Dimensions CM is unable to connect to the database:

  • Check that you have entered the correct database password and Oracle DSN if applicable.

  • Check that the database used by Dimensions CM is active (up). Confirm that it is running, or that you can connect to it, using standard RDBMS database utilities such as sqlplus.

Install on Windows Server 2012R2 with Oracle 12

If you cannot install Dimensions CM on Windows Server 2012R2 with Oracle 12, check the following:

  • The system PATH contains ORACLE_HOME (this should be true if the system is restarted after installing Oracle).

    If ORACLE_HOME is not in the path, the CM server installation will fail to validate the Oracle connection details.

  • The Oracle administrator password doesn't contain a full stop (.), comma (,), or semicolon (;). If any of these characters are included, the CM server installer may fail to validate the Oracle connection details.

    Temporarily remove these characters from the password before installing.

Install into a remote SQL server If you are installing a CM server into a remote SQL server, you need to use an existing and preconfigured ODBC.
Install the Visual Studio 2017 integration

A bug in earlier versions of Visual Studio 2017 may cause the installation of the CM integration to fail.

Before installing or upgrading to the CM clients 14.5.2 or later, install the latest update to Visual Studio 2017.

UNIX CM server upgrade messages

After you upgrade Dimensions CM and Deployment Automation on UNIX to 14.5.2 or later, you can safely ignore the following messages:

com.installshield.sra.event.InstallScript, msg2, InstallScript.onReplacingcCoreFiles

com.installshield.sra.event.InstallScript, msg2, Tomcat was not found.

com.installshield.sra.event.InstallScript, msg2, InstallScript.onReplacingcCoreFiles

PulseUno data directory

Windows Server installation: The location of the PulseUno data directory may vary:

  • If you perform a new installation, the PulseUno data directory is:

    \ProgramData\Micro Focus\Dimensions CM\Pulse

  • If you upgrade from an earlier release, the PulseUno data directory is the same, for example:


Install on Solaris The Solaris installer requires JRE 1.8 or later.
Upgrade Dimensions CM with CM SSO

To upgrade a Dimensions CM installation configured to use the CM Single Sign-On Server (SSO):

  1. Stop Common Tomcat.

  2. Navigate to the Tomcat installation location.

  3. Rename the lib directory to lib.pre145.

  4. Rename the alfssogatekeeper directory to alfssogatekeeper.pre145.

  5. Perform the upgrade.

  6. After the upgrade has completed, navigate to the CM installation location. Verify that all occurrences of the SSO_STS_ENDPOINT variable in the %DM_ROOT%\dm.cfg configuration file contain the string localhost and not the host name of your machine.

Note: These steps are not required if the installation is configured to use Solutions Business Manager as the SSO server.

Upgrade Dimensions Connect for Solutions Business Manager (SBM)

Make sure to uninstall earlier versions of Dimensions Connect for SBM and then install version 14.5.3 before you upgrade the Dimensions CM server.

For example, if you upgrade the Dimensions CM server to 14.5.3, you must also install Dimensions Connect for SBM version 14.5.3. Otherwise, the integration may not work as expected. See the Dimensions CM Connect for SBM Guide.

ALF events configuration file

During installation or upgrade, a new version of the ALF events configuration file is installed for PulseUno:


Any customizations are overridden. But your original file is backed up, and you can merge your customizations into the new version.

Back to top

See also: