By default, Instant Messenger data is not logged. You may be asked to collect client data during a support call. In this situation, you will need to enable logging before you can view client log data.
Instant Messenger logs are created on demand and stored in the user's home directory (usr_home/.sunmsgr/messenger.log).
To set up logging for Instant Messenger you will need to:
Determine the type of data you want to collect.
Modify im.jnlp to include the logconfig parameter.
Specify a type for the logconfig parameter based on the type of data you want to collect.
Redeploy the resource files.
Make a backup copy of im.jnlp.
Open the im.jnlp Instant Messenger resource file in a text editor.
Search for the line:
<application-desc main-class="com.iplanet.im.client.iIM"> |
Add the following argument to the end of the section:
<argument>logconfig=type</argument> |
Where type is one of ALL, API, XMPPTRAFFIC, or CLIENT. See Instant Messenger Log File Content Options for details.
Save and close the im.jnlp file.
If you are using Sun Java System Application Server or Sun Java System Web Server, redeploy the resource files as described in Redeploying Resource Files.
Relaunch Instant Messenger.
Locate the log file.
By default the log file is stored as usr_home/.sunmsgr/messenger.log.
You should revert back to the backup copy of im.jnlp when you have finished troubleshooting Instant Messenger. Then, redeploy the resource files as described in Redeploying Resource Files.
By default, the Instant Messenger log file is stored as messenger.log under the user's home directory as follows:
/usr_home/.sunmsgr/messenger.log |
You can determine what activity you want logged in messenger.log by specifying a value for the logconfig parameter in im.jnlp. Table 13–3 describes the configuration parameters for logconfig. See To Enable Logging for Instant Messenger for instructions on setting the logconfig parameter and generating Instant Messenger logs.
Table 13–3 Instant Messenger Logging Options for messenger.log
logconfig value |
messenger.log Contains... |
ALL |
Information for the API, all traffic between client and server, as well as debugging information for the Instant Messenger client application itself. |
API |
API information only. |
XMPPTRAFFIC |
Client to server communication only. |
CLIENT |
Client application (Instant Messenger) details only. |