软件安装

适用版本 MegaCube 集群管理平台 1.3.2 正式版。

在管理设备上运行 bash install.sh，安装器会识别首次安装或已有安装。已装旧版请直接看升级步骤。

适用：1.3.2。按下面5步安装，之后打开网页使用。先按硬件环境搭建接好设备；本文档只在MC-001管理设备上操作。

1. 解压并复制交付包

1. 找到megacube-1.3.2-customer-bundle.zip，右键解压。
2. 将解压后的整个“MegaCube-集群管理平台-1.3.2”文件夹复制到MC-001。可用U盘复制，放到设备当前用户的主目录即可。
3. 打开这个文件夹，确认能看到install.sh、deploy、software、文档和开始阅读.html。

software文件夹由安装程序自动读取，无需单独操作。不要只复制install.sh；不要在压缩包预览窗口里运行。 如果是在办公电脑下载的，也要把完整文件夹复制到MegaCube上再安装。

2. 打开终端，运行一条命令

1. 在MC-001文件管理器中，进入直接包含install.sh的文件夹。
2. 在文件夹空白处右键，选择“在终端中打开”。
3. 复制下面这行，在终端用Ctrl+Shift+V粘贴，按Enter：

bash install.sh

使用设备的普通管理账号操作，不要在命令前加sudo。没有“在终端中打开”入口时，见维护手册中的备用操作。

3. 按提示输入，等待完成

输入密码时不显示文字或星号是正常的。 设备密码用于系统操作，平台密码用于后面的网页登录，请分别记好。

支持网络选择的安装器会将所选地址统一用于管理平台证书、远程访问和Agent回连；其他设备必须能访问它。Wi-Fi访客隔离可能阻止互通，建议固定IP或设置DHCP地址保留。安装器不关闭另一张网卡，也不修改默认路由；后续网络变化不会自动换成另一个地址。

保持终端打开，等待显示“[7/7] 管理软件安装完成”。如果出现“模型运行环境待处理”，将具体提示交给设备支持人员处理后，再部署模型。

4. 打开网页，登录

1. 在MC-001浏览器打开：

https://127.0.0.1:18181/

2. 首次若出现证书提示，确认是在刚安装成功的MC-001本机、地址与上面一致，再点浏览器“高级”继续访问；证书信任详见维护手册。
3. 用户名输入admin，密码输入刚才自己设置的平台密码，点击登录。

在同一管理网络的办公电脑上打开：

1. 复制安装完成时显示的“其他电脑浏览器地址”到浏览器，必须保留开头的https://和末尾的:18181/。
2. 例如管理IP是192.168.1.100时，地址是https://192.168.1.100:18181/。这是示例，请以安装脚本显示的实际地址为准；办公电脑不要使用127.0.0.1。
3. 首次若提示“连接不是私密连接”或证书不受信任，先核对地址确实属于刚安装的管理设备，再按浏览器“高级 → 继续访问”。公司规定不允许继续时，请现场管理员处理证书信任。

平台18181端口只接受HTTPS。 不要改成http://，也不要只输入IP让浏览器自动使用HTTP。若完整HTTPS地址仍连接超时或被拒绝，请提供这台电脑的IP和报错文字给现场管理员，检查管理网络及平台服务；这与证书提示不同。

5. 安装好了，开始使用

rc.18 首次安装会按所选管理网络添加 MC-001，收到完整Agent心跳并核验本地执行器后才显示就绪。在“集群总览”打开该设备详情，可查看所选网络、平台HTTPS远程访问链接及SSH地址，然后按使用指南添加其他设备。普通升级保留已有登记，不重新创建管理节点。

若提示“管理平台已安装，但本机管理节点接入未完成”，不要重复登记MC-001。恢复原网络并处理提示问题后，以原安装账号在同一交付文件夹运行bash install.sh --resume-management-node；它只恢复本机接入，沿用原网络和编号，不清理设备业务环境。此参数仅适用于提供自动接入能力的安装包。更换管理网络须按专门迁移流程处理，不能用资产编辑或恢复参数直接改地址。

以后开机后直接打开网页，不用重复运行安装脚本。

若失败，记下步骤和错误文字，先看维护手册的常见问题。不要发送密码。升级和空间设置也在维护手册中，不是首次安装的必做操作。

已安装旧版本时怎么升级

1. 用原安装账号登录管理节点。安排维护时间，等待部署、下载、导入、接入、回收及正在处理的模型请求结束。
2. 若上次升级已完成，进入 rc.18 完整解压文件夹，运行 bash install.sh。自定义安装目录时追加 --root="实际安装目录"。
3. 按提示输入当前平台 admin 密码。仅对需要首次或重新授予配套组件更新权限的节点，安装器会集中提示输入设备系统密码。先输入一次通用密码，未通过的节点可按 MC-编号=该设备密码 隐藏补填，每行一台，空行结束。通用密码输错时可用 *=正确通用密码 补填。第一次系统密码提示直接按回车表示取消。
4. 等待检查、准备、更新、确认四个阶段结束。终端显示升级完成后，刷新网页，在关于与版本核对后台版本，再检查各设备的心跳。若终端提示配套组件或心跳未完成，即使网页已显示新版，也应按提示使用原包续装。

普通升级沿用账号、密码、配置、模型库和设备记录。升级不自动补配 QSFP 地址或重新登记管理节点。若首次安装的本机接入尚未完成，请按上文的专用恢复步骤处理。

上次升级未完成

如果显示 UPGRADE_ORIGINAL_PACKAGE，请用原安装账号，按上次升级的入口重新运行同一份完整安装包，并按提示重新认证。看到终端报告升级完成后，再使用新版安装包。

原包续装仍失败时，记录阶段和完整错误，保留原包与升级记录，联系支持人员。请勿手工删除升级记录、用其他包覆盖，或先卸载软件。

管理平台已装好，但 MC-001 接入未完成

先确认管理节点仍连接安装时选择的有线网络，IP 与安装记录一致。如果是 rc.16 在重装后卡在本机 QSFP 准备阶段，可用原安装账号进入 rc.17 完整解压目录，运行：

bash install.sh --resume-management-node

按提示验证当前平台管理员密码及设备系统权限。恢复只继续原 MC-001 登记，核验并沿用已有的 QSFP 地址和 MTU。若配置与原记录不同，先核对原因。看到“本机管理节点已就绪”后，确认 MC-001 在线，再运行 bash install.sh 完成软件升级。

怎么卸载管理软件

先停止并卸载模型服务、回收专属授权，等待任务和会话结束。用原安装账号在完整解压目录运行 bash install.sh --uninstall，输入当前平台 admin 密码。平台服务已停止时也需要认证。卸载保留模型文件、镜像和私有备份，保存位置以终端输出为准。详情见卸载管理软件。