Unsupported content

 

This version of the product has reached end of support. The documentation is available for your convenience. However, you must be logged in to access it. You will not be able to leave comments.

Using the log files to troubleshoot

Log files are the one of the primary sources of information used to troubleshoot issues in BMC Atrium Orchestrator.

For most issues, the grid.log file, located in AO_HOME/tomcat/logs is the most helpful. If you experience a problem when running your own workflows, the processes.log, located in AO_HOME/tomcat/logs, might be the most useful in diagnosing the problem. If the server has stopped or will not come up, the catalina.log (for Windows) or catalina.out (for Linux or UNIX) file, located in AO_HOME/tomcat/logs might be the most helpful.

What to look for in the logs

Each of the logs has key words or phrases to search for. If you find the word or words, look for the time stamp on the same line as or just before the word or phrase. Look also for the next time stamp after the word or phrase. The information between the time stamps contains details about the problem.

Note

Several lines of text might be between the time stamps.

In the grid.log file, search for the following terms:

Search StringMeaning

FATAL

There is either an adapter error or a grid error.

ERROR

There is either an adapter error or a grid error.

MessageNum

The error occurred in Remedy IT Service Manager.

Adapter-Request

An adapter request was sent. Determine whether the request succeeded or failed.

In the processes.log file, search for the following terms: 

Search StringMeaning

ERROR

There is either an adapter error or a grid error.

MessageNum

The error occurred in Remedy IT Service Manager.

In the catalina.log file or the catalina.out file, search for the following term:  

Search String

Meaning

SEVERE

There is a problem with Java.

java.lang(java stack dump)

There is a problem with Java.

Search the BMC Knowledge Base


After you search for the key words, review the information on the lines closest to the key words. Look for any error messages or other distinctive information. Then use the BMC Knowledge Base to search for information relevant to the error message that you find. You can access the BMC Knowledge Base from the BMC Customer Support web page at http://www.bmc.com/support.

grid.log example

05 Nov 2009 06:52:35,279 ERROR DefaultListableBeanFactory : Destroy method on bean
with name '_filterChainProxyPostProcessor' threw an exception
java.lang.OutOfMemoryError: Metaspace

In this example, you would search the knowledge base for the phrase "OutOfMemoryError" or "Metaspace."

catalina.log example

Nov 2, 2009 5:07:47 PM org.apache.coyote.http11.Http11Protocol init
SEVERE: Error initializing endpoint
java.net.BindException: Address already in use<null>:8080


In this example, you would search the knowledge base for the phrase "Error initializing endpoint" or "Address already in use."

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments