My webMethods Server 10.15 | My webMethods Server Webhelp | Diagnosing My webMethods Server | Troubleshooting My webMethods Server Using Diagnostic Tools | Troubleshooting Environment Issues
 
Troubleshooting Environment Issues
My webMethods Server has a set of tools that enable you to easily identify and troubleshoot possible issues that you may encounter while working with it. This section presents some common configuration problems that are addressed by the diagnostic tools. The tools facilitate collecting the needed troubleshooting data and additionally provide output files that can be used by a support organization, such asSoftware AG Global Support or your internal support group.
The following table outlines potential problems, a description of the problem, and a reference to the tool that assists in the resolution:
Problem
Description
Reference
You need external support for your My webMethods Server.
When you request assistance from the Software AG Global Support, you are asked to provide additional environment-specific information for My webMethods Server.
For more information, see envcapture.
You need to report information about:
*Log files.
*Configuration files.
*Installation folder structure, size, time stamps.
*File system permissions for the current operating system user account.
*Details about the local operating system and Java virtual machine.
*Details about the Internet connectivity and the connectivity to My webMethods Server database.
Use the envcapture command line tool to capture the needed information for your My webMethods Server installation.
For more information, see envcapture.
The report file created by the envcapture tool does not contain the needed information.
Use the available -a | --action command option to configure the envcapture tool to report the information that you want to capture.
For more information, see envcapture.
You want to compare snapshots created by the envcapture command line tool.
You can use the envdiff tool to compare XML files generated by the envcapture tool.
For more information, see envdiff.
You encounter issues related to environment changes.
You can identify and troubleshoot issues related to environment changes.
For more information, see envdiff.
Outline the differences in the following attributes of XML snapshot files:
*Folder structure
*File size
*MD5 hash
*Timestamp
*Permissions
You can use the envdiff tool to examine the structure of the XML files and identify differences in the corresponding environment attributes.
For more information, see envdiff.
You need to identify memory leaks within My webMethods Server.
Using the diagnostic tools you can identify possible memory leaks or troubleshoot memory allocation problems.
For more information, see:
Request further assistance from an external support organization about the memory allocation.
Use the memorydump tool to collect information and create a memory dump file.
For more information, see memorydump.
You want to capture memory allocation information on another server instance.
The -s | --server option enables you to capture memory allocation information for other server instances on the local system.
For more information, see memorydump.