Provisioning Examples
Profile Management
Provisioning Guide for Cisco SPA100 and SPA200 Series Analog Telephone Adapters 64
4
Parameter Name Aliases
When generating an XML profile for the ATA, it might be convenient to assign
names to certain configuration parameters that are different from the canonical
names recognized by the ATA. For example, a customer account database might
generate XML element tags for a customer telephone number and SIP registration
password with names, such as SIP-number and SIP-password. These names can
be mapped to the canonical names (User_ID_1_ and Password_1_ ) before being
applied to Line1.
In many instances, the back-end provisioning solution used by the service
provider can perform this mapping. However, the ATA itself can remap the
parameter names internally. To do this, an alias map is defined and stored in one of
the general purpose provisioning parameters. Then, the profile rule which invokes
the resync is directed to remap the non-canonical XML elements as specified by
the alias map.
Exercise
STEP 1 Generate a profile named customer.XML containing the proprietary customer-
account XML form indicated in the following example:
<customer-account>
<SIP-number> 17775551234</SIP-number>
<SIP-password> 512835907884</SIP-password>
</customer-account>
STEP 2 Store the profile in the TFTP server virtual root directory.
STEP 3 Open the web interface on the device to the admin/advanced page, Provisioning
tab, and edit GPP_A to contain the alias map (do not enter new lines through the
web interface, instead simply enter each alias consecutively):
/customer-account/SIP-number = /flat-profile/User_ID_1_ ;
/customer-account/SIP-password = /flat-profile/Password_1_ ;
STEP 4 Edit the Profile_Rule to point to the new XML profile, and specify the alias map as a
URL option, as follows:
[--alias a ] tftp://192.168.1.200/customer.xml
STEP 5 Click Submit All Changes.
When the ATA resyncs, it receives the XML profile, remaps the elements, as
indicated by the alias map, and populates the User_ID_1_ and Password_1_
parameters.