JOYZL SCADA

在 Linux 中安装

安装示例基于 Debian 12 x64位操作系统。

1.安装前的准备

时序数据存储位置应采用独立的磁盘分区，并推荐使用 XFS 文件系统， 以忽略元数据的方式挂载分区，请务必提前准备好用于存储时序数据的分区。

确保当前登录用户未来将用于管理维护并具有 root 权限，否则请切换当前登录用户。 然后下载服务端(JOYZL SCADA Server)程序包，到当前登录用户目录并将其解压。 也可以通过其它工具上传或复制程序包到操作系统中，再执行解压。

# 下载
wget https://www.joyzl.com/download/joyzl-scada-server_linux-x86_64_9.1.0.tar.gz
# 解压
tar -xzf joyzl-scada-server_linux-x86_64_9.1.0.tar.gz

2.执行安装

切换当前目录到解压后的程序文件目录中，然后执行安装脚本。

# 切换目录
cd joyzl-scada-server
# 安装
sudo ./install.sh

安装后文件位于以下目录中：

• 主程序 /opt/joyzl/scada-server
• 配置文件 /etc/joyzl/scada-server
• 服务管理 /etc/systemd/system
• 日志文件 /var/log/joyzl/scada-server
• 缓存文件 /var/cache/joyzl/scada-server
• 结构数据 /var/lib/joyzl/scada-server
• 时序数据 /series

3.调整配置

检查并调整配置文件中的参数，确保符合您的需求。 特别注意时序数据存储位置，默认为 "/series"，系统中可能并没有这个目录。 可以将专用于时序数据的分区挂载到 "/series" 位置； 或通过配置文件将其指定到已准备好的分区路径， 最后需要设置时序数据目录的所有权。 参考 配置项 了解更多关于配置的说明。

# 设置时序数据目录权限
sudo chown -R scada:scada /series
sudo chmod -R 770 /series

4.启动或停止服务

通过以下指令启动或停止服务：

• 启动服务 systemctl start joyzl-scada-server
• 停止服务 systemctl stop joyzl-scada-server
• 运行状态 systemctl status joyzl-scada-server

5.验证是否就绪

服务端程序启动成功后，会输出启动日志，请检查 /var/log/joyzl/scada-server 目录中的日志文件。 如果您的程序包已内置前端页面，可通过浏览器访问服务器地址， 例如：http://192.168.2.8 将能够显示前端页面。

注意： 请检查操作系统和硬件防火墙，确保服务端口位于防火墙允许通信的规则中； 否则需要添加防火墙规则，允许 ODBS_PORT 和 HTTP_PORT 指示的端口被客户端访问。

在 Windows 中安装

安装示例基于 Windows Server 2019 x64位操作系统。

1.安装前的准备

时序数据存储位置应采用独立的磁盘分区，并推荐使用 ReFS 文件系统， 以获得更高性能，请务必提前准备好用于存储时序数据的分区。

下载服务端(JOYZL SCADA Server)程序包到操作系统中。 也可通过其它工具上传或复制到操作系统中。 然后将程序包解压到任意位置。

2.执行安装

安装为系统服务

以管理员身份运行 解压后程序目录中的 install.cmd 文件，将服务端程序安装到默认系统位置， 通常为 C:\Program Files，并自动将其注册为 Windows Service 系统服务， 服务名为 JOYZL-SCADA-Server 。

安装后文件位于以下目录中：

• 主程序 C:\Program Files\joyzl\scada-server
• 配置和数据 C:\ProgramData\joyzl\scada-server

自定义安装

将解压后的整个程序文件夹复制到您期望的位置， 确保整个路径中没有特殊字符和双字节字符（例如汉字）。 服务端(JOYZL SCADA Server)可以免安装方式直接运行。 产生的数据均位于程序所在目录中。

3.调整配置

检查并调整配置文件中的参数，确保符合您的需求。 特别注意时序数据存储位置，默认为 "series" 位于默认程序数据位置。 应通过配置文件将其指定到已准备好的分区路径。 参考 配置项 了解更多关于配置的说明。

4.启动或停止服务

如果安装为系统服务， 在 Windows 的 计算机管理 界面中， 展开 服务和应用程序 并选择 服务， 在列表中找到并选中 JOYZL SCADA Server 将其启动，可以同样的方式停止服务。

如果是自定义安装，可双击程序目录中的 server.cmd 以控制台方式启动程序； 或者运行 server.exe 程序将在后台启动（注意：不会有任何显示）。 控制台启动后可通过 Ctrl+C 将其停止； 后台运行时只能通过 任务管理器 强行停止（不推荐）。

5.验证是否就绪

服务端程序启动成功后，会输出启动日志，默认位于程序目录下的 log 目录中， 请检查日志目录中的日志文件。 如果您的程序包已内置前端页面，可通过浏览器访问服务器地址， 例如：http://192.168.2.8 将能够显示前端页面。

注意： 请检查操作系统和硬件防火墙，确保服务端口位于防火墙允许通信的规则中； 否则需要添加防火墙规则，允许 ODBS_PORT 和 HTTP_PORT 指示的端口被客户端访问。

开始使用

接下来您可以通过工作站(JOYZL SCADA Station)为服务端添加用户和设备了！

由于新安装的服务端中没有任何用户，工作站可以任意账号密码连接到服务端， 请登录后立即创建管理员账号。

注意： 在服务端后续添加的设备中如果有 SCADA(MASTER) ← 设备(SLAVE) 模式； 服务端会动态启用指定的端口，需要添加防火墙规则，允许这些端口被设备访问。

配置项

服务端(JOYZL SCADA Server) 配置文件名为 server.properties， 在Windows系统部署后，配置文件通常位于程序目录中； 在Linux系统部署后，配置文件通常位于 /etc/joyzl/scada-server/ 中。 配置文件修改后需要重启服务程序才能生效。

配置文件中所有与文件目录路径相关的配置项， 均可用绝对路径和相对路径（相对于程序位置）， 但对于时序数据，不应存储在程序所在目录中， 通常应规划到专门的磁盘分区。 不要与任何其它程序共用 服务端(JOYZL SCADA Server) 存储数据的目录， 这些目录应被 服务端(JOYZL SCADA Server) 独占。

# 线程数量，0表示由系统决定
THREAD=0

# ODBS 服务地址，留空表示服务器所有地址
ODBS_IP=
# ODBS 服务端口
ODBS_PORT=1230

# HTTP 服务地址，留空表示服务器所有地址
HTTP_IP=
# HTTP 服务端口
HTTP_PORT=80
# HTTP 服务内容所在目录，通常用于发布前端网页
HTTP_CONTENT=web
# HTTP 服务缓存目录，用于压缩后的缓存资源
HTTP_CACHE=cache

# 基础结构化数据存储目录
BASE_DATA_PATH=data
# 登录密码摘要算法
VERIFY_PASSWORD=SHA-256

# 设备时序数据存储目录
DEVICE_DATA_PATH=series\\device
# 设备时序数据过期天数
DEVICE_DATA_EXPIRE=90
# 设备时序数据保存间隔（秒）
DEVICE_DATA_SAVE_INTERVAL=6

# 表计状态更新间隔（秒）
METER_REFRESH_INTERVAL=2
# 表计每日抄表时刻
METER_DATA_TIME=23:00:00
# 表计抄表记录存储目录
METER_DATA_PATH=series\\energy
# 表计抄表数据过期天数
METER_DATA_EXPIRE=90

# 装备状态更新间隔（秒）
EQUIPMENT_REFRESH_INTERVAL=1
# 工件数据存储目录
PIECE_DATA_PATH=series\\piece
# 工件数据过期天数
PIECE_DATA_EXPIRE=90
# 产量数据存储目录
YIELD_DATA_PATH=series\\yield
# 产量数据过期天数
YIELD_DATA_EXPIRE=90
# 追溯履历存储目录
CODE_DATA_PATH=series\\code
# 追溯履历过期天数
CODE_DATA_EXPIRE=90

# 日志输出等级
# ERROR=1,INFO=2,DEBUG=3
LOG_LEVEL=3
# 日志过期天数
LOG_EXPIRES=90
# 日志存储目录
LOG_PATH=log

卸载程序

Windows

以管理员身份运行 uninstall.cmd 可删除服务和程序文件，用户数据文件不会自动删除； 如确认不再需要这些数据，可以手动将其删除。

Linux

以管理员权限运行 uninstall.sh 可删除服务和程序文件，用户数据文件不会自动删除； 如确认不再需要这些数据，可以手动将其删除。