Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Gather edge node files

Several files are needed to install the Open Horizon (Open Horizon) agent on your edge devices and edge clusters and register them with Open Horizon. This content guides you through bundling the files that are needed for your edge nodes. Perform these steps on an admin host that is connected to the Open Horizon management hub.

The following steps assume that you have installed the cloudctl and oc CLIs, and that you are running the steps from within the unpacked installation media directory ibm-eam-4.2.0-agent-x86_64. This script searches for the required Horizon packages in the agent/edge-packages-4.2.0.tar.gz file, and creates the necessary edge node configuration and certificate files.

  1. Set the following environment variables. This assumes you are still logged in to oc as a result of the management hub installation steps.

    export CLUSTER_URL=https://$(oc get cm management-ingress-ibmcloud-cluster-info -o jsonpath='{.data.cluster_ca_domain}')
    export CLUSTER_USER=$(oc -n ibm-common-services get secret platform-auth-idp-credentials -o jsonpath='{.data.admin_username}' | base64 --decode)
    export CLUSTER_PW=$(oc -n ibm-common-services get secret platform-auth-idp-credentials -o jsonpath='{.data.admin_password}' | base64 --decode)
    oc --insecure-skip-tls-verify=true -n kube-public get secret ibmcloud-cluster-ca-cert -o jsonpath="{\.crt}" | base64 --decode > ieam.crt
    export HZN_MGMT_HUB_CERT_PATH="$PWD/ieam.crt"
    export HZN_FSS_CSSURL=${CLUSTER_URL}/edge-css
  2. Move into the agent directory where edge-packages-4.2.0.tar.gz is:

    cd agent
  3. Run the script to gather the necessary files and put them in the CSS (Cloud Sync Service) component of the Model Management System.

    Note: The script was installed as part of the horizon-cli package and should be in your path.

    HZN_EXCHANGE_USER_AUTH='' ALL -c -p edge-packages-4.2.0

    On each edge node use the -i β€˜css:’ flag of to have it get the needed files from CSS.

    Note: If you plan to use FDO-enabled edge devices, you must run this form of the command.

  4. Alternatively, use to bundle the files in a tar file: ALL -t -p edge-packages-4.2.0

    Copy the tar file to each edge node and use the -z flag of to get the needed files from tar file.

Note: has more flags to control what files are gathered and where they should be placed. To see all of the available flags, run: -h

What’s next

Before edge nodes are set up, you or your node technicians must create an API key and gather other environment variable values. Follow the steps in Prepare for setting up edge nodes.