Deploying the OpenSSO Enterprise WAR File

Before you deploy the opensso.war, a supported web container must be deployed and configured, as described in Chapter 2, Deploying the OpenSSO Enterprise Web Container.

Then you deploy the OpenSSO Enterprise WAR (opensso.war) file using the web container administration console or deploy command.

If you plan to use the OpenSSO configuration data store, you must deploy OpenSSO Enterprise on a local file system and not on an NFS-mounted file system. The OpenSSO configuration data store, which is deployed with OpenSSO Enterprise, is not supported on an NFS-mounted file system.

To Deploy the OpenSSO Enterprise WAR (opensso.war) File

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

   • Access to the OpenSSO Enterprise web container administration console, if you plan to deploy opensso.war using the console.

     or

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

2. If necessary, copy opensso.war to the server where you want to deploy OpenSSO Enterprise.

3. Deploy opensso.war using either the web container administration console or deploy command.

   If the OpenSSO Enterprise web container administration console includes the option to deploy a WAR file, this method is usually the simplest one to use.

   Otherwise, use the web container deploy command. For example, the following command deploys opensso.war on the Application Server 9.1 web container on Solaris systems:

   # cd /opt/SUNWappserver/appserver/bin
   # ./asadmin deploy --user admin --passwordfile /tmp/pwdfile
   --port 4848 zip-root/opensso/deployable-war/opensso.war

   where:

   • zip-root is where you unzipped the opensso_enterprise_80.zip file. Or, if you copied opensso.war to a different location, use that location in the command.

   • /tmp/pwdfile is the Application Server 9.1 password file. This ASCII text file contains the AS_ADMIN_PASSWORD variable set to the administrator password.

Next Steps

Continue with the initial OpenSSO Enterprise server configuration using the Configurator:

Chapter 4, Configuring OpenSSO Enterprise Using the GUI Configurator

or

Chapter 5, Configuring OpenSSO Enterprise Using the Command-Line Configurator