.. _set_up_sip_local_gateway:


.. rst-class:: chapter-with-expand

Set up SIP Local Gateway
------------------------

**Before You Begin**

* You must configure an IOS Device at the customer hierarchy node.
* You must configure an NDL containing the Cisco Unified CM for the customer.
* You must configure a SIP Trunk at the customer hierarchy node.

A SIP Local Gateway is a logical gateway running on a physical IOS device.


**Procedure**

1. Log in as provider, reseller, or customer administrator.
#. Set the hierarchy path to the customer for which you are setting up
   the SIP Local Gateway.
#. Choose **Device Management > IOS > SIP Local Gateways**.
#. Click **Add**.
#. On the **SIP Local Gateways** screen, complete at minimum, the mandatory
   :ref:`sip_local_gateways_fields`.
#. Click **Save**.

   * The SIP Local Gateway appears in the **SIP Local Gateway** list view.
   * The HcsAddSipLocalGwEVT event is generated. If enabled, the IOS
     Command Builder generates the default IOS commands associated with the
     event.
   * The HcsAddSipLocalGwDialPeerEVT event is generated. If enabled, the
     IOS Command Builder generates the default IOS commands associated with
     the event for each dial peer.
     

.. _sip_local_gateways_fields:

SIP Local Gateways Fields
.........................


.. tabularcolumns:: |p{3.5cm}|p{12cm}|

+------------------------+-------------------------------------------+
| Field                  | Description                               |
+========================+===========================================+
| Name \*                | Enter a name for the SIP Local Gateway.   |
|                        | This field is mandatory.                  |
+------------------------+-------------------------------------------+
| Description            | Enter a description for the SIP Local     |
|                        | Gateway.                                  |
+------------------------+-------------------------------------------+
|                        | Choose the IOS Device on which the SIP    |
|                        | Local Gateway is located. This field is   |
|                        | mandatory.                                |
|                        | Note:                                     |
| IOS Device \*          |                                           |
|                        | An IOS Device can have only one SIP Local |
|                        | Gateway.                                  |
|                        |                                           |
|                        | Once selected, the IOS Device cannot be   |
|                        | changed.                                  |
+------------------------+-------------------------------------------+
|                        | Choose the country where the SIP Local    |
|                        | Gateway is. This field is mandatory.      |
| Country \*             |                                           |
|                        | The country selected must be the same     |
|                        | country as the Site to which the SIP      |
|                        | local gateway will be associated.         |
+------------------------+-------------------------------------------+
|                        | Choose the CUCM Publisher. All CUCM       |
|                        | Publishers that are in the customer's NDL |
|                        | are displayed. This field is mandatory.   |
| CUCM Publisher \*      |                                           |
|                        | The chosen CUCM Publisher must be the     |
|                        | same as the CUCM Publisher in the NDL for |
|                        | the Site to which the SIP local gateway   |
|                        | will be associated.                       |
+------------------------+-------------------------------------------+
|                        | Choose the SIP Trunk from the ones        |
|                        | available on the CUCM Publisher. This     |
|                        | field is mandatory.                       |
|                        | Note:                                     |
|                        |                                           |
| SIP Trunk \*           | Only SIP Trunks configured at the         |
|                        | customer hierarchy are available. If the  |
|                        | customer uses a shared CUCM, then SIP     |
|                        | Trunks must be manually configured at the |
|                        | customer level in VOSS-4-UC to be         |
|                        | selectable here.                          |
+------------------------+-------------------------------------------+
|                        | Gateway Address. This field is read-only  |
|                        | and is derived from the selected SIP      |
|                        | Trunk.                                    |
| Gateway Address        |                                           |
|                        | Note:                                     |
|                        |                                           |
|                        | If a SIP Trunk has multiple destination   |
|                        | addresses, only the first one is used.    |
+------------------------+-------------------------------------------+
| Gateway Port           | Gateway Port. This field is read-only and |
|                        | is derived from the selected SIP Trunk.   |
+------------------------+-------------------------------------------+
|                        | Indicates whether call processing is      |
| Run on Every Node      | distributed across all CUCM subscriber    |
|                        | nodes. This field is read-only and is     |
|                        | derived from the selected SIP Trunk.      |
+------------------------+-------------------------------------------+
|                        | If the **Run on Every Node** is cleared   |
|                        | then the Call Manager Group members are   |
|                        | displayed in priority order.              |
| Dial Peer Info         |                                           |
|                        | If the **Run on Every Node** check box is |
|                        | selected, then all CUCM nodes in the      |
|                        | cluster are displayed, but without        |
|                        | priority.                                 |
+------------------------+-------------------------------------------+
|                        | Select this check box to have Command     |
| Enable Command         | Builder generate commands when SIP Local  |
| Builder \*             | Gateway is added, deleted, or modified.   |
|                        | Default = Selected.                       |
+------------------------+-------------------------------------------+
| Override Voice         | Select this check box to override Voice   |
| Translation Limit      | Translation Limit if E164 associations    |
| ** Warning may         | exceed 80. Default = Cleared.             |
| invalidate Command     |                                           |
| Builder Configuration**|                                           |
+------------------------+-------------------------------------------+