Route Group and Distribution Algorithm

Version 1
    This document was generated from CDN thread

    Created by: William Dellara on 18-11-2009 10:56:17 AM
    Is there a way of configuring the Distribution alorithm for a route group via AXL?  There doesn't seem to be anything in the documentation for 4.2 through to 7.1.  We tried to through the distributionAlorithm tag into the XML but CUCM just ignored it.  This seems to be a pretty basic oversight if we can't do it that's why I'm thinking I must be missing something.
     
    Any help?
     
    Thanks,
    Bill

    Subject: RE: Route Group and Distribution Algorithm
    Replied by: Dan-Anders Hook on 24-11-2009 04:45:09 PM
    Hi,
     
    I found it in the Unison_AXL_Interface_Specification. You can use "deviceSelectionOrder", which is set to  1 for Top Down and 2 for Circular.
     
    Kind regards,
     
    //Dan

    Subject: RE: Route Group and Distribution Algorithm
    Replied by: William Dellara on 26-11-2009 02:17:45 PM
    Thx for the info... from what I can tell in the documentation (and testing) is that tag is used in the <member> tag to indicate the order of the devices in the RG.  I tried using it outside the <members> tag, but it was just ignored and nothing happened.  This was on a 6.1.3 CUCM platform.  Is that how it's documentated from your side...
    The XML I used for the addRouteGroup call was:
    <name>billtestaxl</name><dialPlanWizardGenId>0</dialPlanWizardGenId>
    <deviceSelectionOrder>2</deviceSelectionOrder>
    <members><member port="0">
    <deviceSelectionOrder>1</deviceSelectionOrder>
    <deviceName>3.2.3.2</deviceName></member><member port="0">
    <deviceSelectionOrder>2</deviceSelectionOrder>
    <deviceName>4.5.6.7</deviceName>
    </member></members>
     
     
    Thanks for any further help you can offer.

    Subject: RE: Route Group and Distribution Algorithm
    Replied by: Dan-Anders Hook on 29-11-2009 08:17:58 PM
    Hi,
     
    Indeed you are right. I thought the deviceSelection order controlled the value of the tkdistributionalgorithm value in the routegroup table, when it in fact is used in the routegroupdevicemap table to indicate the order in which the members are listed. The order in which they are listed in the XML is not important. But as said, you already knew that. The distributionalgorithm is not documented. I tried to brutally send it in my XML anyway but the cucm just ignores it. I guess the only way is to first add the RG, and then update the value with executeSQLUpdate as below. The RG is always created with 'Circular' which has the value 2. Top Down has the value 1.
     
    Adding the RG (about the same as your XML)
    <addRouteGroup xmlns="http://www.cisco.com/AXL/API/6.1">
     <routeGroup xmlns="">
      <name>rg2</name>
      <dialPlanWizardGenId>1</dialPlanWizardGenId>
      <members>
       <member port="0">
        <deviceSelectionOrder>1</deviceSelectionOrder>
        <deviceName>1.2.3.4</deviceName>
       </member>
       <member port="0">
        <deviceSelectionOrder>2</deviceSelectionOrder>
        <deviceName>2.3.4.5</deviceName>
       </member>
      </members>
     </routeGroup>
    </addRouteGroup>
     
    Updating the distributealgorithm:
     
    <executeSQLUpdate xmlns="http://www.cisco.com/AXL/API/6.1">
     <sql xmlns="">UPDATE routegroup SET tkdistributealgorithm = '1' WHERE name = 'rg2'</sql>
    </executeSQLUpdate>
    Kind regards,
     
    //Dan