Install Dimensions CM for Eclipse

Note: Dimensions CM clients are not required to install the Eclipse integration.

Install the Eclipse integration from a server

You can install the Eclipse integration from an update site hosted by the Dimensions CM server. The Tomcat eclipse.war file is added as part of the Dimensions CM server install.

You can use the same method to install Appcelerator Titanium Studio into Eclipse.

To install the Eclipse integration from a server:

  1. In Eclipse, go to Help > Install New Software. The Available Software dialog box opens.

  2. In the Work with box, enter the update sit URL:

    http(s)://<host>:<port>/eclipse

    where <host> and <port> point to the Tomcat installation.

    Caution: For security reasons, Eclipse 2023 and later doesn’t allow access to external upload sites that use HTTP protocol. To use an HTTP URL, add the following property as the last line to the eclipse.ini file in the Eclipse installation folder:

    -Dp2.httpRule=allow
  3. Select Dimensions Eclipse Interface and click Next.

    Note: You may need to deselect the Group by Category option to display the Dimensions Eclipse integration.

  4. On the Install Details screen, click Next.

  5. Accept the terms of the license agreement and click Finish.

  6. After the software has been installed, restart Eclipse.

Manually install the Eclipse integration 

Pre-installation tasks

If a previous version of Dimensions CM for Eclipse is installed, you need to uninstall it:

  1. As user root, navigate to:

    $installdir/integrations/Eclipse3.x/_Serena Dimensions for Eclipse_installation
  2. Launch the simple Eclipse uninstaller:

    ./uninstaller.jar
  3. Follow the uninstaller wizard instructions to remove the existing Eclipse integration.

    Note: To ensure that the existing Eclipse integration uninstalls successfully, check it is shut down.

  4. Delete the following directory:

    $installdir/integrations/Eclipse3.x

Install OpenText Dimensions CM for Eclipse manually

  1. Log in as user root.

  2. Navigate to and run the appropriate extracted downloaded file:

    • GUI mode:# ./setup<platform>.bin

    • Console mode:# ./setup<platform>.bin -console

Silently install Dimensions CM for Eclipse

To silently install Dimensions CM for Eclipse:

  1. Log in as user root.

  2. Navigate to one of the installer executables:

    • setup-windows.exe
    • setup-linux.bin
    • setup-mac.zip
  3. Copy the executable and associated files to the directory that you are using for the silent installer files. In a terminal window navigate to this directory.

  4. Run this command:

    setup-linux.bin -i silent

    You can optionally specify a response file from which the installer retrieves the variable values for the installation. To record your responses, specify -r fileName. To use the response file, specify -f fileName.

Note: The uninstaller is uninstaller.jar in the Dimensions for Eclipse installation directory.