> ## Documentation Index
> Fetch the complete documentation index at: https://doc.lwops.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 部署与初始化

包含部署与初始化相关常见问题。

（持续完善中）

## 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](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 后重新登录访问

2. 核查 PostgreSQL 数据库 5432 端口监听状态，确认服务正常启动，若数据库异常，则使用以下命令重启相关服务

systemctl restart postgresqld

systemctl restart perseusZ\_server

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

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

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

1.镜像包部署版本：可直接修改操作系统本机 IP，平台服务会自适应生效

2.免编译部署包安装版本：需参考以下链接内完整步骤操作，完成平台相关配置文件IP同步变更。

[/samples/envchange](/samples/envchange)

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

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

[/samples/vmw](/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](/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`
>
> 6. 重启引用方服务：`systemctl restart perseusZ_server`，重启乐维应用（通常重启 nginx + php-fpm 或整体重启脚本）。
> 7. 验证连接：`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`。
>
> 3. 重启 BPM6：`systemctl restart bpm6`（或用 `/itops/bpm6/bin/shutdown.sh && /itops/bpm6/bin/startup.sh`）。
> 4. 验证：`ss -ltn | grep 8083`
> 5. **检查 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/`
>
> 3. 常见原因：
>
> * `.env` 里的 `DB_PORT`/`REDIS_PORT`/`MONGODB_PORT` 没同步 - 应用连不上库。
>
> * `perseusZ_server.conf` 的 `DBPort` 没同步 - Server 起不来。
>
> * nginx 的 `proxy_pass` 还指向旧端口 - 502。
>
> * 防火墙没放行新端口 - 远程连不上。
>
> 4. 确认端口监听：`ss -ltnp | grep -E '新端口'`
> 5. 回滚：用之前备份的 `.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`<br />`systemctl restart redis`<br />`systemctl restart mongodb`<br />`systemctl restart hugegraph`<br />`systemctl restart perseusZ_server`<br />`systemctl restart perseusZ_agentd`<br />`systemctl restart php-fpm`<br />`systemctl restart bpm6`<br />`systemctl restart nginx`
>
> 4. 验证全部就绪：`systemctl status postgresqld redis mongodb hugegraph perseusZ_server perseusZ_agentd php-fpm bpm6 nginx | grep -E 'Active:'`
>
> **注意事项：**
>
> * 重启顺序很重要：数据库和缓存要先起，应用层后起，否则应用启动时连不上库会反复重试或失败。
> * 如果改了端口，一定要先确认配置文件都同步好了再批量重启。

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

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