VoiceObjects Watson

About Watson

Ever stumbled upon "What data to send to support"?

Watson is a tool to collect all data of interest about your VoiceObjects instance. It will gather logs, settings, database information and some other things.
All this information goes into a single archive that can then easily be uploaded to the Evolution portal when opening a ticket, or when support is asking for more data.
Watson is just the collector of information. Analyzing your information is a task for the support team.
Additionally, we will be very happy to help you understand the file contents for your own assessment of issues!

What is nice about Watson is that you can use it in older versions of VoiceObjects too - just get the setup archive, install it and get started!

Installation

Beginning with VoiceObjects 9.1R2 the Watson tool is part of the default Installation of VoiceObjects. It can be found in <VoiceObjectsInstallation>/Platform/WEB-INF/bin/Watson/ as Watson.bat or Watson.sh.
Before VoiceObjects 9.1R2 Watson needs to be "installed" in VoiceObjects:
VoiceObjects Server: Unpack the attached Watson archive to the /Platform/WEB-INF/bin/ directory of VoiceObjects.
VoiceObjects Desktop for Eclipse (DfE): Create a new folder /bin/ in <DfEInstallation>\plugins\com.voiceobjects.Desktop_<version>\. Unpack the attached Watson archive archive to the newly created directory.

Usage

Run watson.sh or watson.bat from the /bin/Watson folder in VoiceObjects (Server: /Platform/WEB-INF/bin/ or DfE: <DfEInstallation>\plugins\com.voiceobjects.Desktop_<version>/bin). Desktop for Eclipse also contains a shortcut in the main installation folder - run watson.bat from there!

Watson creates a ZIP file that contains important information for the support team.
Each ZIP file has a unique name:

VO-Summary-<instanceName>-<Date>-<Time>.zip.

E.g. for the instance "kschmitte_8099" the name is:

VO-Summary-kschmitte_8099-Mon13Sep-1127.zip

By default Watson retrieves the last 3 days of logs.
This is configurable in the file watson.xml (change <property name="range" value="3" />) Or you call the scripts with the desired number of days as a parameter: watson.bat 5 gets the logs for the last 5 days.

Data in the ZIP

The ZIP file contains the following VoiceObjects folders and files:

• logs
  • VODesktop_log
  • Services_log
  • VOServer_log
• configuration
  • WEB-INF/bin
  • WEB-INF/etc
  • WEB-INF/config
  • WEB-INF/properties

More Information on the system is shown in the files:

• database.txt
  • DB type and version
  • Main info on the Metadata and Infostore
• network.txt
  • network information (ifconfig / ipconfig)
  • IP address and port usage
• environment.txt
  • Information on the machine (physical)
  • Information on the OS
  • Information on the runtime environment

Attachments

Watson
Watson (for VoiceObjects releases before 9.1)