test

Sun Java Communications Suite 5 Installation Guide

Access Manager SDK With Container Configuration Example

This example installs Access Manager SDK, using a copy of Access Manager that is already installed on a remote host.

Note –

To use this sequence example, also refer to known issue 6293225 in the Sun Java Enterprise System 5 Release Notes for UNIX.

Requirements

Before you install Access Manager SDK, the Access Manager core services must be installed and running on a remote host. The web container information and Directory Server configuration information that you provide in this installation example must match the web container and Directory Server configuration information that you provided during installation of Access Manager core services.

Note –

When the installer asks for information about the remote web container and Directory Server, default values are displayed based on the local host.

Do not accept the default values; use them only as examples of format. Instead, you must supply the correct information for the remote host.

The installer does not allow you to configure the web container when you are installing only the Access Manager SDK.

ProcedureTo Develop a Sequence for Host A

The following high-level tasks are required:

  1. Checking the installation sequence guidelines

    Check to see what guidelines apply to this example and make adjustments as needed.

  2. Checking the installation prerequisites

    Check to see what tasks you might need to perform for this installation before starting.

  3. Installing and starting Access Manager core services

    Identity Management Example

ProcedureTo Develop a Sequence for Host B

The following high-level tasks are required:

  1. Checking the installation sequence guidelines.

    Check to see what guidelines apply to this example and make adjustments as needed.

  2. Checking the installation prerequisites.

    Check to see what tasks you might need to perform for this installation before starting.

  3. Running the installer.

  4. At component selection, choosing Access Manager SDK.

  5. Resolving incompatibilities.

    The installer verifies software on your host and provides guidance if incompatibilities are identified.

  6. Selecting the Configure Later type.

  7. Running the installation.

  8. Viewing the Installation Summary and Log.

  9. Verifying that your web container is installed and running.

  10. Editing the amsamplesilent file.

    1. Make a copy the amsamplesilent file.

      Solaris: AccessManager-base/SUNWam/bin

      Linux: /opt/sun/identity/bin

    2. By default, many settings are commented out in the amsamplesilent file. Uncomment only the following settings:

      • SERVER_NAME

      • SERVER_HOST

      • SERVER_PORT

      • ADMIN_PORT

      • DS_HOST

      • DS_DIRMGRPASSWD

      • ROOT_SUFFIX

      • ADMINPASSWD

      • AMLDAPUSERPASSWD

      • COOKIE_DOMAIN

      • AM_ENC_PWD

      • NEW_OWNER

      • NEW_GROUP

      • PAM_SERVICE_NAME

      • WEB_CONTAINER

    3. Modify only the following parameters in the amsamplesilent file:

      • DEPLOY_LEVEL should be set to 4.

      • SERVER_HOST and SERVER_PORT should be set to the host and port of the full server which will be used by Access Manager SDK.

      • DS_HOST, DS_DIRMGRPASSWD, and ROOT_SUFFIX should be set to the hostname, directory manager password, and root suffix of the Host A Directory Server.

      • ADMINPASSWD and AMLDAPUSERPASSWD should be set to the amadmin and amldapuser passwords used on Host A.

      • AM_ENC_PWD should be set to the password encryption key used on Host A. For the Access Manager SDK, use the same encryption key for AM_ENC_PWD as the encryption key specified during the remote installation of Access Manager on Host B. Use one of the following commands to obtain this value:

        Solaris: grep pwd /etc/opt/SUNWam/config/AMConfig.properties

        Linux: grep pwd /etc/opt/sun/identity/config/AMConfig.properties

      • WEB_CONTAINER should be set to the corresponding value for the web container being used.

      • BASEDIR should be set to the install directory used during the Configure Later installation of Access Manager SDK.

      • AM_REALM should be set to Enabled if realm mode is used on Host A, and Disabled if legacy mode is used on Host A.

      • Find the settings corresponding to the web container that will be used for the SDK and modify these settings with the details of the web container. For example, if WEB_CONTAINER is set to WS (Sun Java System Web Server), then you should modify the settings which are prefixed by WS_ (WS_INSTANCE , WS_HOME, WS_PROTOCOL and so on.)

  11. As root, use the edited amsamplesilent file to deploy Access Manager.

    ./ amconfig -s ./am.sdk_install

  12. Restarting your web container