23.3 Using the system generator to construct a HiRDB system

The system generator enables you to set up an HiRDB system environment interactively. The system generator provides default values for the HiRDB system environment information. This makes it possible to construct a HiRDB system quickly when a test environment is being constructed because only applicable items need be set.

Note
The settings provided by the system generator are based on the system that is constructed by simple installation. The only items that are explained here are those that must be set by the user. However, these default values may not be suitable for the actual application environment that results from a detailed design.

Figure 23-2 shows the system generator's screen display transitions.

Figure 23-2 System generator's screen display transitions

[Figure]

Organization of this section
(1) Setting the HiRDB directory as the current directory
(2) Starting the system generator
(3) Specifying the license selection
(4) Setting main information for the HiRDB system
(5) Creating a HiRDB unit
(6) Creating the HiRDB
(7) Creating user RDAREAs and user LOB RDAREAs

(1) Setting the HiRDB directory as the current directory

Execute the OS's cd command to set the HiRDB directory as the current directory:

(2) Starting the system generator

Execute HiRDB's pdgen command to start the system generator. The type specification screen is displayed.

(3) Specifying the license selection

Specify your HiRDB license selection.

To specify necessary information on the HiRDB/Single Server License selection menu screen:

  1. On the HiRDB/Single Server License selection menu screen, at the last line, Select 1/2 or q >, enter either 1 or 2[Figure]whatever corresponds to your license mode[Figure]and then press the ENTER key.
    The Master menu is displayed.

(4) Setting main information for the HiRDB system

The Master menu is used to set main information for HiRDB system construction:

Following is the setup procedure on the Master menu screen:

(a) Specify the number of concurrently executable users
  1. At Enter 1-10 or o-q > on the last line of the Master menu screen, enter 3.
    3 : Number of concurrently execute user : is displayed on the last line.
  2. Enter 60, then press the Enter key (for simple installation, the number of concurrently executable users is preset to 60).
(b) Specify the volume of database updating per day
  1. At Enter 1-10 or o-q > on the last line of the Master menu screen, enter 5.
    5 : Database update size per day : is displayed on the last line.
  2. Enter 10, then press the Enter key (for simple installation, the volume of database updating per day is preset to 10 MB).
(c) Specify the server machine's host name

This specification sets the server machine's host name (host name of the server machine where the dictionary server is located).

  1. At Enter 1-10 or o-q > on the last line of the Master menu screen, enter 6.
    6 : Host name of dictionary server : is displayed on the last line.
  2. Enter the host name (such as hostA), then press the Enter key.
    Enter 1-10 or o-q > is displayed on the last line.
  3. Enter u in response to Enter 1-10 or o-q >, then press the Enter key.
    The main information about HiRDB is registered, and the unit initialization screen is displayed again.

(5) Creating a HiRDB unit

To create a HiRDB unit, the following information must be set on the unit initialization screen:

To set up the unit initialization screen:

  1. To set the host name of the HiRDB unit, enter 1 at Enter 1-5 or i-q > on the last line of the HiRDB unit initialization screen.
    1 : Host name: is displayed on the last line.
  2. Enter the server machine's host name, then press the Enter key.
(a) Set the size of the HiRDB file system area for system files

This specification sets the size of the HiRDB file system area that is to be used to store system files, such as files for HiRDB database log information.

To set the size of the HiRDB file system area for system files:

  1. At Enter 1-5 or i-q > on the last line of the HiRDB unit initialization screen, enter 2.
    The message shown below is displayed.
  2. At Enter file name with completely path > on the second line from the bottom of the message, enter /opt/HiRDB_P/sysfiles, then press the Enter key.
  3. At Enter HiRDB-file-system-area size [MB] > on the last line of the message, enter the value displayed as xxxx in the message, The size of HiRDB-file-system-area will more than xxxx [MB], then press the Enter key.
    A HiRDB file system area for system files of the specified size is registered, and the unit initialization screen is displayed again.
(b) Specify the size of the HiRDB file system area for RDAREAs

This specification sets the size of the HiRDB file system area that is to be used for system RDAREAs, user RDAREAs, and user LOB RDAREAs.

To set the size of the HiRDB file system area for RDAREAs:

  1. At Enter 1-5 or i-q > on the last line of the HiRDB unit initialization screen, enter 5, then press the Enter key.
    The message shown below is displayed.
  2. At Enter file name with completely path > on the second line from the bottom of the message, enter /opt/test/HiRDB_P/rdfiles, then press the Enter key.
  3. At Enter HiRDB-file-system-area size [MB] > on the last line of the message, enter the value equal to the value displayed as xxxx in the message, The size of HiRDB-file-system-area will more than xxxx [MB], plus 162 for the area to be used for user RDAREAs and user LOB RDAREAs, plus 10 for extra space, then press the Enter key.
    A HiRDB file system area for RDAREAs of the specified size is registered, and the unit initialization screen is displayed again.
(c) Create the HiRDB unit

To create the HiRDB unit:

  1. At Enter 1-5 or i-q > on the last line of the HiRDB unit initialization screen, enter i, then press the Enter key.
    The HiRDB unit is created automatically, the message lines shown below are displayed, and the message, Unit are initialized. enter return key > is displayed on the last line.
  2. Press the Enter key.
    Automatic unit creation is now complete, and the HiRDB unit initialization screen is displayed again.
  3. At Enter 1-5 or i-q > on the last line of the HiRDB unit initialization screen, enter q, then press the Enter key.
    The creation of the HiRDB unit is now complete, and the Master menu is displayed.

(6) Creating the HiRDB

Create the HiRDB.

To create the HiRDB:

  1. At Enter 1-10 or o-q > on the last line of the Master menu screen, enter g, then press the Enter key.
    The message lines shown below are displayed, the HiRDB system is created automatically, and the message, Push enter key to main menu >, is displayed on the last line. (This message is an example; the actual message that is displayed depends on the values that have been set.)
  2. Press the Enter key.
    Creation of the HiRDB system is now complete, and the Master menu is displayed.

(7) Creating user RDAREAs and user LOB RDAREAs

User RDAREAs and user LOB RDAREAs for storing the SGML documents and plug-in index must be created next.

This example creates two user RDAREAs and four user LOB RDAREAs.

To create user RDAREAs and LOB RDAREAs:

  1. At Enter 1-10 or o-q > on the last line of the Master menu screen, enter r, then press the Enter key.
    The Create new RDAREA menu is displayed, as shown in the above example.
  2. To create an RDAREA, enter 1 at Enter 1-10 or o-q > on the last line of the Create new RDAREA menu screen.
    1 : Rdarea name: is displayed on the last line.
  3. Enter USR1 corresponding to item 1 in Table 23-10, then press the Enter key.
  4. In the same manner as in steps 2-3 above, enter at Enter 1-8 or a-q > the values corresponding to items 2-8 in Table 23-10.
  5. When values have been set for items 1-8, enter a at Enter 1-8 or a-q > in order to add five more RDAREAs, then repeat steps 2-4.
  6. When two user RDAREAs and four user LOB RDAREAs have been added, enter q at Enter 1-8 or a-q >.
    The following message is displayed:

    Rdarea are added. You have to restart HiRDB to use the area.
    Restart now?(Y/N) >

  7. Enter N, then press the Enter key.
    Addition of user LOB RDAREAs is now complete, and the Master menu is displayed again.

The values listed in Table 23-10 are applicable to construction of a HiRDB system by means of the simple installation procedure. When a database is designed in detail, reference should be made to 17. Determining RDAREA Size for the appropriate size estimates.

Table 23-10 Information to be set for RDAREAs

No.Information to be setUser RDAREAsUser LOB RDAREAs
1RDAREA nameUSR1USR2ULOB1ULOB2ULOB3ULOB4
2Size of RDAREA [MB]1140404040
3Segment size for RDAREA [pages]10101111
4Page size for RDAREA [KB]448888
5Type of RDAREATableTableBlobBlobBlobBlob
6Size of global buffer to be allocated to RDAREA350350350350350350
7Absolute path name of HiRDB file that is a component of RDAREA/opt/
HiRDB_P/
rdfiles
/opt/
HiRDB_P
/rdfiles
/opt/
HiRDB_P
/rdfiles
/opt/
HiRDB_P
/rdfiles
/opt/
HiRDB_P
/rdfiles
/opt/
HiRDB_P
/rdfiles
8Name of back-end server to which RDAREA is allocatedb001b002b001b002b001b002