# License通用问题
#### 什么时候需要更换License文件？
当您存在如下变更场景时，需要更换License文件：
- 用户数变更 例如，您已购买500个用户的SDK服务，在使用过程中发现500个用户已无法满足您的业务诉求，重新购买1000个用户的SDK服务用以扩充用户数量。
  
- 更换绑定的应用 例如，您之前配置了A应用的信息，因业务调整，A应用不再使用，现在希望配置成其他应用。
  
- 机器部署范围变更 例如，您之前配置了4台部署机器，因业务调整，新增2台部署机器。
  
- 授权时长变更 例如，您申请的License文件将于2024年09月30日到期，您希望将此License文件延期至2026年09月30日。
  
 
#### 下单后如何获取License文件，需要提供哪些信息？
当您购买的"通用SDK"基础版数据建模引擎订单付款成功后，需要通过[提交工单](https://support.huaweicloud.com/usermanual-ticket/zh-cn_topic_0127038618.html)的方式申请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点。
   
- 临时部署仅作为特殊场景下的应急启动方式。为避免服务因临时部署到期而中断，请尽快根据容器常规部署时返回的错误信息与"错误码"进行问题排查与修复。