Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide

Deploying and Configuring the Console Only WAR File

OpenSSO Enterprise includes the Console only WAR File Configurator (Configurator.jsp) to configure a Console only WAR file.

ProcedureTo Deploy and Configure the Console Only WAR File

  1. Login as a user who has the following privileges:

    • Access to the web container administration console, if you plan to deploy consoleonly.war using this console.

      or

    • The capability to execute the web container's deploy command-line utility, if you plan to deploy consoleonly.war using the CLI.

  2. Deploy consoleonly.war using either the web container administration console or CLI.

  3. Launch the Configurator using the following URL:

    protocol://host.domain:port/console
    

    For example: http://host.example.com:8080/console

    If the Console only deployment is not already configured, you will be directed to the Configurator page. (If the deployment is already configured, you will be directed to the login page.)

  4. On the Configurator page, specify the following information:

    • Server Protocol is the OpenSSO Enterprise server protocol: http or https. Default: http

    • Server Host is the fully qualified host name of the system where OpenSSO Enterprise server is deployed.

    • Server Port is the OpenSSO Enterprise server port number. Default: 58080

    • Server Deployment URI is the URI prefix for accessing the HTML pages, classes, and JAR files associated with OpenSSO Enterprise server.

      Important: This value must include the leading slash (/).

    • Application user name is the user name for the Console only application.

    • Application user password is the password of the user for the application.

    • Administration Console Protocol is the protocol (http or https) used by the Console only server web container. Default: http

    • Administration Console Host is the fully qualified host name where the Console only server is deployed.

    • Administration Console Port is the port number for the Console only server is deployed.

    • Administration Console Deployment URI is the deployment URI Console only server. Default: /console

    • Administration Console Debug directory is the directory where the debug files will be created.

  5. After you have specified all configuration values (or accepted the default values), click Configure.

    (Or, to reset all values, click Reset.)

Next Steps

After the configuration finishes, you will get a message showing the location of the Console only configuration file. This file is created in the home directory of the runtime user who owns the web container instance on which Console only WAR file is deployed.

Important: It is highly recommended that you change the permissions of this configuration file to limit access to the sensitive configuration information.