The VaultVerify tool has a lot of options and switches - what do each of them do?

0 Likes

Problem:

The VaultVerify tool has a lot of options and switches - what do each of them do?

Resolution:


  • Product Name: StarTeam
  • Product Version: 2005, 2005 Rel2, 2006
  • Product Component: VaultVerify
  • Platform/OS Version: All


Vault Verify from the command line as follows:

Vault Verify [options] "server configuration"

Based on the default or given -check options, integrity checks are performed on the vault archive files for the specified StarTeam "server configuration". If you specify the -repair option, Vault Verify attempts to correct problems found. Vault Verify opens the database for the server configuration but does not modify it.

Valid options for Vault Verify are as follows:

-check {missing | corrupt | stray | all}

Determines which integrity checks to perform:

  • missing - Checks for missing files by comparing the database against archive files actually present.
  • corrupt - Checks the integrity of existing archive files (MD5, name, folder, and .gz file format).
  • stray - Checks for extraneous files based on the database. This option cannot be used if the server configuration is in use.
  • all - Performs all integrity checks.

Multiple -check options can be specified. Also, see the -repair option.

Option Description
-cf Path name of the corrupt file folder, where problem files found by the corrupt check are moved when -repair is specified. The TEMP environment variable provides the default output path for this option. The output path provided by TEMP depends on your operating system and user environment. For example, the corrupt file folder on a Windows system could be C:\Documents and Settings \\Local Settings\Temp\VVCorruptFiles.
-dbhost Specifies the host name of the database for the specified "server configuration". This parameter is only used on non-Windows platforms when the database server is executing on a different host than the StarTeam Server. If you specify this option on a Windows platform, it is ignored. This option is only necessary when using an Oracle database with StarTeam
-dbpassword Specifies the database logon password. If not specified, a blank password is used. (The password stored in the configuration is encrypted and cannot be used by Vault Verify.) On server configurations running against Oracle, this option must be specified since the Oracle password is never empty. This option is only necessary when using an Oracle database with StarTeam
-dbuser Specifies the logon ID used to connect to the database. If specified, this parameter overrides the user specified in the StarTeam "server configuration". The only valid user to use with this option is the user that owns the StarTeam tables. This option is only necessary when using an Oracle database with StarTeam
-help -h or -? Displays this usage information.
-path Specifies the folder path of the starteam-server-configs.xml file. This file must exist and contain the specified "server configuration". By 1382 default, this file is opened in the parent folder of the current working directory if it is not found in the current working directory
-repair Specifies that an attempt should be made to correct archive file problems. Corrupt archives are moved to the corrupt file folder (see the -cf option). If they correspond to valid file revisions, they are then treated as missing. Missing archive recovery is attempted from other vault files and, if the -useca option is specified, from a Cache Agent. Stray archives are moved to the stray file folder (see the - sf option). Note: -repair is ignored if the StarTeam "server configuration" is in use.
-sf Path name of the stray file folder, where extraneous files found by the stray check are moved when -repair is specified. The TEMP environment variable provides the default output path for this option. The output path provided by TEMP depends on your operating system and user environment. For example, the stray file folder on a Windows system could be C:\Documents and Settings \\Local Settings\Temp\VVStrayFiles
-t Displays elapsed time information when the verification finishes.
-useca If -repair is specified, this option enables attempts to recover missing files from the specified MPX Cache Agent. The and must designate a remote Cache Agent because it maintains an independent cache.
-verbose Displays additional status information as the verification proceeds. ?server configuration? Specifies the server configuration name. The server configuration name passed to Vault Verify is case-sensitive, and if it includes spaces, you must pass the configuration name to Vault Verify in quotation marks.

Old KB# 27801
Comment List
Related
Recommended