Cisco Unified Border Element (Enterprise) SIP Support Configuration Guide, Cisco IOS XE Release 3S
Configurable SIP Parameters via DHCP
Downloads: This chapterpdf (PDF - 1.41MB) The complete bookPDF (PDF - 4.02MB) | The complete bookePub (ePub - 806.0KB) | Feedback

Configurable SIP Parameters via DHCP

Contents

Configurable SIP Parameters via DHCP

The Configurable SIP Parameters via DHCP feature allows a Dynamic Host Configuration Protocol (DHCP) server to provide Session Initiation Protocol (SIP) parameters via a DHCP client. These parameters are used for user registration and call routing.

The DHCP server returns the SIP Parameters via DHCP options 120 and 125. These options are used to specify the SIP user registration and call routing information. The SIP parameters returned are the SIP server address via Option 120, and vendor-specific information such as the pilot, contract or primary number, an additional range of secondary numbers, and the SIP domain name via Option 125.

In the event of changes to the SIP parameter values, this feature also allows a DHCP message called DHCPFORCERENEW to reset or apply a new set of values.

The SIP parameters provisioned by DHCP are stored, so that on reboot they can be reused.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table at the end of this module.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/​go/​cfn. An account on Cisco.com is not required.

Prerequisites for Configurable SIP Parameters via DHCP

  • A DHCP interface has to be associated with SIP before configurable SIP parameters via DHCP can be enabled.

Cisco Unified Border Element

  • Cisco IOS Release 12.4(22)YB or a later release must be installed and running on your Cisco Unified Border Element.

Cisco Unified Border Element (Enterprise)

  • Cisco IOS XE Release <TBD> or a later release must be installed and running on your Cisco ASR 1000 Series Router.

Restrictions for Configurable SIP Parameters via DHCP

  • DHCP Option 120 is the standard DHCP option (RFC3361) to get a SIP server address, and this can be used by any vendor DHCP server. Only one address is supported, which is in the IPv4 address format. Multiple IPv4 address entries are not supported. Also, there is no support for a DNS name in this or for any port number given behind the IPv4 address.
  • DHCP Option 125 (RFC 3925) provides vendor-specific information and its interpretation is associated with the enterprise identity. The primary and secondary phone numbers and domain are obtained using Option 125, which is vendor-specific. As long as other customers use the same format as in the Next Generation Network (NGN) DHCP specification, they can use this feature.
  • A primary or contract number is required in suboption 202 of DHCP Option 125. There can be only one instance of the primary number and not multiple instances.
  • Multiple secondary or numbers in suboption 203 of DHCP Option 125 are supported. Up to five numbers are accepted and the rest ignored. Also, they have to follow the contract number in the DHCP packet data.
  • Authentication is not supported for REGISTER and INVITE messages sent from a Cisco Unified Border Element that uses DHCP provisioning
  • The DHCP provisioning of SIP Parameters is supported only over one DHCP interface.
  • The DHCP option is available only to be configured for the primary registrar. It will not be available for a secondary registrar.

Information About Configurable SIP Parameters via DHCP

To perform basic Configurable SIP Parameters via DHCP configuration tasks, you should understand the following concepts:

Cisco Unified Border Element Support for Configurable SIP Parameters via DHCP

The Cisco Unified Border Element provides the support for the DHCP provisioning of the SIP parameters.

The NGN is modeled using SIP as a VoIP protocol. In order to connect to NGN, the User to Network Interface (UNI) specification is used. Cisco TelePresence Systems (CTS), consisting of an IP Phone, a codec, and Cisco Unified Communications Manager, are required to internetwork over the NGN for point-to-point and point-to-multipoint video calls. Because Cisco Unified Communications Manager does not provide a UNI interface, there has to be an entity to provide the UNI interface. The Cisco Unified Border Element provides the UNI interface and has several advantages such as demarcation, delayed offer to early offer, and registration.

The figure below shows the Cisco Unified Border Element providing the UNI interface for the NGN.

Figure 1. Cisco NGN with Cisco Unified Border Element providing UNI interface

DHCP to Provision SIP Server, Domain Name, and Phone Number

NGN requires Cisco Unified Border Element to support DHCP (RFC 2131 and RFC 2132) to provision the following:

  • IP address for Cisco Unified Border Element’s UNI interface facing NGN
  • SIP server address using option 120
  • Option 125 vendor specific information to get:
    • Pilot number (also called primary or contract number), there is only one pilot number in DHCPACK, and REGISTER is done only for the pilot number
    • Additional numbers, or secondary numbers, are in DHCPACK; there is no REGISTER for additional numbers
    • SIP domain name
  • DHCPFORCERENEW to reset or apply a new set of SIP parameters (RFC 3203)

DHCP-SIP Call Flow

The following scenario shows the DHCP messages involved in provisioning information such as the IP address for UNI interface, and SIP parameters including the SIP server address, phone number, and domain name, along with how SIP messages use the provisioned information.

The figure below shows the DHCP and SIP messages involved in obtaining the SIP parameters and using them for REGISTER and INVITE.

Figure 2. DHCP-SIP Call Flow

DHCP Message Details

The DHCP call flow involved in obtaining Cisco Unified Border Element provision information, including the IP address for UNI interface and SIP information such as phone number, domain, and SIP server, is shown in the figure below.

Figure 3. DHCP Message Details

The DHCP messages involved in provisioning the SIP parameters are described in Steps 1 to 6.

  1. F1: The Cisco Unified Border Element DHCP client sends a DHCPDISCOVER message to find the available NGN DHCP servers on the network and obtain a valid IPv4 address. The Cisco Unified Border Element DHCP client identity (computer name) and MAC address are included in this message.
  2. F2: The Cisco Unified Border Element DHCP client receives a DHCPOFFER message from each available NGN DHCP server. The DHCPOFFER message includes the offered DHCP server’s IPv4 address, the DHCP client’s MAC address, and other configuration parameters.
  3. F3: The Cisco Unified Border Element DHCP client selects an NGN DHCP server and its IPv4 address configuration from the DHCPOFFER messages it receives, and sends a DHCPREQUEST message requesting its usage. Note that this is where Cisco Unified Border Element requests SIP server information via DHCP Option 120 and vendor- identifying information via DHCP Option 125.
  4. F4: The chosen NGN DHCP server assigns its IPv4 address configuration to the Cisco Unified Border Element DHCP client by sending a DHCPACK message to it. The Cisco Unified Border Element DHCP client receives the DHCPACK message. This is where the SIP server address, phone number and domain name information are received via DHCP options 120 and 125. The Cisco Unified Border Element will use the information for registering the phone number and routing INVITE messages to the given SIP server.
  5. F5: When NGN has a change of information or additional information (such as changing SIP server address from 1.1.1.1 to 2.2.2.2) for assigning to Cisco Unified Border Element, the DHCP server initiates DHCPFORCERENEW to the Cisco Unified Border Element. If the authentication is successful, the Cisco Unified Border Element DHCP client accepts the DHCPFORCERENEW and moves to the next stage of sending DHCPREQUEST. Otherwise DHCPFORCERENEW is ignored and the current information is retained and used.
  6. F6 and F7: In response to DHCPFORCERENEW, similar to steps F3 and F4, the Cisco Unified Border Element requests DHCP Options 120 and 125. Upon getting the response, SIP will apply these parameters if they are different by sending an UN-REGISTER message for the previous phone number and a REGISTER message for the new number. Similarly, a new domain and SIP server address will be used. If the returned information is the same as the current set, it is ignored and hence registration and call routing remains the same.

How to Configure SIP Parameters via DHCP

Configuring the DHCP Client

To receive the SIP configuration parameters the Cisco Unified Border Element has to act as a DHCP client. This is because in the NGN network, a DHCP server pushes the configuration to a DHCP client. Thus the Cisco Unified Border Element must be configured as a DHCP client.

Perform this task to configure the DHCP client.

Before You Begin

You must configure the ip dhcp client commands before entering the ip address dhcp command on an interface to ensure that the DHCPDISCOVER messages that are generated contain the correct option values. The ip dhcp clientcommands are checked only when an IP address is acquired from DHCP. If any of the ip dhcp client commands are entered after an IP address has been acquired from DHCP, the DHCPDISCOVER messages’ correct options will not be present or take effect until the next time the router acquires an IP address from DHCP. This means that the new configuration will only take effect after either the ip address dhcp command or the release dhcp and renew dhcp EXEC commands have been configured.

SUMMARY STEPS

    1.    enable

    2.    configure terminal

    3.    interface type number

    4.    ip dhcp client request sip-server-address

    5.    ip dhcp client request vendor-identifying-specific

    6.    ip address dhcp

    7.    exit


DETAILED STEPS
     Command or ActionPurpose
    Step 1 enable


    Example:
    Router> enable
     

    Enables privileged EXEC mode.

    • Enter your password if prompted.
     
    Step 2 configure terminal


    Example:
    Router# configure terminal
     

    Enters global configuration mode.

     
    Step 3 interface type number


    Example:
    Router(config)# interface gigabitethernet 0/0
     

    Configures an interface type and enters interface configuration mode.

     
    Step 4 ip dhcp client request sip-server-address


    Example:
    Router(config-if)# ip dhcp client request sip-server-address
     

    Configures the DHCP client to request a SIP server address from a DHCP server.

     
    Step 5 ip dhcp client request vendor-identifying-specific


    Example:
    Router(config-if)# ip dhcp client request vendor-identifying-specific
     

    Configures the DHCP client to request vendor-specific information from a DHCP server.

     
    Step 6 ip address dhcp


    Example:
    Router(config-if)# ip address dhcp
     

    Acquires an IP address on the interface from the DHCP.

     
    Step 7 exit


    Example:
    Router(config-if)# exit
     

    Exits the current mode.

     

    Configuring the DHCP Client Example

    The following is an example of how to enable the DHCP client:

    Router> enable
    Router# configure terminal
    Router(config)# interface gigabitethernet 1/1
    Router(config-if)# ip dhcp client request sip-server-address
    Router(config-if)# ip dhcp client request vendor-identifying-specific
    Router(config-if)# ip address dhcp
    Router(config-if)# exit
    

    Enabling the SIP Configuration

    Enabling the SIP configuration allows the Cisco Unified Border Element to use the SIP parameters received via DHCP for user registration and call routing. Perform this task to enable the SIP configuration.

    Before You Begin

    The dhcp interface command has to be entered to declare the interface before the registrar and credential commands are entered.

    SUMMARY STEPS

      1.    enable

      2.    configure terminal

      3.    interface type number

      4.    sip-ua

      5.    dhcp interface type number

      6.    registrar dhcp expires seconds random-contact refresh-ratio seconds

      7.    credentials dhcp password [0| 7] password realm domain-name

      8.    exit


    DETAILED STEPS
       Command or ActionPurpose
      Step 1 enable


      Example:
      Router> enable
       

      Enables privileged EXEC mode.

      • Enter your password if prompted.
       
      Step 2 configure terminal


      Example:
      Router# configure terminal
       

      Enters global configuration mode.

       
      Step 3 interface type number


      Example:
      Router(config)# interface gigabitethernet 0/0
       

      Configures an interface type and enters interface configuration mode.

       
      Step 4 sip-ua


      Example:
      Router(config-if)# sip-ua
       

      Enters SIP user-agent configuration mode.

       
      Step 5 dhcp interface type number


      Example:
      Router(sip-ua)# dhcp interface gigabitethernet 0/0
       

      Assigns a specific interface for DHCP provisioning of SIP parameters.

      • Multiple interfaces on the CUBE can be configured with DHCP--this command specifies the DHCP interface used with SIP.
       
      Step 6 registrar dhcp expires seconds random-contact refresh-ratio seconds


      Example:
      Router(sip-ua)# registrar dhcp expires 100 random-contact refresh-ratio 90
       

      Registers E.164 numbers on behalf of analog telephone voice ports (FXS) and IP phone virtual voice ports (EFXS) with an external SIP proxy or SIP registrar server.

      • expires seconds --Specifies the default registration time, in seconds. Range is 60 to 65535. Default is 3600.
      • refresh-ratio seconds --Specifies the refresh-ratio, in seconds. Range is 1 to 100 seconds. Default is 80.
       
      Step 7 credentials dhcp password [0| 7] password realm domain-name


      Example:
      Router(sip-ua)# credentials dhcp password cisco realm cisco.com
       

      Sends a SIP registration message from a Cisco Unified Border Element in the UP state.

       
      Step 8 exit


      Example:
      Router(sip-ua)# exit
       

      Exits the current mode.

       

      Enabling the SIP Configuration Example

      The following is an example of how to enable the SIP configuration:

      Router> enable
      Router# configure terminal
      Router(config)# interface gigabitethernet 1/0
      Router(config-if)# sip-ua
      Router(sip-ua)# dhcp interface gigabitethernet 1/0
      Router(sip-ua)# registrar dhcp expires 90 random-contact refresh-ratio 90
      Router(sip-ua)# credentials dhcp password cisco realm cisco.com
      Router(sip-ua)# exit
      

      Troubleshooting Tips

      To display information on DHCP and SIP interaction when SIP parameters are provisioned by DHCP, use the debug ccsip dhcp command in privileged EXEC mode.

      Configuring a SIP Outbound Proxy Server

      An outbound-proxy configuration sets the Layer 3 address (IP address) for any outbound REGISTER and INVITE SIP messages. The SIP server can be configured as an outbound proxy server in voice service SIP configuration mode or dial peer configuration mode. When enabled in voice service SIP configuration mode, all the REGISTER and INVITE messages are forwarded to the configured outbound proxy server. When enabled in dial-peer configuration mode, only the messages hitting the defined dial-peer will be forwarded to the configured outbound proxy server.

      The configuration tasks in each mode are presented in the following sections:

      Perform either of these tasks to configure the SIP server as a SIP outbound proxy server.

      Configuring a SIP Outbound Proxy Server in Voice Service VoIP Configuration Mode

      Perform this task to configure the SIP server as a SIP outbound proxy server in voice service SIP configuration mode.

      SUMMARY STEPS

        1.    enable

        2.    configure terminal

        3.    voice service voip

        4.    sip

        5.    outbound-proxy dhcp

        6.    exit


      DETAILED STEPS
         Command or ActionPurpose
        Step 1 enable


        Example:
        Router> enable
         

        Enables privileged EXEC mode.

        • Enter your password if prompted.
         
        Step 2 configure terminal


        Example:
        Router# configure terminal
         

        Enters global configuration mode.

         
        Step 3 voice service voip


        Example:
        Router(config)# voice service voip
         

        Enters voice service VoIP configuration mode and specifies VoIP as the voice-encapsulation type.

         
        Step 4 sip


        Example:
        Router(config-voi-srv)# sip
         

        Enters voice service SIP configuration mode.

         
        Step 5 outbound-proxy dhcp


        Example:
        Router(conf-serv-sip)# outbound-proxy dhcp
         

        Configures the DHCP client to request a SIP server address from a DHCP server.

         
        Step 6 exit


        Example:
        Router(config-serv-sip)# exit
         

        Exits the current mode.

         

        Configuring a SIP Outbound Proxy Server in Voice Service VoIP Configuration Mode Example

        The following is an example of how to configure a SIP outbound proxy in voice service SIP configuration mode:

        Router> enable
        Router# configure terminal
         
        Router(config)# voice service voip
        Router(config-voi-srv)# sip
        Router(conf-serv-sip)# outbound-proxy dhcp
        Router(config-serv-if)# exit
        

        Configuring a SIP Outbound Proxy Server and Session Target in Dial Peer Configuration Mode

        Perform this task to configure the SIP server as a SIP outbound proxy server in dial peer configuration mode.


        Note


        SIP must be configured on the dial pier before DHCP is configured. Therefore the session protocol sipv2 command must be executed before the session target dhcp command. DHCP is supported only with SIP configured on the dial peer.

        >
        SUMMARY STEPS

          1.    enable

          2.    configure terminal

          3.    dial-peer voice number voip

          4.    session protocol sipv2

          5.    voice-class sip outbound-proxy dhcp

          6.    session target dhcp

          7.    exit


        DETAILED STEPS
           Command or ActionPurpose
          Step 1 enable


          Example:
          Router> enable
           

          Enables privileged EXEC mode.

          • Enter your password if prompted.
           
          Step 2 configure terminal


          Example:
          Router# configure terminal
           

          Enters global configuration mode.

           
          Step 3 dial-peer voice number voip


          Example:
          Router(config)# dial-peer voice 10 voip
           

          Defines a dial peer, specifies VoIP as the method of voice encapsulation, and enters dial peer configuration mode.

           
          Step 4 session protocol sipv2


          Example:
          Router(config-dial-peer)# session protocol sipv2
           

          Enters the session protocol type as SIP.

           
          Step 5 voice-class sip outbound-proxy dhcp


          Example:
          Router(config-dial-peer)# voice-class sip outbound-proxy dhcp
           

          Configures the SIP server received from the DHCP server as a SIP outbound proxy server.

           
          Step 6 session target dhcp


          Example:
          Router(config-dial-peer)# session target dhcp
           

          Specifies that the DHCP protocol is used to determine the IP address of the session target.

           
          Step 7 exit


          Example:
          Router(config-dial-peer)# exit
           

          Exits the current mode.

           

          Configuring a SIP Outbound Proxy Server in Dial Peer Configuration Mode Example

          The following is an example of how to configure a SIP outbound proxy in dial peer configuration mode:

          Router> enable
          Router# configure terminal
          Router(config)# dial-peer voice 11 voip
          Router(config-dial-peer)# session protocol sipv2
           
          Router(config-dial-peer)# voice-class sip outbound-proxy dhcp
          Router(config-dial-peer)# session target dhcp
          Router(config-dial-peer)# exit
          

          Feature Information for Configurable SIP Parameters via DHCP

          The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.

          Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/​go/​cfn. An account on Cisco.com is not required.

          Feature History Table for the ISR.

          Table 1 Feature Information for Configurable SIP Parameters via DHCP

          Feature Name

          Releases

          Feature Information

          Configurable SIP Parameters via DHCP

          12.4(22)YB 15.0(1)M

          The Configurable SIP Parameters via DHCP feature introduces the configuring of SIP parameters via DHCP.

          The following commands were introduced or modified: credentials (sip-ua), debug ccsip dhcp, dhcp interface, ip dhcp-client forcerenew, outbound-proxy, registrar, session target (VoIP dial peer), show sip dhcp, voice-class sip outbound-proxy.

          Feature History Table for the ASR.

          Table 2 Feature Information for Configurable SIP Parameters via DHCP

          Feature Name

          Releases

          Feature Information

          Configurable SIP Parameters via DHCP

          IOS XE Release <TBD>

          The Configurable SIP Parameters via DHCP feature introduces the configuring of SIP parameters via DHCP.

          The following commands were introduced or modified: credentials (sip-ua), debug ccsip dhcp, dhcp interface, ip dhcp-client forcerenew, outbound-proxy, registrar, session target (VoIP dial peer), show sip dhcp, voice-class sip outbound-proxy.