6.2.2 Upgrading procedure

This section describes the upgrading procedure.

Organization of this subsection
(1) Making a backup copy
(2) Terminating HiRDB
(3) Saving all necessary files
(4) Cancelling setup of the old version of the plug-in
(5) Installing the new version of the plug-in
(6) Setting up the new version of the plug-in
(7) Making appropriate changes to the system common definition
(8) Restoring files that were saved
(9) Restarting HiRDB
(10) Registering the new version of the plug-in
(11) Terminating HiRDB
(12) Making appropriate changes to the system common definition
(13) Starting HiRDB

(1) Making a backup copy

To protect against possible errors, use the database copy utility (pdcopy) to make a backup copy of the following RDAREAs. For this purpose, be sure to specify the-M x option in the database copy utility (pdcopy).

(2) Terminating HiRDB

Enter the pdstop command to terminate HiRDB normally.

(3) Saving all necessary files

Save all necessary files at the following location:

For details about the files to be saved, see the applicable plug-in documentation. Save the applicable files on all server machines where HiRDB is set up.

(4) Cancelling setup of the old version of the plug-in

Use the pdplgset -d command to cancel setup of the plug-in. This command deletes everything at the following location:

This command does not delete any file under the Conf directory.

Cancel setup on all server machines where HiRDB is set up. For details about how to cancel plug-in setup, see 6.1 Overview of plug-in environment setup.

(5) Installing the new version of the plug-in

Install the new version of the plug-in at each HiRDB server machine. For details about the installation procedure, see the applicable plug-in documentation.

(6) Setting up the new version of the plug-in

Use the pdplgset command to set up the new plug-in. The new plug-in must be set up on all server machines where HiRDB is set up. For details about how to set up plugins, see 6.1 Overview of plug-in environment setup.

(7) Making appropriate changes to the system common definition

Delete the pdplugin operand for the old version of the plug-in from the system common definition. Delete this operand at all the server machines that contain the applicable system common definition.

(8) Restoring files that were saved

Restore the files that were saved in step (3) at all server machines where HiRDB is set up.

(9) Restarting HiRDB

Enter the pdstart command to start HiRDB.

(10) Registering the new version of the plug-in

Execute the pdplgrgst command, specifying the -a option to re-register the plug-in.

(11) Terminating HiRDB

Enter the pdstop command to terminate HiRDB normally.

(12) Making appropriate changes to the system common definition

When HiRDB has terminated normally, add the pdplugin operand to the system common definition. In the pdplugin operand, specify the name of the upgraded plug-in.

For a HiRDB/Parallel Server, add this operand to the system common definition at all server machines; otherwise, you will not be able to start HiRDB.

(13) Starting HiRDB

Enter the pdstart command to start HiRDB. The tables and indexes that were defined before the plug-in was upgraded become available again. Any new facilities provided by the new version of plug-in are also available.