5.2 Upgrading plug-ins

This section describes the procedure for upgrading plug-ins installed in HiRDB (data type and index type plug-ins). Upgrading a plug-in means changing the plug-in without deleting the following:

For notes about upgrading plug-ins, see Notes in pdplgrgst (Register and delete plug-ins) in the manual HiRDB Version 9 Command Reference.

This section describes the upgrading procedure.

Organization of this section
(1) Making a backup copy
(2) Terminating HiRDB
(3) Saving all necessary files
(4) Installing the new version of the plug-in
(5) Making appropriate changes to the system common definition
(6) Restoring files that were saved
(7) Restarting HiRDB
(8) Registering the new version of the plug-in
(9) Terminating HiRDB
(10) Making appropriate changes to the system common definition
(11) 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).

For details about making backups, see the HiRDB Version 9 System Operation Guide.

(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) 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.

(5) 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.

(6) Restoring files that were saved

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

(7) Restarting HiRDB

Enter the pdstart command to start HiRDB.

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

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

(9) Terminating HiRDB

Enter the pdstop command to terminate HiRDB normally.

(10) 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.

(11) 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.