# 批量节点注册
#### 使用场景
如果您需要对大量相同类型的边缘节点进行管理、更新与维护，这时使用[注册边缘节点](https://support.huaweicloud.com/usermanual-ief/ief_01_0084.html#ief_01_0084__section473425183615)的方法逐一纳管边缘节点会有些繁琐。
IEF提供批量节点注册功能，使得相同类型的边缘节点能够预安装软件，在上电联网后能自动纳管到IEF中。批量节点注册与边缘节点满足一对多的关系，提高管理效率，也节约了运维成本。
#### 批量节点注册流程
批量纳管边缘节点的流程如下：
1. 准备边缘节点，边缘节点需要满足一定的规格要求，请参见[配置边缘节点环境](https://support.huaweicloud.com/usermanual-ief/ief_01_0083.html)在节点上完成环境配置。
2. [创建批量节点注册作业]，获取配置文件和注册软件，并预安装到边缘节点上，具体请参见[批量纳管边缘节点]。如果在启动脚本配置注册命令，设备上电联网后会自动纳管成为IEF的边缘节点。
 
 #### 创建批量节点注册作业
1. 登录[IEF控制台](https://console.huaweicloud.com/ief2.0/)。
2. 选择左侧导航栏的"批量管理 \> 节点注册"，单击页面右上角的"批量节点注册"。
3. 配置基本信息。其中带"\*"标志的参数为必填参数。 
   ![](https://support.huaweicloud.com/usermanual-ief/zh-cn_image_0000001256641544.png "点击放大")
   
   - **名称**：批量节点注册作业的名称。
   
   - **描述**：作业的描述信息。
   
   - **标签**：标签可用于对资源进行标记，方便分类管理。
   
   - **属性**：属性是键值对形式，请输入属性名和属性值。
   
   
   
   
4. 单击页面右下角的"创建"，节点注册可选"通过证书注册"和"通过token注册"两种方式。
   
   - 方式一：通过证书注册。下载配置文件、EdgeCore Register和EdgeCore Installer。
     ![](https://support.huaweicloud.com/usermanual-ief/public_sys-resources/notice_3.0-zh-cn.png)
     为保障节点安全，您现在必须下载配置文件和工具，稍后将无法找回。
     ![](https://support.huaweicloud.com/usermanual-ief/zh-cn_image_0000001415589036.png "点击放大")
     
     1. 根据页面提示，单击"下载cert_1.tar.gz配置文件"下载配置文件。
     
     2. 根据您边缘节点的CPU架构选择EdgeCore Register和EdgeCore Installer，单击"下载EdgeCore Register"和"下载EdgeCore Installer"。
      
   
   
   
   - 方式二：通过token注册。下载EdgeCore Register和EdgeCore Installer，并保存安装凭证。
     图1下载EdgeCore Register和EdgeCore Installer   
     ![](https://support.huaweicloud.com/usermanual-ief/zh-cn_image_0000001457510233.png "点击放大")
     图2安装凭证   
     ![](https://support.huaweicloud.com/usermanual-ief/zh-cn_image_0000001407004290.png "点击放大")
     1. 根据您边缘节点的CPU架构选择EdgeCore Register和EdgeCore Installer，单击"下载 EdgeCore Register"和"下载EdgeCore Installer"。
     
     2. 保存执行安装命令中的***identifier***字段。
      
   
   
   
   
5. 将下载的文件上传至边缘节点，稍后参见[批量纳管边缘节点]操作指南纳管边缘节点。
 
 #### 批量纳管边缘节点
按照批量节点注册作业完成页的操作指南，在边缘节点执行纳管操作。
1. 以具备sudo权限的用户登录边缘节点。
2. 上传[创建批量节点注册作业：步骤4]下载好的配置文件和工具到边缘节点。
3. 执行如下命令解压配置文件、EdgeCore Register和EdgeCore Installer。 
   **sudo tar -zxvf** *edge-installer_1.0.10_x86_64.tar.gz* **-C /opt**
   **sudo tar -zxvf** *edge-register_2.0.10_x86_64.tar.gz* **-C /opt**
   **sudo tar -zxvf** *cert_batchNodes.tar.gz* **-C /opt/edge-register/** （**"通过token注册"时不需要执行此命令**）
   *edge-installer_1.0.10_x86_64.tar.gz* 、*edge-register_2.0.10_x86_64.tar.gz* 和*cert_batchNodes.tar.gz* 请替换为[创建批量节点注册作业]下载的文件名。
   
   
4. （可选）配置节点预置信息文件。 
   批量纳管边缘节点会采用默认配置进行节点纳管，其中：
   - 节点名称为节点hostname和mac地址的组合"**hostname** _**mac**"。
   
   - GPU和NPU默认不启用。
   
   - Docker默认启用。
   
   
   如需自定义配置节点信息，可以参考以下操作配置节点信息文件。
   **cd /opt/edge-register**
   **vi nodeinfo**
   在nodeinfo文件中填入节点的配置信息，其格式如下所示（下面样例罗列了所有可配置的参数，可以根据场景需求配置其中的参数值，对于不需要自定义配置的参数可以删除示例中对应的参数配置）：
   包括节点名称、描述、是否启用GPU、NPU、NPU类型、属性以及日志配置等，具体参数解释请参见[API参考 \> 注册边缘节点](https://support.huaweicloud.com/api-ief/CreateEdgeNode.html#section2)。
   ```
   {
       "name": "nodename",
       "description": "",
       "enable_gpu": false,
       "enable_npu": true,
       "npu_type": "***",
       "enable_docker": true,
       "attributes": [
           {
               "key": "key1",
               "value": "value1"
           }
       ],
       "log_configs": [
           {
               "component": "app",
               "type": "local",
               "level": "debug",
               "size": 100,
               "rotate_num": 5,
               "rotate_period": "daily"
           }
       ],
       "device_infos": [
           {
               "device_ids": ["15696983-5ee6-43b4-9653-5d8512813dcc"],
               "relation": "camera",
               "comment": "devicedescription"
           }
       ],
       "mqtt_config": {
           "enable_mqtt": false,
           "mqtts": []
       },
       "tags": [
           {
               "key": "name",
               "value": "value"
           }
       ]
   }
   ```
   
   
5. 执行如下命令，纳管边缘节点。 
   - 通过证书注册 **cd /opt/edge-register; ./register --mode=cert**
     
   
   
   
   - 通过token注册 **cd /opt/edge-register; ./register --mode=identifier --identifier=** *token注册的凭证*
     *token注册的凭证* 请替换为[创建批量节点注册作业]时保存的安装凭证**identifier**字段。
     
   
   
   执行完成后，可以根据[查看纳管的节点]查看节点是否注册成功。
   您也可以配置上电启动脚本，在边缘节点上电时自动执行注册命令，在上电脚本中添加注册命令：**cd /opt/edge-register; ./register --mode=cert**
   如果注册命令的执行结果返回值为0，则表示注册成功。
   
   
 
 #### 查看纳管的节点
批量纳管的节点，可以在控制台查看。
1. 登录[IEF控制台](https://console.huaweicloud.com/ief2.0/)。
2. 选择左侧导航栏的"批量管理 \> 节点注册"，在右侧单击作业名称。
3. 在"节点"页签下，可以查看到已经纳管的节点。 
   图3查看批量纳管的节点   
   ![](https://support.huaweicloud.com/usermanual-ief/zh-cn_image_0000001113957132.png "点击放大")