1. Maintenance and Troubleshooting Guide
  2. Fault Management
  3. Session Management for SIP H.323 and IWF

Session Management for SIP H.323 and IWF

Using the session management feature, you can display and manage SIP, H.323, and IWF sessions using a range of new ACLI commands. You can choose to view summary or detailed displays.

If you choose to terminate a session that is already in progress, the Oracle Communications Session Border Controller tears down the session and returns:

  • SIP BYE with a reason header naming administrative preemption as a cause, and where the cause code is 3
  • H.323 Disconnect with Q.850 disconnect cause code 8, preemption

Note that if your system is carrying a heavy traffic load, it could take a good amount of time to display or clear sessions. When you use these commands, a reminder will appear about the fact that it can take up to thirty seconds for the command to complete.

Displaying Sessions

You can display SIP, H.323 and IWF sessions using the ACLI show <protocol type> sessions command. This command now takes the following additional arguments:

  • all—Displays all SIP or H.323 sessions for the protocol you specify.
  • by-agent—When entered with the name of a configured session agent, displays session information for the specified session agent: adding iwf to the very end of the command shows sessions for IWF; adding detail to the very end of the command expands the displayed information
  • by-ip—When entered with the IP address of an endpoint, displays session information for the specific endpoint; adding iwf to the very end of the command shows sessions for IWF; adding detail to the very end of the command expands the displayed information

    Entries for the IP address portion of this command must be enclosed in quotation marks ()

  • by-user—When entered with the calling or called number, displays session information for the specified user; adding iwf to the very end of the command shows sessions for IWF; adding detail to the very end of the command expands the displayed information
  • by-callid—Display H.323 sessions for the call ID specified; adding iwf to the end of the command shows sessions for the IWF; adding detail to the end of the command expands the displayed information

Example 1 Displaying All SIP Sessions

The following is an example of a display showing all SIP sessions.

ORACLE# show sipd sessions all
------------------------------------------------------------------
Displaying Sessions 'all' expression ''
 This may take up to 30 seconds
------------------------------------------------------------------
   CallID(S)  1139b3d8-1d0010ac-13c4-12557b-146c746b-12557b@127.0.0.11 (ESTABLISHED)
   CallID(C)  SDo6d9601-05da1dd13301cad1523806354168b28b-v3000i1
 IWF Call Leg is = SERVER
  From (Server)
    Realm       sip172 SA=127.0.0.11
    From-URI    <sip:2180000@127.0.0.11:5060;transport=UDP>;tag=113783f0-1d0010ac-13c4-12557b-426bb44b-12557b
    To-URI      <sip:1180000@127.0.0.100:5060;transport=UDP>;tag=SDo6d9699-0000012000088798
    Contact-URI <sip:2180000@127.0.0.11:5060;transport=UDP>
  To (Client)
    Realm       h323192fs; SA=192.168.200.29
    From-URI    <sip:2180000@127.0.0.11:5060;transport=UDP>;tag=SDo6d9601-113783f0-1d0010ac-13c4-12557b-426bb44b-12557b
    To-URI      <sip:1180000@192.168.200.29:1720;acme_sa=192.168.200.29;acme_realm=h323192fs;acme_irealm=sip172;acme_iwf_itrusted>;tag=0000012000088798
    Contact-URI <sip:1180000@127.0.0.1:5070;acme_sa=192.168.200.29;acme_realm=h323192fs;acme_iwf_itrusted>
------------------------------------------------------------------
Displayed 1 out of total of 1 Sessions (msg=1)
------------------------------------------------------------------
ORACLE#

Example 2 Displaying All H.323 Sessions

The following is an example of a display showing all H.323 sessions.

ORACLE# show h323d sessions all
------------------------------------------------------------------
Displaying Sessions 'all' expression ''
 This may take up to 30 seconds
------------------------------------------------------------------
   CallID(S)  SDo6d9601-05da1dd13301cad1523806354168b28b-v3000i1 ()
   CallID(C)  80834d3a4200001f0110090e2f3cc51b
 IWF Call Leg is = SERVER
  From (Server)
    Realm
    From-URI    <sip:2180000@127.0.0.11:5060;transport=UDP>;tag=SDo6d9601-113783f0-1d0010ac-13c4-12557b-426bb44b-12557b
    To-URI      <sip:1180000@127.0.0.100:5060;transport=UDP>
  To (Client)
    Realm    ; SA=192.168.200.29
    From-URI    <sip:2180000@127.0.0.11:5060;transport=UDP>;tag=SDo6d9601-113783f0-1d0010ac-13c4-12557b-426bb44b-12557b
    To-URI      <sip:1180000@127.0.0.100:5060;transport=UDP>
------------------------------------------------------------------
Displayed 1 out of total of 1 Sessions (msg=1)
------------------------------------------------------------------
ORACLE#

Example 3 Displaying SIP Sessions for a Session Agent

The following is an example of a display showing SIP sessions for a specified session agent.

ORACLE# show sipd sessions by-agent 127.0.0.11
------------------------------------------------------------------
Displaying Sessions 'by-agent' expression '127.0.0.11'
 This may take up to 30 seconds
------------------------------------------------------------------
   CallID(S)  1139b3d8-1d0010ac-13c4-12557b-146c746b-12557b@127.0.0.11 (ESTABLISHED)
   CallID(C)  SDo6d9601-05da1dd13301cad1523806354168b28b-v3000i1
 IWF Call Leg is = SERVER
  From (Server)
    Realm       sip172 SA=127.0.0.11
    From-URI    <sip:2180000@127.0.0.11:5060;transport=UDP>;tag=113783f0-1d0010ac-13c4-12557b-426bb44b-12557b
    To-URI      <sip:1180000@127.0.0.100:5060;transport=UDP>;tag=SDo6d9699-0000012000088798
    Contact-URI <sip:2180000@127.0.0.11:5060;transport=UDP>
  To (Client)
    Realm       h323192fs; SA=192.168.200.29
    From-URI    <sip:2180000@127.0.0.11:5060;transport=UDP>;tag=SDo6d9601-113783f0-1d0010ac-13c4-12557b-426bb44b-12557b
    To-URI      <sip:1180000@192.168.200.29:1720;acme_sa=192.168.200.29;acme_realm=h323192fs;acme_irealm=sip172;acme_iwf_itrusted>;tag=0000012000088798
    Contact-URI <sip:1180000@127.0.0.1:5070;acme_sa=192.168.200.29;acme_realm=h323192fs;acme_iwf_itrusted>
------------------------------------------------------------------
Displayed 1 out of total of 1 Sessions (msg=1)
------------------------------------------------------------------
ORACLE#

Example 3 Displaying H.323 Sessions for a Session Agent

The following is an example of a display showing H.323 sessions for a specified session agent.

ORACLE# show h323d sessions by-agent 192.168.200.29
------------------------------------------------------------------
Displaying Sessions 'by-agent' expression '192.168.200.29'
 This may take up to 30 seconds
------------------------------------------------------------------
   CallID(S)  SDo6d9601-05da1dd13301cad1523806354168b28b-v3000i1 ()
   CallID(C)  80834d3a4200001f0110090e2f3cc51b
 IWF Call Leg is = SERVER
  From (Server)
    Realm
    From-URI    <sip:2180000@127.0.0.11:5060;transport=UDP>;tag=SDo6d9601-113783f0-1d0010ac-13c4-12557b-426bb44b-12557b
    To-URI      <sip:1180000@127.0.0.100:5060;transport=UDP>
  To (Client)
    Realm    ; SA=192.168.200.29
    From-URI    <sip:2180000@127.0.0.11:5060;transport=UDP>;tag=SDo6d9601-113783f0-1d0010ac-13c4-12557b-426bb44b-12557b
    To-URI      <sip:1180000@127.0.0.100:5060;transport=UDP>
------------------------------------------------------------------
Displayed 1 out of total of 1 Sessions (msg=1)
------------------------------------------------------------------
ORACLE#

Example 4 Displaying SIP Sessions for a Call ID

The following is an example of a display showing SIP sessions for a specified call ID.

ORACLE# show sipd sessions by-callId A899FD1C-8D4F-4E6C-921C-F45F5CD5DFC9@192.168.11.101
<call-id>                     Call-Id
< sessions by-callId A899FD1C-8D4F-4E6C-921C-F45F5CD5DFC9@192.168.11.101
------------------------------------------------------------------
Displaying Sessions 'by-callId' expression 'A899FD1C-8D4F-4E6C-921C-F45F5CD5DFC9@192.168.11.101'
 This may take up to 30 seconds
------------------------------------------------------------------
   CallID     A899FD1C-8D4F-4E6C-921C-F45F5CD5DFC9@192.168.11.101 (ESTABLISHED)
  From (Server)
    Realm       access SA=192.168.12.100
    From-URI    "poza"<sip:333@192.168.12.200:5060>;tag=43629539029921
    To-URI      <sip:1234@192.168.12.200:5060>;tag=EE9B4A00-BFF07BF1
    Contact-URI <sip:333@192.168.11.101:5060>
  To (Client)
    Realm       core
    From-URI    "poza"<sip:333@192.168.12.200:5060>;tag=43629539029921
    To-URI      <sip:1234@192.168.12.200:5060>;tag=EE9B4A00-BFF07BF1
    Contact-URI <sip:1234-dcgkuvfb53ne8@192.168.12.100:5060;transport=udp>
------------------------------------------------------------------
   CallID     A899FD1C-8D4F-4E6C-921C-F45F5CD5DFC9@192.168.11.101 (ESTABLISHED)
  From (Server)
    Realm       core
    From-URI    "poza"<sip:333@192.168.12.200:5060>;tag=43629539029921
    To-URI      <sip:1234@192.168.12.200:5060>;tag=EE9B4A00-BFF07BF1
    Contact-URI <sip:333-3sd0uq3ad3a65@192.168.12.100:5060;transport=udp>
  To (Client)
    Realm       access
    From-URI    "poza" <sip:333@192.168.12.200:5060>;tag=43629539029921
    To-URI      <sip:1234@192.168.12.200:5060>;tag=EE9B4A00-BFF07BF1
    Contact-URI <sip:1234@192.168.11.102>
------------------------------------------------------------------
Displayed 2 out of total of 2 Sessions (msg=1)

Clearing Sessions

You can clear sessions from the Oracle Communications Session Border Controller with the clear-sess command. You can clear all sessions, or you can:

  • Clear sessions for a specific session agent (by-agent)
  • Clear sessions for a specific call by using the call identifier (by-callid)
  • Clear sessions for a specific IP address (by-ip, where you enter the IP address in quotation marks () )
  • Clear sessions for a specific user by using the called or calling number (by-user)

Example 1 Clearing All SIP Sessions

The following is an example of clearing all SIP sessions from the Oracle Communications Session Border Controller. 

ORACLE# clear-sess sipd sessions all
------------------------------------------------------------------
Clearing Sessions 'all' expression ''
 This may take up to 30 seconds
------------------------------------------------------------------
   CallID(S)  1139b3d8-1d0010ac-13c4-12568b-333eb709-12568b@127.0.0.11 (ESTABLISHED)
   CallID(C)  SDpmd9601-8a9346384f02a41972cf4e65d7b692be-v3000i1
 IWF Call Leg is = SERVER
  From (Server)
    Realm       sip172 SA=127.0.0.11
    From-URI    <sip:2180000@127.0.0.11:5060;transport=UDP>;tag=113783f0-1d0010ac-13c4-12568b-3ce7f7a6-12568b
    To-URI      <sip:1180000@127.0.0.100:5060;transport=UDP>;tag=SDpmd9699-0000022c000a0e38
    Contact-URI <sip:2180000@127.0.0.11:5060;transport=UDP>
  To (Client)
    Realm       h323192fs; SA=192.168.200.29
    From-URI    <sip:2180000@127.0.0.11:5060;transport=UDP>;tag=SDpmd9601-113783f0-1d0010ac-13c4-12568b-3ce7f7a6-12568b
    To-URI      <sip:1180000@192.168.200.29:1720;acme_sa=192.168.200.29;acme_realm=h323192fs;acme_irealm=sip172;acme_iwf_itrusted>;tag=0000022c000a0e38
    Contact-URI <sip:1180000@127.0.0.1:5070;acme_sa=192.168.200.29;acme_realm=h323192fs;acme_iwf_itrusted>
Clear Call [y/n]?: y
*** Call Cleared ***
------------------------------------------------------------------
Cleared 1 Sessions
------------------------------------------------------------------
ORACLE#

Example 2 Clearing an H.323 Session by User

The following is an example of clearing an H.323 session for a specific user from the Oracle Communications Session Border Controller. 

ORACLE# clear-sess h323d sessions by-user 2180000
------------------------------------------------------------------
Clearing Sessions 'by-user' expression '2180000'
 This may take up to 30 seconds
------------------------------------------------------------------
   CallID(S)  SD70bp801-c3ab2f185aa73aca37d1fc619ec16a2f-v3000i1 ()
   CallID(C)  c080c5f0c600001f0112090e2f3cc51b
 IWF Call Leg is = SERVER
  From (Server)
    Realm
    From-URI    <sip:2180000@127.0.0.11:5060;transport=UDP>;tag=SD70bp801-1138cd28-1d0010ac-13c4-1257b5-1a5eebc4-1257b5
    To-URI      <sip:1180000@127.0.0.100:5060;transport=UDP>
  To (Client)
    Realm    ; SA=192.168.200.29
    From-URI    <sip:2180000@127.0.0.11:5060;transport=UDP>;tag=SD70bp801-1138cd28-1d0010ac-13c4-1257b5-1a5eebc4-1257b5
    To-URI      <sip:1180000@127.0.0.100:5060;transport=UDP>
Clear Call [y/n]?: y
*** Call Cleared ***
 Retrying the command
------------------------------------------------------------------
Cleared 1 Sessions
------------------------------------------------------------------
ORACLE#