简介
HAMi 企业版 License 与集群硬件绑定 — 需要提供集群信息才能生成有效的 License 文件。本指南覆盖完整流程：安装验证、License 申请、激活。
流程：
-
完成激活前检查清单，确认集群就绪
-
从集群获取 License 申请信息，发送给 Dynamia AI
-
通过邮件接收 License 文件并完成激活
试用 License 默认为 1 个月、最多 8 张 GPU。超出此范围需单独审批。
激活前准备
开始前请确认以下条件全部满足，缺一不可：
| 条件 | 说明 |
|---|---|
| HAMi | 集群已部署且正常运行，HAMi enterprise / HAMi AI Platform 已完成安装 |
| kubectl 访问权限 | 当前 kubeconfig 对应角色在 hami-system 命名空间具备 secrets 资源的创建/更新权限 |
HAMi Enterprise 企业版
证书获取
HAMi 核心组件就绪后，确认需要授权的设备已通过设备插件或厂商组件上报到集群，再收集许可证申请信息。
在运维终端确认 kubectl 和 jq 可用，当前 kubecontext 指向目标集群，并具有读取 kube-system 命名空间和所有 Node 的权限。
从离线交付包中取得 collect-hami-license-info.sh，也可在联网机器上下载采集脚本后传入目标环境。在脚本所在目录执行以下命令，生成许可证申请文件。
bash collect-hami-license-info.sh > hami-license-info.json
生成的 hami-license-info.json 内容示例如下，包含一张 NVIDIA A10 和两张 MLU：
{
"esn": "96565d61-986a-4918-aafb-448ff6e3746b",
"deviceInstances": [
{
"uuid": "GPU-ceee905d-48ac-93de-a81b-17c00e1e5e02",
"deviceType": "NVIDIA A10"
}
],
"deviceModels": [
{
"deviceType": "MLU",
"count": 2
}
]
}
-
esn是kube-system命名空间的 UID，用于标识目标集群。 -
deviceInstances列出按实例授权的设备，每项包含设备 UUID 和型号。 -
deviceModels列出仅按型号授权的设备，count是该型号在所有节点上的物理卡数。
纯实例授权集群的 deviceModels 为空，纯型号授权集群的 deviceInstances 为空。申请信息中至少应有一类设备清单非空。
核对清单中的 UUID、型号和卡数，确保覆盖全部需要授权的设备。deviceType 应保留脚本采集到的值。若缺少设备，先检查设备插件或厂商组件的上报状态，以及节点注解和 Capacity，再重新采集。
脚本默认使用 HAMi Chart 的资源名。如果调整过 mluResourceCores 或 kunlunResourceName，运行脚本前分别将环境变量 HAMI_MLU_CORE_RESOURCE 或 HAMI_KUNLUN_COUNT_RESOURCE 设为对应的资源名。
将核对后的 hami-license-info.json 发送给密瓜智能售前或技术支持，申请许可证。
接收 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、昇腾及监控组件不构成前置条件。
-
使用平台管理员账号登录 HAMi AI Platform。
-
进入「运营」→「授权管理」页面，找到目标集群。
-
在目标集群卡片中点击「申请授权」，选择授权范围，使用「下载 .json」或「复制 JSON」获取授权申请材料。
-
将授权申请信息发送给密瓜智能销售或交付人员。
-
根据指引完成激活。
接收 License
密瓜智能完成签发后，将由销售通过邮件交付 License 文件。
激活 License
-
使用
平台管理员账号登录 HAMi AI Platform。 -
进入「运营」→「授权管理」页面，找到目标集群。
-
在目标集群卡片中点击「激活授权」；已有授权时点击「替换授权」。选择销售邮件中收到的 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 已通过校验。若未查询到相关事件，不能据此判断校验成功；若出现校验失败事件，请根据事件消息排查或联系密瓜智能技术支持。
验证结果
请确认：
-
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 页面上传并激活。