Enterprise Administration > File Vaulting and Replication > File Vaulting > Understanding File Vaulting > Diagnostic and Repair Tools > Verifying Content Files
  
Verifying Content Files
Windchill includes a command line utility, WContentVerify, that checks for content files that are referenced in the database but missing in the vaults. This utility also verifies actual content file sizes with the sizes in the metadata in the database. Running the wt.fv.tools.WContentVerify command from the Windchill shell provides the details of the business object that is associated with missing or incorrectly sized files, and the results are output to an XML file in the Windchill log directory.
The command windchill wt.fv.tools.WContentVerify -usage details all the valid arguments and their effects. Running it without the -email argument specified results in no email notifications being sent. All command line arguments are optional. If no arguments are supplied, the system checks all system content for internal integrity by checking all vaults and folders for missing or incorrectly sized files.
* 
The wt.mail.mailhost property in the wt.properties file in the codebase directory must point to a valid SMTP server.
Following are the arguments you can use and their descriptions:
Argument
Description
-user=<adminid>
User ID of the administrator user.
-password=<<adminpassword>
Password of the administrator user.
-propertyFile=<pathname>
Location of the property file of the utility.
-vaults=<vault1,vault2,...>
Only folders for the specified vaults will be checked. No spaces are allowed in or between the vault names.
-folders=<folder1,folder2,...>
Only specified folders will be checked. No spaces are allowed in or between the folder names.
-replicavaults=<vault1,vault2,...>
Only folders for the specified replica vaults will be checked. No spaces are allowed in or between the replica vault names.
-replicafolders=<folder1,folder2,...>
Only specified folders will be checked. No spaces are allowed in or between the replica folder names.
-onlyExistence
Only check and report the existence of files.
-onlyReportLatest
Report only the latest iteration of iterated documents.
-email=[DIRECT_EMAIL,EMAIL_GROUP]
Enables mail to specified users. This argument overwrites equivalent properties of the property file. You can use a value of DIRECT_EMAIL, EMAIL_GROUP, or both (comma-separated).
-listVaultsFolders
Print vault and folder names and then exit.
-listRemoteVaultsFolders
Print vault and folder names on remote sites and then exit.
-listReplicationRules
Prints all replication rules that are present on the system. This report is based on the vaults that have replication rules. Results are stored in an HTML file in the Windchill log directory.
-listPredictiveRules
Prints all predictive rules that are present on the system. This report is based on the vaults that have predictive rules. Results are stored in an HTML file in the Windchill log directory.
-usage
Print list of valid arguments and then exit.
-checkBusinessObject=<businessobject>
Prints detailed information about a business object, including the locations where it is stored and has been replicated
-checkContentItem=<filename>
Prints detailed information about a specific file, including the locations where it is stored and whether it has been replicated.
-checkPendingTransfers
Prints detailed information about the files in remote sites that have not been transferred yet.
-checkReplicationHistory=<remotesite>
Prints detailed information about the files in a remote site and the period of time that has been replicated.
Additionally, if WContentVerify throws any exceptions during execution, it is recommended that you run the tool with the -debug option. A value of 1 enables additional informational messages. A value of 2 enables informational and debug messages. A value of 3 enables informational, debug, and trace messages.
Most of the command line arguments can be specified in a property file and the property file path specified on the command line with the -propertyFile argument. Alternatively, the property file can be saved as WContentVerify.properties in the Windchill codebase directory, which is the default name and place that this utility searches for.
* 
Arguments specified on the command line override property settings in the property file.
An example property file format is as follows:
# Path to the directory that will store utility's output. If not
# specified, will default to $WT_HOME/logs
OUTPUT_STORAGE_PATH=D:\\XML_Output\\

# true/false Enable sending of summary email after a run of the utility
# The wt.properties setting of wt.mail.mailhost is required
EMAIL_GROUP.enabled=true

# Comma separated windchill usernames. Everyone on this list receives
# email notification of a completed utility execution. No spaces allowed.
EMAIL_GROUP.list=testUser1,testUser2

# Enable sending emails to modifiers of the files that have been detected to have
# errors
DIRECT_EMAIL.enabled=true

# Subject of emails sent to modifiers of files that have been detected to have
# errors
DIRECT_EMAIL.mailSubject=Direct Email Report

# Opening line(s) of emails sent to modifiers of files that have been detected to
# have errors
DIRECT_EMAIL.body=First line of Direct Email Report

# Valid windchill username that will be set as the originator of the email
# notification
DIRECT_EMAIL.replyTo=testUser3

# Valid values are html or text. Determines whether the modifiers receive a text
# or html email
DIRECT_EMAIL.format=html

# The maximum number of errors permissible for direct email to be sent.
# If the total number of errors is greater than this number,
# no direct emails will be sent, default is 2000
DIRECT_EMAIL.limit=1500

# Must be one of All or onlyReportLatest . Reports errors either in all
# iterations or the last iteration of iterated objects, default is All.
REPORT_DOCUMENTS_FILTER=All