设置参数概述
本章介绍可用于配置文件脚本的预配置参数
此产品的文档集力求使用非歧视性语言。在本文档集中,非歧视性语言是指不隐含针对年龄、残障、性别、种族身份、族群身份、性取向、社会经济地位和交叉性的歧视的语言。由于产品软件的用户界面中使用的硬编码语言、基于 RFP 文档使用的语言或引用的第三方产品使用的语言,文档中可能无法确保完全使用非歧视性语言。 深入了解思科如何使用包容性语言。
思科可能会在某些地方提供本内容的当地语言翻译版本。请注意,翻译版本仅供参考,如有任何不一致之处,以本内容的英文版本为准。
本章介绍可用于配置文件脚本的预配置参数
下表定义了设置选项卡配置文件参数部分中每个参数的功能和用途。
参数名称 |
描述和默认值 |
---|---|
启用设置 |
控制独立于固件升级操作的所有重新同步操作。 设置为是将启用远程设置。 默认值为“是”。 |
重置时重新同步 |
除参数更新和固件升级导致的重新启动外,每次重新启动之后都触发重新同步。 默认值为“是”。 |
重新同步随机延迟 |
执行重置之前,启动序列后的随机延迟指定以秒为单位。 在安排要同时接通电源的 IP 电话设备池中,这会在每个设备向设置服务器发送重新同步请求的时间中引入一个时间差。 在大型住宅部署中,如果发生地区性电力故障,此功能将十分有用。 此字段的值必须为介于 0 到 65535 之间的整数。 默认值为 2。 |
重新同步时间 (HHmm) |
设备与设置服务器重新同步的时间 (HHmm)。 此字段的值必须为介于 0000 到 2400 之间的四位数字,以 HHmm 格式表示时间。 例如,0959 年表示 09:59。 默认值为空。 如果值无效,该参数将被忽略。 如果此参数设置为有效值,则“重新同步周期”参数将被忽略。 |
随机延迟重新同步 |
防止设置服务器在大量设备同时接电时过载。 为避免来自多部电话的大量重新同步请求涌向服务器,电话的重新同步范围介于小时和分钟,以及小时、分钟加上随机延迟之间 (hhmm, hhmm+random_delay)。 例如,如果随机延迟 =(随机延迟时重新同步 + 30)/60 分钟,以秒为单位输入的值会转换为分钟,四舍五入计入下一分钟以计算最终的 random_delay 间隔。 有效值介于 600 到 65535 之间。 如果值小于 600,则内部随机延迟介于 0 到 600 之间。 默认值为 600 秒(10 分钟)。 |
重新同步周期 |
与设置服务器定期重新同步的时间间隔。 仅在第一次成功同步服务器后,关联重新同步计时器才会激活。 有效格式如下所示:
此参数设置为零将禁用定期重新同步。 默认值为 3600 秒。 |
重新同步错误重试延迟 |
如果因为 IP 电话设备无法从服务器检索配置文件导致重新同步操作失败,或者下载的文件已损坏或发生内部错误,设备将在指定的时间(以秒为单位)之后再次尝试重新同步。 有效格式如下所示:
如果延迟设置为 0,在尝试重新同步失败后,设备不会再尝试重新同步。 |
强制重新同步延迟 |
执行重新同步之前电话等待的最长延迟(以秒为单位)。 如果有一条电话线路处于活动状态,设备不会重新同步。 因为重新同步可能需要数秒钟的时间,所以最好等待,直至设备在重新同步之前长时间处于空闲状态。 这使得用户能够连续发起呼叫而不会中断。 设备有一个计时器,当其所有线路变为空闲时便会开始倒计时。 此参数是计数器的初始值。 重新同步事件会延迟直至此计数器递减为零。 有效值介于 0 到 65535 之间。 默认值为 14,400 秒。 |
从 SIP 重新同步 |
启用将通过 SIP NOTIFY 消息触发的重新同步。 默认值为“是”。 |
尝试升级后重新同步 |
在发生任何升级之后启用或禁用重新同步操作。 如果选择“是”,将触发同步。 默认值为“是”。 |
重新同步触发器 1、重新同步触发器 2 |
可配置重新同步触发器条件。 当这些参数中的逻辑等式计算结果为 TRUE 时,将会触发重新同步。 默认值为(空)。 |
FNF 重新同步失败 |
如果未收到来自服务器的请求配置文件,则重新同步视作失败。 这会被该参数覆盖。 如果设置为否,当收到服务器发回的 默认值为“是”。 |
配置文件规则 配置文件规则 B 配置文件规则 C 配置文件规则 D |
每条配置文件规则会告知电话应从哪个来源获取配置文件(配置文件)。 每个重新同步操作期间,电话会依次应用所有配置文件。 默认值:/$PSN.xml 如果您要对配置文件应用 AES-256-CBC 加密,如下所示采用 --key 关键字指定加密密钥: [--密钥 <encryption key>] 您可以将加密密钥括在双引号 (") 内。 |
使用的 DHCP 选项 |
DHCP 选项用逗号分隔,用于检索固件和配置文件。 默认值为 66,160,159,150,60,43,125。 |
日志请求消息 |
此参数包含尝试开始重新同步时发送到系统日志服务器的消息。 默认值为 $PN $MAC –Requesting % $SCHEME://$SERVIP:$PORT$PATH。 |
日志成功消息 |
成功完成重新同步后发出的系统日志消息。 默认值为 $PN $MAC –Successful Resync % $SCHEME://$SERVIP:$PORT$PATH -- $ERR。 |
日志失败消息 |
尝试重新同步失败后发出的系统日志消息。 默认值为 $PN $MAC -- Resync failed: $ERR。 |
用户可配置重新同步 |
允许用户在 IP 电话屏幕上重新同步电话。 默认值为“是”。 |
下表定义了设置选项卡固件升级部分中每个参数的功能和用途。
参数名称 |
描述和默认值 |
---|---|
启用升级 |
允许固件升级操作独立于重新同步操作。 默认值为“是”。 |
升级错误重试延迟 |
如果升级失败,应用升级重试间隔(以秒为单位)。 设备有一个固件升级错误计时器,会在固件升级尝试失败后激活。 计时器使用此参数中的值进行初始化。 当此计时器倒计至零时,会再次尝试进行固件升级。 默认值为 3600 秒。 |
升级规则 |
定义升级条件及所关联固件 URL 的固件升级脚本。 它使用相同的语法作为配置文件规则。 使用以下格式输入升级规则:
例如:
若未指定任何协议,系统会假设您指定了 TFTP。 如果未指定服务器名称,则使用请求 URL 的主机作为服务器名称。如果未指定端口,则使用默认端口(TFTP 为 69,HTTP 为 80,HTTPS 为 443)。 默认值为空白。 |
日志升级请求消息 |
固件升级尝试开始时发出的系统日志消息。 默认值:$PN $MAC -- Requesting upgrade $SCHEME://$SERVIP:$PORT$PATH |
日志升级成功消息 |
成功完成固件升级尝试后发出的系统日志消息。 默认值为 $PN $MAC -- Successful upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERR |
日志升级失败消息 |
固件升级尝试失败后发出的系统日志消息。 默认值为 $PN $MAC -- 升级失败:$ERR |
对等固件共享 |
启用或禁用对等固件共享功能。 选择是或否以启用或禁用该功能。 默认值:Yes |
对等固件共享日志服务器 |
指示 IP 地址和接收 UDP 消息的端口。 例如:10.98.76.123:514,其中 10.98.76.123 是 IP 地址,514 是端口号。 |
下表定义了设置选项卡通用参数部分中每个参数的功能和用途。
参数名称 |
描述和默认值 |
---|---|
GPP A - GPP P |
默认值为空白。 |
以下设置参数内识别了特定的宏变量:
Profile_Rule
Profile_Rule_*
Resync_Trigger_*
Upgrade_Rule
Log_*
GPP_*(特定情况下)
这些参数内识别和扩展了 $NAME 或 $(NAME) 等语法类型。
可以通过表示法 $(NAME:p) 和 $(NAME:p:q) 指定宏可变子字符串,其中 p 和 q 是非负整数(修订版 2.0.11 及以上版本中可用)。 产生的宏扩展是从字符偏移量 p 开始的子字符串,长度为 q(如果未指定 q,则直到字符串结尾)。 例如,如果 GPP_A 包含 ABCDEF,则 $(A:2) 将扩展到 CDEF,$(A:2:3) 将扩展到 CDE。
无法识别的名称不会转换,扩展后参数值中 $NAME 或 $(NAME) 的格式仍将保持不变。
参数名称 |
描述和默认值 |
||
---|---|---|---|
$ |
$$ 扩展为单个 $ 字符。 |
||
A through P |
替换为通用参数 GPP_A 至 GPP_P 的内容。 |
||
SA through SD |
替换为专用参数 GPP_SA 至 GPP_SD。 这些参数存有在设置过程中使用的密钥或密码。
|
||
MA |
使用小写十六进制数字的 MAC 地址,例如 000e08aabbcc。 |
||
MAU |
使用大写十六进制数字的 MAC 地址,例如 000E08AABBCC。 |
||
MAC |
使用小写十六进制数字并用冒号分隔十六进制数字对的 MAC 地址。 例如 00:0e:08:aa:bb:cc。 |
||
PN |
|||
PSN |
|||
SN |
序列号字符串;例如 88012BA01234。 |
||
CCERT |
SSL 客户端证书状态:安装或未安装。 |
||
IP |
电话在其本地子网中的 IP 地址。 例如 192.168.1.100。 |
||
EXTIP |
电话的外部 IP(在 Internet 上显示的 IP)。 例如 66.43.16.52。 |
||
SWVER |
软件版本字符串。 例如,
|
||
HWVER |
|||
PRVST |
部署状态(数字字符串): -1 = 显式重新同步请求 0 = 接通电源时重新同步 1 = 定期重新同步 2 = 重新同步失败,重试 |
||
UPGST |
升级状态(数字字符串): 1 = 第一次升级尝试 2 = 升级失败,重试 |
||
UPGERR |
上次升级尝试的结果消息(错误);例如,http_get 失败。 |
||
PRVTMR |
距离上次重新同步尝试的秒数。 |
||
UPGTMR |
距离上次升级尝试的秒数。 |
||
REGTMR1 |
线路 1 丢失在 SIP 服务器的注册信息后经历的秒数。 |
||
REGTMR2 |
线路 2 丢失在 SIP 服务器的注册信息后经历的秒数。 |
||
UPGCOND |
原来的宏名称。 |
||
SCHEME |
文件访问方案,TFTP、HTTP 或 HTTPS 之一,在解析重新同步或升级 URL 后获得。 |
||
SERV |
请求目标服务器主机名,在解析重新同步或升级 URL 后获得。 |
||
SERVIP |
请求目标服务器 IP 地址,在解析重新同步或升级 URL 后获得,可能在 DNS 查找之后。 |
||
PORT |
请求目标 UDP/TCP 端口,在解析重新同步或升级 URL 后获得。 |
||
PATH |
请求目标文件路径,在解析重新同步或升级 URL 后获得。 |
||
ERR |
重新同步或升级尝试的结果消息。 只有助于生成结果系统日志消息。 尝试升级时,值将保留在 UPGERR 变量中。 |
||
UIDn |
线路 n UserID 配置参数的内容。 |
||
ORIGTYPE AUTHSTATUS |
控制电话是否需要请求许可证。 是:orig_ent、orig_mpp、无 是:经典、wxc、无
|
电话定义多个内部错误代码 (X00–X99),以便加强配置,从而在某些错误条件下更好地控制设备行为。
参数名称 |
描述和默认值 |
---|---|
X00 |
发送 SIP 请求时出现传输层(或 ICMP)错误。 |
X20 |
等待响应时,SIP 请求超时。 |
X40 |
一般 SIP 协议错误(例如,200 和 ACK 消息中,SDP 的编解码器不可接受;或等待 ACK 时超时)。 |
X60 |
根据给定拨号方案,被叫号码无效。 |