Skip to main content
包含部署与初始化相关常见问题。 （持续完善中）

​
Q1: 平台部署最低硬件配置要求是多少？

推荐配置：CPU 8核以上、内存 16GB 以上、硬盘 200GB 以上（具体根据监控规模浮动）。生产环境建议更高配置。

​
Q2: 镜像包部署和部署包安装有什么区别？

镜像包（ISO）是完整系统镜像，部署更快捷但灵活性低；部署包是在已有操作系统上通过脚本安装，可自定义，灵活性更高。镜像包仅支持 VMware Workstation 和 VMware vSphere 环境，部署包支持多种 Linux 发行版。

​
Q3: 乐维平台默认管理员账号密码是什么？

账号：Admin 密码：ITIM_p@ssw0rd

​
Q4: 免费版在哪里下载？

访问以下链接下载： http://channel.lwops.cn/backend_api/door/verification/channel?c=901BlvGU&type=register

​
Q5: 部署时硬盘挂载失败怎么处理？

在部署包安装过程中，选择更改硬盘挂载路径。

​
Q6: 重新启动服务器后又回到环境检测界面怎么办？

核查 PostgreSQL 数据库5432端口监听状态，确认服务正常启动。 若端口未启用、服务异常，执行下述命令重启数据库与采集服务： systemctl restart postgresqld systemctl restart perseusZ_server

​
Q7: 部署 8.1 版本后部分模块界面显示空白怎么办？

1.前端页面兼容排查：切换 Chrome、Edge 等主流浏览器，清理浏览器缓存与 Cookie 后重新登录访问
  1. 核查 PostgreSQL 数据库 5432 端口监听状态，确认服务正常启动，若数据库异常，则使用以下命令重启相关服务
systemctl restart postgresqld systemctl restart perseusZ_server

​
Q8: 部署 8.1 平台在初始化界面卡住了怎么办？

刷新页面，等待片刻后即可恢复。

​
Q9: 如何修改监控平台的 IP 地址？

1.镜像包部署版本：可直接修改操作系统本机 IP，平台服务会自适应生效 2.免编译部署包安装版本：需参考以下链接内完整步骤操作，完成平台相关配置文件IP同步变更。 /samples/envchange

​
Q10: 镜像部署平台无法获取设备 IP 地址怎么处理？

可参考部署手册内系统IP调整步骤完成静态IP地址配置 /samples/vmw

​
Q11: 镜像包和部署包分别支持哪些操作系统？

1.镜像包： 支持虚拟化平台 VMware Workstation、VMware vSphere 2.免编译部署包：支持以下操作系统 / 容器环境： 容器环境：Docker / Podman 服务器操作系统清单： UOS Server 20 1070a OpenEuler_22.03 SP2 / SP3 / SP4 CentOS7.0-7.9 / AnolisOS7.7-7.9 / Redhat7.0-7.9 KylinV10 SP3 2403 / KylinV10 SP3 2303 / KylinV10 SP2 RockyLinux 8.3-8.10 / AnolisOs 8.2-8.10 / RHEL 8.0-8.10

​
Q12: 8.2 版本的移动端访问地址是什么？

手机浏览器访问 http://平台IP/h5/mobile/lwjk/#/monitor/home。若现场部署使用域名或 HTTPS，请将 平台IP 替换为对应访问地址。

​
Q13: 平台部署到 工单（BPM）阶段时中断失败怎么办？

新建 mariadb-server.cnf 配置文件，配好后重新部署即可。具体处理步骤参考下方链接内容： /samples/bpm-installfailtshoot

​
Q14: 部署中断提示 8081 端口被占用，Nginx 启动失败怎么办？

部署环境为非纯净环境，存在其他程序占用 8081 端口，环境冲突导致服务起不来。需要更换全新纯净服务器环境，重新部署，避开端口冲突。

​
Q15: 平台页面加载缓慢或卡顿怎么处理？

  1. 清理浏览器缓存；
  2. 更换浏览器（推荐 Chrome）；
  3. 检查服务器资源使用情况；
  4. 关闭浏览器图形加速功能（部分显卡驱动兼容问题）。

​
Q16: 运维驾驶舱无法加载出来怎么解决？

更换浏览器，或者关闭浏览器的图形加速功能。

​
Q17: CMDB 和监控中心有什么区别？

CMDB 记录资产的配置信息（型号、序列号、负责人、所属业务等）；监控中心记录实时运行状态（CPU、内存、端口流量等）。CMDB 可与监控联动，自动同步监控对象的资产数据。

​
Q18: 如何修改乐维门户访问端口（Nginx 80/443）？

修改/itops/nginx/conf/vhost/lwjk_app.conf里的listen 指令，执行systemctl restart nginx。同时建议同步 .env 里的 WEB_PORT。
详细步骤：
  1. 备份：cp /itops/nginx/conf/vhost/lwjk_app.conf /itops/nginx/conf/vhost/lwjk_app.conf.bak.$(date +%F)
  2. 编辑文件，把 listen 80; 改成目标端口，例如 listen 8080;。如果启用 HTTPS，同步改 listen 443 ssl;。
  3. 同步 .env：把 /itops/nginx/html/lwjk_app/.env 里的 WEB_PORT=80 改成新端口。
  4. 检查配置语法：/itops/nginx/sbin/nginx -t
  5. 重启：systemctl restart nginx
  6. 验证：ss -ltn | grep 8080，浏览器访问 http://\<服务器IP>:8080/
注意事项：
  • 80 端口通常需要 root 权限，改成非 80 端口后普通用户也能绑，但 1024 以下端口仍需 root 或 setcap。
  • 如果前面还有负载均衡或防火墙，记得同步放行新端口。
  • listen 8081 是 PHP-FPM 后端的内部监听，一般不要动。

​
Q19: 如何修改 PostgreSQL 数据库端口（默认 5432）？

修改 postgresql.conf 里的 port，重启 postgresqld，然后同步更新所有引用方的端口（.env、perseusZ_server.conf）。
详细步骤：
  1. 找到配置文件：find /itops/postgresql -name postgresql.conf，通常在 /itops/postgresql/\<版本>/data/postgresql.conf。
  2. 备份后修改 port = 5432 为新端口，例如 port = 15432。同时检查 listen_addresses 是否允许远程连接。
  3. 重启：systemctl restart postgresqld
  4. 验证监听：ss -ltn | grep 15432
  5. 同步引用方（关键，否则平台起不来）：
  • /itops/nginx/html/lwjk_app/.env：DB_PORT=15432
  • /itops/perseusZ/etc/perseusZ_server.conf：DBPort=15432
  1. 重启引用方服务：systemctl restart perseusZ_server，重启乐维应用（通常重启 nginx + php-fpm 或整体重启脚本）。
  2. 验证连接：PGPASSWORD=\<密码> psql -h 127.0.0.1 -p 15432 -U itops -d lwops -c '\l'
注意事项：
  • PostgreSQL 是乐维主库，改端口影响面最大，务必同步所有引用方。
  • 如果开启了防火墙，放行新端口。
  • PerseusZ 的监控模板里有些自定义监控项用 psql -p 连库，改端口后这些模板的宏可能要更新。

​
Q20: 如何修改 MySQL/MariaDB 端口（默认 3306）？

修改 /etc/my.cnf.d/mariadb-server.cnf 里 [mysqld] 段的 port，重启 mariadb。
详细步骤：
  1. 备份：cp /etc/my.cnf.d/mariadb-server.cnf /etc/my.cnf.d/mariadb-server.cnf.bak.$(date +%F)
  2. 在 [mysqld] 段添加或修改 port=3307。
  3. 重启：systemctl restart mariadb
  4. 验证：ss -ltn | grep 3307，mysql -h 127.0.0.1 -P 3307 -u root -p
注意事项：
  • 乐维主业务用 PostgreSQL，MySQL/MariaDB 多用于 BPM 或第三方组件。改之前确认哪些组件连它（检查 .env 和各组件配置里有没有 mysql 连接串）。
  • 如果有组件通过 localhost 连接，注意 MySQL 的 socket 连接不受 port 影响，但 TCP 连接会受影响。

​
Q21: 如何修改 MongoDB 端口（默认 27017）？

修改 /itops/mongodb/mongodb.conf 里的 port，重启 mongodb，同步 .env 里的 MONGODB_PORT。
详细步骤：
  1. 备份：cp /itops/mongodb/mongodb.conf /itops/mongodb/mongodb.conf.bak.$(date +%F)
  2. 修改 port=27017 为新端口，例如 port=27018。注意 bind_ip 当前是 127.0.0.1，如需远程访问也要改。
  3. 重启：systemctl restart mongodb
  4. 验证：ss -ltn | grep 27018
  5. 同步引用方：/itops/nginx/html/lwjk_app/.env 里的 MONGODB_PORT=27018。
  6. 重启乐维应用使 .env 生效。
  7. 验证连接：mongosh --port 27018 -u cmdb -p --authenticationDatabase cmdb
注意事项：
  • MongoDB 存的是 CMDB 数据，改端口后 CMDB 相关功能依赖 .env 的 MONGODB_PORT，必须同步。
  • auth=true 已开启，连接需要账号密码。

​
Q22: 如何修改 Redis 端口（默认 6379）？

修改 /etc/redis.conf 里的 port，重启 redis，同步 .env 里的 REDIS_PORT。
详细步骤：
  1. 备份：cp /etc/redis.conf /etc/redis.conf.bak.$(date +%F)
  2. 修改 port 6379 为新端口，例如 port 6380。
  3. 重启：systemctl restart redis
  4. 验证：ss -ltn | grep 6380，redis-cli -p 6380 ping
  5. 同步引用方：/itops/nginx/html/lwjk_app/.env 里的 REDIS_PORT=6380。
  6. 重启乐维应用使 .env 生效。
注意事项：
  • Redis 当前 bind 127.0.0.1 且 protected-mode yes，只本机访问。改成远程访问要同时调整 bind 和 protected-mode，并设置 requirepass。
  • 乐维用 Redis 做缓存和会话，改端口不同步 .env 会导致登录异常。

​
Q23: 如何修改 BPM6（Tomcat）端口（默认 8082/8005）？

修改 /itops/bpm6/conf/server.xml 里的 Connector port 和 Server port，重启 BPM6。
详细步骤：
  1. 备份：cp /itops/bpm6/conf/server.xml /itops/bpm6/conf/server.xml.bak.$(date +%F)
  2. 编辑 server.xml：
  • HTTP Connector：“ 改成新端口，例如 8083。
  • Shutdown 端口：“ 建议一并改掉，例如 8006。
  1. 重启 BPM6：systemctl restart bpm6（或用 /itops/bpm6/bin/shutdown.sh && /itops/bpm6/bin/startup.sh）。
  2. 验证：ss -ltn | grep 8083
  3. 检查 nginx 反代：/itops/nginx/conf/vhost/lwjk_app.conf 里有 proxy_pass http://127.0.0.1:8082/bpm6/;，改成新端口后 reload nginx：systemctl reload nginx。
注意事项：
  • BPM6 是工单流程引擎，改端口主要影响工单相关页面。nginx 反代不改的话，工单入口会 502。
  • Tomcat 的 redirectPort="8443" 一般不用动，除非你配置了 HTTPS 直连 Tomcat。

​
Q24: 如何修改 HugeGraph 图数据库端口（默认 8091/8182）？

修改 /itops/hugegraph/conf/rest-server.properties 和 gremlin-server.yaml，重启 hugegraph。
详细步骤：
  1. 备份两个配置文件。
  2. rest-server.properties：rpc.server_port=8091 改成新端口。
  3. gremlin-server.yaml：port: 8182 改成新端口（注意这个文件里 port 是注释掉的，需要取消注释或确认实际值）。同步 gremlin-driver-settings.yaml、remote.yaml、remote-objects.yaml 里的 port: 8182。
  4. 重启：systemctl restart hugegraph
  5. 验证：ss -ltn | grep -E '8091|8182'
注意事项：
  • HugeGraph 的 REST 端口（8091）和 Gremlin 端口（8182）要同时改，且配置文件之间要一致，否则 Gremlin 查询会连不上。
  • HugeGraph 主要服务于拓扑关系，改端口后拓扑图加载会受影响，确认乐维应用里拓扑模块的 HugeGraph 地址配置（一般在 .env 或专门的配置文件里）也要同步。

​
Q25: 如何修改 PerseusZ Server 端口（默认 10051）？

修改 /itops/perseusZ/etc/perseusZ_server.conf 里的 ListenPort，重启 perseusZ_server，同步 Agent 的 Server 配置和 .env。
详细步骤：
  1. 备份：cp /itops/perseusZ/etc/perseusZ_server.conf /itops/perseusZ/etc/perseusZ_server.conf.bak.$(date +%F)
  2. 修改 ListenPort=10051 为新端口，例如 10053。
  3. 重启：systemctl restart perseusZ_server
  4. 验证：ss -ltn | grep 10053
  5. 同步 Agent：/itops/perseusZ/etc/perseusZ_agentd.conf 里的 Server=127.0.0.1,192.168.1.60 后面如果有端口要同步；ServerPort=10051（如果有）改成新端口。重启 Agent：systemctl restart perseusZ_agentd。
  6. 同步 .env：PERSEUS_SERVER_PORT=10053，重启乐维应用。
  7. 检查 nginx 反代：lwjk_app.conf 里 proxy_pass http://127.0.0.1:8081/zbx/ 是通过 PHP 中转的，一般不直接连 10051，但要确认乐维前端调用的 API 地址。
注意事项：
  • PerseusZ Server 是监控核心，改端口影响所有 Agent 上报和前端监控数据拉取。
  • 分布式部署时，所有远端 Agent 的 Server 都要改，否则采集中断。
  • perseusZ_server.conf 里还有 DBPort=5432，如果 PG 端口也改了，这里要同步。

​
Q26: 如何修改 PerseusZ Agent 端口（默认 10050）？

修改 /itops/perseusZ/etc/perseusZ_agentd.conf 里的 ListenPort，重启 perseusZ_agentd。
详细步骤：
  1. 备份配置文件。
  2. 修改 ListenPort=10050 为新端口，例如 10055。
  3. 重启：systemctl restart perseusZ_agentd
  4. 验证：ss -ltn | grep 10055
  5. 同步 Server 侧：PerseusZ Server 主动连接 Agent 做主动检查时，需要在 Server 配置或前端「主机配置」里指定 Agent 端口。在乐维平台「监控 > 主机」里编辑对应主机，把 Agent 端口改成新值。
注意事项：
  • Agent 端口用于接收 Server 的主动检查（如 ICMP、端口检查）。改了之后，Server 不知道新端口会导致部分监控项超时。
  • Server=127.0.0.1,192.168.1.60 这行控制允许哪个 Server 连过来，改端口不影响这个白名单。

​
Q27: 如何修改 PHP-FPM 监听方式（默认 socket）？

修改 /itops/php/etc/php-fpm.d/www.conf 里的 listen，重启 php-fpm，同步 nginx 的 fastcgi_pass。
详细步骤：
  1. 备份：cp /itops/php/etc/php-fpm.d/www.conf /itops/php/etc/php-fpm.d/www.conf.bak.$(date +%F)
  2. 当前是 listen = /itops/php/var/run/php-fpm.sock（Unix socket）。改成 TCP：listen = 127.0.0.1:9000。
  3. 重启：systemctl restart php-fpm
  4. 验证：ss -ltn | grep 9000
  5. 同步 nginx：/itops/nginx/conf/vhost/lwjk_app.conf 里所有 fastcgi_pass unix:/itops/php/var/run/php-fpm.sock; 改成 fastcgi_pass 127.0.0.1:9000;，然后 systemctl reload nginx。
注意事项：
  • 默认 socket 性能略好（少一层 TCP），一般不建议改成 TCP 除非要做远程 PHP 或容器化。
  • 改回 socket 时反向操作即可。

​
Q28: 改完端口后平台起不来，怎么排查？

按依赖顺序逐个查：数据库 - Redis/Mongo - PerseusZ - PHP-FPM - Nginx，看哪个服务的日志报端口冲突或连接拒绝。
详细步骤：
  1. 查每个服务状态：systemctl status postgresqld redis mongodb perseusZ_server perseusZ_agentd php-fpm nginx bpm6 hugegraph
  2. 看日志：
  • PostgreSQL：/itops/postgresql//data/log/
  • Nginx：/itops/nginx/logs/error.log
  • PHP-FPM：/itops/php/var/log/php-fpm.log
  • PerseusZ Server：/itops/perseusZ/logs/zabbix_server.log
  • 乐维应用：/itops/nginx/html/lwjk_app/runtime/logs/
  1. 常见原因：
  • .env 里的 DB_PORT/REDIS_PORT/MONGODB_PORT 没同步 - 应用连不上库。
  • perseusZ_server.conf 的 DBPort 没同步 - Server 起不来。
  • nginx 的 proxy_pass 还指向旧端口 - 502。
  • 防火墙没放行新端口 - 远程连不上。
  1. 确认端口监听：ss -ltnp | grep -E '新端口'
  2. 回滚：用之前备份的 .bak 文件恢复，重启服务。

​
Q29: 有没有一键重启所有组件的方法？

乐维通常提供整体启停脚本，在 /itops/perseusZ/scripts/ 或部署目录下，也可以按依赖顺序手动重启。
详细步骤：
  1. 查找启停脚本：ls /itops/perseusZ/scripts/ | grep -iE 'start|stop|restart'，或 find /itops -maxdepth 3 -name '*.sh' | grep -iE 'start|stop'。
  2. 如果有 start_all.sh / stop_all.sh，按顺序执行：先 stop 再 start。
  3. 手动按依赖顺序重启（推荐，更可控）：
systemctl restart postgresqld
systemctl restart redis
systemctl restart mongodb
systemctl restart hugegraph
systemctl restart perseusZ_server
systemctl restart perseusZ_agentd
systemctl restart php-fpm
systemctl restart bpm6
systemctl restart nginx
  1. 验证全部就绪：systemctl status postgresqld redis mongodb hugegraph perseusZ_server perseusZ_agentd php-fpm bpm6 nginx | grep -E 'Active:'
注意事项：
  • 重启顺序很重要：数据库和缓存要先起，应用层后起，否则应用启动时连不上库会反复重试或失败。
  • 如果改了端口，一定要先确认配置文件都同步好了再批量重启。

​
Q30：部署进度卡在 6%，日志提示 database is locked 如何解决？

上次安装脚本异常中断，产生.rpm.lock 残留文件。排查残留进程与锁文件，删除相关文件，执行卸载脚本后重新运行安装脚本