| |
The dbvolcreate utility is used to create the main database volume file of an Eloquence
database environment and initialize the system catalog. It also adds the volume filename
to the [Volumes] section of the database server configuration file.
usage: dbvolcreate [options] volume_file_name
options:
-v - verbose
-d flags - debug flags
-c cfg - configuration file name
-s sz - Initial size
-e sz - Extension size
-m sz - Max volume size
-b 0|1 - Byte order 0:LITTLE_ENDIAN 1:BIG_ENDIAN
The options are:
- -help
- The -help option displays a brief help text.
- -v
- The -v option causes dbvolcreate to output more detailed processing messages.
- -d flags
- The -d option specifies debug flags and is normally not used.
- -c cfg
- The -c option specifies the eloqdb server configuration file name. If not specified,
the default configuration file name depends on OS platform and Eloquence version.
- -s size
- The -s option specifies the initial size (in MB) of the volume to be created.
The default size is 2.5 MB (which is also the minimum size).
- -e size
- The -e option specifies the extension size (in MB). When the volume is getting full,
it will be extended in steps of size MB. If size is 0, the volume will not be extended
automatically by the server. The default extension size is 1 MB.
- -m size
- The -m option specifies the maximum volume size (in MB). Automatic volume extensions
will not grow the volume beyond size MB. If not specified (or specified as zero), the
maximum volume size is determined by the "VolumeFileSizeLimit" setting in the eloqdb
server configuration file.
- -b volume_format
-
The -b option specifies the volume byte order for a new volume set
that is created. By default the volume set that is created uses the
platform conventions.
- The option -b 0 will create a little endian volume set.
This option also implies a default character set encoding of iso-8859-1.
This is the default on Linux and Windows.
- The option -b 1 will create a big endian volume set.
This option implies a character set encoding of hp-roman8.
This is the default on HP-UX.
This option is mostly intended for testing purposes or to
allow for backwards compatibility with previous Eloquence
releases.
The volume set endian setting can only
be specified upon volume set creation and cannot be changed subsequently.
- dbvolcreate needs write access to the eloqdb config file to update the [Volumes] section.
- Additional (data or log) volume files may be created with the dbvolextend utility. Volume
parameters "extension size" and "maximum size" may be changed with the dbvolchange utility.
- The -b option was added with the B.08.40 release.
The example below creates a database volume file named /data/db-01.vol and specifies that
it will be extended in 100 MB increments as needed. A volume-specific maximum size is not
specified.
dbvolcreate -v -c eloqdb.cfg -e 100 /data/db-01.vol
dbvolextend,
dbvolchange,
dbvoldump.
|
|
