Uninstall OpenText Dimensions CM

Introduction

  • Check that no Dimensions CM or RDBMS applications are running.
  • If you are uninstalling a server and client installed on the same machine, uninstall the clients first.

Stop Tomcat

If you are uninstalling a Dimensions CM server first shut down Tomcat:

  1. Log in as the Dimensions system administrator (the user who owns the Dimensions CM files). Default: dmsys

    Caution: Do not stop Tomcat as user root. It must be stopped by the DSA to shut down correctly.

  2. Stop the Common Tomcat:

    $ cd $installdir/../common/tomcat/<tomcat-version>/bin
    $ ./shutdown.sh
  3. To verify that Tomcat is not running check the process list for the tomcat process.

Shut down Dimensions CM

If you are uninstalling a Dimensions CM server or agent, first shut down Dimensions CM:

  1. Log in as user root.

  2. Give yourself the Dimensions CM environment variable values by running the appropriate Dimensions CM login script, for example:

    • Bourne Shell

      $ cd /opt/opentext/dimensions/<version>/cm
      $ . ./dmprofile
    • C Shell

      $ cd /opt/opentext/dimensions/<version>/cm
      $ source ./dmlogin
  3. Shut down Dimensions CM:

    1. Go to the Dimensions CM prog directory, for example:

      # cd /opt/opentext/dimensions/<version>/cm/prog
    2. Run this command:

      # dm_control cm_stop
  4. Check that the Dimensions CM processes have shut down:

    # ps -eaf | grep dm[pal]

    Services such as dmappsrv.x and dmpool.x should not be listed.

Uninstall components‌

Stop services

Stop the following services:

  • Dimensions CM: O

    penText Common Tomcat
    Dimensions Listener Service
    License Server
    Dimensions CM HTTP/S Connector
    
  • Oracle Enterprise:

    Oracle<oracle_service_name>TNSListener
    OracleService<oracle_service_name>
    
  • SQL Server Enterprise:

    SQL Service <instance_name>
    
  • PostgreSQL:

    Dimensions_Postgres_Service

Remove programs

  1. Depending on your version of Windows, open Add/Remove Programs or Programs and Features.

  2. Uninstall the following:

    Dimensions CM Web Client Native Components
    Dimensions CM Web Client Tools
    OpenText Common Tools
    Dimensions CM Agents
    Dimensions CM Clients
    Dimensions CM for Eclipse <version>
    Dimensions Make <version>
    Dimensions CM Server
    AutoPass License Server
    
  3. When you are prompted to remove shared files, click Yes to All. It is not recommended that any Dimensions file be shared with other products.

Undeleted files

Some files in the CM home folder may not be deleted. You can safely delete these files. For example:

  • Activity logs

  • Some configuration files

  • Database files

  • License files

  • Files that were active or being accessed by an active process

Undeleted registry keys

Some Dimensions CM installation-specific information is retained in the registry for reuse in subsequent installations. If you have removed all Dimensions CM products from your system you can remove this key and its contents:

HKEY_LOCAL_MACHINE\SOFTWARE\Serena\Dimensions\<version>

Uninstall the Eclipse integration

The Eclipse uninstaller requires Java. If you have Java version 7 or later, before uninstalling you must specify the path to LAX_VM:

  1. Open a command prompt and navigate to the location of the uninstaller.

  2. Run this command:

    setup-windows.exe LAX_VM "<path>"
    

    where <path> must be the physical location of Java and not the linked directory that redirects to the physical location.

    For example:

    setup-windows.exe LAX_VM "c:\program files
    (x86)\Java\jre1.9.0_66\bin\java.exe"

Manually uninstall Windows clients‌

If the automatic uninstallation procedure fails, you can manually uninstall the clients.

Clear up files

A failed automatic uninstallation procedure may not remove files. If these files do not contain data that you need to retain and you do not have a server installation on the same machine, complete the clearing up process by deleting the Dimensions CM folders %installdir% or %PCMS_ROOT%.

Clear up environment variable

Update your PATH environment variable to remove the CM element. The default path is:

C:\Program Files\OpenText\Dimensions <version>\cm\prog

Complete the uninstallation procedure

To complete the uninstallation procedure, reboot the Windows machine. This is especially important if you are going to reinstall any of the Windows client components that you have just uninstalled.