Sun Java Enterprise System 5 Update 1 Upgrade Guide for Microsoft Windows

Chapter 10 Service Registry

This chapter describes how to upgrade Service Registry from Java ES 5 (Release 5) to Java ES 5 Update 1 (Release 5U1): Service Registry 3.1 Update 1.

This chapter covers the following topics


Note –

File locations in this chapter are specified with respect to directory paths referred to as ServiceRegistryR4-base and RegistryDomainR4-base (Java ES Release 4 Service Registry), and ServiceRegistryR5-base and RegistryDomainR5-base (Release 5 and 5U1 Service Registry). At least part of these paths might have been specified as installation directories when Service Registry was installed. If not, the Java ES installer assigned a default value. The default values of these directory paths are:

ServiceRegistryR4-base

C:\Sun\ServiceRegistry

DomainRegistryR4-base

C:\Sun\ServiceRegistry

ServiceRegistryR5-base

C:\Program Files\Sun\JavaES5\srvc-registry

DomainRegistryR5-base

C:\Program Files\Sun\JavaES5\srvc-registry


Overview of Service Registry Upgrade

This section describes the following general aspects of Service Registry that impact upgrading to Java ES 5 Update 1 :

About Java ES 5 Update 1 Service Registry

Release 5U1 Service Registry represents a maintenance release that fixes bugs in Release 5 Service Registry. Release 5 Service Registry was a minor feature release with respect to Release 4 Service Registry. It included some improved functionality, updated interfaces, and selected bug fixes.

Service Registry Upgrade Roadmap

The following table shows the supported Service Registry upgrade paths to Java ES 5.

Table 10–1 Upgrade Paths to Java ES 5 Update 1: Sun Java System Service Registry 3.1u1

Java ES Release  

Service Registry Release  

General Approach 

Reconfiguration 

Release 5 

Sun Java System Service Registry 3.1 

Maintenance upgrade. Apply patches. 

None 

Release 4 

 

Direct upgrade of Service Registry from Release 4 to Release 5U1 is not supported. This upgrade path is supported by first upgrading Release 4 Service Registry to Release 5 Service Registry and then upgrading Release 5 to Release 5U1. The information about upgrading Release 4 to Release 5 is documented in Sun Java ES 5 Upgrade Guide for Microsoft Windows.

 

Service Registry Data

The following table shows the type of Service Registry data.

Table 10–2 Service Registry Data Usage

Type of Data 

Location  

Usage 

Installation Parameters 

ServiceRegistryR-base\install\install.properties

Configuration of Service Registry  

Trusted certificates  

ServiceRegistryR-base\install\cacerts

Certificates trusted by Service Registry that are not part of the Application Server installation  

Configuration data  

RegistryDomainR-base\domains\registry\applications\j2ee-modules\soar\WEB-INF\classes\*.properties

Configuration of Service Registry instance 

Registry/repository data 

RegistryDomainR-base\3.1\data

Database and user certificates  

Web interface configuration  

RegistryDomainR-base\3.1\jaxr-ebxml

Configuration of web interface 

Service Registry Compatibility Issues

Release 5U1 Service Registry is backwardly compatible with Release 5 Service Registry.

Service Registry Dependencies

Service Registry dependencies on other Java ES components can impact the procedure for upgrading and reconfiguring Service Registry software. Changes in Service Registry interfaces or functions, for example, could require upgraded version of components upon which Service Registry depends. The need to upgrade such components depends upon the specific upgrade path.

Service Registry has dependencies on the following Java ES components:

Upgrading Service Registry from Java ES 5

This section includes information about upgrading Service Registry from Java ES 5 to Java ES 5 Update 1 . The section covers the following topics:

Introduction

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

Release 5 Service Registry Upgrade

This section describes how to perform an upgrade of Service Registry from Java ES Release 5 to Release 5U1. This section covers the following topics:

Pre-Upgrade Tasks

Before you upgrade Web Server, perform the tasks described below.

Upgrade Service Registry Dependencies

It is generally recommended that all Java ES components on a computer system (and in a computing environment) be upgraded to Release 5U1. Release 5U1 Service Registry has hard upgrade dependencies on Application Server and Java DB, so these should be upgraded before upgrading Service Registry. Service Registry also requires that Windows Installer patch (126910–02) is already applied.

Backing Up Service Registry Data

The Service Registry upgrade from Release 5 to Release 5U1 does not modify the Release 5 configuration data. You do not need to back up current data.

Upgrading Release 5 Service Registry

This section discusses considerations that impact the upgrade procedure for Web Server, followed by a description of the procedure itself.

Upgrade Considerations

The upgrade of Service Registry software to Java ES Release 5U1 takes into account the following considerations:

Table 10–3 Patches1 to Upgrade Service Registry on Windows

Description 

Patch ID [Patch revision numbers are the minimum required for upgrade to Release 5U1. If newer revisions become available, use the newer ones instead of those shown in the table.]

Service Registry core 

125443–09 

Service Registry Localization 

The localized patch files are delivered within the core patch. 

Upgrade Procedure

The procedure documented below applies to Service Registry instances residing locally on the computer where the upgrade is taking place.

ProcedureTo Upgrade Service Registry to Java ES 5 Update 1

  1. Log in as administrator.

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

    ServiceRegistryR5–base\install\ant -f build-install.xml appserver.domain.stop

  3. Make sure you have upgraded any Java ES components upon which Service Registry has hard upgrade dependencies (see Upgrade Service Registry Dependencies).

  4. Obtain the required Service Registry Release 5U1 upgrade patches, based on Table 10–3.

  5. Install the patch.

    Installation is generally performed by running patch-id.exe, however, be sure to consult the README.patch-id file in the patch directory for installation instructions.


    Note –

    If you are prompted to restart the system, select No. Wait till the patch installation process is completed and then restart and re-login as the same user to complete the patch installation.


  6. Verify the patch log file.

    The log file is found at: %TEMP%\SUNJAVAES_<patch-id>.log

  7. Verify the patch installation with the utility ListJavaESPatches.exe.

    Run ListJavaESPatches.exe and check that the output includes the patch id of the patch that you have installed in Step 5. For more information, see Identifying Installed Java ES Patches.

  8. Upgrade and configure the Release 5U1 Service Registry instance.

    ServiceRegistryR5–base/install

    ant -f build-install.xml upgrade.jes5.to.jes5u1

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

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

Verifying the Upgrade

You can verify successful upgrade of Service Registry with the help of the utility ListJavaESPatches.exe as described in the procedure to upgrade Service Registry. See Upgrade Procedure.

Post-Upgrade Tasks

There are no post-upgrade tasks beyond the steps described in Upgrade Procedure and Upgrade Considerations.

Rolling Back the Upgrade

  1. Log in as administrator.

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

    ServiceRegistryR5–base/install

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

  3. Double-click uniinstall_patch-id.bat to uninstall the patch.

  4. Execute the following command.

    ant -f build-install.xml appserver.domain.start appserver.undeploy appserver.deploy appserver.deploy.fix install.l10n appserver.domain.stop appserver.domain.start appserver.deploy.test