Analyze docbase data

The docbasevalidate program provides structural analysis of a docbase.

The contents of the output file are not relevant for day-to-day TEXTML Server operations. However, when troubleshooting you might want to use the procedure below to generate a file which you can send to IXIASOFT Customer Support for analysis.

To use the docbasevalidate tool:

  1. Stop the TEXTML Server service to take the docbase offline.
  2. Open a command-line interface to the server.
  3. Navigate to the TEXTMLServer directory:
    cd %ProgramFiles%\IxiaSoft\TextmlServer[version]
  4. Enter the Docbasevalidate command as shown below, and zero or more arguments, with reference to Table 1.
    DocbaseValidate arguments --outfile path and filename for output docbase path and filename
    docbase log path and filename
    For example:
    DocbaseValidate.exe --repositoryonly --outfile c:\tmp\dbvalidate.txt c:\docbases\UserDocs[version] c:\docbases\UserDocs[version] 
    Table 1. Docbasevalidate optional arguments
    Argument Output
    --cfgfile <configfile> Config file to use to override the internal default values of the program. Typically used for changing some memory parameters.
    --storeonly Validates only the repository and versions. Includes the names, number of documents and access to various content.
    --listindexes Lists all the docbase indexes by name and by unique system ID.
    --indexonly Validates only the indexes.
    --repositoryonly Validates only the document repository (internal data structures). Does not validate access to the content.
    --consumelog Will only commit outstanding write operations into the docbase.

    This is used to speed-up subsequent opening of the docbase and for preparation for other utility programs such as conversion from one version to another.

    Tip: If you do not enter any of the optional arguments, TEXTML Server performs a full validation (all arguments are applied).
  5. Press Enter.
    A text file with docbase data is generated.
    Tip: If you get an "Error opening docbase" error, ensure that you entered the docbase name and path correctly. Re-attempt the procedure.
  6. To view the details, open the text file you specified in Step 4.
  7. Re-start TEXTML Server.