How to enable channel ownership logging with SwitchKit
Introduction:
When debugging certain application issues with either Dialogic® MSP SwitchKit® Development Environment or Dialogic® CSP SwitchKit® Development Environment a support engineer may need additional channel ownership information that is not normally written to the logs.
Investigation of some SwitchKit application issues may require information about when an application gains or loses ownership of a channel. This logging is disabled by default as it requires more space on the host's hard drive and increases the amount of resources SwitchKit needs to run.
See also:
How to read SwitchKit messages.log with channel ownership logging enabled
How to enable channel ownership logging:
To enable channel ownership logging the following three following Environment variables must be set in either the environment or the Defaults file contained in the SK_LIB_DIR:
SK_DEBUG_CHANNEL_MANAGER
This environment variable is used to enable debug messaging coming from the LLC channel manager. When used in conjunction with SK_ENABLE _CHANNEL_OWNERSHIP_LOGGING it will enable channel ownership logging in the messages.log
SK_ENABLE_CHANNEL_OWNERSHIP_LOGGING
This environment variable is used to enable logging of the channel ownership changes for each application connected to this LLC to the messages log. A list of some examples of when a channel will gain/lost ownership follows:
• Gain of ownership
AllocateChannel (and AllocateChannelGroup)
RFS via the watchChannelGroup method
RequestChannel
requestOutseizedChannel
requestRouteControlledChannel
TransferChannel (from another application)
Redundant Application Pool (RAP) switchover to new primary
Outsieze or routeControl on an unclaimed channel
• Loss of ownership
Transfer channel (to another application)
sk_returnChannel
ChannelReleased (withdata) message received from switch
DS0 of purge or out of service
Termination of application
Redundant Application Pool (RAP) switchover to new primary
SK_LOG_LEVEL
This environment variable is used to enable the messages log that the above two environment variables will write debug channel data to.
These Environment variables will need to be set as follows in the environment for channel management logging to work correctly:
SK_LOG_LEVEL=3
SK_ENABLE_CHANNEL_OWNERSHIP_LOGGING= 1
SK_DEBUG_CHANNEL_MANAGER= 1
or set as follows in the defaults file:
log_level:3
enable_channel_ownership_logging:1
debug_channel_manager:1
This will enable printing similar to the following in the messages log showing a SK application(201) gaining and then losing control of a channel:
Jul 12 2010 11:21:13 ChanMgmntInfo(ChannelController::handleRequestChannelMsg): Attempting to reserve (sp:(0x32) ch:(0x00) in state:(Idle)) for app(201)
Jul 12 2010 11:21:13 ChanMgmntInfo(ChannelController::handleRequestChannelMsg): Successfully reserved (sp:(0x32) ch:(0x00) in state:(Reserved)) for app(201)
Jul 12 2010 11:21:13 ChanMgmntInfo(ChannelController::newCallAttempt): Calling outgoingCallBegin on (sp:(0x32) ch:(0x00) in state:(Reserved)) for app(201)
Jul 12 2010 11:21:13 ChanMgmntInfo(CH_Reserved::outgoingCallBegin): Outseize assigning app(201) as owner of (sp:(0x32) ch:(0x00) in state:(Reserved))
Jul 12 2010 11:21:13 H LLC ->X4000 : 00 e8 00 01 00 00 01 29 02 ff fe 02 02 1e 16 00 03 00 13 00 02 00 09 00 0f 00 01 0b 00 09 00 05 0d 03 00 32 00 03 00 33 00 22 00 04 27 92 00 04 c0 a8 01 40 27 93 00 04 00 00 27 37 27 94 00 04 c0 a8 01 03 27 95 00 04 00 00 27 37
Jul 12 2010 11:21:14 H LLC =>H201 : 00 e8 00 01 00 00 01 29 02 ff fe 02 02 1e 16 00 03 00 13 00 02 00 09 00 0f 00 01 0b 00 09 00 05 0d 03 00 32 00 03 00 33 00 22 00 04 27 92 00 04 c0 a8 01 40 27 93 00 04 00 00 27 37 27 94 00 04 c0 a8 01 03 27 95 00 04 00 00 27 37 (orig msg was 00 e8 00 01 00 00 10 01 02 1e 09 00 01 00 39 00 03 00 32 00 )
Jul 12 2010 11:21:37 H LLC ->X4000 : 00 08 00 01 00 00 02 0d 03 00 32 00 0d 03 00 32 00
Jul 12 2010 11:21:37 H LLC =>H201 : 00 08 00 01 00 00 02 0d 03 00 32 00 0d 03 00 32 00 (orig msg was 00 08 00 01 00 00 10 )
Jul 12 2010 11:21:37 H LLC ->X4000 : 00 69 00 f8 00
Jul 12 2010 11:21:37 ChanMgmntInfo(CH_InUse::handleIncomingMsg): AutoReturn clearing app(201) as owner of (sp:(0x32) ch:(0x00) in state:(In Use))
Jul 12 2010 11:21:37X4000 ->H201 : 00 69 00 f8 00 00 01 0d 03 00 32 00 02 02 1e 2a 00 05 01 04 00 04 00 00 00 00 01 05 00 04 00 00 00 00 01 11 00 04 00 00 00 01 01 10 00 04 00 00 00 00 01 12 00 04 00 00 00 a0 03 00 33 00 28 00 05 27 4e 00 02 00 10 27 92 00 04 c0 a8 01 40 27 93 00 04 00 00 27 37 27 94 00 04 c0 a8 01 03 27 95 00 04 00 00 27 37
Product List
Dialogic® CSP SwitchKit® Development Environment
Dialogic® MSP SwitchKit® Development Environment
See also:How to read SwitchKit messages.log with channel ownership logging enabled
First published: 22-Jul-2010
Last published: 20-Dec-2010
Open access: Product rule: ; Page rule: Auto
