Get docbase statistics
The docbasestats program will give the overall size of your docbase dictionaries (that is, the lists of indexed values), which is a good indication of the base memory needed.
To get docbase statistics:
-
Do one of the following:
- If you plan to carry out this procedure on multiple docbases installed on a single server, stop the TEXTML Server service to take the docbases offline. Skip to Step 5.
- If you plan to carry out this procedure on a single docbase while others must remain available, go to Step 2.
- Open the TEXTML Server Administration Console and connect to the server.
- Right-click the docbase whose statistics you want to check and select Uninstall to take the docbase offline.
- Close or minimize the TEXTML Server Administration Console.
- Open a command-line interface to the server.
-
Navigate to the TEXTMLServer directory:
cd /opt/ixiasoft/textmlserver/instance-name
-
Enter the docbasestats command and arguments:
For example:./docbasestats --outfile statsfile-path-and-filename.txt --user system-username docbase-path docbase-log-path
./docbasestats --outfile /docbases/news150k1/docbasestats.txt --user textml /docbases/news150k1 /docbases/news150k1
Tip: The--outfile path and filename for output
argument is optional; if you do not provide it, the statistics will be displayed directly in the command-line window. The default user ID istextml
. -
Press Enter.
The statistics for the docbase are generated.Tip:
- If you get an error -109, the docbase configuration file could not be loaded. Make sure that the DocumentBaseCfg.xml file found in the docbase directory (for example: /docbases/TEXTML[version]/Prod_v[cmsversion]) is valid and has content, and TEXTML Server is able to read it.
- If you get an error -126, the docbase has an invalid storage version. Verify the value defined as the
StorageVersion
in the DocumentBaseCfg.xml file found in the docbase directory (for example: /docbases/TEXTML[version]/Prod_v[cmsversion]). For TEXTML Server version 4.5, the storage version should be 45XX. If the storage version is not correct, you must migrate your docbase to the correct version, see the Upgrading TEXTML Server from 4.3 to 4.4 for details.
- To view the statistics, open the outfile value you specified in Step 7.
- Re-open the TEXTML Server Administration Console and re-install the docbase.