Sun OpenSSO Enterprise 8.0 Developer's Guide

Customizing and Redeploying opensso.war

The opensso.war file contains all OpenSSO Enterprise components. To customize OpenSSO Enterprise, you must update and redeploy this file.

If you have not already done so, download and unzip the file. The opensso.war file is then in the zip-root/deployable-war directory, where zip-root is where you unzipped the file.

ProcedureTo Customize and Redeploy opensso.war

  1. Make sure that your JAVA_HOME environment variable points to a JDK of version 1.5 or later.

  2. Create a staging directory for your customized WAR file. For example:

    # mkdir customized-opensso
  3. In the staging directory, extract the files from opensso.war:

    # cd customized-opensso
    # jar xvf zip-root/opensso/deployable-war/opensso.war
  4. Customize the files required for your deployment.

  5. Create the new customized WAR file:

    # cd customized-opensso
    # jar cvf zip-root/opensso/deployable-war/customized-opensso.war

    In this example. customized-opensso.war is the name of the new customized OpenSSO Enterprise WAR file.

  6. Deploy and configure the new customized OpenSSO WAR file in your specific web container, as described in the Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide.