- 主页
- /
- 文章
在 Cisco BroadWorks 上为电话预配置参数
此帮助文章适用于Cisco BroadWorks注册的Cisco电话。此页面上的信息包括配置参数及其语法。
配置参数类型
本部分描述了根据职能广泛组织的配置参数。
通用参数
在配置电话与特定配置服务器解决方案交互时,通用参数GPP_*(
)用作免费字符串寄存器。默认情况下,GPP_*参数为空。可将其配置为包含不同的值,包括以下内容:-
加密密钥
-
URL
-
多阶段配置状态信息。
-
发布请求模板
-
参数名称别名地图
-
部分字符串值,最终合并为完整的参数值。
GPP_*参数可用于其他配置参数中的宏扩展。为此,单字母大写大写名称(A至P)足以识别GPP_A至GPP_P的内容。此外,当用作以下URL选项的参数时,双字母大写字母SA通过SD将GPP_SA通过GPP_SD作为特殊分支:
键、uid和pwd
这些参数可以在配置和升级规则中用作变量。它们通过以“$”字符前缀变量名称来引用,例如$GPP_A。
启用参数
Provision_启用和Upgrade_启用参数控制所有配置文件重同步和固件升级操作。这些参数相互独立地重新同步和升级。这些参数还控制通过管理Web服务器发布的重新同步和升级URL命令。默认情况下,这两个参数都设置为是 。
Resync_From_SIP参数控制重同步操作的请求。SIP通知事件从服务提供商代理服务器发送到电话。如果启用,代理可以请求重新同步。为此,代理会发送包含事件的SIP通知消息:将标题重新同步到设备。
设备通过401响应来挑战请求(已使用的凭证被拒绝授权)。设备在满足来自代理的重新同步请求之前,等待经过验证的后续请求。活动:reboot_now 和活动:restart_now 头头分别执行冷热重启,这也会面临挑战。
剩下的两个启用是Resync_On_Reset和Resync_After_Upgrade_Try。这些参数确定设备在软件重新启动后和每次升级尝试后是否执行重新同步操作。
启用Resync_On_重置时,设备会引入一个随机的延迟,该延迟将在执行重置之前跟随启动序列。延迟是随机时间,最高为Resync_Random_延迟(以秒为单位)指定的值。在同时供电的电话池中,此延迟会传播每个单元的重新同步请求的开始时间。在区域电力故障的情况下,此功能可用于大型住宅部署。
触发
电话允许您在特定间隔或特定时间重新同步。
在特定间隔重新同步
电话旨在定期与预配服务器重新同步。重新同步间隔以Resync_周期(秒)为单位配置。如果此值为空,设备不会定期重新同步。
重同步通常发生在语音线路闲置时进行。如果当重新同步到期时,语音线路处于活动状态,电话将延迟重新同步过程,直到该线路再次闲置。重新同步可能导致配置参数值发生变化。
重新同步操作可能会失败,因为电话无法从服务器检索配置文件、下载的文件损坏或发生内部错误。设备在Resync_Error_Retry_延迟(秒)中指定的时间后尝试重新同步。如果Resync_Error_Retry_延迟设置为0,设备在重新同步尝试失败后不会尝试重新同步。
如果升级失败,将在Upgrade_Error_Retry_延迟秒后进行重试。
有两种可配置参数可用于条件触发重新同步:Resync_Trigger_1和Resync_Trigger_2。每个参数都可以使用经过宏扩展的条件表达式进行编程。当重新同步间隔到期时(下一次重新同步的时间),触发器(如果设定)将阻止重新同步,除非一个或多个触发器评估为真。
以下示例条件触发重新同步。在本示例中,上次电话升级尝试已超过5分钟(300秒),自上次重新同步尝试以来至少已超过10分钟(600秒)。
$UPGTMR gt 300和$PRVTMR ge 600
在特定时间重新同步
Resync_At参数允许电话在特定时间重新同步。此参数使用24小时格式(hhmm)来指定时间。
Resync_At_Random_延迟参数允许电话以未指定的延迟时间重新同步。此参数使用正整数格式指定时间。
应避免将多个电话的重新同步请求淹没服务器,这些请求同时设置为重新同步。要做到这一点,电话会在指定时间后10分钟内触发重新同步。
例如,如果您将重新同步时间设置为1000(上午10点),电话会在上午10点至上午10点10点之间随时触发重新同步。
此功能在缺省情况下是禁用的。如果配置了Resync_At参数,则忽略了Resync_Periodic参数。
可配置的日程
您可以配置定期重新同步的安排,并且可以使用以下配置参数指定重新同步和升级故障的重新尝试间隔:
-
Resync_周期性
-
Resync_Error_Retry_延迟
-
Upgrade_Error_Retry_延迟
每个参数接受一个延迟值(秒)。新的扩展语法允许连续延迟元素的逗号分隔列表。序列中的最后一个元素将永远默示地重复。
或者,您可以使用加号来指定另一个附加随机额外延迟的数值值。
案例 1
在此示例中,电话会定期每2小时重新同步。如果发生重新同步失败,设备会按以下时间间隔重试:30分钟,1小时,2小时,4小时。设备继续每隔4小时进行试用,直到成功重新同步。
Resync_周期性=7200 Resync_Error_Retry_延迟=1800,3600,7200,14400
示例 2
在此示例中,设备会定期每小时重新同步(加上10分钟的额外随机延迟)。如果重新同步失败,设备会按以下时间间隔重试:30分钟(最多5分钟)。1小时(最多10分钟),2小时(最多15分钟)。设备继续尝试2小时(加上15分钟),直到成功重新同步。
Resync_周期性=3600+600 Resync_Error_Retry_延迟=1800+300,3600+600,7200+900
示例 3
在此示例中,如果远程升级尝试失败,设备将在30 分钟内重试,再重试1小时后,再重试2小时后。如果升级仍然失败,设备每四到五小时重试,直到升级成功。
Upgrade_Error_Retry_Delay = 1800,3600,7200,14400+3600
配置文件规则
电话提供多个远程配置配置文件参数(Profile_规则*)。因此,每个重同步操作可以检索不同服务器管理的多个文件。
在最简单的情况下,设备会定期重新同步到中央服务器上的单个配置文件,从而更新所有相关的内部参数。或者,配置文件可以在不同文件之间拆分。部署中的所有电话都有一个文件。为每个帐户提供单独且唯一的文件。加密密钥和证书信息可以通过另一个配置文件提供,该配置文件存储在单独的服务器上。
每当需要重新同步操作时,电话会按顺序评估四个Profile_Rule*参数:
-
Profile_规则
-
Profile_Rule_B
-
rofile_ule_⦅_ph_3⦆
-
rofile_ule_ule_
每次评估都可以从远程配置服务器中检索配置文件,并可能更新一些内部参数。如果评估失败,则重新同步序列会中断,并从Resync_Error_Retry_延迟参数指定的开始重新尝试(秒)。如果所有评估都成功,设备会等待Resync_周期参数指定的第二次,然后执行另一个重同步。
每个Profile_规则*参数的内容由一组备选方案组成。备选方案按| (pipe)字符分隔。每个备选方案包括条件表达式、分配表达式、配置文件URL以及任何相关的URL选项。所有这些组件在每个备选方案中都是可选的。以下为有效组合,以及它们必须显示的顺序(如果存在):
[ 条件-expr ] [ 分配-expr ] [[ 选项 ] URL ]
在每个Profile_规则*参数中,除最后一个参数之外的所有替代都必须提供条件表达式。将评估此表达式并按如下方式处理:
-
从左到右评估条件,直到发现一个评估为真(或直到找到一个没有条件表达式的替代方案)。
-
将评估任何随附的分配表达式(如果存在)。
-
如果URL作为该替代方案的一部分指定,则尝试下载位于指定URL中的配置文件。系统尝试相应更新内部参数。
如果所有替代方案都有条件表达式,并且没有评估为真(或者如果整个配置文件规则为空),则将跳过整个Profile_规则*参数。评估序列中的下一个配置文件规则参数。
案例 1
此示例无条件地重新同步到指定URL中的配置文件,并向远程配置服务器执行HTTP GET请求:
http://remote.server.com/cisco/$MA.cfg
示例 2
在此示例中,设备根据行1的注册状态重新同步到两个不同的URL。如果注册丢失,设备将对CGI脚本执行HTTP POST。设备会发送宏扩展的GPP_A的内容,该内容可能会提供有关设备状态的其他信息:
($PRVTMR ge 600)? http://p.tel.com/has-reg.cfg | [--post a] http://p.tel.com/lost-reg?
示例 3
在此示例中,设备重新同步到同一服务器。如果单位中未安装证书(对于原2.0版),设备将提供其他信息:
(“$CCERT”,如“已安装”)? https://p.tel.com/config? | https://p.tel.com/config?cisco$MAU
示例4
在此示例中,将Line 1禁用,直到GPP_A设置为通过第一个URL配置为已配置为止。然后,它重新同步到第二个URL:
(“$A”而不是“已预定”)?(ine_Lnable_1_ =“否”;)! https://p.tel.com/init-prov | https://p.tel.com/configs
示例5
在此示例中,假设服务器返回的配置文件包含XML元素标签。这些标签必须由GPP_B中存储的别名映射替换为正确的参数名称:
[--alias b] https://p.tel.com/account/$PN$MA.xml
如果未从服务器收到请求的配置文件,则通常认为重新同步失败。Resync_Fails_On_FNF参数可以覆盖此默认行为。如果Resync_Fails_On_FNF设置为“否”,设备将接受来自服务器的未找到文件响应作为成功重新同步。Resync_Fails_On_FNF的缺省值为“是”。
升级规则
升级规则是告诉设备激活新的负载,并在必要时从哪里获取负载。如果负载已在设备上,则不会尝试获取负载。因此,当所需负载处于非活动分区时,负载位置的有效性并不重要。
Upgrade_规则指定固件负载(如果与当前负载不同),将下载并应用固件负载,除非受条件表达式限制或Upgrade_启用设置为否。
电话提供一个可配置的远程升级参数,Upgrade_规则。此参数接受与配置文件规则参数相似的语法。不支持URL选项进行升级,但可以使用条件表达式和分配表达式。如果使用条件表达式,则参数可以填充多个备选方案,并按| 字符分隔。每个备选方案的语法如下:
[ 条件-expr ] [ 分配-expr ] URL
与Profile_Rule*参数一样,Upgrade_Rule参数评估每个备选,直到满足条件表达式或替代没有条件表达式。如果指定,将对随附的分配表达式进行评估。然后,尝试升级到指定的URL。
如果Upgrade_规则包含没有条件表达式的URL,设备将升级到URL指定的固件图像。宏观扩展和规则评估后,设备不会重新尝试升级,直到规则被修改或更改方案+服务器+端口+文件路径的有效组合。
要尝试固件升级,设备会在程序开始时禁用音频,并在程序结束时重新启动。只有当所有语音线路当前处于非活动状态时,设备才会自动启动由Upgrade_规则内容驱动的升级。
例如,
https://10.73.10.223/firmware/PHONEOS-8875.1-0-1-0001-1.loads
在此示例中,Upgrade_规则将固件升级到存储在指定的URL中的图像。
下面是另一个示例:
(“$F”ne “beta-客户”)? http://p.tel.com/firmware/PHONEOS-8875.1-0-1-0001-1.loads | http://p.tel.com/firmware/PHONEOS-8875.1-0-1-0001-1.loads
此示例根据通用参数GPP_F的内容指示单元加载两个图像中的一个。
配置参数
您可以在电话网页中的配置 标签页上找到配置参数。
配置配置文件参数
下表定义了配置 标签页下的配置配置文件参数 部分中每个参数的功能和用途。
参数名称 |
描述和默认值 |
---|---|
启用提供 |
控制所有重新同步操作,独立于固件升级操作。设置为是 以启用远程配置。 默认值为“是”。 |
重设时重新同步 |
每次重新启动后触发重新同步,但参数更新和固件升级导致的重新启动除外。 默认值为“是”。 |
重新同步随机延迟 |
执行重置前先启动顺序的随机延迟,以秒为单位。在安排同时开机的IP电话设备池中,这引入了每个单位向配置服务器发送重同步请求的时间间隔。在区域电力故障的情况下,此功能可用于大型住宅部署。 此字段的值必须为0至65535之间的整数。 缺省值为2。 |
重同步时间(HHmm) |
设备与配置服务器重新同步的时间(HHmm)。 此字段的值必须为0000至2400之间的四位数字,以以HHmm格式表示时间。例如,0959表示09:59。 默认值为空。如果值无效,则忽略该参数。如果此参数设置为有效值,将忽略Resync Periodic参数。 |
随机延迟重新同步 |
当大量设备同时开机时,可防止配置服务器过载。 为了避免从多个电话向服务器发送重同步请求,电话在小时和分钟之间重新同步,小时和分钟加上随机延迟(hhmm, hhmm+random_delay)之间重新同步。例如,如果随机延迟= (随机延迟+ 30)/60 分钟,输入值以秒为单位,四舍五入到下一分钟以计算最后random_delay 间隔。 有效值介于600至65535之间。 如果值小于600,则内部随机延迟为0至600之间。 默认值为600秒(10 分钟)。 |
重新同步定期 |
定期之间的时间间隔与配置服务器重新同步。关联的重新同步计时器仅在与服务器首次成功同步后才会激活。 有效格式如下:
将此参数设置为零,禁用周期性重新同步。 缺省值为3600秒。 |
重新同步错误重试延迟 |
如果重新同步操作失败,因为IP电话设备无法从服务器检索配置文件,或下载的文件已损坏,或发生内部错误,设备将在指定时间以秒为单位后尝试重新同步。 有效格式如下:
如果延迟设置为0,设备在重新同步尝试失败后不会尝试重新同步。 |
强制重新同步延迟 |
电话在执行重新同步之前等待的最大延迟(以秒为单位)。 当其中一条电话线处于活动状态时,设备不会重新同步。由于重新同步可能需要几秒钟,因此最好等到设备闲置一段时间后再重新同步。这允许用户连续呼叫而不间断。 设备有一个计时器,当所有线路都闲置时开始倒数。此参数是计数器的初始值。重新同步事件被延迟,直到此计数器降为零。 有效值介于0至65535之间。 缺省值为14,400 秒。 |
从SIP重新同步 |
启用通过SIP通知消息触发重新同步。 默认值为“是”。 |
升级尝试后重新同步 |
在任何升级发生后启用或禁用重新同步操作。如果选择“是”,将触发同步。 默认值为“是”。 |
Resync Trigger 1、Resync Trigger 2 |
可配置的重新同步触发条件。当这些参数中的逻辑方程评估为TRUE时,将触发重新同步。 缺省值为(空)。 |
在FNF上重新同步失败 |
如果未从服务器收到请求的配置文件,则认为重新同步失败。此参数可以覆盖此参数。设置为否时,设备将接受服务器的 默认值为“是”。 |
配置文件规则 配置文件规则B 配置文件规则C 配置文件规则D |
每个配置文件规则通知电话获取配置文件(配置文件)的来源。在每次重新同步操作中,电话按顺序应用所有配置文件。 默认: 如果您正在将AES-256-CBC加密应用于配置文件,请使用 您可以选择用双引号(")封装加密密钥。 |
要使用的DHCP选项 |
以逗号分隔的DHCP选项,用于检索固件和配置文件。 默认值为66,160,159,150,60,43,125。 |
日志请求管理 |
此参数包含在重新同步尝试开始时发送到系统日志服务器的消息。 默认值为 |
日志成功消息 |
成功完成重新同步尝试后发出的系统日志消息。 默认值为 |
日志失败Msg |
重新同步尝试失败后发出的系统日志消息。 默认值为 |
用户可配置的Resync |
允许用户从IP电话屏幕重新同步电话。 默认值为“是”。 |
固件升级参数
下表定义了配置 标签页的固件升级 部分中每个参数的功能和使用情况。
参数名称 |
描述和默认值 |
---|---|
升级启用 |
启用固件升级操作,独立于同步操作。 默认值为“是”。 使用其中一种方法配置此参数:
|
升级错误重试延迟 |
升级失败时应用升级重试间隔(以秒为单位)。设备有固件升级错误计时器,在固件升级尝试失败后会激活。使用此参数中的值初始化计时器。当该计时器向下计数到零时,会进行下一次固件升级尝试。 缺省值为3600秒。 使用其中一种方法配置此参数:
|
升级规则 |
定义升级条件和相关固件URL的固件升级脚本。它使用与配置规则相同的语法。 使用以下格式输入升级规则:
例如:
如果未指定协议,则假定TFTP。如果未指定服务器名,请求该URL的主机将用作服务器名。如果未指定端口,将使用默认端口(TFTP为69,HTTP为80,HTTPS为443)。 缺省值为空。 使用其中一种方法配置此参数:
|
日志升级请求管理信息 |
固件升级尝试开始时发出的 Syslog 消息。 默认: 使用其中一种方法配置此参数:
|
日志升级成功消息 |
成功完成固件升级尝试后发出的 Syslog 消息。 默认值为 使用其中一种方法配置此参数:
|
日志升级失败Msg |
固件升级尝试失败后发出的 Syslog 消息。 默认值为 使用其中一种方法配置此参数:
|
对等固件共享 |
启用或禁用对等固件共享(PFS)功能。选择是 或否 以启用或禁用该功能。 缺省值:是 使用其中一种方法配置此参数:
|
对等固件共享日志服务器 |
表示IP地址和发送UDP消息的端口。 例如:10.98.76.123:514,10.98.76.123是IP地址,514是端口号。 使用其中一种方法配置此参数:
|
通用参数
下表定义了配置 标签页的通用参数 部分中每个参数的功能和用途。
参数名称 |
描述和默认值 |
---|---|
gpp a - gpp p |
在配置电话与特定配置服务器解决方案交互时,通用功能参数GPP_*用作自由字符串寄存器。可将其配置为包含不同的值,包括以下内容:
缺省值为空。 |
宏扩展变量
某些宏变量在以下配置参数内被识别:
-
Profile_规则
-
Profile_Rule_*
-
esync_rigger_*
-
Upgrade_规则
-
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到P |
由通用参数GPP_A至GPP_P的内容取代。 |
SA至SD |
通过GPP_SD被特殊用途参数GPP_SA代替。这些参数保留配置中使用的密钥或密码。 $SA到$SD被识别为可选重同步URL限定符--键的参数。 |
MA |
使用小写十六进制数字的MAC地址,例如,000e08aabbcc。 |
MAU |
使用大写十六进制数字的MAC地址,例如000E08AABBCC。 |
MAC |
使用小写十六进制数字的MAC地址,并用逗号分隔十六进制数对。例如00:0e:08:aa:bb:cc。 |
PN |
产品名称。例如,CP-8875-CC-C-9K。 |
psn | 产品系列编号。例如,V03。 |
SN |
序列号字符串。例如88012BA01234。 |
CCERT的 |
SSL客户端证书状态:已安装或未安装。 |
IP |
本地子网中的电话的IP地址。例如192.168.1.100。 |
外部 |
电话的外部IP,如在互联网上看到的。例如66.43.16.52。 |
斯沃尔 |
软件版本字符串。例如, phoneos-8875.1-0-1-0001-1 |
hwver |
硬件版本字符串。例如,2.0.1 |
普韦斯特 |
配置状态(数字字符串): -1 =显式重同步请求 0 =加电重新同步 1 =定期重新同步 2 =重新同步失败,重试 |
升级 |
升级状态(数字字符串): 1 =首次升级尝试 2 =升级失败,重试 |
上传 |
上次升级尝试的结果消息(ERR);例如http_get 失败。 |
Prvtmr |
上次重新同步后秒数。 |
Upgtmr |
自上次升级尝试以来的秒数。 |
REGTMR1 |
自Line 1丢失使用SIP服务器注册以来的秒数。 |
REGTMR2 |
自Line 2丢失使用SIP服务器注册以来的秒数。 |
upgcond |
遗留宏名称。 |
方案 |
文件访问方案,TFTP、HTTP或HTTPS,在解析重同步或升级URL后获得的。 |
塞尔维亚 |
请求目标服务器主机名,在解析重同步或升级URL后获得的。 |
服务 |
请求目标服务器IP地址,在解析重同步或升级URL后获得,可能在DNS查找后获得。 |
端口 |
请求目标UDP/TCP端口,如解析重同步或升级URL后获得的。 |
路径 |
请求目标文件路径,如解析重同步或升级URL后获得的。 |
错误 |
重新同步或升级尝试的结果消息。仅用于生成结果系统日志消息。在尝试升级时,该值保留在UPGERR变量中。 |
用户名 |
Line n UserID配置参数的内容。 |
ems |
扩展移动状态 |
静音 |
扩展移动用户ID |
mpwd |
扩展移动密码 |
内部错误代码
电话定义了一些内部错误代码(X00–X99),以便于配置,从而更精确地控制设备在某些错误条件下的行为。
参数名称 |
描述和默认值 |
---|---|
X00 |
发送SIP请求时发生传输层(或ICMP)错误。 |
X20 |
SIP请求在等待响应时超时。 |
X40 |
一般SIP协议错误(例如,200和ACK消息中的SDP中不可接受的编解码器,或等待ACK时超时)。 |
X60 |
根据给定的拨号计划,拨号号码无效。 |