Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide

Planning Your Patch Operation

This section describes the general steps to patch an OpenSSO Enterprise 8.0 release. If you are installing the opensso.war file in an update release or patch as a new deployment, see Chapter 3, Installing OpenSSO Enterprise.

ProcedureTo Plan Your Patch Operation

  1. Check the patch and upgrade paths in Table 23–1.

  2. If you are not familiar with ssopatch, read the Overview of the ssopatch Utility.

  3. Before you install an OpenSSO Enterprise 8.0 update release or patch, check the information about the new features, hardware and software requirements, and issues and workarounds in the following documents:

  4. Download the lastest OpenSSO Enterprise update release or patch (patch ID 141655) from http://sunsolve.sun.com/.

  5. Check the README file associated with the patch for information such as the issues fixed in the patch.

  6. Install ssopatch for your platform, as described in Installing the ssopatch Utility.

  7. Determine if your existing WAR file has been customized or modified, by comparing your WAR file to its internal manifest file.

  8. Compare your existing WAR file and the update release WAR file, to return the files customized in the original WAR, files updated in the new WAR file, and files added or deleted between the two WAR versions.

  9. Backup your existing OpenSSO WAR file and configuration data.

  10. Patch your OpenSSO Enterprise WAR file, as described in Patching an OpenSSO Enterprise 8.0 WAR File.

  11. Run the updateschema script, as described in Running the updateschema Script.

OpenSSO Patch and Upgrade Paths

Table 23–1 OpenSSO Patch and Upgrade Paths

Release 

Patch or Upgrade Path 

Sun OpenSSO Enterprise 8.0 update release or patch 

  • Patching OpenSSO Enterprise 8.0 with an update release or patch using the ssopatch utility.

  • Patching the following OpenSSO Enterprise 8.0 specialized WAR files with an update release using the ssopatch utility:

    • OpenSSO Administration console only WAR file

    • Distributed Authentication UI server WAR file

    • OpenSSO server only WAR file, without the Administration Console

    • IDP Discovery Service WAR file

  • Patching an update release or patch with a newer update release or patch using the ssopatch utility.

  • Installing an OpenSSO Enterprise 8.0 update release or patch as a new deployment.

  • Creating and installing a new specialized WAR file from an OpenSSO Enterprise 8.0 update release or patch.

Sun Java System Access Manager 7.1 

Sun Java System Access Manager 7 2005Q4 

Sun Java System Federation Manager 7.0 

To go from Access Manager 7.x or Federation Manager 7.0 to an OpenSSO Enterprise 8.0 update or patch release: 

  1. Upgrade to OpenSSO Enterprise 8.0, as described in the Sun OpenSSO Enterprise 8.0 Upgrade Guide.

  2. Apply the update release or patch, as described in this chapter.