To Patch a Specialized OpenSSO WAR (Oracle OpenSSO 8.0 Update 2 Release Notes)

Oracle OpenSSO 8.0 Update 2 Release Notes

To Patch a Specialized OpenSSO WAR

Before You Begin

The existing specialized WAR file and the OpenSSO 8.0 update 2 specialized WAR file should already be created.

Note –

In the following example, the directory zip-root is the root directory for the unzipped contents of the currently deployed WAR file. The directory /u2 is the root directory for the unzipped contents of the upgraded version that will be deployed.

Create a manifest file for the existing specialized OpenSSO WAR.
1. Run ssopatch to create the OpenSSO manifest file.
  
  Example:
```
# cd /u2/opensso/tools/patch
# ./ssopatch -o zip-root/opensso/deployable-war/distauth.war --manifest 
/tmp/OpenSSO.manifest
```
  where opensso.war is an existing OpenSSO WAR file. The ssopatch utility creates a new manifest file named manifest in the /tmp directory.
2. To allow the WAR file to be patched, copy this new manifest file to the META-INF directory inside the opensso.war file.
  
  Example:
```
# cd zip-root/opensso/deployable-war
# mkdir META-INF
# cp /tmp/OpenSSO.manifest META-INF
# jar uf distauth.war META-INF/OpenSSO.manifest
# rm -rf /tmp/OpenSSO.manifest
```

Generate a manifest file for the updated specialized WAR file.

Example:

# cd /u2/opensso/tools/patch

# ./ssopatch -o /u2/opensso/deployable-war/distauth.war 
--manifest /tmp/OpenSSO.manifest 
cd ../../deployable-war

# mkdir META-INF
# cp /tmp/OpenSSO.manifest META-INF
# jar uf distauth.war META-INF/OpenSSO.manifest
# rm -rf /tmp/OpenSSO.manifest

Use the ssopatch utility to compare your old and new WAR files.

Example:

# cd /u2/opensso/tools/patch
# ./ssopatch -o zip-root/opensso/deployable-war/distauth.war 
-c /u2/opensso/deployable-war/distauth.war -override

Generate a staging area for the new specialized WAR file.

Example:
```
# cd /tmp/customized_staging
# jar cvf /patched/distauth.war *
```

Redeploy the /patched/distauth.war file to the web container using the original deploy URI.

Example, /distauth.