Sun OpenSSO Enterprise 8.0 Developer's Guide

Deploying the OpenSSO Enterprise WAR File

OpenSSO Enterprise Deployment Considerations

Before you deploy the OpenSSO Enterprise WAR file, here are a few changes to consider from previous releases of Access Manager and Federation Manager:

ProcedureTo Deploy the OpenSSO Enterprise Server WAR File:

The following procedure summarizes the OpensSSO Enterprise WAR file deployment. Links are provided to the detailed steps in the Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide.

  1. If necessary, install, configure, and start one of the supported web containers listed in Chapter 2, Deploying the OpenSSO Enterprise Web Container, in Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide.

  2. Download and unzip the file from one of the following sites:

    Be sure to check the Sun OpenSSO Enterprise 8.0 Release Notesfor any current issues.

  3. Deploy the opensso.war file to the web container, using the web container administration console or deployment command.

    Detailed steps are in Chapter 3, Installing OpenSSO Enterprise, in Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide.

  4. Run either the GUI or command-line Configurator.

    To run the GUI Configurator, enter the following URL in your browser:


    For example:

    If you are running the GUI Configurator, enter values in the Configurator fields or accept the default value for some fields. The GUI Configurator has two configuration options:

    • The Default Configuration option requires you to enter only the OpenSSO Enterprise administrator (amAdmin) and default policy agent (UrlAccessAgent) passwords. The Configurator then uses default values for the other configuration options.

      Use the Default Configuration for development environments or simple demonstration purposes when you just want to evaluate OpenSSO Enterprise features.

    • The Custom Configuration option allows you to enter specific configuration values for your deployment (or accept the default values).

      Use the Custom Configuration for production and more complex environments. For example, a multi-server installation with several OpenSSO Enterprise instances behind a load balancer.

    Detailed steps for configuring OpenSSO Enterprise are in:

  5. Launch OpenSSO Enterprise using the specific web container console or deployment command, or by specifying the URL from Step 4 in your browser.

  6. Login to the Console as the OpenSSO Enterprise administrator (amadmin) using the password you specified when you ran the Configurator.

  7. To make additional configuration changes to your deployment, use the OpenSSO Administration Console or the ssoadm command-line utility.

    For information, refer to the OpenSSO Administration Console Online Help or the Sun OpenSSO Enterprise 8.0 Administration Reference.