contact contact

B.08.30 / Reference Docs / Utilities / dbvolextend

dbvolextend utility

» Usage | Notes | Examples | See also
  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
 -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:
The -help option displays a brief help text.

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.

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

See also

dbvolcreate, dbvolchange, dbvoldump.

Database backup and recovery using on-line backup mode.

  Privacy | Webmaster | Terms of use | Impressum Revision: 2014-08-04  
  Copyright © 1995-2021 Marxmeier Software AG