快速开始部署办公套件

页面中的 IP 地址、安装包名称、版本号和目录均为示例。实际部署时，请以当前环境和交付物料为准。

一、部署流程概览

整个过程可以分为以下 7 步：

步骤	需要完成的操作	完成标志
1. 准备服务器和安装物料	确认服务器、安装器和办公套件发行包可用	可以登录服务器并找到安装文件
2. 启动安装器	在安装节点运行 mdp-installer	终端显示安装器访问地址
3. 上传发行包	在浏览器中选择办公套件发行包	页面提示发行包校验通过
4. 配置部署环境	填写域名或 IP、部署模式、节点登录信息和数据目录	节点验证通过并可进入部署概览
5. 执行环境检查	等待安装器检查服务器和部署环境	没有阻塞安装的失败项
6. 开始安装	确认检查结果并执行部署	页面显示安装已完成
7. 保存交付信息	保存访问地址并完成登录、服务和功能验证	可以访问业务页面和 MDP 运维平台

二、部署前准备

1. 准备一台安装节点

安装节点用于运行安装器，并作为本次 All-in-One 单节点部署的目标服务器。

开始前请确认：

• 已准备一台可用服务器，并获得服务器 IP 地址。
• 可以通过 SSH 登录服务器。
• SSH 用户为 root，或具备执行部署任务所需的权限。
• 服务器 CPU 架构与安装器、发行包一致，例如均为 x86_64。
• 服务器满足当前部署规格，建议使用 Ubuntu 24.04 LTS 最小化安装。
• 根分区和数据空间满足当前部署要求，并已确定数据目录。
• 服务器时间和时区正确，时间同步正常。
• 浏览器所在电脑可以访问安装节点的 18080/TCP 端口。
• 服务器可以访问互联网，以便在线安装下载部署包和镜像资源。
• 业务访问使用域名时，已提前完成域名解析（可选）。

服务器最低要求如下：

操作系统	架构	CPU	内存	磁盘
Ubuntu 24.04 LTS	x86_64	16 Core	32 GB	100 GB SSD

另外请确认：

• 不要将 /root、/var、/tmp 单独分区。
• 安装前不要在服务器上额外部署 Docker、Kubernetes 等可能影响安装器检查的组件。
• 端口 22/TCP 用于 SSH，18080/TCP 用于安装器 Web 页面，80/TCP 和 443/TCP 用于业务访问。

正式部署前，建议先根据实际并发量、文件规模和可用性要求确认服务器规格；本文的单节点流程适合快速部署和验证，长期运行或需要高可用时请使用对应的集群部署方案。

2. 准备安装物料

物料清单如下

文件	说明
mdp-installer 安装器	根据服务器架构选择对应文件，例如 mdp-installer-amd64。
办公套件发行包	文件名和版本以实际交付为准，例如 co1.8.20260711.3286-drive-release.tar.gz。

建议把安装器和相关安装资料放在同一个工作目录中，便于后续查找和保留。使用发行包前，请确认文件完整且未被传输工具损坏。

上传安装器

将石墨提供的安装器上传到安装节点的 /root/ 目录。可以选择自已熟悉的上传方式，本文以 scp 命令作为示例。

在本地电脑执行：

scp mdp-installer-amd64 root@<安装节点IP>:/root/

获取发行包

准备本次部署使用的办公套件发行包。发行包在 Web 安装页面中上传，文件名和版本以实际交付为准。

文件名示例：co1.8.20260711.3286-drive-release.tar.gz

物料清单如下：

文件	说明
mdp-installer 安装器	根据服务器架构选择对应文件，例如 mdp-installer-amd64。
办公套件发行包	文件名和版本以实际交付为准，例如 co1.8.20260711.3286-drive-release.tar.gz。

建议把安装器和相关安装资料放在同一个工作目录中，便于后续查找和保留。使用发行包前，请确认文件完整且未被传输工具损坏。

三、启动安装器

1. 登录安装节点

通过 SSH 登录安装节点，进入安装器所在目录。例如：

ssh root@<安装节点IP>
cd /root

2. 添加执行权限

如果安装器还没有执行权限，运行：

chmod +x ./mdp-installer-amd64

命令中的文件名需要替换为实际安装器名称。

3. 启动 Web 安装页面

运行：

./mdp-installer-amd64 server

如果需要让安装器在当前终端退出后继续运行，可以使用：

nohup ./mdp-installer-amd64 server > nohup.out 2>&1 &

启动成功后，终端会显示两个地址：

• Local：仅安装节点本机使用。
• Network：同一网络中的其他电脑可访问。

如果使用后台方式启动，可执行以下命令查看安装器输出：

cat nohup.out

在浏览器中打开终端显示的 Network 地址，例如：

http://<安装节点IP>:18080/

执行安装期间请保持安装器进程运行，不要关闭安装器进程或停止当前服务。

四、上传办公套件发行包

1. 选择发行包

进入安装页面后：

1. 单击 开始部署 或页面中的发行包选择入口。
2. 选择本次部署使用的办公套件 .tar.gz 发行包。
3. 等待文件上传和校验完成。

2. 确认校验结果

校验通过后，页面会显示发行包名称和部署配置入口。

确认以下信息无误：

• 发行包名称与本次交付版本一致。
• 发行包属于办公套件产品。
• 页面未提示文件损坏、格式错误或架构不匹配。

确认后单击 继续 进入部署配置。

如果校验未通过，请重新确认发行包是否完整、文件类型是否正确，以及发行包是否与服务器 CPU 架构匹配。

五、配置部署环境

1. 确认网络地址

检查页面识别出的主机名或 IP 地址。该地址应为使用方可以正常访问的安装节点地址。

不要填写 127.0.0.1，也不要使用仅当前电脑能够访问的临时地址。使用域名访问时，请确认域名已经解析到正确的业务入口。

2. 选择 All-in-One 单节点模式

在部署模式或目标环境中选择 All-in-One 单节点（页面实际显示名称以当前版本为准）。

该模式下，安装节点同时承担本次部署的控制和业务工作角色，适合产品体验、功能验证和单节点规划的轻量环境。

3. 配置节点 SSH

安装器通过 SSH 连接目标节点并执行部署任务。请填写：

• 节点 IP 地址。
• SSH 用户，通常为 root。
• SSH 端口，默认通常为 22。
• 密码或私钥认证信息。

填写完成后，单击 验证，确认 SSH 连接成功。

SSH 凭证只应在受控环境中使用和保管，不要把密码或私钥写入公开文档、截图或聊天记录。

4. 设置数据目录和其他配置

根据页面提示填写或确认以下配置：

配置项	说明
访问域名 / IP	用户访问办公套件的地址；使用 IP 时填写可被访问的实际地址。
部署模式	选择 All-in-One 单节点模式。
节点数据目录	用于存放部署数据。请确认目录所在磁盘空间充足且具备读写权限。
离线仓库	本文为在线安装，按页面默认值保留。
第三方中间件	本文按默认配置部署，按当前交付要求确认是否需要外部中间件。

如没有特殊配置要求，可以先保留离线仓库和第三方中间件的默认值。检查完成后，单击页面底部的 初始化部署。

六、确认部署概览

部署概览用于在正式检查前核对本次安装配置。

请重点确认：

• 发行包版本和产品名称正确。
• 访问域名或 IP 正确，且不是 127.0.0.1。
• 部署模式为 All-in-One 单节点。
• 节点 IP、SSH 用户和端口正确。
• 数据目录正确，所在磁盘空间充足。
• 离线仓库和第三方中间件配置符合当前环境。

确认无误后单击 继续，进入环境检查。

七、执行环境检查

安装器会检查节点和部署环境。检查过程可能需要几分钟，请保持页面打开。

1. 查看节点概览

节点概览会展示 SSH 连通性、系统与性能、存储与磁盘、网络和部署环境等检查进度。

如需查看某个检查项的详细结果，单击对应检查项或详情入口。

2. 查看详细检查结果

详细结果通常包含：

• SSH 连通性和执行用户权限。
• 操作系统、CPU 架构和核心数。
• 内存容量、磁盘空间和目录权限。
• 时区和时间同步状态。
• 网络、镜像资源和外部服务连通性。
• 服务器上可能影响部署的环境残留。

3. 理解检查状态

状态	含义	下一步操作
成功	当前检查项满足部署要求	继续等待其他项目完成
警告	不会直接阻止部署，但需要确认是否符合当前规划	打开详情，确认影响后继续
失败	当前问题会影响安装或产品运行	先修复问题，再重新扫描
运行中	安装器正在执行检查	等待检查完成，不要重复操作

如果某个项目长时间停留在“运行中”，可以先等待当前磁盘或远程检查完成，再决定是否重新扫描。

4. 处理警告和失败项

如果页面显示警告：

1. 打开对应检查项的详细说明。
2. 确认警告是否符合当前部署规划。
3. 无法判断时，先保留页面和安装器日志，再联系实施或运维人员确认。

如果页面显示失败：

1. 按提示修复 SSH、权限、资源、磁盘、网络或中间件问题。
2. 单击 重新扫描。
3. 确认失败项已经消失。

没有阻塞部署的失败项，并已确认所有警告后，单击 继续。

八、开始安装

1. 确认安装计划

页面会展示安装计划和即将执行的任务。确认无误后，单击 开始部署。

页面可能弹出“确认开始安装”提示。开始后安装任务将按计划执行；如果还需要调整配置，请单击 取消 返回上一步。

2. 查看部署进度

开始部署后，页面会展示当前执行的任务状态、实时日志和执行耗时。单节点部署通常约需 10 分钟，实际时间会受服务器性能和网络带宽影响。

安装过程中请注意：

• 不要关闭安装器进程。
• 不要重启安装节点。
• 不要刷新、后退或重复提交安装任务。
• 如任务失败，先查看对应任务日志中的第一条错误，再根据提示处理。

当页面显示 安装已完成 或进入 部署交付 页面时，表示安装任务已经结束。

九、保存交付信息

安装完成页面会展示本次部署的访问信息和检查入口。请立即完成以下操作：

1. 运行安装后的服务检查，确认检查结果。
2. 按部署交付页面的访问信息，打开办公套件业务页面并完成登录验证。
3. 记录办公套件业务访问地址和 MDP 运维平台地址。
4. 保存初始账号及临时密码，并在首次登录后立即修改初始密码。
5. 在 MDP 运维平台中检查集群节点和应用状态。

交付信息中包含访问地址和初始凭证。不要截屏传播，不要上传到公开知识库，也不要通过非受控渠道发送。

石墨办公套件入口：
http(s)://<访问域名>/

MDP 运维平台入口：
http(s)://<访问域名>/mdp/

请使用安装页面提供的交付信息登录石墨。

十、检查部署结果

完成安装后，建议按以下顺序验收：

1. 检查安装后服务

在安装完成页面运行安装后检查，确认服务测试用例执行通过或结果符合当前环境预期。

如检查未通过或部分通过，可以在 MDP 运维平台中再次提交巡检任务。

2. 检查 MDP 运维平台

登录 MDP 运维平台，进入 系统服务 → 集群管理，确认集群节点和应用运行状态正常。

3. 验证办公套件功能

登录办公套件前台页面，至少验证以下功能：

• 创建测试文件或套件。
• 编辑内容并保存。
• 导出文件。
• 导入文件。

上述检查均通过后，表示本次快速部署完成。后续如需长期运行、扩容或高可用，请根据实际规模切换到对应部署方案，并完成许可证和业务配置。

十一、常见问题

1. 浏览器无法打开安装页面

依次检查：

• 安装器进程是否仍在运行。
• 访问地址是否使用安装节点的实际 IP 或可解析域名。
• 18080/TCP 端口是否已经放通。
• 浏览器所在电脑与安装节点之间的网络是否连通。

2. 发行包校验失败

检查：

• 上传的文件是否为完整的 .tar.gz 发行包。
• 文件名和产品类型是否与本次交付一致。
• 发行包与服务器 CPU 架构是否匹配。
• 文件在上传或传输过程中是否损坏。

3. SSH 验证失败

检查：

• 节点 IP 和 SSH 端口是否正确。
• SSH 用户、密码或私钥是否正确。
• SSH 用户是否具备部署所需权限。
• 防火墙或安全组是否允许 SSH 连接。

4. 环境检查出现警告

警告不会直接阻止部署，但需要打开详情确认影响。如果涉及磁盘性能、时间同步、配置残留或外部服务，请先确认是否符合本次部署规划，再决定是否继续。

5. 环境检查出现失败

失败项需要先修复。不要直接绕过检查开始安装。修复后单击 重新扫描，确认失败项已经通过。

6. 安装任务失败

1. 打开失败任务的执行日志。
2. 找到最先出现的错误信息。
3. 保存安装器日志、失败任务名称和发生时间。
4. 处理对应的网络、磁盘、镜像、中间件或 Kubernetes 问题后，再按实际恢复方式继续。