# Installation and Upgrade Guide

# Installing AquaLogic Interaction Identity Service - LDAP

This section describes the following steps that allow for the successful installation and deployment of LDAP IDS:

1. Ensure that you have performed pre-installation procedures. For details, see Completing Pre-Installation Steps.
2. Install product files on the remote server host and the Image Service. For details, see Installing LDAP IDS.
3. Run a diagnostic test to verify successful installation. For details, see Verifying Deployment.

## Installing LDAP IDS

LDAP IDS is implemented as a remote server in the context of the portal deployment; you install the product on a remote server host computer that can communicate with the portal. For host requirements, see Hardware and Software Requirements.

Note: | For UNIX and Linux installations: the installer creates a new pthome.xml file in any install location that does not already contain the file. For that reason, you should install LDAP IDS in the same location as all other AquaLogic User Interaction components on the machine.

Note: | For UNIX and Linux installations: the installation wizard is a graphical application. If you run it interactively, you must do so from an X-windows client. If you are running remotely, for example in an xterm, make sure the DISPLAY environment variable is set correctly.

To install product files:

1. Log in to the host computer using an administrator account that has access to the portal installation.
2. Map a connection to the Image Service directory.
3. Copy the LDAP IDS installation package to a location on the remote server host.
4. To launch the installer, double-click the ALIIdentityServiceLDAP_v2-2.exe file.
5. Complete the installation wizard pages as described in the following table.

Note: | We recommend that you keep the default settings.
Table 3-1 Installation Wizard Pages
Wizard Page | Values
--- | ---
Introduction | Click Next.
Choose Server Type | Choose Remote Server to install files for LDAP IDS. Choose Image Service to install files for the Image Service.
Choose Installation Folder | Click Next to accept the default: Windows: C:\bea\alui UNIX and Linux: /opt/bea/alui
Specify Image Service Folder | Specify the location of your Image Service folder.
Note: | We recommend using: \ptimages
Application Port | Choose whether to use a secure HTTP protocol for the Web service (https) or a standard Web protocol (http). Also select your port number. The installer specifies the default port 11950. Make sure to enter the SSL port number if using https.
Pre-Installation Summary | Verify the information in the panel and click Install.

1. Click Done to exit the installer.
2. (Windows only) Reboot your computer and start the LDAP IDS using Administrative Tools | Services.
3. (UNIX and Linux Only) You must set the PT_HOME environment variable, where PT_HOME is the root directory for installed AquaLogic User Interaction products, and restart LDAP IDS before verifying installation:

1. Open a terminal window.
2. Type the commands:

    source <pt_home>/pthome.sh
    <pt_home>/ptldapaws/2.2/bin/ptldapawsd.sh restart

## Verifying Deployment

After you have deployed the LDAP IDS package, you can run a diagnostic utility to verify connectivity among deployment components.

To verify your deployment of the LDAP IDS package:

1. In a Web browser, open the URL for the remote server diagnostics utility, for example:

http://<remoteserver>:<port>/ldapaws/install/index.html

2. Complete the steps as described in the utility summary page to verify the correct configuration of deployment components.