Silently install Windows agents and clients

You can invoke the agent or client installers with specific command-line parameters and use them on other Windows nodes to perform unattended cloned installations, known as "silent installations".

Silently install OpenText common tools

Note: The client installer requires a Java Runtime Environment (JRE) to be present.

  1. Log in as a user with local administrative privileges.

  2. Create a folder called common in the location for the silent installer files.

  3. Navigate to where the CM installer files are located and copy the common folder and its contents. Copy to the common folder in the silent installer location.

  4. Open a command prompt and navigate to the common folder in the silent installer location.

  5. Run this command:

    setupOpenTextCommonTools_win64.exe -silent -P  
      installLocation="<Common Tools install location>" -
      V IS_DESTINATION="<Common Tools install
      destination>" -V JRE_ONLY=TRUE
    

    For example:

    setupOpenTextCommonTools_win64.exe -silent -P
      installLocation="C:\Program Files\OpenText\common"
      -V IS_DESTINATION="C:\Program
      Files\OpenText\common" -V JRE_ONLY=TRUE

Important: The installation folder names must not include a trailing backslash (\). If they do, the double-quote are "escaped" and -V IS_DESTINATION="C:\Program is appended to the folder name that the installer attempts to use, causing the installation to fail.

Silently install clients

  1. Log in as a user with local administrative privileges.

  2. Navigate to the CM installer files and copy this file (located at the same level as the "common" folder):

    Dimensions_CM_Clients_<version>.exe
    
  3. Copy the file to the folder you are using for the client silent installer files (at same level as the "common" folder).

  4. Open a command prompt and navigate to the silent installer folder.

  5. Run one of these commands:

    • Full installation with default settings

      Note: The Visual Studio integration is installed only if Visual Studio is detected.

      "Dimensions_CM_Clients_<version>.exe" /s /v" /qn /log <log_dir>
         INSTALLDIR=<installation_dir>"

      For example:

      "Dimensions_CM_Clients_<version>.exe" /s /v" /qn /log
         \"C:\temp\install.log\"
         INSTALLDIR=\"C:\Program Files\OpenText\Dimensions
         <version>\CM\""

      The installer automatically restarts Windows. To restart Windows at a specific time add the REBOOT parameter:

      "Dimensions_CM_Clients_<version>" /s /v" /qn /log
         \"C:\temp\install.log\"
         INSTALLDIR=\"C:\Program Files\OpenText\Dimensions
         <version>\CM\" REBOOT=ReallySuppress"

    • Full installation with custom settings

      Enables you to specify clients. The Visual Studio for Dimensions integration must be specified last:

      "Dimensions_CM_Clients_<version>.exe" /s /v"/qn /log <log_dir>
        INSTALLDIR=<installation_dir>
        DM_COMPUTER_NAME=<local_host_id>
        DM_SERVER_HOST_NAME=<Dimensions CM_server_host_id>
        DM_DB_NAME=<database_name on_Dimensions CM_server>
        DM_DB_CONN=<database_connection_to
        _Dimensions CM_server_database> PORTNUMBER=<port_no>
        ADDLOCAL=<clients_spec> REBOOT=<reboot_param>"

      For example:

      "Dimensions_CM_Clients_<version>.exe" /s /v"/qn /log
        \"C:\temp\install.log\" INSTALLDIR=\"C:\Program
        Files\OpenText\Dimensions <version>\CM\"
        DM_COMPUTER_NAME=\"idd-vmbigxp2\" DM_SERVER_HOSTNAME=\"prodserver\"
        DM_DBNAME=\"cm_typical\" DM_DB_CONN=\"dim14\"
        PORTNUMBER=\"8080\"
        ADDLOCAL=AdminTools,CMShellExtension,Configuration_Files,
        DesktopClient"

    Note:  

    • See below for the full list of silent install command parameters.

    • If you do not specify an installation folder, the default is:

      C:\Program Files\OpenText\Dimensions <version>\CM
    • DM_COMPUTER_NAME specifies the host-id of the local client machine.

    • DM_SERVER_HOSTNAME, DM_DB_NAME, and DM_DB_CONN are used to prepopulate the client login dialog boxes.

  6. Check the log file to confirm that the clients have successfully installed.

Silent install command parameters

Parameter Description
/s Uses silent mode during the installation.
/v Allows the exe file to pass the parameters listed to the embedded msi file.
/qn Specifies that silent mode is used. You can initially run the command without this parameter to check for any mistakes in your command.
/log Specifies the log file to be created. Any folder specified must already exist. You should inspect this log after installation to confirm that the clients installed successfully.
INSTALLDIR

Specifies the folder in which to install the clients. Must end with the sub-folder CM\.

  • The folder specification should include a trailing backslash (\).

  • For upgrades, you must specify the existing installation folder.

DM_COMPUTERNAME Specifies the host-id of the computer on which the clients are installed.
DM_SERVER_HOSTNAME Specifies the host-id of the computer on which the server is located.
DM_DB_NAME Specifies the server database to be used by the clients (for example cm_typical)
DM_DB_CONN Specifies the database connection-id to be used by the clients (for example dim14).
PORTNUMBER Specifies the port number to be used by the OpenText Common Tools. Default: 8080
ADDLOCAL

Lists the clients to be installed. If you reduce the list to limit functionality you may receive an error indicating that some required DLLs are not found. To resolve this issue modify the ADDLOCAL to include the required components, for example:

ADDLOCAL="Configuration_Files,PC_Client,DesktopClient
,Project_Merge"
  • Required

    (Mandatory) Core configuration, message, and binary files.

  • AdminTools

    The parent feature of SCC_Integration, VsMigration, and Dmpmcli. This parameter, and each child feature that you want to install, must be specified. For example:

    ADDLOCAL=\"AdminTools,
    SCC_Integration,VsMigration,Dmpmcli\"
  • CMShellExtension

    Windows Explorer shell extension. For Windows 64-bit add CMShellExtension_64Bit.

  • Configuration_Files

    (Mandatory) Configuration files required by the ADDLOCAL components.

  • DesktopClient

    The Dimensions desktop client (pcwin.exe).

  • DesktopShortcuts

    Desktop shortcuts for the web client and OpenText PulseUno only.

  • DesktopClientShortcut

    Desktop shortcut for the desktop client only.

  • Developers_Toolkit

    The Developer's Toolkit.

  • Dmpmcli

    Dimensions CM process modeling scripting interface.

  • ISScript

    Script files internal to the installer.

  • Make

    Dimensions CM Make.

  • Araxis_Merge

    Araxis Merge tool only.

  • Serena_Merge

    File Merge Tool only.

  • PCClientServerFiles

    Copies server files required by the desktop client.

  • Project_Merge

    Project Merge Tool.

  • SCC_Integration

    The Dimensions SCC integration.

  • VSIP

    Visual Studio integration. Must be specified last in the ADDLOCAL list.

  • VsMigration

    Visual Studio migration tool.

  • The following parameters are also mandatory:

    Toolkit_Shared_Lockable
    Transfer_Common_Files
REINSTALL For upgrades, specifies existing clients to be upgraded. Use ADDLOCAL to add clients during an upgrade.
REBOOT "REBOOT=ReallySuppress" prevents an automatic restart at the end of the installation. However, to use the clients a restart is required.

Silently install the shell extension on 64-bit Windows

The shell extension on Windows 64-bit is a separate installer that must be run at the end of the client installation. For silent installations, this is a manual procedure.

Adding CMShellExtension_64Bit to the ADDLOCAL property copies the required files to the DMROOT\cmShell64 folder. You can launch the extension installer silently after the client installation has successfully completed using this command:

msiexec /qn /i
  "[DMROOT]\cmShell64\Serena_Dimensions_Shell_Explorer_
  64-bit.msi" INSTALLDIR="[DMROOT]"

If you are upgrading the client, uninstall the current cmshell64 before installing the new one:

  • CM 14.1 only:

    uninstall {A8959131-E26B-4A4D-BB9D-2FDF11243921} 
    "64-bit Dimensions Shell Integration"
  • All other versions of CM:

    uninstall {EC683EBB-5AD5-4F05-B626-F3A0B2F37636} 
    "64-bit Dimensions Shell Integration"

Silently install an agent

Note: You do not need to pre-install the OpenText Common Tools.

  1. As a user with local administrative privileges, navigate to the CM installer files and copy this file:

    Dimensions_CM_Agents_<version>.exe
  2. Copy the file to the folder with the agent silent installer files.

  3. In a command prompt, go to the agent installer folder.

  4. Run this command:

    Dimensions_CM_Agents_<version>.exe" /s /v" /qn /log 
      <log_dir> INSTALLDIR=<installation_dir>"

    For example:

    "Dimensions_CM_Agents_<version>.exe" /s /v" /qn /log
      \"C:\temp\install.log\" INSTALLDIR=\"C:\Program
      Files\OpenText\Dimensions <version>\CM\""