23.3 Using the system generator to construct a HiRDB system
(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.
- HiRDB/Parallel Server License selection menu screen
![[Figure]](figure/ga220010.gif)
To specify necessary information on the HiRDB/Single Server License selection menu screen:
- On the HiRDB/Single Server License selection menu screen, at the last line, Select 1/2 or q >, enter either 1 or 2
whatever corresponds to your license mode
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:
- Master menu screen
![[Figure]](figure/ga220020.gif)
Following is the setup procedure on the Master menu screen:
(a) Specify the number of concurrently executable users
- 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.
- 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
- 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.
- 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).
- 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.
- Enter the host name (such as hostA), then press the Enter key.
Enter 1-10 or o-q > is displayed on the last line.
- 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:
- HiRDB unit initialization screen (In the following Unit initialization screen example, the host name is hostA)
![[Figure]](figure/ga220030.gif)
To set up the unit initialization screen:
- 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.
- 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:
- 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.
- 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.
- 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.
- Message (In this example, 150 is displayed)
Enter file name and partition size for HiRDB-file-system-area.
This HiRDB-file-system-area will be used for HiRDB system files. (log and status etc...)
-- Attention --
Please enter file name with complete path.
If specified file are already exist pdgen will delete the file and recreate.
The size of HiRDB-file-system-area will more than 150 [MB].
The HiRDB-file-system-area creates as UNIX file with specified size.
Enter file name with completely path > /opt/HiRDB_P/sysfiles
Enter HiRDB-file-system-area size [MB] >150 |
(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:
- 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.
- 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.
- 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.
- Message (In the following example, the area size displayed is 77)
Enter file name and partition size for HiRDB-file-system-area.
This HiRDB-file-system-area will be used for rdarea.
-- Attention --
Please enter file name with complete path.
If specified file are already exist pdgen will delete the file and recreate.
The size of HiRDB-file-system-area will more than 77 [MB].
The HiRDB-file-system-area creates as UNIX file with specified size.
Enter file name with completely path >/opt/test/HiRDB_P/rdfiles
Enter HiRDB-file-system-area size [MB] >249 |
(c) Create the HiRDB unit
To create the HiRDB unit:
- 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.
- Press the Enter key.
Automatic unit creation is now complete, and the HiRDB unit initialization screen is displayed again.
- 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.
- Message (The following is only an example; the actual message that is displayed depends on the values that have been set)
HiRDB unit initialization start. host name : hostA
Creating HiRDB definition files (/opt/HiRDB_P/conf)
Definition files are created
Creating HiRDB file system
HiRDB file system area for systemfiles creating (hostA:/opt/HiRDB_P /sysfiles 150[MB])
Unit status file for hostA creating
+ pdstsinit -u u001 -f /opt/HiRDB_P/sysfiles/u001st1a -c XX
:
Server status file for f001 creating
+ pdstsinit -s f001 -f /opt/HiRDB_P/sysfiles/f001sv1a -c XX
:
syncpoint dump file for f001 creating
+ pdloginit -d spd -s f001 -f /opt/HiRDB_P/sysfiles/f001cpd1 -n XX
:
Log file for f001 creating
+ pdloginit -d sys -s f001 -f /opt/HiRDB_P/sysfiles/f001jn1a -n XXX
:
:
syncpoint dump file for dic creating
+ pdloginit -d spd -s dic -f /opt/HiRDB_P/sysfiles/diccpd1 -n XXX
:
Log file for dic creating
+ pdloginit -d sys -s dic -f /opt/HiRDB_P/sysfiles/dicjn1a -n XXX
:
HiRDB-file-system-area for system files created (/opt/HiRDB_P/sysfiles)
HiRDB file system area for Database creating (hostA:/opt/HiRDB_P/rdfiles 249[MB])
HiRDB-file-system-area for rdarea created (/opt/HiRDB_P/rdfiles)
HiRDB system files are initialized
Unit are initialized. enter return key > |
(6) Creating the HiRDB
Create the HiRDB.
To create the HiRDB:
- 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.)
- Press the Enter key.
Creation of the HiRDB system is now complete, and the Master menu is displayed.
- Message (The following is only an example; the actual message that is displayed depends on the values that have been set)
Start HiRDB system generation
HiRDB starting
Initializing rdareas
KFPX24000-I DB initialize ended, return code=0
Rdarea initialize completed
A...A XX:XX:XX u001 _rdm KFPS05110-I HiRDB unit u001 initialization process complete
A...A XX:XX:XX u001 _rdm KFPS05210-I HiRDB system initialization process complete
Initializing rdareas for registry
KFPX24600-I Pdreginit command start at XX:XX:XX on YYYY/YY/YY
KFPX24225-I Processing of create rdarea statement ended, RDAREA name="REG_BASE"
KFPX24225-I Processing of create rdarea statement ended, RDAREA name="REG_KEY_VALUE"
KFPX24226-I Processing of create rdarea statements ended return code=0
KFPX24200-I DB modification ended, return code=0
KFPX24601-I Pdreginit command for ended return code=0 at XX:XX:XX on YYYY/YY/YY
Rdarea(for registry) initialize completed
Push enter key to main menu > |
(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.
- Create new rdarea menu screen
![[Figure]](figure/ga220080.gif)
To create user RDAREAs and LOB RDAREAs:
- 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.
- 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.
- Enter USR1 corresponding to item 1 in Table 23-10, then press the Enter key.
- 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.
- 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.
- 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) >
- 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 set | User RDAREAs | User LOB RDAREAs |
---|
1 | RDAREA name | USR1 | USR2 | ULOB1 | ULOB2 | ULOB3 | ULOB4 |
2 | Size of RDAREA [MB] | 1 | 1 | 40 | 40 | 40 | 40 |
3 | Segment size for RDAREA [pages] | 10 | 10 | 1 | 1 | 1 | 1 |
4 | Page size for RDAREA [KB] | 4 | 4 | 8 | 8 | 8 | 8 |
5 | Type of RDAREA | Table | Table | Blob | Blob | Blob | Blob |
6 | Size of global buffer to be allocated to RDAREA | 350 | 350 | 350 | 350 | 350 | 350 |
7 | Absolute 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 |
8 | Name of back-end server to which RDAREA is allocated | b001 | b002 | b001 | b002 | b001 | b002 |