玄道智控平台

# 部署手册

文档版本 内容修订 修订人 修订日期
V1.0 玄道智控部署手册基本内容 王垚、王家乐 2021-01-12
V1.1 添加用户权限认证, 添加自启注意事项 王垚 2021-01-21
V1.2 添加 SSL 证书配置方式 王垚 2021-02-04
V1.3 添加 Frist Login 模式 王垚 2021-02-22
V1.4 添加 ArangoDB 数据库安装配置说明 王垚 2021-03-23
V1.5 添加 ccs-web 组件部署说明 王家乐 2021-07-09
V1.6 更新中标麒麟部署说明 王垚 2021-08-08
V1.7 更新操作系统要求 王垚 2022-10-16
V1.8 添加使用 nedb 数据库使用方式 王垚 2022-11-23
V2.1.9 新增服务管理 王家乐 2024-08-20
V3.0.0 更新部署方式 郭程豪 2024-09-20

# 硬件和操作系统要求

硬件要求 推荐规格
处理器(CPU) >= i5-10500，arm 或 x84-64
内存(RAM) >= 16G
硬盘(DISK) >= 512G，推荐 SSD
操作系统 推荐版本
Windows >= Win10
Macos >= 12.1
Ubuntu >= 20.04

# 获取软件

下载地址: 上海三思玄道智控 (opens new window)

通过上面的链接可以下载到玄道智控软件的各个系统版本(cyberhub),请下载适合目标设备的软件，解压安装。适用于在 x86 和 arm 架构下的 64 位通用操作系统上运行, 如果需要 MIPS/LoongArch 架构等特殊版本或者特殊操作系统适配, 请联系研发团队获取.

img_021

程序名称 架构 适用操作系统
cyberhub_x.x.x_windows_x64.zip x64 Window10及以上
cyberhub_x.x.x_windows_arm64.zip arm64 Window10及以上
cyberhub_x.x.x_mac_x64.zip x64 MacOS(Intel 版本)
cyberhub_x.x.x_mac_arm64.zip arm64 MacOS(M1、M2版本)
cyberhub_x.x.x_linux_x64.deb x64 Ubuntu、CentOS、中标麒麟、UOS 等
cyberhub_x.x.x_linux_arm64.deb arm64 Ubuntu、CentOS、中标麒麟、UOS 等

# 安装启动

# Windows

下载 cyberhub_x.x.x_windows_[arch].zip 压缩包并解压，解压后可以看到如下内容，运行 run.bat

使用键盘输入数字1后按回车键导入服务，等待执行结束后再次按下回车键
当看到 当前服务状态：SERVICE_RUNNING 是表明服务安装成功，此时关闭终端
使用新版 Edge 浏览器或者 Chrome 浏览器访问 http://127.0.0.1:1280 即可进入操作页面

# ⚠️注意：0.9.4 以后默认开启 HTTPS，访问地址为 https://127.0.0.1:12443

deploy1.png

image-20231102091451654

image-20231102091509976

image-20231102091521966

# Linux

此处以 Ubuntu 为例，

联网的状态下获取软件：

sudo wget https://ccs-pro.sansi.io/deb/cyberhub_3.0.0_latest_arm64.deb

非联网状态下获取软件：

  1. 通过 玄道智控平台 (opens new window) 下载对应平台的 deb 安装包。
  2. 将 deb 安装包通过U盘，scp、sftp、光盘等方式传递到需要安装的linux服务器上。

执行安装命令

sudo chmod 755 cyberhub_3.0.0_linux_arm64.deb # 调整权限(注意文件名修改为实际名称)。
sudo dpkg -i cyberhub_3.0.0_linux_arm64.deb # 安装程序。

上述命令执行完成后，看到

image-20231102095132761

# 升级

点击用户头像，进入【关于平台】页面。

deploy2.png

点击【检查更新】或【本地更新】按钮

检查更新为在线升级
本地更新为上传软件包升级

在弹出的文件选择框里面选择对应平台的安装包，windows 选择 zip，linux 选择 deb。

deploy3.png

之后会看到上传进度，上传结束后等待服务自动重启即可，重启可能会需要等待一段时间，重启后需刷新页面

deploy4.png

# 卸载

# Windows

找到安装目录，并双击 run.bat 运行。 deploy1.png

# Linux

打开终端并输入如下命令即可卸载对应的程序。

sansi

# 执行卸载

输入数字键 2 后回车，根据提示操作即可进行卸载

image-20231102095809606

# 软件激活

确保服务器时间，与世界时间保持一致

# 在线激活

# 离线激活

# 配置管理员

在使用默认配置的情况下，软件启动后在浏览器中输入http://127.0.0.1:1280 即可打开软件，如果修改可以配置，可以根据控制台输出的信息在浏览器中打开对应的地址即可。

首次启动软件，自动进入初始化管理员页面，创建系统管理员，系统管理员账户密码打死不能告诉别人

img_010

# 进入软件

创建完系统管理员后，自动跳转至登陆页面，登陆成功后进入主页

img_004

注意: 输入配置管理员的账号密码即可进入项目

# 主页介绍

进入主页后, 显示页面如下，在项目首页鼠标悬浮到项目中，即可编辑项目.

deploy4

  1. 进入项目：运行编辑好的项目
  2. 编辑项目：编辑项目布局事件等，项目编辑器的使用教程不在此文档范畴内，如需学习使用页面编辑器, 请参考编辑器使用手册
  3. 重命名项目：名称、项目预览图
  4. 删除项目
  5. 服务管理：维护现场用到的所有软件，启动，停止，重启，监控服务状态，添加服务请求代理，修改服务配置
  6. 用户管理：创建用户，修改用户信息，修改用户角色，重置密码，禁用用户

在已经有项目数据包(项目名称_v1.0.0_202101010808.sccs)的情况下, 点击左上角导入项目, 选择数据包导入即可, 如果没有数据包, 则需要点击新建项目来创建一个新项目.

# 数据目录

应用启动后, 会在用户目录下生成相关文件, 如下:

在window系统中, 该文件夹路径可能为: C:\sansitech\cyberhub.

在 Linux系统中, 该文件夹的路径可能为: /opt/sansitech/cyberhub.

img_008

  • 如果后续需要调整应用启动端口, 请调整此目录下的 config/cyberhub.json 文件.
  • 如果现场程序出现无法解决的故障, 请将 logs 目录压缩打包后发送给研发团队, 用于分析故障原因.
  • app目录为服务端下载的服务端程序数据

# 数据备份

img_008

  1. 进入服务管理页面，点击全选按钮。
  2. 点击备份，等待备份完成

# 数据恢复

img_008

  1. 进入服务管理页面，点击备份。
  2. 上传备份数据，等待备份完成

# 注意事项

  • 部分路由器没有明确的 LAN口和 WAN 口，当检测到外网被识别的口，被定义为 WAN 口，大多数项目是不接外网的，会导致无法正确识别 WAN 口, 导致连接 Wi-Fi 的设备之间 ping 不通, 需要登录到路由器配置页面手动指定 WAN 口.
  • Pad 上使用 Chrome 访问, 地址栏占用空间过大, 将页面添加到桌面即可, 如果无法添加到桌面, 参考下一条.
  • Pad 在将应用也添加到桌面不生效，应在Pad设置 -> 权限管理 -> 找到 Google Chrome -> 发送到桌面 开启发送到桌面权限
  • 所有可控设备在控制界面发出对应指令不生效时，应检测通信是否正常，使用电脑 ping 目标设备，检测是否可以 ping 通.
  • 当前软件仅支持 Chrome 80 以上的版本, 如果运行过程中发现问题, 请检查 Chrome 版本是否为最新版本.
  • 设置自动启动策略时, 一定要注意启动账户和账户名是否和当前配置的账户一致.

← 页面编辑 →