Upgrading to a newer Waveset release might require changes to the platform in your environment. You can determine the best upgrade path and estimate the complexity of the upgrade by assessing and documenting your Production environment.
This section describes the steps that you perform when reviewing your Production environment:
If you use source control and CBE to manage this information, these can serve as the documentation for your Waveset installation and for your custom components. Review the information and familiarize yourself with the various environments in which you deploy your Waveset application, giving particular attention to your Production environment.
To determine the best upgrade path, use the worksheets provided in Chapter 7, Assessment Worksheets to inventory the components of your current platform, including the following:
Verify that you are using the correct version of these components for the upgrade version that you want to install. Check Supported Software and Environments in Oracle Waveset 8.1.1 Release Notes for details.
If you are using an Oracle repository, the Waveset repository DDL uses data types that are not properly handled by older Oracle JDBC drivers. The JDBC drivers in ojdbc14.jar do not properly read all of the columns in the log table.
You must upgrade to the ojdbc5.jar for JDK 5 drivers for Waveset to work properly.
Record the application server version, and note any additional patches or service packs. In addition, record the following:
Operating system version and any additional patches or service packs.
Java Development Kit (JDK) version required by your application server. When upgrading Waveset, you must use a JDK supplied by the same vendor.
Record the database server version, and note any additional patches or service packs.
Verify which Waveset Gateway version you are running by performing the following steps:
Open a command window and execute the following command on each of the Gateway servers:
gateway -v |
Record the results.
Record the operating system version of each Gateway server.
The Gateway server version should always be the same as the Waveset version.
Record the currently installed JRE version required by the lh console. Also record the name of the vendor that supplied the installed JRE (for example, Sun, IBM, Oracle, and so on). When upgrading Waveset, you must use a JRE supplied by the same vendor.
Record supported resource names and versions, and note any additional patches or service packs.
Record the Web server version, and note any additional patches or service packs.
To determine the best upgrade path, use the worksheets provided in Chapter 7, Assessment Worksheets to inventory the components of your current Waveset installation.
The following sections describe methods for collecting this information:
To verify the version number of your current Waveset installation, use the Waveset Console .
Waveset provides the following utilities to list and record your installation information:
installed Utility: Searches the $WSHOME/bin directory for manifests and provides version information for releases, patches, service packs, and hotfixes.
inventory Utility: Inspects the file system for files that were added to or deleted from the system, using files that are packaged in the release. This utility determines which files were changed based on the manifest that shipped with Waveset.
To access the installed and inventory utilities, follow these steps:
Open a command window and change directories to $WSHOME/bin.
At the prompt, execute the following command:
At the prompt, type one of the following commands:
installed [option] [option]...
inventory [option] [option]...
The following tables describe the options that you can use with the installed and inventory utilities.
installed Utility Options
Option |
Function |
Description |
---|---|---|
-h |
Help |
Displays usage. |
-r |
Releases |
Displays only installed releases. |
-p |
Patches |
Displays only installed patches. |
-s |
Service packs |
Displays only installed service packs. |
-f |
Hotfixes |
Displays only installed hotfixes. |
Be sure to record the manifest file names that are associated with all service packs or patches. For example:
Identity_Manager_8_0_0_0_20080530.manifest |
inventory Utility Options
Option |
Function |
Description |
---|---|---|
-a |
Added |
Displays only added files. |
-d |
Deleted |
Displays only deleted files. |
-h |
Help |
Displays usage. |
-m |
Modified |
Displays only modified files. |
-u |
Unchanged |
Displays only unchanged files. |
Use the worksheets provided in Chapter 7, Assessment Worksheets to inventory your custom components, including the following:
If you are using the Identity Manager IDE or an older version Consolidated Build Environment (CBE), these component customizations should already be part of your baseline. In this case, the CBE baseline serves as your documentation.
If your current Waveset installation has a large amount of custom work, contact Sun Professional Services for assistance with your upgrade.
Version 7.1 and version 8.0 of Waveset made significant changes to the Waveset database table definitions.
If you previously modified the database table definitions for the Waveset repository, you must decide whether to make the same modifications to the new and updated tables.
You might need to update your customized file system objects to enable them to function properly with later Waveset releases. List any customized file system object names that are in your environment as explained in the following sections.
Recent Waveset versions might contain API changes. If you have modified .jsp files in your installation, you might have to update them when upgrading. You must update any JSP that was supplied by Waveset and changed during a deployment (or a custom JSP that uses Waveset APIs) to work with the new JSP structure and API changes for the target release.
For a detailed description of API changes, see the Waveset Release Notes for the release to which you are upgrading.
Use the inventory -m command (described on Waveset Assessment Tools) to identify any JSP modifications made in your deployment.
For more information about JSP customizations, see Chapter 11, Editing Configuration Objects, in Sun Identity Manager 8.1 Technical Deployment Overview.
Record any changes that you made to the default Waveset.properties file.
Record any changes that you made to the default WPMessages.properties file.
Record any changes that you made to other property files on your system.
You might have to recompile your custom resource adapters, depending on the target Waveset version. All custom Java code that uses Waveset APIs (including custom resource adapters) requires a recompile during upgrading. Also, consider other Java classes that use the Waveset library.
Record any changes that you made to the Waveset stylesheets.
You might have to maintain customized repository objects to enable them to function properly with target Waveset releases. Record any customized repository objects that are in your environment as explained in the following sections.
You can use the Waveset SnapShot feature to create a baseline or snapshot of the customized repository objects in your deployment, which can be very useful when planning an upgrade. See Step 5: Take a Snapshot for more information.
You might have to update customized forms to take advantage of current product enhancements.
You might have to update customized workflows to take advantage of current product enhancements.
You might have to export customized email templates to take advantage of current product enhancements.
Significant schema changes occurred between Version 7.0 and Version 8.0 of Waveset. If you are upgrading from an earlier version of Waveset, you must update your schema.
Record the names of any other custom repository objects that you created or updated. You might have to export these objects from your current installation and then reimport them to the newer version of Waveset after upgrading.
Admin group |
Resource form |
Admin role |
Role |
Configuration |
Rule |
Policy |
Task definition |
Provisioning task |
Task template |
Remedy configuration |
User form |
Resource action |
|
The SPML 2.0 implementation in Waveset changed in version 8.0. In previous releases, the SPML objectclass attribute used in SPML messages was mapped directly to the objectclass attribute of Waveset User objects. The objectclass attribute is now mapped internally to the spml2ObjectClass attribute and is used internally for other purposes.
During the upgrade process, the objectclass attribute value is automatically renamed for existing users. If your SPML 2.0 configuration contains forms that reference the objectclass attribute, you must manually change those references to spml2ObjectClass.
Waveset does not replace the sample spml2.xml configuration file during an upgrade. If you used the spml2.xml configuration file as a starting point, be aware that this file contains a form with references to objectclass that you must change to spml2ObjectClass. Change the objectclass attribute in forms (where it is used internally), but do not change the objectclass attribute in the target schema (where the attribute is exposed externally).
You can use the Waveset SnapShot feature to copy the following, specific object types from your system for comparison:
AdminGroup |
ResourceAction |
AdminRole |
Resourceform |
Configuration |
Role |
EmailTemplate |
Rule |
Policy |
TaskDefinition |
ProvisionTask |
TaskTemplate |
RemedyConfig |
UserForm |
For specific instructions, see Step 5: Take a Snapshot.