Install a Windows agent‌

  1. Run the agent installer. Read and accept the license agreement.

  2. (Optional) Select the Deployment Automation agent feature.

  3. Accept the default installation folder or select a different one.

  4. Enter the host name and port number of the server that provides auto update install packages.

  5. To configure the installation of a Deployment Automation agent:

    • Specify the name of a DA agent process.

    • (Optional) Select Server Mutual Authentication if you want the agent to use mutual authentication with SSL when connecting to the Deployment Automation server.

    • (Optional) Connect to an agent relay instead of directly to the Deployment Automation server. Specify the following parameters for the agent relay:

      • Host name or address. Default: localhost

      • Communication port. Default: 7916

      • HTTP proxy port: Default: 20080

    If you are connecting directly to a Deployment Automation server, specify:

    • The host name or address of the server.

    • The Java Message Service (JMS) communication port. Default: 7918

    For details about installing and using DA, see Support.

  6. Click Install. When the installation is complete, click Finish.

Check the agent installation

Installation Logs

Check the installation logs before running any tests:

%installdir%\InstallTemp

Agent acceptance tests

Note: To perform these tests you require access to a server.

  1. As a user with local administrative privileges open Windows Services.

  2. Check that the OpenText Dimensions CM Listener Service has the Status Started and Startup set to Automatic.

    If the listener service fails to start automatically, start it manually after the RDBMS database service has started.

  3. Open the Windows task manager and check for the following:

    Dimensions CM processes:
dimensions_service.exe
dmlsnr.exe
dmpool.exe

  4. At a command prompt, enter dmcli and log in to CM. The output should be a Dimensions CM banner and copyright message followed by a Dimensions> prompt.

  5. Enter exit.

Start the listener

By default the agent listener service is owned by the user with local administrative rights who installed Dimensions CM. You change the owner of the Dimensions system administrator.

  1. Log in as a user with local Windows administrative rights and open Services.

  2. Shut down the OpenText Dimensions CM Listener Service.

  3. Log out as the user with local Windows administrative rights and log back in as the Dimensions system administrator.

  4. Navigate to: 

    %installdir%\dfs

  5. Edit the file listener.dat and add the following entries: 

    -user <DSA_username>
-restricted_mode

    where <DSA_Username> is the Dimensions system administrator that runs the listener on the agent.

  6. Restart the OpenText Dimensions CM Listener Service service.

Note:  

  • When running an agent in restricted mode, area and remote node authentication credentials are not used. Files in a remote area are owned by the user running the dmpool process regardless of which user-id is set for the area or userid specified in Remote Node Authentication.

  • Edit the Dimensions Listener Service so that it starts as the chosen non-administrator user.