Logging and tracing on the Sametime Embedded and Connect clients
Trace logs are stored in a workspace folder on the user's local hard drive or a network drive. Sametime Embedded and Connect client users can enable tracing on their client with the following instructions.
Procedure
- Locate the client workspace.
-
On the computer where you use the client, use a text editor and open the
rcpinstall.properties
file which is located in the following directory according to the client:- Windows
- Sametime Connect Client
C:\Users\user_name\AppData\Roaming\HCL\Sametime\.config\rcpinstall.properties
- Sametime Embedded Client (single user install path)
C:\Program Files\HCL\Notes\Data\workspace\.config\rcpinstall.properties
- Sametime Embedded Client (multi user install path)
C:\users\user_name\AppData\Local\HCL\Notes\Data\workspace\.config\rcpinstall.properties
- Sametime Connect Client
- Mac OSNote: Use the Cmd+Shift+Dot keyboard combination to show hidden folders.
- Sametime Connect Client
/Users/user_name/Library/Application Support/HCL Sametime Data/.config/rcpinstall.properties
- Sametime Embedded Client
/Users/user_name/Library/Application Support/HCL Notes Data/Expeditor/Applications/.config/rcpinstall.properties
- Sametime Embedded Client (multi user install path)
C:\users\user_name\AppData\Local\HCL\Notes\Data\workspace\.config\rcpinstall.properties
- Sametime Connect Client
- Windows
-
Add the following lines to the end of the file, depending on what kind of issue
you're diagnosing.
- General client issues
com.ibm.collaboration.realtime.level=FINE
- Instant messaging
issues
com.lotus.sametime.community.kernel.level=FINER com.lotus.sametime.im.level=FINEST com.lotus.sametime.places.level=FINEST com.ibm.collaboration.realtime.rtcadapter.level=FINEST com.ibm.collaboration.realtime.people.internal.level=FINE com.ibm.collaboration.realtime.internal.sametime.level=FINER com.ibm.collaboration.realtime.login.level=FINEST com.ibm.collaboration.realtime.community.internal.level=FINEST
- General login
failure
com.ibm.collaboration.realtime.community.internal.level=FINEST com.ibm.collaboration.realtime.im.community.level=FINEST org.apache.commons.httpclient.level=FINE com.ibm.rcp.internal.security.auth.module.level=FINEST com.ibm.collaboration.realtime.login.level=FINEST com.lotus.sametime.community.level=FINEST
- SSO
failures
com.ibm.collaboration.realtime.community.internal.level=FINEST com.ibm.collaboration.realtime.im.community.level=FINEST org.apache.commons.httpclient.level=FINE com.ibm.rcp.internal.security.auth.module.level=FINEST com.ibm.collaboration.realtime.login.level=FINEST com.lotus.sametime.community.level=FINEST com.ibm.rcp.internal.security.level=FINEST com.ibm.rcp.security.level=FINEST
- Managed
settings
com.ibm.collaboration.realtime.policy.sametime.managedsettings.level=FINEST
- Calendar integration
issues
com.ibm.rtc.meetings.servers.level=FINEST com.ibm.rtc.meetings.shelf.level=FINEST com.ibm.rtc.meetings.shelf.ui.level=FINEST com.ibm.rtc.meetings.util.level=FINEST com.ibm.collaboration.realtime.calendar.level=FINER com.ibm.collaboration.realtime.calendar.notes.level=FINEST
- Connectivity issues
com.ibm.rtccore.level=FINEST com.ibm.rtc.spaces.level=FINER
- To reduce the number of log and trace files from being overwritten,
increase the option values of the following settings from the default
values. The default values are:
- For the Connect client: 12 trace files and 6 log files
- For the Embedded client: 20 trace files and 12 log files
com.ibm.rcp.core.internal.logger.boot.RCPTraceHandler.count=20 com.ibm.rcp.core.internal.logger.boot.RCPLogHandler.count=12
- General client issues
- Save and close the file.
- Restart the Connect client.
-
View the error log and trace files in the Connect client, by clicking
. In most cases, View Trace provides the most useful information.
- Optional:
You can include logs and other data into a compressed ifle to send to support
for diagnostics.