Sun Java Enterprise System 2005Q4 Upgrade Guide |
Chapter 8
High Availability Session StoreThis chapter describes how to upgrade High Availability Session Store to Java ES 2005Q4 (Release 4): High Availability Session Store (HADB) 4.4.2.
The chapter provides a general overview of upgrade issues before covering the different upgrade paths supported by Java ES Release 4. The chapter covers upgrades on both the Solaris and Linux operating systems:
Overview of HADB UpgradesThis section describes the following general aspects of HADB that impact upgrading to Java ES 2005Q4 (Release 4):
About Java ES Release 4 HADB
Java ES Release 4 versions of HADB represents bug fixes to the Java ES 2005Q1 (Release 3) version.
HADB Upgrade Roadmap
Table 8-1 shows the supported HADB upgrade paths to Java ES Release 4. The table applies to both Solaris and Linux operating systems.
HADB Data
The following table shows the type of data that could be impacted by an upgrade of HADB software.
Table 8-2 HADB Data Usage
Type of Data
Location
Usage
Dynamic application data
/var/opt/SUNWhadb and /etc/opt/SUNWhadb
High availability session store and configuration information.
Compatibility Issues
HADB provided with Java ES Release 4 is backwardly compatible with HADB provided with Java ES Release 3.
HADB Dependencies
HADB provided with Java ES Release 4 requires Java 2 Platform, Standard Edition (J2SE) Version 5.0 or later.
Upgrading HADB from Java ES Release 3This section includes information about upgrading HADB from Java ES 2005Q1 (Release 3) to Java ES 2005Q4 (Release 4). The section covers the following topics:
Introduction
When upgrading Java ES Release 3 HADB to Java ES Release 4, consider the following aspects of the upgrade process:
- General Upgrade Approach. Upgrades consist of removing the Java ES Release 3 HADB packages and adding the Java ES Release 4 packages. There are two upgrades approaches available:
- Upgrade Dependencies. HADB requires J2SE Version 5.0 or later.
- Backward Compatibility. HADB provided with Java ES Release 4 is backwardly compatible with HADB provided with Java ES Release 3.
- Upgrade Rollback. Rollback from the Java ES Release 4 upgrade to Java ES Release 3 is achieved by restoring the Release 3 version, which is left undisturbed in a separate directory by the upgrade to Release 4.
- Platform Issues. The general approach for upgrading HADB is the same on both Solaris and Linux operating systems.
Release 3 HADB Upgrade
This section describes how to perform an upgrade of HADB from Java ES Release 3 to Java ES Release 4 on both the Solaris and Linux platform. The section covers the following topics:
Pre-Upgrade Tasks
Before you upgrade HADB you should perform the tasks described below.
Verify Current Version Information
You can verify the current version of HADB using standard version checking utilities. For example:
Solaris:
pkgparam -v SUNWhadbaLinux:
rpm -qi sun-hadb-a-4.4.2-7.i386.rpm
Upgrade HADB Dependencies
It is generally recommended that all Java ES components on a computer system (and in a computing environment) be upgraded to Java ES Release 4. The upgrade of HADB to Release 4 depends on J2SE 5.0 or later.
Back Up Directory Data
The HADB upgrade from Java ES Release 3 to Java ES Release 4 does not in itself modify HADB dynamic data. However, you can back up the Java ES Release 3 packages in case you need to roll back the upgrade.
Obtain Required Configuration Information and Passwords
HADB upgrade requires you to know the superuser password.
Upgrading Release 3 HADB
This section discusses considerations that impact the upgrade procedure for HADB followed by a description of the procedure itself.
Upgrade Considerations
The upgrade of HADB software to Java ES Release 4 takes into account the following considerations:
- Based on your production requirements, you need to determine whether an online or offline upgrade is more appropriate.
- The Java ES Release 4 upgrade packages for Solaris and Linux platforms are shown in the following table. Solaris packages are listed in their installation sequence.
Online Upgrades of HADB
Online upgrades of HADB are only available when upgrading from Java ES Release 3.
When you perform an online upgrade of HADB, you first install HADB on each server in the cluster being upgraded. Each server first unregisters from an earlier installation of HADB and then registers with the newly installed version of HADB.
For details on performing an online upgrade, refer to the following section in Sun Java System Application Server Enterprise Edition 8.1 2005Q2 High Availability Administration Guide (http://docs.sun.com/doc/819-2555/6n4r9qo7n?a=view)
Offline Upgrades of HADB
An offline upgrade of HADB is available when upgrading from either Java ES Release 3.
To perform an offline upgrade, shut down your HADB services and replace the existing HADB packages with the newer versions available from your Java ES Release 4 distribution, shown in Table 8-4.
Use the procedures documented in Upgrading Packages on Solaris Platforms and Upgrading Packages on Linux Platforms.
Verifying the Upgrade
After completing the online upgrade, verify the upgrade by using the following procedure. After verifying that the upgrade is successful, the old installation packages can be deleted.
To verify that running processes are using the upgraded HADB services, you can perform the following steps.
- For all HADB services running, issue either of the following commands:
HADB-base/bin/ma -V
HADB-base/bin/hadbm -VFor example, on the Solaris 8 platform:
HADB-base/bin/ma -V
Sun Java System High Availability Database 4.4 Database Management Agent
Version : 4.4.2.7 [V4-4-2-7 2005-05-26 13:49:01 server@domain] \ (SunOS_5.8_sparc)- Check whether the database is running by issuing the commands in the following example for a database named ExampleDB:
HADB-base/bin/hadbm status -n databaseName
HADB-base/bin/hadbm list
Database
ExampleDBHADB-base/bin/hadbm status ExampleDB
Database Status
ExampleDB FaultTolerantHADB-base/bin/hadbm status -n ExampleDB
NodeNo HostName Port NodeRole NodeState MirrorNode
0 sungod012 15000 active running 1
1 sungod012 15020 active running 0All HADB services for listed nodes should in the “running” state.
- Verify that all products using HADB are using the new HADB path by issuing the command in following example for a database named ExampleDB:
HADB-base/bin/hadbm get PackageName ExampleDB
Attribute Value
PackageName V4.4.2.7The above command displays the current version of HADB. For a detailed listing, issue the following command:
hadbm get --all ExampleDB
Post-Upgrade Tasks
There are no post-upgrade tasks beyond the steps described in Upgrading HADB from Java ES Release 3.
Rolling Back the Upgrade
To roll back the upgrade to HADB, replace the newer versions of the HADB packages you installed with the versions you previously had installed. Use the same procedure described in Rolling Back the Upgrade. There is no data or configuration files that need to be changed.