System information

157
CONFIGURING AND ADMINISTERING COLDFUSION 9
Using Verity Utilities
Last updated 2/21/2012
Examples: maintaining collections
The following examples show the commands for maintaining a collection.
Repairing a collection
The following command automatically repairs a collection, or enables it after manual repairs:
mkvdk -repair -collection path
Backing up a collection
The following command backs up a collection to the specified directory:
mkvdk -backup path_1 -collection path_2
Deleting a collection
To delete a collection, use the appropriate command for your operating system. For example, to remove the collection
directory structure and control files on a UNIX system, use the following command:
rm -r -collection_path
Purging a collection
The following command deletes all documents from a collection, but does not delete the collection itself:
mkvdk -purge -collection path
Option Description
-backup dir Backs up the collection into the specified directory. The backup does not include the tde subdirectory. The tde
subdirectory is created by and for Topic Document Entry if Topic Document Entry is used to create or maintain
the collection.
-repair Repairs the collection, performed by an API call.
-purge Waits the amount of time specified by the -purgewait option and then deletes all documents in the collection,
but not the collection itself. It leaves the collection directory structure intact.
To specify a different wait period, use the -purgewait option instead of the
-purge option. If you do not use the -purgewait option, the default is 600 seconds.
-purgeback Used with the -purge option, performs a purge in the background.
-purgewait sec Specifies to the -purge option how many seconds to wait. If you do not specify sec, the default is 600.
-noservice Prevents collection servicing, which includes indexing, by this instance of the mkvdk command, performed by an
API call.
-persist Services the collection repeatedly, at default intervals of 30 seconds. Use the -sleeptime option to set a
different interval.
-sleeptime sec Specifies the interval between service calls when the mkvdk utility is run with the -persist option.
-optimize spec Performs various optimizations on the collection, depending on the value of spec. The specifier, spec, is a string
consisting of keywords separated by hyphens, such as maxmerge-squeeze-readonly. For valid keywords, see
“Optimization keywords” on page 158.
-noexit Windows only. Causes the I/O window to remain after the program has finished. By default, the window closes
and the program exits, so that scripts calling the mkvdk utility do not hang.