Install zLinux agents

Obtaining the executables‌

Obtain the installation software for the Dimensions CM for zLinux agents:

  • Download the UNIX files from the Support website.

  • Copy the contents of the installation DVD to a disk and maintain the directory layout structure.

Run the agent installer‌

  1. Extract the contents of the zLinux tar file.

    Tip: Capture the installer output into a "script" logfile, for example: 

    # script install_zliunx.log
# umask 022

    Exit script logging after completion of the zLinux installation by typing exit.

  2. Initiate the agent installer: 

    # ./install.sh
  Dimensions <version> - Installation Requirements

    Please ensure the following:

    • You are currently running from the root account.

    • An OS login id already exists for the Dimensions System Administrator.

    • The OS group 'dmtool' already exists for owning the Dimensions files.

Prompt Action
Do you want to continue? (Yes,No) [Yes]

  1. Enter Yes to continue. The license agreement is displayed in a UNIX "more" window.

  2. Read the license and quit the UNIX "more" window: q

Do you accept the terms of the license agreement (Yes,No) ? [No]

Type Yes to continue.

Dimensions <version> - Installation Type

Choose the installation type that best suits your needs. 

1- Agent

Installs only the Dimensions CM Agent files.
Select the number corresponding to the type of install you would like: [0] Type 1 to install the agent.
Enter the OS login id for the Dimensions System Administrator [dmsys] Press RETURN to accept the default login ID or enter an ID.
Please specify a directory or press Enter to accept the default directory [/opt/opentext/dimensions/<version>]

Press RETURN to accept the default directory or enter a directory name. 

Dimensions <version> is installed in the following
location:

/opt/opentext/dimensions/<version>

With the following features:

Dimensions CM Agent

For a total size:

100 MB

Using the following login id for the Dimensions System
Administrator: dmsys
Please confirm you want to proceed with these parameters (Yes,No) ? [No] Type Yes to continue. If logging to a "script" logfile, enter: # exit.

Check the agent installation

This section describes some quick checks that you can perform to establish that your agent installation is functioning. Full post-installation activities are described in Post-installation tasks.

To perform these checks, you need an evaluation license or a fully licensed version of Dimensions CM.

Start the listener as root user

  1. Log in as user root.

  2. Set up the Dimensions CM pcms_sdp network service. Either locally, or on a NIS server, edit the file /etc/services and add the following entry at the end:

    pcms_sdp<white-space><port>/tcp<white-space># <comment>

    This entry is required by the Dimensions CM listener.

    <port> default: 671

  3. Start the Dimensions listener:

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

      # cd /opt/opentext/dimensions/<version>/cm/prog

      The dmstartup script also exports the environment variables to the user root and runs this Bourne shell login script located in the root directory ($installdir):

      dmprofile

    2. Run the following command: 

      # ./dmstartup

    3. Check that the Dimensions CM processes have started: 

      # ps -eaf | grep dm

      Services such as dmlsnr and dmpool.x should be listed.

Start the listener as administrator or non-root user

  1. Log in to Dimensions.

    Some UNIX systems do not allow you to directly output X Window System programs to your local display. Export the display to another X Window System or run this command:

    $ ssh -X root@localhost

  2. Set up the Dimensions CM pcms_sdp network service. Either locally, or on a NIS server, edit the file /etc/services and add the following entry at the end of the file:

    pcms_sdp<white-space><port>/tcp<white-space># <comment>

    This entry is required by the Dimensions CM listener.

    <port> default: 671

  3. Log out and log back in as the Dimensions system administrator (by default dmsys).

  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 system administrator non-root user that is running the Dimensions listener on the Dimensions agent (typically dmsys.)

  6. Start the Dimensions agent listener:

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

      # cd /opt/opentext/dimensions/<version>/cm/prog

    2. Run the following command: 

      # ./dmstartup

  7. Check that the Dimensions CM processes have started: 

    # ps -eaf | grep dm

    Services such as dmlsnr and dmpool.x should be listed.

Stop the listener as administrator or non-root user

When an agent’s listener service is owned by the system administrator (by default dmsys), modify how it is shut down:

  1. Navigate to: 

    $installdir/prog

  2. Edit the file dmshutdown and modify this entry:

    ./stop_dimensions

    to:

    ./stop_dimensions -host <host_name>:<port_number>

    For example:

    ./stop_dimensions -host DMSERVER:1025

Verify the agent installation

See Verify server and agent installations.

Uninstall an agent

Uninstall a default installation

To uninstall an existing earlier default (root) installation of the agent:

  1. Go to the Dimensions CM prog directory:

    # cd $installdir/prog

  2. Run the following command to shutdown the listener: 

    # ./dmshutdown

  3. Delete the existing agent file hierarchy: 

    # rm -r $installdir

Uninstall a restricted mode installation

To uninstall an existing earlier restricted mode (dmsys) installation of the agent:

  1. Shut down the listener. For details, see Stop the listener as administrator or non-root user.

  2. Delete the agent file hierarchy: 

    # rm -r $installdir