# Installation and Upgrade Guide

# Installing AquaLogic Interaction Content Service - Documentum

This chapter describes how to install AquaLogic Interaction Content Service - Documentum. The instructions are the same for Windows, UNIX, and Linux platforms, except where noted. To install Documentum CS:

1. Ensure that you have performed pre-installation procedures. For more information, see Pre-Installation Procedures.
2. Install product files on the Documentum CS host computer and the Image Service host computer. For more information, see Installing AquaLogic Interaction Content Service - Documentum.
3. Complete the post-installation procedures. For more information, see Configuring Documentum CS.

## Installation Procedure

AquaLogic Interaction Content Service - Documentum is implemented as a remote server in the context of the portal deployment.

To install product files:

1. Log in to the Documentum CS host computer using an administrator account that has access to the portal installation.

Alternatively, log in to any host using an administrator account that has access to the Documentum CS host and the portal installation.

2. Map a connection to the top-level folder for the portal installation.
3. Copy the installation package to a location on the Documentum CS host.
4. To launch the installer, click the ALIContentServiceDocumentum_v5-5.exe (Windows) or ALIContentServiceDocumentum_v5-5 (UNIX and Linux) file.
5. Complete installation wizard pages as described in the following table.

Note: | To facilitate any troubleshooting that might be required, as well as communication among IT staff and customer support, we recommend that you keep the default settings.
Table 3-1 Installation Wizard Pages
Wizard Page | Description
--- | ---
Introduction | Click Next.
Choose Components | Choose Content Service for Documentum to install the Documentum CS application files. Choose Image Service Files to install Documentum CS files for the Image Service. Then click Install.
Installation Folder | Click Next to accept the default value: On Unix and Linux: /opt/bea/alui On Windows: C:\bea\alui
Specify Image Service Folder | Click Choose and then browse to and select the ptimages directory on the Image Service host computer. The default is: On Unix and Linux: /opt/bea/alui/ptimages On Windows: C:\bea\alui\ptimages
Note: | This panel only appears when installing Image Service files. If you are not installing Image Service files, you will need to run the installer on the Image Service host computer to install the Image Service files.
Application Port | Specify the port that Documentum CS should use to handle requests. Indicate whether this should be HTTP or HTTPS. The default port is 11951.
Documentum Client Library | Type the full path to your Documentum Client Library. For Unix and Linux, this is the path to dfcbase.jar. For Windows, this is the path to dctm.jar.
Documentum config folder | Type the full path to your Documentum config folder.
Documentum shared folder | Type the full path to your Documentum shared folder.
Pre-Installation Summary | Verify the information in the panel and click Install.
Install Complete | The installation is complete. Click Done to finish.

6. Complete the steps on the Content Service for Documentum Installation Verification page. This page is located on your Documentum CS host computer, at http://<RemoteServer>:<port>/dctmcws/web/install/index.html. The Documentum CS must be running prior to navigating to this page. For details on starting the Documentum CS, see the following section, Starting and Stopping the BEA ALI Content Service for Documentum.

## Starting and Stopping the BEA ALI Content Service for Documentum

### To Start the Service in Windows

From the Service Control Manager, start the BEA ALI Content Service for Documentum.

Or, from the command line, run:

    $ <install base>\ptdctmcws\5.5\bin\ptdctmcsd.bat start

### To Start the Service in UNIX and Linux

From the command line, run:

    $ .<PT_HOME>/pthome.sh
    $ sh <install base>/ptdctmcws/5.5/bin/ptdctmcsd.sh start

Caution: | If your PT_HOME is a directory other than /opt/bea/alui, you will need to edit the file <PT_HOME>/pthome.sh so that PT_HOME is set to the correct value.

### To Stop the Service in Windows

From the Service Control Manager, stop the BEA ALI Content Service for Documentum.

Or, from the command line, run:

    $ <install base>\ptdctmcws\5.5\bin\ptdctmcsd.bat stop

### To Stop the Service in UNIX and Linux

From the command line, run

    $ sh <install base>/ptdctmcws/5.5/bin/ptdctmcsd.sh stop