Sun OpenSSO Enterprise 8.0 Developer's Guide

Creating Specialized OpenSSO Enterprise WAR Files

You can use the opensso.war file to create these specialized WAR files:

Distributed Authentication UI server
OpenSSO Administration Console only
OpenSSO Enterprise server without the Administration Console
IDP Discovery Service

If you have not already done so, download and unzip the opensso_enterprise_80.zip file. You will then need the following files in the zip-root/deployable-war directory to create a specialized WAR file, where zip-root is where you unzipped the opensso_enterprise_80.zip file:

opensso.war contains all OpenSSO Enterprise components.
fam-distauth.list, fam-console.list, fam-noconsole.list, or fam-idpdiscovery.list contain a list of files required to create a specialized WAR file.
distauth, console, noconsole, and idpdiscovery directories contains the additional files you will need to create, deploy, and configure a specialized WAR file.

To Create a Specialized OpenSSO Enterprise WAR File

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

Create a staging directory and extract the files from opensso.war in this staging directory. For example:
```
# mkdir opensso-staging
# cd opensso-staging
# jar xvf zip-root/opensso/deployable-war/opensso.war
```

Create the new specialized WAR file, as follows:
```
# cd opensso-staging
# jar cvf zip-root/opensso/deployable-war/new-war-filename.war \
   @zip-root/opensso/deployable-war/war-file.list
```
- new-war-filename is the name of the new WAR file. For example: opensso-distauth.war, opensso-idpdiscovery.war, opensso-consoleonly.war, or opensso-noconsole.war.
  
  Note: Some web containers require the Distributed Authentication UI server WAR file name to use the same name as the deployment URI. Check with your web container documentation for more information.
- war-file.list specifies the list of files required for the new WAR file, as follows: fam-distauth.list, fam-console.list, or fam-noconsole.list, or fam-idpdiscovery.list.

Update the WAR file created in previous step with the additional files required for new specialized WAR file. For example:
```
# cd zip-root/opensso/deployable-war/specialized-files-directory
# jar uvf zip-root/opensso/deployable-war/new-war-filename.war *
```
- specialized-files-directory specifies the directory where the additional files reside:
  - distauth
  - console
  - noconsole
  - idpdiscovery
- new-war-filename is the name of the new specialized WAR file.

Next Steps

You are now ready to deploy and configure the new specialized WAR file. For the detailed steps, see the following chapters: