Sun Java System Application Server Standard and Enterprise Edition 7 2004Q2 Update 7 Release Notes

ProcedureUpgrade Procedure

To upgrade from HADB version 4.4.x to version 4.4.2-7, use the following procedure:

  1. Perform the pre-upgrade tasks mentioned under Pre-upgrade Tasks/Data Migration.

  2. Install HADB version 4.4.2-7 on all HADB hosts (on another path than that of version 4.4.x, for instance on /opt/SUNWhadb/4.4.2-7).

  3. Install the HADB 4.4.2-7 version on the hadbm client hosts, if they are different than that of the HADB hosts.

  4. Stop all management agents running on all HADB hosts.

  5. Start the management agent processes using the HADB 4.4.2-7 software, with the old configuration files. In the remaining steps, use the hadbm command found in the HADB 4.4.2-7 /bin directory.

  6. Register the package in the management domain (default package name becomes V4.4, so another package name may be required to avoid conflicts with existing packages having the same name):

    hadbm registerpackage --packagepath=/opt/SUNWhadb/4.4.2-7 V4.4.2-7

  7. Run the hadbm listpackages command and check that the new package is registered in the domain.

  8. Restart the database with the new hadbm version 4.4.2-7. If it is necessary to move the devices and history files, run online upgrade combined with setting new paths for devices and history files in one single operation:

    hadbm set packagename=V4.4.2-7,devicepath=new_devpath,historypath=new_histpath

    If the devices and history files are already outside the installation directory, run the following command, which only does a rolling restart of the nodes:

    hadbm set packagename=V4.4.2-7 database name

  9. Check that the database status is "running" (using the hadbm status command) and that it functions normally, serving the client transactions.

  10. If everything is working, the old installation can be removed later. Before unregistering the old package, remove all references to the old package from the ma repository. Otherwise, hadbm unregisterpackage will fail with "package in use" error message. A dummy reconfiguration operation, for instance, hadbm set connectiontrace=same as previous value will remove all references to the old package.

  11. Unregister the old package:

    hadbm unregisterpackage [--hosts=host-list] old pacakge name

  12. Remove the old installation from the file system.