Upgrading Service Registry from Java ES Release 4

This section includes information about upgrading Service Registry from Release 4 to Release 5. The section covers the following topics:

• Introduction to Upgrading Service Registry

• Release 4 Service Registry Upgrade

Introduction to Upgrading Service Registry

When upgrading Release 4 Service Registry to Release 5, consider the following aspects of the upgrade process:

• General Upgrade Approach. The upgrade is achieved by performing a fresh install of Release 5 Service Registry, migrating the Release 4 data and configuration to Release 5, and then removing Release 4 to conserve disk space.

• Upgrade Dependencies. Service Registry has dependencies on a number of Java ES shared components, as listed in Table 1–7. All of these shared components are automatically upgraded to Release 5 by the Java ES installer when you perform an Service Registry upgrade.

  In addition, Service Registry has a hard upgrade dependency on Application Server and Java DB.

• Backward Compatibility. Release 5 Service Registry is backwardly compatible with Release 4.

• Upgrade Rollback. A rollback of the Release 5 upgrade is achieved by reverting to Release 4 after restoring the saved database and configuration data.

Release 4 Service Registry Upgrade

This section describes how to perform a Java ES 4 Service Registry upgrade to Java ES 5. The section covers the following topics:

• Pre-Upgrade Tasks

• To Upgrade the Service Registry

• To Roll Back the Upgrade

Pre-Upgrade Tasks

Before you upgrade Service Registry, perform the following procedures:

• Backing Up Service Registry Data

• Upgrading Service Registry Dependencies

Backing Up Service Registry Data

The Service Registry upgrade from Release 4 to Release 5 does not modify configuration data or the registry and repository database. You do not have to back up current data.

Upgrading Service Registry Dependencies

All Java ES components on a computer system and in a computing environment should be upgraded to Java ES Release 5. Service Registry has hard upgrade dependencies on a number of shared components and on Application Server.

When upgrading Service Registry dependencies, you should do so in the order below, before you upgrade Service Registry. Upgrade of shared components is normally achieved automatically by the Java ES installer.

1. Shared Components.Release 5 installer automatically installs all required shared components in the parallel path.

2. Application Server. Instructions for upgrading Application Server to Release 5 are provided in Chapter 6, Application Server

To Upgrade the Service Registry

Before You Begin

• Obtain the user IDs, passwords, domain name, and port number for your Release 4 Service Registry.

1. Log in as administrator.

2. Stop the Release 4 Service Registry (Application Server) domain.

   cd ServiceRegistryR4-base\install

   ant -f build-install.xml appserver.domain.stop

3. Install Release 5 Service Registry.

   Use the Configure Manually After Installation option to install Java ES 5 Service Registry. For Service Registry installation instructions, see the Sun Java Enterprise System 5 Installation Guide for Microsoft Windows.

4. Update the Release 5 install.properties file.

   1. Set the jes.data.home property property in the install.properties file to point to the Release 4 install location.

   2. Set the soar.data.home property in the install.properties file to point to ServiceRegistryR4-base.

5. Perform post-install upgrade and configuration of the Release 5 Service Registry.

   cd ServiceRegistryR5-base\install

   ant -f build-install.xml upgrade

   The upgrade utility creates a new Application Server domain for Service Registry, starts the Service Registry domain and deploys the Service Registry. Each Service Registry is associated with its own Application Server domain.

6. Stop the Release 5 Service Registry (Application Server) domain.

   cd ServiceRegistryR5-base\install

   ant -f build-install.xml appserver.domain.stop

7. Update the Release 5 configuration data files with changes made to the Release 4 configuration data files.

8. Start the Release 5 Service Registry (Application Server) domain.

   cd ServiceRegistryR5-base\install

   ant -f build-install.xml appserver.domain.start

To Roll Back the Upgrade

1. Log in as administrator.

2. Stop and delete the Release 5 Service Registry (Application Server) domain.

   cd ServiceRegistryR5-base\install

   ant -f build-install.xml appserver.domain.stop appserver.domain.delete

3. Run the Release 5 uninstaller to uninstall Release 5 Service Registry.

4. Start the Release 4 Service Registry (Application Server) domain.

   cd ServiceRegistryR4-base\install

   ant -f build-install.xml appserver.domain.start