Unique Profiles, Macro Expansion, And Http - Cisco 8800 Series Manual

Unique Profiles, Macro Expansion, and HTTP

Parameter Name
Log Request Msg
Log Success Msg
Log Failure Msg
Unique Profiles, Macro Expansion, and HTTP
In a deployment where each phone must be configured with distinct values for some parameters, such as
User_ID or Display_Name, the service provider can create a unique profile for each deployed device and host
those profiles on a provisioning server. Each phone, in turn, must be configured to resync to its own profile
according to a predetermined profile naming convention.
The profile URL syntax can include identifying information that is specific to each phone, such as MAC
address or serial number, by using the macro expansion of built-in variables. Macro expansion eliminates the
need to specify these values in multiple locations within each profile.
A profile rule undergoes macro expansion before the rule is applied to the phone. The macro expansion controls
a number of values, for example:
• $MA expands to the unit 12-digit MAC address (using lower case hex digits). For example, 000e08abcdef.
• $SN expands to the unit serial number. For example, 88012BA01234.
Other values can be macro expanded in this way, including all the general purpose parameters, GPP_A through
GPP_P. An example of this process can be seen in
to the URL file name, but can also be applied to any portion of the profile rule parameter. These parameters
are referenced as $A through $P. For a complete list of variables that are available for macro expansion, see
Macro Expansion Variables, on page
In this exercise, a profile specific to a phone is provisioned on a TFTP server.
Cisco IP Phone 8800 Series Multiplatform Phone Administration Guide for Release 11.3(1) and Later
44
Description and Default Value
The message that is sent to the syslog server at the start of a resync attempt. If no value
is specified, the syslog message is not generated.
The default value is
$PN $MAC -- Requesting resync
$SCHEME://$SERVIP:$PORT$PATH
• In the phone configuration file with XML(cfg.xml), enter a string in this format:
<Log_Request_Msg ua="na">$PN $MAC -- Requesting resync
$SCHEME://$SERVIP:$PORT$PATH</Log_Request_Msg>
The syslog message that is issued upon successful completion of a resync attempt. If
no value is specified, the syslog message is not generated.
In the phone configuration file with XML(cfg.xml), enter a string in this format:
<Log_Success_Msg ua="na">$PN $MAC -- Successful resync
$SCHEME://$SERVIP:$PORT$PATH</Log_Success_Msg>
The syslog message that is issued after a failed resync attempt. If no value is specified,
the syslog message is not generated.
The default value is
$PN $MAC -- Resync failed: $ERR
In the phone configuration file with XML(cfg.xml), enter a string in this format:
<Log_Failure_Msg ua="na">$PN $MAC -- Resync failed: $ERR</Log_Failure_Msg>
TFTP Resync, on page
73.
Cisco IP Phone Provisioning
41. Macro expansion is not limited