Linksys SPA921 Cisco Small Business IP Telephony Devices Provisioning Guide - Page 82

Parameter Name Aliases

Page 82 highlights

Provisioning Tutorial Profile Formats 3 Parameter Name Aliases When generating an XML profile for the IP Telephony Device, it may be convenient to assign names to certain configuration parameters that are different from the canonical names recognized by the IP Telephony Device. For example, a customer account database may generate XML element tags for a customer telephone number and SIP registration password with names such as SIP-number and SIPpassword. 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 IP Telephony Device 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 customeraccount XML form indicated in the following example: 17775551234 512835907884 STEP 2 Store the file in the TFTP server virtual root directory. STEP 3 Open the test web interface on the admin/advanced page, Provisioning tab, and edit GPP_A to contain the alias map indicated above (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 also specify the alias map as a URL option, as follows: [--alias a ] tftp://192.168.1.200/customer.xml Cisco Small Business IP Telephony Devices Provisioning Guide 80

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116

Provisioning Tutorial
Profile Formats
Cisco Small Business IP Telephony Devices Provisioning Guide
80
3
Parameter Name Aliases
When generating an XML profile for the IP Telephony Device, it may be convenient
to assign names to certain configuration parameters that are different from the
canonical names recognized by the IP Telephony Device. For example, a customer
account database may 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 IP Telephony Device 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 file in the TFTP server virtual root directory.
STEP 3
Open the test web interface on the admin/advanced page, Provisioning tab, and
edit GPP_A to contain the alias map indicated above (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 also specify the alias map
as a URL option, as follows: