[Index]

Model: relation/HcsRouteGroupREL

Route Groups

To access the latest documentation, go to Documentation and Resources at: https://voss.portalshape.com

This procedure adds or modifies route groups.

Prerequisites:

You must define one or more gateway or SIP trunks before you add a route group.

A route group allows you to designate the order in which gateways are selected. It allows you to prioritize a list of gateways and ports for outgoing trunk selection.

For example, if you use two long distance carriers, you could add a route group so that long distance calls to the less expensive carrier are given priority. Calls only route to the more expensive carrier if the first trunk is unavailable.

Note

Each gateway or gateway and port combination can only belong to one route group and can only be listed once within that route group. All gateways in a route group must have the same route pattern. The pattern is assigned to the route list containing the route group (not the route group itself).

Route groups are optional. If a proposed route group only contains one gateway or one gateway and port combination and that route group is not to be included in a route list, the route group is not needed.

Perform the following steps:

  1. Log in as provider, reseller or customer administrator.

  2. Perform one of:

  3. Do you want to ..

  4. From the CUCM drop-down menu, choose or modify the Cisco Unified Communications Manager that corresponds to the route group.

  5. Enter a unique name for the new route group in the Route Group Name field, or modify the existing Route Group Name if desired. The name can comprise up to 50 alphanumeric characters and can contain any combination of spaces, period(s), hyphens (-), and underscore characters (_). Ensure that each route group name is unique to the route plan.

    Tip:

    Use concise and descriptive names for the route group. The CompanynameLocationGroup format usually provides a sufficient level of detail and is short enough to enable you to quickly and easily identify a route group. For example, - CiscoDallasAA1 - identifies a Cisco Access Analog route group for the Cisco office in Dallas.

  6. From the drop-down menu, select or modify the Distribution Algorithm options for the route group. Default value is Circular.

Option Description
Top Down

Select this option if you want Cisco Unified Communications Manager to distribute a call to idle or available members starting with the first idle or available member of a route group to the last idle or available member of a route group.

Note:

You need to select Top Down to prioritize the order of devices in Step 10.
Circular Chose this option if you want Cisco Unified Communications Manager to distribute a call to idle or available members starting from the (n+1)th member of a route group, where the nth member is the member to which the Cisco Unified Communications Manager most recently extended a call. If the nth member is the last member of a route group, Cisco Unified Communications Manager distributes a call starting from the top of the route group.

  1. Click + to open the Members box. Perform one or more of the following steps:

  2. To add a device to the route group:

    1. From the Device Name drop-down menu, choose the device where the route group is added.

      Note:

      When a SIP trunk or gateway is added, all ports on the device are selected.

    2. For Device Selection Order, indicate the order in which to prioritize multiple devices. A lower selection order indicates higher priority. This field requires an integer value. The default is no setting. The device selection order, if specified, overrides the position of the device in the list.

  3. To add another device to the route group, click + at the top of the Members box, then repeat Steps 8 and 9 for each additional device.

  4. If no device selection order is specified, you can change the priority of a device by moving the device up or down in the list by clicking the arrows on the right side of the Members box. Using the Up arrow, move the device higher in the list to make it a higher priority in the route group, or using the Down arrow, move the device lower in the list to make it a lower priority in the route group.

    Note: The Top Down distribution algorithm must be selected in Step 6 to prioritize the order of devices.

  5. To remove a device from the route group, select the device in the Members box and click the - on the right side of the Members box.

    Note:

    You must leave at least one device in the route group.

  6. To save a new or updated route group, click Save. The route group appears in the Route Group list.

This relation wraps the default CUCM Route Group element to allow for targeted network device addition.

Model Details: relation/HcsRouteGroupREL

Title Description Details
Distribution Algorithm * Default: Circular
  • Field Name: distributionAlgorithm
  • Type: String
  • Cardinality: [1..1]
  • Default: Circular
  • Choices: ["Top Down", "Circular", "Longest Idle Time", "Broadcast"]
Name *
  • Field Name: name
  • Type: String
  • Cardinality: [1..1]
Members
  • Field Name: members
  • Type: ["Object", "Null"]
  • Cardinality: [1..1]
Member
  • Field Name: member.[n]
  • Type: Array
  • Cardinality: [1..n]
Device Selection Order *
  • Field Name: members.member.[n].deviceSelectionOrder
  • Type: Integer
  • Cardinality: [1..1]
Device Name *
  • Field Name: members.member.[n].deviceName
  • Type: String
  • Cardinality: [1..1]
Port *
  • Field Name: members.member.[n].port
  • Type: Integer
  • Cardinality: [1..1]
Network Device
  • Field Name: networkDevice
  • Type: Object
Network Device Select the network device for which you would like to add this element.
  • Field Name: networkDevice.nd
  • Type: String
  • Choices: [" "]