dbamverify
Synopsis
dbamverify
[ [A [-a attribute_type] [-s attribute_subtype]]
[-T] [-X] [-D] [-S]
[-c cache_size] [-d] [-e] [-v]
[-t temp_dir]
[full_backup_file [delta_backup_files]] ] |
-h |
-V
Options
-A
-
Verifies the consistency of the attribute value index (AVIDX) blocks of the active database.
-T
-
Verifies the consistency of the tree (TREE) blocks of the active database.
-a attribute_type
-
Directs dbamverify to verify the consistency of the AVIDX blocks of the specified attribute type. If this option is not specified, the consistency of all attribute types is verified.
-c
-
Specifies the cache size in MB. The default cache size is 128 MB. This option is valid for the
-A, -T, -X, -D and -S options.
-d
-
Disables verification header update after verification. If this option is specified, dbamverify checks the defined components but does not update the verification information in the dirxbackup archive file.
-e
-
Enables expert mode. This mode is intended for support. This option is valid for the -A, -T, -X, -D and -S options.
-s attribute_subtype
-
Directs dbamverify to verify the consistency of the AVIDX blocks of the specified attribute subtype. If this option is not specified, the consistency of all attribute subtypes is verified.
Use one of the following values to specify attribute_subtype:-
0—The INITIAL attribute value index (AVIDX) blocks
-
1—The FINAL attribute value index (AVIDX) blocks
-
2—The CONTAINS attribute value index (AVIDX) blocks
-
3—The PRESENT attribute value index (AVIDX) blocks
-
4—The PHONETIC attribute value index (AVIDX) blocks
(See also the dirxadm db attrconfig operation.)
-
-t temp_directory
-
Specifies the directory that dbamverify uses to store temporary files. This directory must exist. If this option is not specified, dbamverify uses the directory install_path*/tmp*.
-X
-
Verifies the consistency of the attribute value index bit strings of the active database.
-S
-
Verifies the consistency of the subordinate index bit strings of the active database.
-D
-
Verifies the consistency of DSEs of the active database.
full_backup_file [delta_backup_files]
-
Specifies a dirxbackup archive file plus optional delta backup files. This option directs dbamverify to work on these files instead of working on the active database, which avoids having the DSA locked during dbamverify update operations. It is important to specify the correct sequence of the dirxbackup archive files. The file name of the full backup archive file must be specified first, followed optionally by the delta backup archive files in the correct chronological order.
-v
-
Disables verbose mode. Displays only errors.
-h
-
Prints a command usage message.
-V
-
Displays the DirX Directory product version, in the format:
product_version build_id date time
For example:
DirX Directory V9.0 9.4.428 2023:03:23 20:10 64-Bit
Description
The dbamverify command verifies the consistency of the active database or dirxbackup archive files (if specified). The database is locked for update operations while the verify process is performed.
If a dirxbackup archive file plus optional delta backup files are specified, dbamverify processes only these files and does not block DSA operations. As a result, this is the recommended method to use since the directory service can operate without any restrictions while dbamverify is running. Note that the dbamverify command must be executed on a machine and DirX Directory installation with the same architecture (including 32bit versus 64bit) as the machine where the backup was produced.
Use the -A option to verify the consistency of all attribute value index (AVIDX) blocks. Use the -a option to verify the AVIDX blocks of only one attribute type. Use the -s option to verify AVIDX blocks of only one attribute subtype of all attribute types or only one attribute type (if -a is specified).
Use the -T option to verify the consistency of the tree (TREE) blocks of the database.
Use the -X option to verify the consistency of all attribute value index bit strings. This test verifies whether indexed attribute values in the DSEs are correctly registered in the attribute value index. It performs the same consistency check the DSA would perform by a db check -bs ATTRIBUTE operation initiated with dirxadm. A detailed result of this test is saved in the file install_path*/tools/log/aidxcheck*pid*.txt*.
Use the -S option to verify the consistency of all subordinate index bit strings. This test verifies whether the locations of all DSEs in the tree are correctly registered in the subordinate index. It performs the same consistency check the DSA would perform by a db check -bs SUBORDINATE operation initiated with dirxadm. A detailed result of this test is saved in the file install_path*/tools/log/subcheck*pid*.txt*.
Use the -D option to verify the consistency of all DSEs. It performs the same consistency check the DSA would perform by a db check -rob operation initiated with dirxadm. A detailed result of this test is saved in the file install_path*/tools/log/entrycheck*pid*.txt*. (See the db (dirxadm) reference page for details.)
If no options are specified, dbamverify performs consistency tests of the tree (option -T) and of all attribute value index blocks (option -A) on the active database.
While the dbamverify command works on the active database and is in progress, the operation mode of the DSA is VERIFY. (See the dirxadm sys opmode operation for details.) While dbamverify works on dirxbackup files, the mode of the DSA remains unchanged.
It is not possible to run the dbamverify command while restoring a database.
Examples
-
The following sample command verifies the consistency of all attribute value index blocks:
dbamverify -A
The command output is as follows:
Testing attribute index (type = 0, subtype = INITIAL) 100% of attribute index info tested ... Testing attribute index (type = 3, subtype = INITIAL) 100% of attribute index info tested ... Testing attribute index (type = 4, subtype = INITIAL) 100% of attribute index info tested ... Testing attribute index (type = 13, subtype = INITIAL) 100% of attribute index info tested ... Testing attribute index (type = 15, subtype = INITIAL) 100% of attribute index info tested ...
-
The following sample command verifies the consistency of all attribute value index blocks of the subtype INITIAL:
dbamverify -A -s0
The command output is as follows:
[.monospaceemphasis]#Testing attribute index (type = 0, subtype = INITIAL) + 100% of attribute index info tested ... + Testing attribute index (type = 3, subtype = INITIAL) + 100% of attribute index info tested ... + Testing attribute index (type = 4, subtype = INITIAL) + 100% of attribute index info tested ... + Testing attribute index (type = 13, subtype = INITIAL) + 100% of attribute index info tested ... + Testing attribute index (type = 15, subtype = INITIAL) + 100% of attribute index info tested ...#
-
The following sample command verifies the consistency of the tree (TREE) blocks:
dbamverify -T
The command output is as follows:
Testing tree 100% of tree info tested ...
-
The following sample command performs all consistency checks on a dirxbackup archive file:
dbamverify -XDS db-dirx82b-mycompany
The command output is as follows:
Reading file db-dirx82b-mycompany, full backup from Tue Aug 07 10:30:57 2012 100% read ... Testing attribute index (type = 0, subtype = INITIAL) 100% of attribute index info tested ... Testing attribute index (type = 3, subtype = INITIAL) 100% of attribute index info tested ... Testing attribute index (type = 3, subtype = FINAL) 100% of attribute index info tested ... Testing attribute index (type = 4, subtype = INITIAL) 100% of attribute index info tested ... Testing attribute index (type = 4, subtype = FINAL) 100% of attribute index info tested ... Testing attribute index (type = 13, subtype = INITIAL) 100% of attribute index info tested ... Testing attribute index (type = 13, subtype = FINAL) 100% of attribute index info tested ... Testing attribute index (type = 15, subtype = INITIAL) 100% of attribute index info tested ... Testing attribute index (type = 15, subtype = FINAL) 100% of attribute index info tested ... Testing tree 100% of tree info tested ... Testing attribute index (bit strings) Scan all DSEs ... Testing attribute index objectClass (type=0, subtype=INITIAL) : OK Testing attribute index cn (type=3, subtype=INITIAL) : OK Testing attribute index cn (type=3, subtype=FINAL) : OK Testing attribute index sn (type=4, subtype=INITIAL) : OK Testing attribute index sn (type=4, subtype=FINAL) : OK Testing attribute index c (type=6, subtype=INITIAL) : OK Testing attribute index c (type=6, subtype=FINAL) : OK Testing attribute index o (type=13, subtype=INITIAL) : OK Testing attribute index o (type=13, subtype=FINAL) : OK Testing attribute index collectiveOrganizationName (type=14, subtype=INITIAL) : OK Testing attribute index collectiveOrganizationName (type=14, subtype=FINAL) : OK Testing attribute index ou (type=15, subtype=INITIAL) : OK Testing attribute index ou (type=15, subtype=FINAL) : OK Testing attribute index collectiveOrganizationalUnitName (type=16, subtype=INITIAL) : OK Testing attribute index collectiveOrganizationalUnitName (type=16, subtype=FINAL) : OK Testing subordinate index (bit strings) Subordinate index OK Testing DSEs 100% of DSEs tested ... DSEs OK