Collecting Data: IBM Connections 4.0 and 4.5 Forums

Technote (FAQ)


This document applies only to the following language version(s):

English

Question

Gathering this information before calling IBM support will reduce the time that it takes to understand and resolve your problem.

Answer

Collecting Log information can be automated (using IBM Support Assistant Lite (ISA Lite)) or collected manually.
Automated data collection:

Collecting the following log information is automated in the IBM Support Assistant Lite (ISA Lite) tool for IBM Connections. This tool is included with the product and can be found:

<IBM Connections program dir>\data\shared\tools\isa

To run the ISA tool, please follow these steps:
1. Since the tool is a Java application, it is necessary to set the JAVA_HOME environment variable before the tool can start.

Execute the following script:

AIX® or Linux®:
../setupCmdLine.sh

Windows®:
setupCmdLine.bat

2. Run ISALiteConsole.bat script in the <IBM Connections program dir>\data\shared\tools\isa directory
3. Follow the prompts to gather the data set for the problem component. Make sure you specify the cluster name of the Websphere Application Server where the component is deployed.

Detailed instructions on running and using the tool can be found here:
http://www-01.ibm.com/support/docview.wss?uid=swg24025198

When running the ISALite Collector, you can edit or modify the trace setting. Support may ask that additional trace settings be applied during ISA Collection.

Manual data collection:

Collecting the following data before contacting support will help expedite problem determination and resolution of the problem:

1. Provide a precise description of the issue, screenshots, error messages, and steps to reproduce.

2. Please provide Connection environment details:
IBM Connections version and fix level.
LDAP type, version, fix level
Amount of RAM on each of the server nodes
Is this a pilot or production installation?
Is this a new installation or an upgrade from an earlier version?
How many nodes in the cluster and are components installed to a single or multiple jvm's?
Is the problem reproducible on all nodes?
What browser types and versions are in use and is the issue reproducible on the supported browsers?
Is there a SSO solution in front of IBM Connections (Siteminder, TAM, Spnego)?
Please outline any customization that you may have.
What changes occurred in the environment prior to the issue

3. Tracing can be very verbose. If tracing is requested by support, follow these steps.

a. Log in to the IBM WebSphere Application Server (WAS) administration console using an administrator ID
b. Go to Troubleshooting -> Logs and Trace -> Logging and Tracing -> Server 1 (or server Forums is installed on) -> Diagnostic Trace Server -> Change Log Detail Levels -> please add the following *string and click Apply -> OK


Forum Specific Trace:

(1) Core service functionality
com.ibm.lconn.forum.internal.service.* 

(2) Functionality related to authenticating and building user info that drives access control
com.ibm.lconn.forum.internal.security.*
Useful to determine what communities Forums is told a user belongs to.

(3) Community life cycle event integration
com.ibm.lconn.forum.lifecycle.*
Useful for diagnosing responses to community life cycle events.

Other WAS tracing that is usually helpful


(4) Often used to trace directory services and communities integration
com.ibm.connections.httpClient.*=all:com.ibm.connections.directory.services.*=all:org.apache.commons.httpclient.*=all

(5) Widget tracing for community integration
com.ibm.lconn.widgets.service.*=all:com.ibm.lconn.widgets.actions.*=all

(6)ReplyTo
com.ibm.lconn.forum.internal.service.MailInServiceImpl=all

(6) Database tracing (very verbose)
Com.ibatis=all:com.ibatis.common.jdbc.SimpleDataSource=all:com.ibatis.common.jdbc.ScriptRunner=all:com.ibatis.sqlmap.engine.impl.SqlMapClientDelegate=all:java.sql.Connection=all:java.sql.Statement=all:java.sql.PreparedStatement=all:java.sql.ResultSet=all:com.ibm.lconn.forum.internal.ExecutionContext=all

**Note:** The DB trace settings are very verbose and are only really useful if you can limit server activity to reproducing a problem.


Collect a Fiddler Trace

Fiddler is a tool for monitoring requests made and received by a web browser. This information is often invaluable when troubleshooting a problem with IBM Connections. Due to the AJAX nature Connections, an error message may not always display the true cause of the error. A fiddler trace helps all requests or responses that may have been made.

Fiddler can be downloaded from http://www.fiddler2.com

Close all other browser windows before opening fiddler, log into connections. Run the fiddler application. Have the user perform the operation that is causing the error. When the action has been completed, save the results in fiddler by choosing “File”->”Save”->”All Sessions”.



Please configure fiddler to decrypt the https request:
Select "Decrypt HTTP traffic" and ""Ignore server Certificate errors



Keywords: Mustgather, Must Gather, Forums, 4.0



Rate this page:

(0 users)Average rating

Document information


More support for:

IBM Connections
Forums

Software version:

4.0, 4.5

Operating system(s):

Linux, Windows

Software edition:

All Editions

Reference #:

1609775

Modified date:

2013-06-26

Translate my page

Machine Translation

Content navigation