|
The Initdb Utility
The initdb utility allows you to initialize the physical database files according to the definitions in the database description (.dsc) file. The initdb program can also be used to modify the existing database description (stored in the HEDR file) or to enlarge the size of any of the database files (see the parameters provided in the syntax below). The initdb utility stores the binary encoded database description in the first record of the HEDR file, which is where the database building program and the search engine look to retrieve the information.
Important Note: This utility performs step 2 in the database build process. It is strongly recommended that you use the SiteSearch Database Operations Tool (SSDOT) to complete the database build process. SSDOT, a component of the SiteSearch system, has a menu-driven interface that calls the appropriate database utility programs to execute the various build processes, including the tasks performed by the initdb utility.
Syntax
initdb -cdbdescfile [-dpdir_name] [-rhdir_name] [-ppost_name] [-hheader_name] [-iindx_name] [-u] [-a] [-h]
or
initdb @parmfile
Note: |
If the optional parameters for the five database files are not specified as shown in the first syntax above, initdb will attempt to create files with default names of HEDR, HDIR, POST, PDIR, and INDX, respectively.
|
Parameter
|
Description
|
-cdbdescfile
|
Specifies the name of the .dsc file to work with when preparing the database files for the pippin and rome utility programs.
|
-dpdir_name
|
Overrides the default file name and creates a postings directory file of the name pdir_name.
|
-rhdir_name
|
Overrides the default file name and creates a header directory file of the name hdir_name.
|
-ppost_name
|
Overrides the default file name and creates a posting file of the name post_name.
|
-hheader_name
|
Overrides the default file name and creates a header file of the name header_name.
Note: |
If you include the -h flag without a value for the header_name variable, the utility's usage statement will be displayed instead, as shown in the -h flag syntax description below.
|
|
-iindx_name
|
Overrides the default file name and creates an index file of the name indx_name.
|
-u
|
Uses the dbdescfile specified by the -c parameter to update the existing database description stored in the header file of the database. Refer to Creating a Database Description (.dsc) File for more information.
|
-a
|
Uses the dbdescfile specified by the -c parameter to extend the formatted size of the existing database files. See the Database File Definitions section for more information on specifying database file size.
|
-h
|
Displays the utility's usage statement.
Note: |
Do not confuse the -h flag with the -hheader_name command described above.
|
|
@parmfile
|
Provides an alternative to using the parameters in the first syntax example above by defining the name of a parameter file, parmfile, as the single input parameter. (Refer to the second syntax description above.) parmfile contains a list of the command line parameters. To create the file, use a text editor to produce a list of the parameters to be used.
Note: |
The format of the parmfile should conform to the conventions of UNIX command line parameter specifications. For example, using the blank (' ') to separate parameters and using the slash ('\') for line continuation beyond a single line of input.
|
|
See Also
An Introduction to Database Files Database File Definitions Creating a Database Description (.dsc) File An Explanation of the Database Build Process The Pippin Utility The Rome Utility Open SiteSearch Database Builder Utility Programs SiteSearch Database Operations Tool (SSDOT)
|