Using built-in tools to diagnose appliance problems - IBM Websphere

After network connectivity issues are ruled out, there are various tools resident on the DataPower B2BAppliance that are useful in identifying application and configuration problems.

Using the B2B Transaction Viewer

When the viewer is configured for external access,external partners can access the viewer to viewtransactions. Make sure that the B2B Transaction Viewer is configured

Checking the appliance status

To get a general assessment of the appliance’s health, check the file system information to ensure that no limits are reached. The Filesystem Information object can provide information about why the appliance stopped processing messages. If the logging facility fills up the available file space, the logging facility can no longer write events. When the logging facility cannot write messages, the logging facility prevents the
processing of incoming messages.

From the WebGUI, select Status System Filesystem Information to see the information displayed.

Filesystem Information

Filesystem Information

Also, check the System usage by selecting Status System System Usage.

Checking the system log

Logging can be viewed at the system-wide level or at the domain-specific level.Logging is the primarymeans to determine the cause of a problem and to verify when a particular problem is solved.a system-wide log.

System Log

System Log

By default,the appliance log level is error, which provides minimal information if and only if errors occur. In order to get more relevant troubleshooting information,change the log level to debug when the goal is to troubleshoot.

To change the logging level for the appliance-wide log or the domain-specific log, use the followingprocedure:

  1. From the control panel, click the Troubleshooting icon.
  2. Navigate to the Logging section.
  3. Select the debug logging level from the Log Level list.
  4. Click Set Log Level.

Note that the log must be viewed from the bottom to the top,because the most recent chronological entries are at the top. Each new sequence has a similar time stamp. You can view the sequence of events from start to finish and note each error or warning message as another clue to the problem that you are attempting to solve.

Checking the audit log

The audit log in the default domain records changes depending on the configuration of the appliance. To view the audit log, select STATUS View Logs System Logs.depicts a typical audit log window.

Audit log

Audit log

The audit log contains entries about changes to the configuration of the appliance and files that are stored on the appliance.The length of the audit log is restricted to approximately 256 KB with one rotation.The audit log (audit-log) and its rotation (audit-log-1) are stored in the audit: directory.

You cannot access the audit: directory with the File Management utility. You cannot modify the entries that are written to the audit log.

Checking the Object Status

The Object Status indicates the operational state of objects in the appliance. Check the status of all the objects. An object in the down operational state can disable the overarching service.

In the B2B Gateway, the Partner Profile object is a good example of this overarching behavior. Select Objects B2B Configuration B2B Partner Profile.this shows Partner Profile objects in the up and down states.

Partner Profile object status

Partner Profile object status

Generating an error report

An error report file contains the current configuration, the current contents of the appliance log, and the current content of the command line interface (CLI) log. The Administrator can generate a verbose report at any time by using the Generate Error Report option. During the testing phase,generating an error report is an excellent first step for locating problems.The error report:

  • Is created in the temporary directory and contains the current configuration, the current contents of the system log, and the contents of the CLI log.
  • Can be sent to an e-mail address
  • Is required when engaging with IBM DataPower support

To create the report, click Generate Error Report,.

Generate Error Report

Generate Error Report

A dialog window asks for confirmation and indicates the location of the resulting file.

Error report confirmation

Error report confirmation

If an error report is available, you can view it by clicking View Error Report. The error report file opens.(You also can view the file from the File Management panel.)

View Error Report

View Error Report

You can send the error report to a designated e-mail account.

Send Error Report

Send Error Report


All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM Websphere Topics