Adding a server while HiRDB is running

Nonstop Database, HiRDB Version 9 System Operation Guide

11.4.1 Adding a server while HiRDB is running

Add a front-end server (FES3) and a back-end server (BES3) to unit 3. The following figure illustrates the procedure:

[Figure]

Use of the system reconfiguration command (pdchgconf command) eliminates the need to terminate HiRDB normally. Note that HiRDB Advanced High Availability must be installed in order to use this command.

Organization of this subsection: (1) Check the memory requirements for unit 3; (2) Create updated HiRDB system definitions; (3) Use the pdloginit and pdstsinit commands to create the system files required for FES3 and BES4; (4) Use the pdconfchk command to check the updated HiRDB system definitions; (5) Use the pdchgconf command to modify the HiRDB system definitions; (6) Use the pdmod command to add or move RDAREAs; (7) Modify client environment definitions

(1) Check the memory requirements for unit 3

To add the servers, you must re-estimate the memory requirements for unit 3. You might also need to modify operating system parameters of the OS. For details about memory requirements and evaluating operating system parameters, see the HiRDB Version 9 Installation and Design Guide.

Note that you must restart the OS for changes to operating system parameters to take effect, which means that HiRDB must be terminated normally. In this example, we assume that there are no operating system parameters to be changed.

(2) Create updated HiRDB system definitions

Use the procedure explained below to create HiRDB system definitions that reflect the change in the server configuration. If you plan to add or move RDAREAs as explained in step (6), update the global buffer definitions as well.

Procedure

Create a $PDDIR/conf/chgconf directory.
Copy the current HiRDB system definition files into the directory you created in step 1.
Modify the HiRDB system definitions that are in the $PDDIR/conf/chgconf directory.

(3) Use the pdloginit and pdstsinit commands to create the system files required for FES3 and BES4

 
pdloginit -d sys -s fes3 -f /sysarea/log01 -n 5000 -D         1
   :
pdloginit -d spd -s fes3 -f /sysarea/sync01 -n 5000 -D        2
   :
pdstsinit -s fes3 -f /sysarea/ssts01 -c 3000 -D               3
   :

Explanation

Creates system log files for FES3 and BES4.
Creates synchronization point dump files for FES3 and BES4.
Creates server status files for FES3 and BES4.

Because these commands are executed in unit 3 rather than in unit 1 (system manager unit), the -D option must be specified for the pdloginit and pdstsinit commands.

(4) Use the pdconfchk command to check the updated HiRDB system definitions

 
pdconfchk -d chgconf

Check the HiRDB system definitions in the $PDDIR/conf/chgconf directory. If errors are detected, correct the HiRDB system definitions, and then execute the pdconfchk command again.

(5) Use the pdchgconf command to modify the HiRDB system definitions

 
pdchgconf

Replace the HiRDB system definitions with the updated HiRDB system definitions.

(6) Use the pdmod command to add or move RDAREAs

If necessary, you can add or move RDAREAs to BES4. For details about adding RDAREAs, see 15.2 Creating an RDAREA (RDAREA addition); for details about moving RDAREAs, see 15.9 Moving an RDAREA (RDAREA migration).

If you did not modify the global buffer definitions in step (2), use the pdbufmod command to update the global buffers dynamically.

(7) Modify client environment definitions

If necessary, specify the following operands in the client environment definitions for the front-end server (FES3) that you added:

PDFESHOST
PDSERVICEGRP
PDSERVICEPORT

We recommend that after the command has executed you check whether the execution results are correct. For details on how to check command execution results, see the manual HiRDB Version 9 Command Reference.