Enabling debug mode for the Report Exporter installer
For products:
WebTrends Analytics (All versions - Non-Vista installs only)
Last modified: 04/06/09
Introduction/Situation:
The WebTrends Report Exporter fails to install, possibly displaying some combination of error messages in either the Java console or a DOS prompt. You want to enable the installer debugging to try to generate further debug logs.
Process:
Currently, this option is only available when running the report exporter manually, and only on non-Vista operating systems.
To enable debugging
1. Retrieve the WebTrends Report Exporter installer (docutil_installer.zip) from your WebTrends server. It is located in your WebTrends install folder under storageconfigcomponent
eportexporterdocutil_installer.zip. You can also download a copy by logging into WebTrends and going to Install Components > Accessories > WebTrends Client Components Installations and downloading the full client components package.
2. Extract the contents of the zip file to a folder. In that folder, find and edit the install.bat file.
3. Find the following text: REM Run the program %WT_JAVA% -classpath %WT_CLASSPATH% com.webtrends.docutil.installer.DocUtil_Installer %* change it to read: REM Run the program %WT_JAVA% -classpath %WT_CLASSPATH% com.webtrends.docutil.installer.DocUtil_Installer %* -debug > debug.txt
4. Save your changes.
5. Run the install.bat file. A debug.txt file is created in the Report Exporter install folder. If you want to simply run the installer in debug mode without creating text file, you can simply add -debug to the install string without the file redirection. Doing this will cause the installer to open a DOS prompt and display the debug messages inline with the installer while it runs. If you choose to do this, the DOS prompt will close when the installer finishes, however, you will be able to read the debug messages until you cancel out of the install process. A sample debug file is attached to this document.