Troubleshooting Tools

If you encounter an issue while working with WorldServer, a number of tools and resources are available to you to diagnose, track and resolve issues. Tools include:

Knowledge Base
The Knowledge Base is an online repository of documents on a variety of WorldServer topics. Its contents are worth browsing even if you are not currently experiencing any issues with WorldServer.
WorldServer logging
Logging tracks activities as you perform tasks in WorldServer. The resulting log can be helpful to pinpoint the actions that are causing issues. You can enable logging using the general.properties file or the ws_gate URL.

Before you can use logging, add the property log4.appender.logfile.File=<drive>:<path> to the general.properties file or to the Windows Registry, where, <drive>:<path> is the explicit location and filename of the log file. For example, c:\logs\ws.log. Also, clear out all logs before a log test.
Take care choosing categories to log and choose only what you need. Useful log categories include:
- com.idiominc.ws.sql
- com.idiominc.ws.sql.ConnectionPool
- com.idiominc.ws.rules
- com.idiominc.ws.rules.recurrence
- com.idiominc.ws.ais
- com.idiominc.ws.notification
- com.idiominc.ws.workflow
- com.idiominc.ws.workflow.autoactions
- com.idiominc.ws.workflow.engines
- com.idiominc.ws.workflow.engines.WorkflowEngineDaemon
Thread dumps
Thread dumps give a stack trace for each of the application server threads at a given moment in time. They are useful when a system or piece of the system is hung or appears to be hung. Methods for acquiring a thread dump vary for each application server.
Database tools
Database tools are provided by database vendors that can be helpful for a variety of troubleshooting tasks.
Deployment
Deployment is a feature that allows you to copy the objects in a WorldServer configuration from one server to another. For example, deployment allows you to copy filter configuration, recurrences, workflows, linkage, rules, and other objects. Deployment reduces the need to repeat manual configuration and testing among different systems. From a troubleshooting perspective, you can copy a working configuration onto a system with a nonworking configuration.

Deployment is achieved using wstool command line application or the deployment servlet.