22.3 Using the system generator to construct a HiRDB system

The system generator is the facility that enables the user to construct interactively a HiRDB system environment.

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 22-2 shows the system generator's screen display transitions.

Figure 22-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 (pdgen)
(3) Specifying the license selection
(4) Setting main information for the HiRDB system
(5) Creating the HiRDB.
(6) Creating user RDAREAs and user LOB RDAREAs

(1) Setting the HiRDB directory as the current directory

The OS's cd command is used to set the HiRDB directory as the current directory:

(2) Starting the system generator (pdgen)

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

(3) Specifying the license selection

Specify your HiRDB license selection.

To specify the necessary information on the HiRDB/Single Server License selection menu screen, use the following procedure:

  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 selection [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-12 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-12 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) 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-12 or i-q > on the last line of the Master menu screen, enter 8.
    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_S/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 cursor is placed on the line Enter 1-12 or o-q >.
(d) 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-12 or i-q > on the last line of the Master menu screen, enter 12, 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_S/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 81 for the area to be used for user RDAREAs and user LOB RDAREAs, plus 5 for extra space, then press the Enter key.
    A HiRDB file system area for RDAREAs of the specified size is registered, and the cursor is placed on the line Enter 1-12 or o-q >.

(5) Creating the HiRDB.

To create the HiRDB:

  1. At Enter 1-12 or o-q > on the last line of the Master menu screen, enter g, then press the Enter key.
    The message lines shown as follows are displayed, the HiRDB system is created automatically, and the message, Push enter key to main menu>, is displayed on the last line.
  2. Press the Enter key.
    Creation of the HiRDB system is now complete, and the Master menu is displayed.

(6) Creating user RDAREAs and user LOB RDAREAs

Next, create a user RDAREA and user LOB RDAREAs for storing the SGML documents and plug-in index.

This example creates one user RDAREA and two user LOB RDAREAs.

To create a user RDAREA and user LOB RDAREAs:

  1. At Enter 1-12 or o-q > on the last line of the Master menu screen, enter r, then press the Enter key.
    The Create new rdarea menu screen is displayed.
  2. To create an RDAREA, enter 1 at Enter 1-7 or o-q > on the last line of the Create new rdarea menu.
    1: Rdarea name: is displayed on the last line.
  3. Enter USR1 corresponding to item 1 in Table 22-9, then press the Enter key.
  4. In the same manner as in steps 2 and 3 above, at Enter 1-7 or a-q > enter the values corresponding to items 2-7 in Table 22-9.
  5. When values have been set for items 1-7, enter a at Enter 1-7 or a-q > to add two more RDAREAs, then repeat steps 2-4.
  6. When one user RDAREA and two user LOB RDAREAs have been added, enter q at Enter 1-7 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 22-9 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 22-9 Information to be set for RDAREAs

No.Information to be setUser RDAREA USR1User LOB RDAREA
1RDAREA nameUSR1ULOB1ULOB2
2Size of RDAREA [MB]14040
3Segment size for RDAREA [pages]1011
4Page size for RDAREA [KB]488
5Type of RDAREATableBlobBlob
6Size of global buffer to be allocated to RDAREA350350350
7Absolute path name of HiRDB file that is a component of RDAREA/opt/HiRDB_S/
rdfiles
/opt/HiRDB_S/
rdfiles
/opt/HiRDB_S/
rdfiles