设置参数

设置参数概述

本章介绍可用于配置文件脚本的预配置参数

配置文件参数

下表定义了设置选项卡配置文件参数部分中每个参数的功能和用途。

参数名称

描述和默认值

启用设置

控制独立于固件升级操作的所有重新同步操作。 设置为将启用远程设置。

默认值为“是”。

重置时重新同步

除参数更新和固件升级导致的重新启动外,每次重新启动之后都触发重新同步。

默认值为“是”。

重新同步随机延迟

执行重置之前,启动序列后的随机延迟指定以秒为单位。 在安排要同时接通电源的 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 分钟)。

重新同步周期

与设置服务器定期重新同步的时间间隔。 仅在第一次成功同步服务器后,关联重新同步计时器才会激活。

有效格式如下所示:

  • 一个整数

    示例:输入 3000 表示下次重新同步将在 3000 秒后发生。

  • 多个整数

    示例:输入 600,1200,300 表示第一次重新同步将在 600 秒后发生,第二次重新同步将在第一次重新同步之后的 1200 秒后发生,第三次重新同步将在第二次重新同步之后的 300 秒后发生。

  • 时间范围

    示例:输入 2400+30 表示下次重新同步将在重新同步成功后的 2400 到 2430 秒之间发生。

此参数设置为零将禁用定期重新同步。

默认值为 3600 秒。

重新同步错误重试延迟

如果因为 IP 电话设备无法从服务器检索配置文件导致重新同步操作失败,或者下载的文件已损坏或发生内部错误,设备将在指定的时间(以秒为单位)之后再次尝试重新同步。

有效格式如下所示:

  • 一个整数

    示例:输入 300 表示下次重新同步重试将在 300 秒后发生。

  • 多个整数

    示例:输入 600,1200,300 表示第一次重试将在失败之后的 600 秒后发生,第二次重试将在第一次重试失败之后的 1200 秒后发生,第三次重试将在第二次重试失败之后的 300 秒后发生。

  • 时间范围

    示例:输入 2400+30 表示下次重试将在重新同步失败后的 2400 到 2430 秒之间发生。

如果延迟设置为 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|http|https>://<ip address><:port>/<path>/<load name>

例如:

tftp://192.168.1.5/firmware/sip88xx.11-0-0MPP-321.loads
tftp://192.168.1.5/firmware/sip78xx.11-0-1MPP-321.loads
tftp://192.168.1.5/firmware/sip68xx.11-0-1MPP-321.loads

若未指定任何协议,系统会假设您指定了 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

当将电话配置为与特定设置服务器解决方案进行交互时,通用参数 GPP_* 用作免费字符串寄存器。 可将它们配置为包含不同的值,其中包括:
  • 加密密钥。

  • URL。

  • 多阶段设置状态信息。

  • POST 请求模板。

  • 参数名称别名映射。

  • 最终并入完整的参数值的部分字符串值。

默认值为空白。

宏扩展变量

以下设置参数内识别了特定的宏变量:

  • 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。 这些参数存有在设置过程中使用的密钥或密码。

 

$SA 至 $SD 被认为是传递给可选重新同步 URL 限定符 — 密钥 — 的参数。

MA

使用小写十六进制数字的 MAC 地址,例如 000e08aabbcc。

MAU

使用大写十六进制数字的 MAC 地址,例如 000E08AABBCC。

MAC

使用小写十六进制数字并用冒号分隔十六进制数字对的 MAC 地址。 例如 00:0e:08:aa:bb:cc。

PN

产品名称。例如,CP-8841-3PCC。

产品名称。例如,CP-7832-3PCC。

产品名称。例如,CP-6841-3PCC。

PSN

产品序列号。 例如 V03。

产品序列号。 例如 6841-3PCC。

SN

序列号字符串;例如 88012BA01234。

CCERT

SSL 客户端证书状态:安装或未安装。

IP

电话在其本地子网中的 IP 地址。 例如 192.168.1.100。

EXTIP

电话的外部 IP(在 Internet 上显示的 IP)。 例如 66.43.16.52。

SWVER

软件版本字符串。 例如,

  • 对于固件版本 11.3(1)SR1 及其之前的版本:sip68xx.11-0-1MPP-312

  • 对于固件版本 11.3(2) 及其之后的版本:sip68xx.11-3-2MPP0001-609

  • 对于固件版本 11.3(1)SR1 及其之前的版本:sip78xx.11-0-1MPP-312

  • 对于固件版本 11.3(2) 及其之后的版本:sip78xx.11-3-2MPP0001-609

  • 对于固件版本 11.3(1)SR1 及其之前的版本:sip88xx.11-0-1MPP-312

  • 对于固件版本 11.3(2) 及其之后的版本:sip88xx.11-3-2MPP0001-609

HWVER

硬件版本字符串。 例如 2.0.1

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 配置参数的内容。

EMS

Extension Mobility 状态

MUID

Extension Mobility 用户 ID

MPWD

Extension Mobility 密码

ORIGTYPE

AUTHSTATUS

控制电话是否需要请求许可证。

下列对象的值
ORIGTYPE
是:orig_ent、orig_mpp、无
下列对象的值
AUTHSTATUS
是:经典、wxc、无
添加变量:
  • 配置文件规则或升级规则宏展开和条件表达式

  • 转换授权规则宏扩展

内部错误代码

电话定义多个内部错误代码 (X00–X99),以便加强配置,从而在某些错误条件下更好地控制设备行为。

参数名称

描述和默认值

X00

发送 SIP 请求时出现传输层(或 ICMP)错误。

X20

等待响应时,SIP 请求超时。

X40

一般 SIP 协议错误(例如,200 和 ACK 消息中,SDP 的编解码器不可接受;或等待 ACK 时超时)。

X60

根据给定拨号方案,被叫号码无效。