PXVDI

Appearance

PXVDI 安装 ​

本页说明 PXVDI 总控模式 Web 管理系统的安装和首次初始化流程。

这里介绍的是 PXVDI Server 的安装，也就是你们日常使用的这套管理后台服务端。

安装前先确认什么 ​

正式安装前，建议逐项核对：

  • PXVIRT 已经安装完成。
  • PXVIRT 集群已经创建完成。
  • 已准备一台 Debian(12或者13版本)或者openeuler 24版本 主机或虚拟机安装 PXVDI Server。
  • 已准备数据库地址、端口、账号和密码。
  • 浏览器可以访问 PXVDI Server 监听的 3002 端口。
  • 管理网络可以访问 PXVIRT 管理地址。

总控模式涉及哪些组件 ​

组件作用是否必须说明
PXVIRT提供底层虚拟化能力必须所有虚拟机和集群资源的底座
PXVDI Server提供 Web 管理平台和交付逻辑必须当前这套管理系统
MySQL提供平台数据库必须初始化时要连接
PXVDI HTML5提供浏览器接入能力按需需要浏览器访问桌面时部署
PXVDI Stream提供自研远控和集中控制能力按需需要远控或集中控制时使用
PXVDI 客户端 / 瘦终端供终端用户接入桌面按需视终端接入方式而定

PXVDI Server 安装在哪更合适 ​

安装在虚拟机 ​

优点：

  • 易迁移
  • 易备份
  • 物理机损坏后恢复更方便
  • 平台整体更容易做快照和迁移

适合：

  • 大多数正式环境
  • 未来可能迁移平台的环境

安装在物理机 ​

优点：

  • 架构更直观
  • 少一层虚拟化依赖

风险：

  • 物理机损坏后恢复更麻烦
  • 迁移和备份弹性较差

第一步：安装数据库 ​

PXVDI Server 默认使用 MySQL 数据库。在debian系列系统中安装。

安装数据库 ​

bash
apt update
apt install default-mysql-server -y

设置 root 密码 ​

bash
mysql -uroot -p # 这里会直接进入数据库命令行
ALTER USER 'root'@'localhost' IDENTIFIED BY '新密码'; #这些直接修改root的密码，请替换'新密码'为密码

如果数据库和 PXVDI 不在同一台机器 ​

还需要额外处理：

  • 开启远程访问权限
  • 给 PXVDI 使用的账号授权

示例：

bash
mysql -uroot -p
create user 'pxvdi'@'%' identified by 'P@SSw0rd';    # 创建一个用户
GRANT ALL PRIVILEGES ON *.* to 'pxvdi'@'%';;  # 给予用户所有的数据库权限
FLUSH PRIVILEGES;

数据库连接信息怎么准备 ​

初始化时通常需要下面这些值：

字段含义推荐值 / 示例注意事项
数据库地址PXVDI Server 要连接哪台数据库127.0.0.1 或 10.10.10.30本机数据库一般填 127.0.0.1
数据库端口MySQL 监听端口3306除非你们改过默认值
数据库用户名PXVDI 登录数据库用的账号root 或 pxvdi正式环境建议单独账号
数据库密码上述账号的密码实际密码填写前先确认可登录
数据库名称PXVDI 使用的数据库名pxvdi建议测试和生产分开命名

第二步：安装 PXVDI Server 主程序 ​

主程序下载地址 https://mirrors.lierfang.com/pxcloud/pxvdi/MIDServer/server/

有3个版本，

  • pxvdiserver_latest_amd64.deb 针对x86/c86架构的包，如intel amd处理器
  • pxvdiserver_latest_arm64.deb 针对arm64架构的包，如鲲鹏，飞腾处理器
  • pxvdiserver_latest_loong64.deb 针对loongarch64架构的包，如龙芯3C5000处理器

把安装包（可以通过scp上传，或者通过wget直接在服务器上完成下载）上传到 Debian 主机后执行：

bash
dpkg -i pxvdiserver.deb
systemctl enable pxvdiserver

如果你们部署规范要求安装后立即启动，也可以再执行：

bash
systemctl start pxvdiserver

安装后建议立即检查什么 ​

建议至少检查这 3 项：

bash
systemctl status pxvdiserver
ss -lntp | grep 3002
journalctl -u pxvdiserver -n 50 --no-pager

重点确认：

  • 服务是否正常运行
  • 3002 端口是否已监听
  • 日志中有没有明显报错

第三步：打开初始化页面 ​

安装完成后，在浏览器访问：

text
https://服务器地址:3002

示例：

  • https://10.13.14.121:3002

如果浏览器打不开，优先检查：

  • 服务是否启动
  • 防火墙是否放行 3002
  • 地址和端口是否正确
  • 证书告警是否被浏览器拦截

第四步：初始化数据库连接 ​

进入初始化页面后，第一步通常是填写数据库信息。

字段说明 ​

字段含义推荐值 / 示例注意事项
数据库地址PXVDI Server 连接数据库的地址127.0.0.1本机数据库一般这样填
数据库端口数据库监听端口3306默认 MySQL 端口
数据库用户名登录数据库使用的账号pxvdi正式环境更推荐专用账号
数据库密码上述账号的密码实际密码不要填错环境
数据库名称供 PXVDI 使用的库名pxvdi_prod建议测试和生产分开

初始化数据库操作步骤 ​

  1. 输入数据库地址。
  2. 输入数据库端口。
  3. 输入用户名和密码。
  4. 输入数据库名称。
  5. 点击确认初始化。
  6. 等待系统执行初始化。
  7. 如果初始化成功，系统通常会自动重启服务或刷新页面。

一个推荐示例 ​

  • 数据库地址：127.0.0.1
  • 数据库端口：3306
  • 数据库用户名：pxvdi
  • 数据库密码：正式密码
  • 数据库名称：pxvdi

第五步：配置 PXVIRT 连接 ​

数据库初始化完成后，系统通常会继续要求配置 PXVIRT 连接。

字段说明 ​

字段含义推荐值 / 示例注意事项
PXVIRT 主机地址要对接的 PXVIRT 管理地址10.10.10.10一般不需要写路径
PXVIRT 管理账号平台连接 PXVIRT 的账号root@pam初始化阶段最常见
PXVIRT 管理密码上述账号对应的密码实际密码填写错误会导致对接失败

配置 PXVIRT 操作步骤 ​

  1. 输入 PXVIRT 地址。
  2. 输入管理账号。
  3. 输入密码。
  4. 点击测试或确认。
  5. 测试通过后保存。
  6. 保存成功后，系统会进入登录页面。

第六步：首次登录系统 ​

初始化完成后，系统会进入登录页面。

默认管理员通常为：

  • 用户名：admin
  • 密码：P@SSw0rd

首次登录后建议立刻做什么 ​

建议按下面顺序做首轮检查：

  1. 先修改管理员密码。
  2. 到运维 -> 系统摘要确认平台版本和授权。
  3. 到集群 -> 集群概览确认 PXVIRT 已正常对接。
  4. 再去看虚拟机、桌面池等业务模块是否能正常加载。

常见安装问题怎么排查 ​

页面打不开 ​

优先检查：

  • pxvdiserver 服务状态，使用命令systemctl status pxvdiserver
  • 3002 端口是否监听，使用命令ss -lntp | grep 3002
  • 防火墙是否放行
  • 浏览器是否拦截证书告警

数据库初始化失败 ​

优先检查：

  • 地址和端口是否能连通
  • 账号密码是否正确
  • 账号是否有权限创建或使用数据库
  • 数据库服务是否正常启动

PXVIRT 对接失败 ​

优先检查：

  • PXVIRT 地址是否可达
  • root@pam 密码是否正确
  • 管理网络是否互通
  • PXVIRT 证书或连接凭据是否异常

安装完成后的最低验收标准 ​

至少确认下面 5 件事：

  • 能正常打开登录页
  • 能用管理员账号登录
  • 首页 4 个主模块能打开
  • 集群节点和存储数据能正常显示
  • 运维页中的系统摘要和日志可正常加载