SIP Options Keep Alive Overview (Gateway Busy Out)

The IMG can monitor the status of external SIP gateways by sending periodic SIP OPTIONS messages. If the gateway does not respond to one OPTIONS message the gateway will be considered down or unreachable and attempt to re-route the call to a different gateway. Once the gateway is down or considered unreachable it will take the configured amount of responses to show the gateway as UP or Reachable.

 

RFC

RFC 3261 SIP: Session Initiation Protocol, Section 11.

 

Configuration

SIP Profile 10.5.2

SIP Profile 10.5.3

External Gateway

SIP Options KeepAlive Configure

 

Configuration

Enable the SIP Busy Out feature on a specific gateway by executing the following.

 

Note: If the Options Keep Alive property is enabled, disable it before changing other Properties in the SIP External Gateway object. Then, re-enable it once the other changes have been made.  This sequence will insure the IMG is configured correctly.

  1. In the External Gateway Pane in Clientview select "enable" from the drop down menu in the "SIP Options Keep Alive" field. See below.

    10.3.3

    sc_sip_gateway_options_keepalive_10.3.3.png



    10.5.0
    sc_sip_gateway_options_keepalive.png

     

  2. Once the Options Keep Alive is enabled then the Parameters can be configured. Right click on SIP SGP profiles object pane and select New Options Keep Alive and the SIP Options Keep Alive pane will appear.

    sc_sip_options_keepalive.png

 

Number of Responses

Number of responses received before marking the gateway as reachable. Drop down menu has selections from 1 to 10 (Default 3).

 

Up Timer (s)

Timer to define the interval the IMG will send the OPTIONS message to the gateway when the gateway up and responsive. Timer is in seconds (Default=120 seconds)

 

Down Timer (s)

Timer to define the interval the IMG will send the OPTIONS message to the gateway when the gateway is down or non responsive. Timer is in seconds (Default=30 seconds)

 

EventView Alarm

A SIP gateway Alarm that will appear in both EventView and alarm.log. The alarm indicates the status of a particular SIP Gateway. This alarm will contain the status (either 'unreachable' or 'reachable') and the IP address of the Gateway. The SIP Gateway Alarm is first sent if the Gateway is considered 'unreachable'. Below are samples of the alarm messages

 

SIP Gateway Alarm

Sep 19 2007 11:08:36.838 X0[88.235.44.169]->H : 00 b9 04 0a 00 03 0a 04 07 00 04 07 cc 09 c9 4a

Sep 19 2007 11:08:36 **Major: Node 0: Entity 0xa Alarm: Unrecognized Alarm 0x4

 

00 b9 - Alarm Message

04 - Reserved

0a - Sequence Number

00 - Logical Node ID

03 - Severity (3=Major)

0a - Alarm Type ALARMentGATEWAY

04 - Gateway Unreachable  03=Gateway Reachable

07 - DATA Length

00 - Gateway Status  0=Down   1=Up

04 07 - GATEWAY ID (1031)

cb 07 65 41 - GATEWAY IP Address (203.7.101.65)

 

 

 

Alarm Cleared

This alarm is sent when the Gateway is considered 'reachable' again.

 

Sep 19 2007 11:12:38.048 X0[88.235.44.169]->H : 00 c1 02 77 00 03 0a 03 07 01 04 07 cc 09 c9 4a

Sep 19 2007 11:12:38 Major: Node 0: Entity 0xa Alarm: Unrecognized Alarm Cleared 0x3

 

00 c1 - Alarm Cleared

02 - Reserved

77 - Sequence Number

00 - Logical Node ID

03 - Severity (3=Major)

0a - Alarm Type Alarm Cleared

03 - Gateway Reachable 04=Unreachable

07 - DATA Length

01 - Gateway Status  0=Down   1=Up

04 07 - Gateway ID

cb 07 65 41 - Gateway IP address

 

 

Call Tracing

Call Tracing will capture the sending/reception of the OPTIONS method and indicate that re-routing has taken place because the gateway is down.

 

Example Call Trace:

21:24:03.305 SIP (W)

                        <--- [10.129.43.154, 5060 <- 10.129.43.23, 5060]

                       OPTIONS sip:10.129.43.154:5060;ttl=0 SIP/2.0

                       Via: SIP/2.0/UDP 10.129.43.23:5060; rport;branch=z9hG4bK-

                       6df4-1156281802-19999-423

                       Call-ID: 5aa9-1e61-7222006212322-chiloe-0@10.129.43.23

                        CSeq: 1 OPTIONS

                       Max-Forwards: 70

                       To: <sip:10.129.43.154;ttl=0>

                       From: <sip:10.129.43.23>;tag=95ffcd055e0f78f7d5d397020e8

                       9288db5f2

                       User-Agent: Dialogic-SIP/10.3.2.57 chiloe 0

                       Contact: <sip:10.129.43.23:5060>

                       Accept: application/ sdp

                       Content-Length: 0

 

Example entry in Call Trace:

13:12:48.804 CALL(GCL) (01:00003:01) WARNING: Channel Group [Lap_PC],GWIP [10.129.51.137] DOWN, trying next one

 

 

Additional Information