License通用问题

什么时候需要更换License文件？

当您存在如下变更场景时，需要更换License文件：

• 用户数变更

  例如，您已购买500个用户的SDK服务，在使用过程中发现500个用户已无法满足您的业务诉求，重新购买1000个用户的SDK服务用以扩充用户数量。

• 更换绑定的应用

  例如，您之前配置了A应用的信息，因业务调整，A应用不再使用，现在希望配置成其他应用。

• 机器部署范围变更

  例如，您之前配置了4台部署机器，因业务调整，新增2台部署机器。

• 授权时长变更

  例如，您申请的License文件将于2024年09月30日到期，您希望将此License文件延期至2026年09月30日。

下单后如何获取License文件，需要提供哪些信息？

当您购买的“通用SDK”基础版数据建模引擎订单付款成功后，需要通过提交工单的方式申请License文件。在此之前，您需要提前准备如下相关信息：

• SDK所属应用的应用ID（License文件不支持跨应用使用）。
• 已支付订单中购买的用户数量。
• 已支付订单中订阅的时长。
• SDK部署机器的信息。
  • 如果SDK部署机器为本地通用服务器，则需要准备如下信息：
    • Windows系统：提供机器MAC地址。
    • Linux系统：提供机器的UUID。
  • 如果SDK部署机器为容器，则提供容器的ESN。

重新生成SDK包，需要更换License文件吗？

升级SDK包版本不需要更换License文件。

如何激活License文件？

1. 使用具有“应用开发人员”或“应用责任人”角色的账号登录应用设计态。
2. 在左侧导航栏中，选择“系统管理 > License管理”，进入“License管理”页面。
3. 在“License激活”页签下，单击“获取ESN”，记录生成的ESN编码，并联系技术支持生成License文件。
4. 收到License文件后，单击“导入License”，选择License文件完成激活。

如何失效License文件？

当机器的绑定信息发生变更（如更换服务器硬件），或因用户数扩容、ESN变更等场景需要更新License文件时，建议您先将当前的License文件设置为失效，然后再重新申请新的License文件，以确保您的系统或软件能够正常运行并保持授权的有效性和合法性。

1. 登录已部署的SDK服务。
2. 在左侧导航栏中，选择“系统管理 > License管理”，进入“License管理”页面。
3. 选择“License失效”页签，单击“失效License”。
4. 在弹出的提示框中，单击“确定”。
5. 复制并记录生成的失效码，单击“确定”，关闭窗口。

   失效码可用于后续的新License申请，请务必妥善保管。

如何进行容器临时部署？

在使用容器部署数据建模引擎运行SDK时，如果当前环境的ESN与License文件中的ESN不匹配，可通过在环境变量中设置以下参数启用临时部署模式：

xdm.license.temp-deploy.enable=true

临时部署允许在License文件ESN校验不通过的特殊场景下，临时启动数据建模引擎运行SDK，以便进行调试或应急处理。

临时部署存在以下注意事项：

• 每个License文件仅记录一次临时部署信息，其中包括本次临时部署的到期时间。
• 临时部署总时长不超过8天，具体到期时间根据以下规则计算：
  • 当License到期时间 + License宽限时间 ≤ 当前SDK部署时间，不允许临时部署。
  • 当License到期时间 + License宽限时间 < 当前SDK部署时间 + 7天，临时部署到期时间 = License到期时间 + License宽限时间。
  • 当License到期时间 + License宽限时间 ≥ 当前SDK部署时间 + 7天，临时部署到期时间 = 当前SDK部署时间 + 7天，并向上取整至第二天凌晨0点。
• 临时部署仅作为特殊场景下的应急启动方式。为避免服务因临时部署到期而中断，请尽快根据容器常规部署时返回的错误信息与“错误码”进行问题排查与修复。