| Table of Contents |
|---|
| Anchor | ||||
|---|---|---|---|---|
|
Htek话机指派工具（Htek Provision Tool，HPT）是一款配合HTEK话机使用的软件，集配置文件可视化编辑、配置文件批量生成、设备发现、设备管理、话机手动指派、PNP、配置文件服务器、固件服务器等功能与一身，可方便快捷地完成对局域网内HTEK话机的配置指派。
| Anchor | ||||
|---|---|---|---|---|
|
系统 | Windows 7 及以后版本 |
显示器 | 最小1280X800分辨率 |
网络 | 运行该软件的电脑需要与将要指派的话机在同一局域网 |
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
在该页可以看到当前选择的设备模板，并且可以对选择的设备的Account、LineKey、EXP_KEY、Network等进行个性化设置，其可配置项与网页端基本相同。
...
该页左侧为话机图片，可点击图片上面的功能按键（账号键，可程序设计功能键，扩展板功能键等），中间目录以及页面右侧的内容会对此动作作出响应。亦可以直接点击中间的目录，右侧的内容会对此作出响应。
| Anchor | ||||
|---|---|---|---|---|
|
在该页可以导入合适的CSV文件，批量生成配置文件。
...
选择“批量生成”支持自定义生成的配置文件的存放地址；选择“生成到内建服务器”，则生成的配置文件将保存到内建服务器的cfg目录下（如：C:\Users\admin\Desktop\HPT 1.4.0beta\server\htdocs\cfg）。
| Anchor | ||||
|---|---|---|---|---|
|
在该页可以扫描局域网中的设备，并对选中的设备进行手动指派、升级、刷新状态以及重启等操作。
...
“Reboot”：该命令让话机重启，此时需要填写CMD的name和password，如下图所示：
...
3.3.1 扫描DSP信息功能介绍
此功能可以实现DSP版本信息显示。
示例:
DSP列显示信息对照
...
每次使用Discover Devices 后，Dsp列都会刷新，需要点击DSP ANALYING重新获取，在获取过程中，按钮样式会变为[DSP ANALYING...] 在获取成功并显示之后会恢复原状。
本功能基于HTTP请求，使用前，请开启话机网页设置Network->Advanced→Web Server →Type 选择要有HTTP项，否则会造成访问失败导致的不能获取DSP信息。
| Anchor | ||||
|---|---|---|---|---|
|
在该页可以简易同步设备状态（ONLINE、ACCOUNT、DND等）以及对设备进行指派、升级、配置文件下载等操作。
...
3.4.1 前置条件
HPT工具的设备管理功能需要话机版本大于2.42.6.4.43R11(2021-10-30)
请确保话机配置了DM (Devices Manage) 服务器地址
...
| Info |
|---|
可以通过HPT的指派配置功能，批量为要部署的话机设置这一P值 |
3.4.2 DM服务配置与运行
DM服务需要正确配置并开启。其中Port填写端口号，最终DM服务的地址为宿主IP+Port，如10.2.0.70:8080，点击右侧“Start”开始运行，如下图：
...
如果DM服务不运行（即未点击“Start”），则DM刷新设备状态的功能以及图中的“Refresh”将不能工作。
...
成功开启后，DM服务器将显示运行中
...
Refresh（主动刷新）：开启此功能后，可以设置话机状态主动刷新时间X分钟，DM将每隔X分钟（如图中为3分钟）对设备状态进行更新，即主动要求话机上报信息。该刷新是对上次数据更新已经超过X分钟的设备进行，若超过3次话机依然没有上报信息，该话机将会变成下线状态，即ONLINE变为“OFF”；
...
更新状态监控：DM以可视化的方式展现数据库中设备的更新，目前设定为每3秒计算一次。左上角的数字表示该图标坐标的上限。该图可以协助检测网络是否存在问题。
...
3.4.3 导入设备
在使用前，需导入设备信息。
设备信息可以通过csv文件编辑、导入（请注意使用UTF-8编码格式）。
...
在设置PIN码后，点击Import导入编辑好的csv文件
...
3.4.4 设备信息展示
导入设备信息后，信息会按STATION分组展现，其中All组包含所有设备信息。设备信息包含如下：
...
可以在站点导航界面直接点击站点进行导航，当站点数据过多时，可以在站点导航下方搜索框内输入关键字进行过滤。
...
3.4.5 站点状态与指派
站点区可以显示当前所选择站点的设备状态（若选择All，则为所有设备的状态）。
...
点击“Provison”按钮，可对所选组所有设备进行批量指派。
...
3.4.6 设备搜索
在搜索区，可以进行设备搜索。搜索按全匹配模式进行，暂不支持模糊搜索。对于“ONLINE”，“DND”等是非选项，输入1/yes/on表示真值，输入0/no/off表示假值，输入为空，表示搜索全部。
...
3.4.7 单设备操作
在设备列表区域，选中某个设备并右键，可弹出操作菜单，如下图（因在线情况不同，有些选项会变灰而无法使用）：
...
编辑：编辑设备信息，支持更改设备名称、话机网页登录账号，话机网页登陆密码以及话机所属站点。更改了设备所属站点后，设备可能显示不在线，在话机再次上报信息后会显示在线。
...
3.4.8 web页面访问
需要在Browser中填入有效的浏览器执行程序路径（推荐chrome或firefox等），按住Ctrl键，点击设备的IP地址，可直接访问话机的网页。若设备信息导入前输入了PIN码加密，则输入PIN码可直接通过https访问话机网页，无需填写用户名和密码进行登录认证；若不填写PIN码，则通过http访问话机网页并且需要填写用户名和密码进行登录认证。
...
4 服务器/程序设置页
在该页可以开启HTTP服务器，用作配置文件服务器和固件服务器。另可开启PNP服务器，用于话机自动指派。同时，在该页还可以修改HPT显示语言。
...
在此模块可以设置工具语言（目前版本仅支持中文和英文两种语言），也可以在此模块选择保留的日志文件数量。
...
5 小工具
该页提供了一种加密工具来加密BIN和XML格式的可读Cfg文件。
...
可以在此页面设置加密密钥、加密文件存储路径、是否覆盖已存在的文件以及观察文件状态等。
6 其他
6.1 服务器运行状态
在工具顶部能够试试观测内建HTTP服务器、PNP服务器以及DM服务运行状态。“Stop”表示服务器停止运行，“Running”表示服务器正在运行。
...
6.2 模板导入与保存
点击“载入模板”加载一个bin格式的配置文件，以使用自定义的配置模板。
...
当编辑了“可视化编辑”页中内容后，“保存”按钮将可用，若点击该按钮，将会直接修改已加载的配置文件模板。点击“另存为”，会弹出另存为对话框，可以将当前的修改另存，而不会修改已加载的模板。
| Anchor | ||||
|---|---|---|---|---|
|
| Info |
|---|
以下所有操作都是指派模式在“Mac模式”下进行的。“PIN模式”在当前版本中不支持 |
| Anchor | ||||
|---|---|---|---|---|
|
要完整的使用本工具的所有功能，需要首先配置和开启相关服务器（如果只进行配置文件生成，则不需要进行这一步操作）。
...
（4）启动PNP服务器。对于HTEK话机，“监听”栏中填写“224.0.1.75”，“端口”栏中填写“5060”（若该端口被占用，需要关闭占用该端口的进程，确保端口可用）。
...
| Anchor | ||||
|---|---|---|---|---|
|
点击所示红框，选择可视化编辑时所用的设备模板。
...
| Anchor | ||||
|---|---|---|---|---|
|
选择设备模板后，软件将使用该模板默认配置。点击“载入模板”加载一个bin格式的配置文件，以使用自定义的配置模板。
...
点击“另存为”，可以将当前的修改另存，而不会修改已加载的模板。
...
| Anchor | ||||
|---|---|---|---|---|
|
切换页面到“可视化编辑”，在该页进行模板的个性化设置。
...
右侧即为具体项目的编辑，每一项对应一个P值。编辑的过程中，软件会自动保存修改到内存中，因此可以直接切换目录，但如果需要使修改在下次打开软件时依然有效，则需要按照上一步（步骤3：加载配置文件模板）的操作进行保存。
| Anchor | ||||
|---|---|---|---|---|
|
切换页面到“批量制作”。
（1）准备好CSV文件，该文件可用文本编辑器或者Excel打开和制作（模板在HPT工具的samples文件夹中）；
...
（6）点击“批量生成”或“生成到内建服务器”保存生成的配置文件。
| Anchor | ||||
|---|---|---|---|---|
|
切换页面到“设备扫描”。在该页，可以搜索局域网内设备并对其进行指派。
...
点击右键，会弹出功能菜单，支持指派、升级、刷新状态以及Reboot四个功能。
步骤7：使用DM服务
切换页面到“设备管理”页面。
填写可用端口，点击“开启”打开DM服务；
选择开启“刷新”，并设置话机上报状态信息的间隔时间，单位：分钟；
导入CSV文件，建议用户导入文件前输入PIN码以增加数据安全性；
在“浏览器”内填入有效的浏览器执行程序路径，用以访问话机网页、抓包等；
选中某一话机，鼠标右键，可执行指派、升级、刷新状态、下载bin格式的配置文件、下载xml格式的配置文件、下载话机log、话机网页抓包、话机重启以及话机信息编辑的功能（ONLINE为“OFF”的话机只能执行重启和编辑的功能）。
| Anchor | ||||
|---|---|---|---|---|
|
工具的文件结构如下图所示：
...
根目录下有“cache”、“DB”、“default”、“ini”、“log”、“models”、“samples”和“server”文件夹。
...
“server”下的“htdocs”文件夹中有“cfg”文件夹（用于存放cfg文件）和“fw”文件夹（存放固件）。内建HTTP服务器需要这些文件夹。
| Anchor | ||||
|---|---|---|---|---|
|
为什么PNP服务器不能启动？
通常这是因为端口被占用。如3CX服务器会独占5060端口，对此您可选择停止3CX的服务，或者使用其他的PC。
...
抱歉，当前版本不支持该功能。我们正在解决这个问题。
| Anchor | ||||
|---|---|---|---|---|
|
2020-10-27:1.4.0beta
1.新增Devices Manage功能和说明；
...