| |
The dbvolextend utility is used to extend the database environment by adding a DATA or LOG
volume file. It also adds the volume filename to the [Volumes] section of the database server
configuration file. The most common usage of dbvolextend is to create the mandatory log
volume for the database environment.
dbvolextend is also used to re-create log volume file(s) after restoring an online backup.
usage: dbvolextend [options] volume_file_name
dbvolextend [options] -R
options:
-R - recreate missing LOG volumes if possible
-t type - Volume type (DATA, LOG)
-v - verbose
-d flags - debug flags
-c cfg - configuration file name
-s sz - Initial size
-e sz - Extension size
-m sz - Max volume size
The options are:
- -help
- The -help option displays a brief help text.
- -R
- The -R option is used to re-create missing LOG volume files after restoring the DATA
volume files from a backup created in Eloquence "online backup mode" (to prepare for
starting the eloqdb server again).
- -t type
- The -t option specifies the volume file type DATA or LOG. There is no default.
- -v
- The -v option causes dbvolextend 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.
- The eloqdb database server must not be running when dbvolextend is used.
- dbvolextend needs write access to the eloqdb config file to update the [Volumes] section.
- The -t option has no default. Type DATA or LOG must be chosen explicitly.
The example below adds a LOG volume file named /data/log-1.vol and specifies that it will
be extended in 10 MB increments as needed. A volume-specific maximum size is not specified.
It also adds a second data volume file named /data/db-02.vol with a custom extension size.
dbvolextend -v -c eloqdb.cfg -t log -e 10 /data/log-1.vol
dbvolextend -v -c eloqdb.cfg -t data -e 100 /data/db-02.vol
dbvolcreate,
dbvolchange,
dbvoldump.
Database backup and recovery using
on-line backup mode.
|
|
