Updated on 2023-11-24 GMT+08:00

Managing an Edge Node

Managing an edge node is the process of using the EdgeCore installer and configuration file downloaded in Registering an Edge Node to install EdgeCore on the edge node. In this way, the edge node can be connected to and managed by IEF.

When you manage your edge node on IEF for the first time, IEF automatically pushes the latest EdgeCore. For example, if three EdgeCore versions 2.51.0, 2.52.0, and 2.53.0 are available, IEF will push the latest version 2.53.0.

The edge nodes registered on IEF have one-to-one relationships with the actual devices. The EdgeCore installer and configuration file of an edge node can be installed on only one actual device.

Prerequisites

Managing an Edge Node

  1. Log in to an edge node as a user with sudo permissions.
  2. Upload the EdgeCore installer and configuration file downloaded in Registering an Edge Node to a specified directory on the edge node, for example, /home, and go to the directory.
  3. Run the following command to decompress the EdgeCore installer to the /opt directory:

    sudo tar -zxvf edge-installer_1.0.0_x86_64.tar.gz -C /opt

    Replace edge-installer_1.0.0_x86_64.tar.gz with the name of the EdgeCore installer package downloaded in Registering an Edge Node.

  4. Run the following command to decompress the configuration file to the opt/IEF/Cert directory. If the edge node to be managed is registered using a token, skip this step.

    sudo mkdir -p /opt/IEF/Cert; sudo tar -zxvf Edge node name.tar.gz -C /opt/IEF/Cert

    Replace Edge node name.tar.gz with the name of the configuration file downloaded in Registering an Edge Node.

  5. Run one of the following commands to manage the edge node:

    • For an edge node registered using a certificate:

      cd /opt/edge-installer; sudo ./installer -op=install

    • For an edge node registered using a token:

      cd /opt/edge-installer; sudo ./installer -op=install -identifier=Credential for registration using a token

      Replace Credential for registration using a token with the value of identifier field of the installation credential saved in Registering an Edge Node.

  6. Verify whether the edge node is managed successfully.

    1. Log in to the IEF console.
    2. In the navigation pane, choose Managed Resources > Edge Nodes.
    3. Check the edge node status. If the status is Running, the edge node has been managed by IEF.
      Figure 1 Checking the edge node status

After the edge node is managed by IEF, do not delete the /opt directory on the edge node, or you will need to register the edge node and enable IEF to manage it again.