简介

HAMi 企业版 License 与集群硬件绑定 — 需要提供集群信息才能生成有效的 License 文件。本指南覆盖完整流程：安装验证、License 申请、激活。

流程：

1. 完成激活前检查清单，确认集群就绪

2. 从集群获取 License 申请信息，发送给 Dynamia AI

3. 通过邮件接收 License 文件并完成激活

试用 License 默认为 1 个月、最多 8 张 GPU。超出此范围需单独审批。

激活前准备

开始前请确认以下条件全部满足，缺一不可：

条件	说明
HAMi	集群已部署且正常运行，HAMi enterprise / HAMi AI Platform 已完成安装
kubectl 访问权限	当前 kubeconfig 对应角色在 hami-system 命名空间具备 secrets 资源的创建/更新权限

HAMi Enterprise 企业版

证书获取

HAMi 核心组件就绪后即可收集许可证信息；无需等待按需部署的 GPU Operator、昇腾或监控组件。

执行以下脚本收集许可证信息（需要 kubectl、jq）：

curl -fsSL https://public.hami.run/collect-hami-license-info.sh | bash

执行后可以看到以下 JSON 内容：

{
  "esn": "96565d61-986a-4918-aafb-448ff6e3746b",
  "deviceInstances": [
    {
      "uuid": "GPU-ceee905d-48ac-93de-a81b-17c00e1e5e02",
      "deviceType": "NVIDIA A10"
    }
  ]
}

把上述 JSON 发送给 Dynamia.ai 的售前/技术支持获取证书。

接收 License

密瓜智能完成授权签发后，将由销售通过邮件交付 License 文件。

请将文件保存到能够通过 kubectl 访问目标 Kubernetes 集群的运维机器。

创建 License Secret

执行以下命令，将 License 文件创建为 Kubernetes Secret：

kubectl create secret generic hami-license \
  --from-file=license=/你的 License 文件路径 \
  -n hami-system

预期输出：

secret/hami-license created

添加 License 标签

Secret 创建成功后，执行：

kubectl label secret hami-license \
  hami.io/license="true" \
  -n hami-system

预期输出：

secret/hami-license labeled

至此，HAMi Enterprise License 已完成部署。

检查调度器事件

License 导入后，执行以下命令查看校验事件，确认 License 合法有效：

kubectl get events --field-selector involvedObject.name=hami-license -n hami-system

检查与本次导入相关的最新事件。校验成功时，事件类型为 Normal，原因为 LicenseValid，消息包含 validated successfully。消息中的 expire_time 表示 License 的到期时间，请确认与签发约定一致且尚未到期。

仅确认 hami-license Secret 存在，不能证明 License 已通过校验。若未查询到相关事件，不能据此判断校验成功；若出现校验失败事件，请根据事件消息排查或联系密瓜智能技术支持。

HAMi AI Platform 平台版

证书获取

HAMi 核心与平台服务就绪后即可获取授权申请信息；按需安装的 GPU Operator、昇腾及监控组件不构成前置条件。

1. 使用平台管理员账号登录 HAMi AI Platform。

2. 进入「运营」→「授权管理」页面，找到目标集群。

3. 在目标集群卡片中点击「申请授权」，选择授权范围，使用「下载 .json」或「复制 JSON」获取授权申请材料。

4. 将授权申请信息发送给密瓜智能销售或交付人员。

5. 根据指引完成激活。

接收 License

密瓜智能完成签发后，将由销售通过邮件交付 License 文件。

激活 License

1. 使用 平台管理员 账号登录 HAMi AI Platform。

2. 进入「运营」→「授权管理」页面，找到目标集群。

3. 在目标集群卡片中点击「激活授权」；已有授权时点击「替换授权」。选择销售邮件中收到的 License 文件。

4. 上传文件后，点击「激活」。

5. 等待系统完成校验。

检查调度器事件

License 导入后，执行以下命令查看校验事件，确认 License 合法有效：

kubectl get events --field-selector involvedObject.name=hami-license -n hami-system

检查与本次导入相关的最新事件。校验成功时，事件类型为 Normal，原因为 LicenseValid，消息包含 validated successfully。消息中的 expire_time 表示 License 的到期时间，请确认与签发约定一致且尚未到期。

仅确认 hami-license Secret 存在，不能证明 License 已通过校验。若未查询到相关事件，不能据此判断校验成功；若出现校验失败事件，请根据事件消息排查或联系密瓜智能技术支持。

验证结果

请确认：

• License 状态显示为“正常”。

• 产品和授权范围与采购内容一致。

• License 到期时间正确。

• 平台功能可以正常使用。

验证

License 更新或续期

HAMi Enterprise 企业版

如果集群中已经存在 hami-license Secret，应先删除原有 Secret：

kubectl delete secret hami-license -n hami-system

然后使用新的 License 文件重新创建：

kubectl create secret generic hami-license \
  --from-file=license=/实际的/License文件路径 \
  -n hami-system

重新添加标签：

kubectl label secret hami-license \
  hami.io/license="true" \
  -n hami-system

License 导入后，执行以下命令查看校验事件，确认 License 合法有效：

kubectl get events --field-selector involvedObject.name=hami-license -n hami-system

检查与本次导入相关的最新事件。校验成功时，事件类型为 Normal，原因为 LicenseValid，消息包含 validated successfully。消息中的 expire_time 表示 License 的到期时间，请确认与签发约定一致且尚未到期。

仅确认 hami-license Secret 存在，不能证明 License 已通过校验。若未查询到相关事件，不能据此判断校验成功；若出现校验失败事件，请根据事件消息排查或联系密瓜智能技术支持。

更新后通常无需重启。等待约 60 秒后，重新检查调度器事件，确认本次更新的 License 校验成功且到期时间正确。

HAMi AI Platform 平台版

收到新的 License 文件后，重新进入平台 License 页面上传并激活。

FAQ