This utility can be used to start and stop tracing (logging) of specified sessions on the content server. The logging must be configured with the log facility trace. All sessions traced by tracesession will log in the same file. See the Section 4.7, “Logging” in Operations Basics for details on the logging of CoreMedia CMS.

Caution

Use this utility with care! tracesession will produce additional load on the server and will slow down the system. Only use tracesession for debugging custom clients or to determine the cause for unusual peaks in the server load but not for daily logging. The output of tracesession is very technical, so you probably will only benefit from it in cooperation with a CoreMedia consultant or the CoreMedia support.

usage: cm tracesession -u <user> [other options] -s <session> [-q]
          tracesession -u <user> [other options] -t <type> [-q]
available options:
 -d,--domain <domain name>   domain for login (default=<builtin>)
 -p,--password <password>    password for login
 -q                          quit tracing
 -s,--session <session>      ID of the session to be traced
 -t,--type <type>            type of the sessions to be traced
                             (one of: unknown, editor,
                              generator, publisher,replicator,
                              importer, utility, uapi,
                              all)
 -u,--user <user name>       user for login (required)
 -url <ior url>              url to connect to
 -v,--verbose                enables verbose output

The options have the following meaning:

CoreMedia recommends that you separate the tracesession logging from the standard logging (which usually goes to capserver.log), because a mixture of both looks pretty cluttered and is hard to read. Just configure an additional log action, for example

# write all trace output to a log file
log.action.2.class=FileAction
log.action.2.selectors=trace:debug
log.action.2.initArgs=\
file=var/logs/capserver-trace.log,fileSize=4000,writeOps=1000

Now you can start tracesession, for example a user's editor session which you found with the sessions tool:

> cm tracesession -u admin -p admin -s coremedia:///cap/session/14

Traces started by ID and by type are independent of each other. That is, you cannot stop tracing the above session with the following command, although it is an editor session:

> cm tracesession -u admin -p admin -t editor -q

You can only stop it by ID, just like you started it.