Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide

Generating a Console Only WAR File

To generate a console only 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 Console Only WAR File

Before You Begin

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 console files.
zip-root/deployable-war/fam-console.list specifies the files that are required to generate a console only WAR file.
zip-root/deployable-war/console contains additional files you will need to deploy and configure the console.

where zip-root is 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 JDK 1.5 or later.

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

Create the Console only WAR using the files in fam-console.list:

# cd consolestaging
# jar cvf zip-root/opensso/deployable-war/consoleonly.war \
   @zip-root/opensso/deployable-war/fam-console.list

where consoleonly.war is the name of the new Console only WAR file.

Update the WAR file created in previous step with the additional files required for the specific Console only WAR. For example:
```
# cd zip-root/opensso/deployable-war/console
# jar uvf zip-root/opensso/deployable-war/consoleonly.war *
```
You are now ready to configure the new consoleonly.war, as described in the next section.