Dial Peer Configuration Guide, Cisco IOS XE Release 3S
Server Groups in Outbound Dial Peers
Downloads: This chapterpdf (PDF - 1.3MB) The complete bookPDF (PDF - 3.21MB) | The complete bookePub (ePub - 594.0KB) | Feedback

Server Groups in Outbound Dial Peers

Server Groups in Outbound Dial Peers

This feature configures a server group (group of server addresses) that can be referenced from an outbound dial peer.

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.

Information About Server Groups in Outbound Dial Peers

You can now group IPv4 and IPv6 addresses of servers and configure it as in an outbound SIP dial-peer destination. A server group is first created and associated with a SIP outbound dial peer. When a call matches an outbound dial peer, a connection is made to one of the servers of the group, which can then route the call to the destination.

You can associate a preference with each of the servers in the group, which decides the order of selection for outgoing call setup.

You can also configure the round-robin selection of servers in the group.

You can configure up to five dial peers to a server group.

If neither round robin nor preference order is configured, the selection of servers is random.

If the specified server-group is in shutdown mode, the referenced dial peers are not selected to route outgoing calls.

How to Configure Server Groups in Outbound Dial Peers

Configuring Server Groups in Outbound Dial Peers

SUMMARY STEPS

    1.    enable

    2.    configure terminal

    3.    voice class server-group server-group-id

    4.    {ipv4 | ipv6} address [port port] [preference preference-order]

    5.    (Optional) hunt-scheme round-robin

    6.    (Optional) description string

    7.    exit

    8.    dial-peer voice dial-peer-id voip

    9.    session protocol sipv2

    10.    destination-pattern [+] string [T]

    11.    session server-group server-group-id

    12.    end

    13.    show voice class server-group server-group-id


DETAILED STEPS
     Command or ActionPurpose
    Step 1enable


    Example:
    Device> enable
    
     

    Enters privileged EXEC mode.

    • Enter your password if prompted.
     
    Step 2configure terminal


    Example:
    Device# configure terminal
    
     

    Enters global configuration mode.

     
    Step 3voice class server-group server-group-id


    Example:
    Device(config)# voice class server-group 171
    
     
    Configures a voice class server group and enters voice class configuration mode.
    • You can use the shutdown command to make the server group inactive.
     
    Step 4{ipv4 | ipv6} address [port port] [preference preference-order]


    Example:
    Device(config-class)# ipv4 10.1.1.1 preference 3
    
     

    Configures a server IP address as a part of this server group along with an optional port number and preference order.

    • Repeat this step to add up to five servers to the server group.
    • The servers are not selected by the preference value if round robin is configured in the next step.
    • Default and highest value of preference is zero.
     
    Step 5hunt-scheme round-robin


    Example:
    Device(config-class)# hunt-scheme round-robin
     
    (Optional)

    Defines a hunt method for the order of selection of target server IP addresses (from the IP addresses configured for this server group) for the setting up of outgoing calls.

    • If a hunt scheme is not defined, an available IP address of highest preference value is selected. If neither a round-robin hunt scheme nor a preference values is configured, the selection of servers is random.
     
    Step 6description string


    Example:
    Device(config-class)# description It has 3 entries
    
     
    (Optional)

    Provides a description for the server group.

     
    Step 7exit


    Example:
    Device(config-class)# exit
    
     

    Exits voice class mode and enters global configuration mode.

     
    Step 8dial-peer voice dial-peer-id voip


    Example:
    Device(config)# dial-peer voice 123 voip
    
     

    Defines a VoIP dial peer and enters dial peer configuration mode.

     
    Step 9session protocol sipv2


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

    Specifies SIP version 2 as the session protocol for calls between local and remote routers using the packet network.

     
    Step 10destination-pattern [+] string [T]


    Example:
    Device(config-dial-peer)# destination-pattern +5550179
     

    Specifies either the prefix or the full E.164 telephone number to be used for a dial peer.

     
    Step 11session server-group server-group-id


    Example:
    Device(config-dial-peer)# session server-group 171
     

    Configures the specified server group as the destination of the dial peer.

    • This command is available for SIP dial peers only.
    • If the specified server group is in shutdown mode, the dial peer is not selected to route outgoing calls.
     
    Step 12end


    Example:
    Device(config-dial-peer)# end
    
     

    Exits dial peer configuration mode and enters privileged EXEC mode.

     
    Step 13show voice class server-group server-group-id


    Example:
    Device# show voice class server-group 171
    
     

    Displays information about the voice class server group.

     

    Verifying Server Groups in Outbound Dial Peers

    SUMMARY STEPS

      1.    show voice class server-group [server-group-id]

      2.    show voice class server-group dialpeer dial-peer-id


    DETAILED STEPS
      Step 1   show voice class server-group [server-group-id]

      Displays the configurations for all configured server groups or a specified server group.



      Example:
      Device# show voice class server-group 171
      
      Voice class server-group: 171
       AdminStatus: Up                 OperStatus: Up
       Hunt-Scheme: preference         Last returned server: 10.1.1.1
       Description:
       Total server entries: 3
      
       Pref   Type   IP Address                               IP Port
       ----   ----   ----------                               -------
       1      ipv4   10.1.1.1
       2      ipv4   10.1.1.2                                 34515
       3      ipv4   2001:DB8:12:1::26
      -------------------------------------
      
      
      Step 2   show voice class server-group dialpeer dial-peer-id

      Displays the configurations for dial peers associated with server groups.



      Example:
      Device# show voice class server-group dialpeer 181
      
      Voice class server-group: 171    AdminStatus: Up
       Hunt-Scheme: round-robin
       Total Remote Targets: 3
      
       Pref   Type   IP Address                               IP Port
       ----   ----   ----------                               -------
       0      ipv4   10.1.1.2
       1      ipv4   10.5.0.1
       1      ipv4   10.1.1.1
      
      

      Configuration Examples for Server Groups in Outbound Dial Peers

      Server Groups in Outbound Dial Peers (Preference-Based Selection)

      ! Configuring the Server Group
      Device(config)# voice class server-group 171
      Device(config-class)# ipv4 10.1.1.1 preference 1
      Device(config-class)# ipv4 10.1.1.2 preference 2
      Device(config-class)# ipv4 10.1.1.3 preference 3
      Device(config-class)# description It has 3 entries
      Device(config-class)# exit
      
      
      ! Configuring an outbound SIP dial peer.   
      Device(config)# dial-peer voice 181 voip system
      !Associate a destination pattern 
      Device(config-dial-peer)# destination-pattern 3001
      Device(config-dial-peer)# session protocol sipv2
      !Associate a server group with the dial peer
      Device(config-dial-peer)# session server-group 171
      Device(config-dial-peer)# end
      
      ! Displays the configurations made for the outbound dial peer 181 associated with a server group
      Device# show voice class server-group dialpeer 181
      
      Voice class server-group: 171    AdminStatus: Up
       Hunt-Scheme: preference
       Total Remote Targets: 3
      
       Pref   Type   IP Address                               IP Port
       ----   ----   ----------                               -------
       1      ipv4   10.1.1.1
       2      ipv4   10.1.1.2
       3      ipv4   10.1.1.3
      
      ! Displays the configurations made for the server group.
      
      Device# show voice class server-group 171
      
      Voice class server-group: 171
       AdminStatus: Up                 OperStatus: Up
       Hunt-Scheme: preference         Last returned server: 10.1.1.1
       Description: It has 3 entries
       Total server entries: 3
      
       Pref   Type   IP Address                               IP Port
       ----   ----   ----------                               -------
       1      ipv4   10.1.1.1
       2      ipv4   10.1.1.2
       3      ipv4   10.1.1.3
      
      -------------------------------------
      
      

      Server Groups in Outbound Dial Peers (Round-Robin-Based Selection)

      ! Configuring the Server Group
      Device(config)# voice class server-group 171
      Device(config-class)# ipv4 10.1.1.1
      Device(config-class)# ipv4 10.1.1.2
      Device(config-class)# ipv4 10.1.1.3
      Device(config-class)# hunt-scheme round-robin
      Device(config-class)# description It has 3 entries
      Device(config-class)# exit
      
      ! Configuring an outbound SIP dial peer.   
      Device(config)# dial-peer voice 181 voip system
      ! Associate a destination pattern 
      Device(config-dial-peer)# destination-pattern 3001
      Device(config-dial-peer)# session protocol sipv2
      ! Associate a server group with the dial peer
      Device(config-dial-peer)# session server-group 171
      Device(config-dial-peer)# end
      
      ! Displays the configurations made for the outbound dial peer 181 associated with a server group
      Device# show voice class server-group dialpeer 181
      
      Voice class server-group: 171    AdminStatus: Up
       Hunt-Scheme: round-robin
       Total Remote Targets: 3
      
       Pref   Type   IP Address                               IP Port
       ----   ----   ----------                               -------
       0      ipv4   10.1.1.1
       0      ipv4   10.1.1.2
       0      ipv4   10.1.1.3
      
      ! Displays the configurations made for the server group.
      Device# show voice class server-group 171
      
      Voice class server-group: 171
       AdminStatus: Up                 OperStatus: Up
       Hunt-Scheme: round-robin        Last returned server: 10.1.1.1
       Description: It has 3 entries
       Total server entries: 3
      
       Pref   Type   IP Address                               IP Port
       ----   ----   ----------                               -------
       0      ipv4   10.1.1.1
       0      ipv4   10.1.1.2
       0      ipv4   10.1.1.3
      
      -------------------------------------
      
      

      Additional References

      Related Documents

      Related Topic Document Title
      Voice commands Cisco IOS Voice Command Reference
      Cisco IOS Commands Cisco IOS Master Command List, All Releases
      SIP Configuration Guide SIP Configuration Guide
      Configuring SIP profiles

      SIP Parameter Modificaton.

      Configuring server groups

      Configuring Server Groups.

      Technical Assistance

      Description Link

      The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.

      To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds.

      Access to most tools on the Cisco Support website requires a Cisco.com user ID and password.

      http:/​/​www.cisco.com/​support

      Feature Information for Configuring Server Groups in Outbound Dial Peers

      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.

      Table 1 Feature Information for Configuring Server Groups in Outbound Dial Peers

      Feature Name

      Releases

      Feature Information

      Configuring Server Groups in Outbound Dial Peers

      Cisco IOS XE Release 3.11S

      15.4(1)T

      This feature configures server groups (groups of IPv4 and IPv6 addresses) which can be referenced from an outbound SIP dial peer.

      The following commands were introduced or modified: voice class server-group, description, ipv4 port preference, ipv6 port preference, hunt-scheme, show voice class server-group, shutdown (Server Group).