Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide

Generating a Distributed Authentication UI Server WAR File

To generate a Distributed Authentication UI server WAR file, use the jar command to extract the files from the opensso.war file and then to generate the specialized WAR file.

To Generate a Distributed Authentication UI Server WAR File

Before You Begin

If you have not already done so, download and unzip the opensso_enterprise_80.zip file. You will then need the following files:

zip-root/deployable-war/opensso.war is the OpenSSO Enterprise WAR file that contains all components, including the Distributed Authentication UI server files.
zip-root/deployable-war/fam-distauth.list specifies the files that are required to generate a Distributed Authentication UI server WAR file.
zip-root/deployable-war/distauth contains the additional files you will need to deploy and configure a Distributed Authentication UI server.

where zip-root is the directory where you unzipped the opensso_enterprise_80.zip file.

For more information about the opensso.war file, see Downloading OpenSSO Enterprise.

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

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

Create the Distributed Authentication UI server WAR using the files in fam-distauth.list:
```
# cd dastaging
# jar cvf zip-root/opensso/deployable-war/openssoDistauth.war \
   @zip-root/opensso/deployable-war/fam-distauth.list
```
where openssoDistauth.war is the name of the new Distributed Authentication UI server WAR file.

Note: Some web containers require the Distributed Authentication WAR file name to use the same name as the deployment URI.

Update the WAR file created in previous step with the additional files required for the Distributed Authentication UI server WAR. For example:
```
# cd zip-root/opensso/deployable-war/distauth
# jar uvf zip-root/opensso/deployable-war/openssoDistauth.war *
```
You are now ready to configure the new openssoDistauth.war, as described in the next section.