|
The dbvolremove utility is used to remove unused database
volume files. Unused volume files are log volumes when the server was
shutdown cleanly and data volume files that currently dont hold data.
If a volume file is not unused it cannot be removed.
Please note that a data volume must be present to verify it is
unused. A log volume may be removed when not present.
usage: dbvolremove [options] [ID ...]
options:
-v - verbose
-c cfg - configuration file name
-d flags - debug flags
The options are:
- -help
- The -help option displays a brief help text.
- -v
- The -v option causes dbvolremove to output more detailed processing messages.
- -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.
- -d flags
- The -d option specifies debug flags and is normally not used.
- The dbvolremove utility was introduced with B.08.40.
Using dbvolremove does not affect backwards compatibility
with previous Eloquence versions.
- The dbvolremove utility is an offline utility.
The database server may not be active.
dbvolremove requires write access to the database volume files,
its directory and the configuration file.
It must be started as root or the owner of the database files.
When run without specifying a volume id the volumes are listed along
with an indication if a volume may be removed.
# dbvolremove
ID Type Path
1 DATA /data/db/db01.vol
2 LOG /data/db/db02.vol
3 DATA /data/db/db03.vol
4 DATA /data/db/db04.vol
5 DATA /data/db/db05.vol
ID Type Removable? Free Used
1 DATA no 0.0 2048.0
2 LOG YES 61.4 0.1
3 DATA no 0.0 2048.0
4 DATA no 303.9 1473.6
5 DATA YES 2.5 0.0
To remove a volume file the id of the volume is specified on the
command line.
# dbvolremove 5
Removing DATA volume file #5:
/data/db/db05.vol
1 volume file removed.
ID Type Path
1 DATA /data/db/db01.vol
2 LOG /data/db/db02.vol
3 DATA /data/db/db03.vol
4 DATA /data/db/db04.vol
ID Type Removable? Free Used
1 DATA no 0.0 2048.0
2 LOG YES 61.4 0.1
3 DATA no 0.0 2048.0
4 DATA no 303.9 1473.6
dbvolremove removes the volume file and its reference from the server
configuration file. The updated volume status is output.
A volume that is currently in used cannot be removed.
# dbvolremove 4
Cannot remove DATA volume #4, not removable:
/data/db/db04.vol
B.08.40 release notes
|
