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

Install Open Horizon

You must install and configure a management hub before you start the Open Horizon node tasks.

Prerequisites for full installation

  • Ensure you are using a Debian-based Linux® distribution such as Ubuntu 20.04 or 22.04 LTS and running on an x86-based micro-architecture. The installation can run on the bare hardware or in a VM. The Hub cannot run on arm64-based hardware.
  • For installation, you will need to become root, ex. sudo -i
  • Ensure that you know the public or network facing IP address for the local network that other machines will use to connect to the Management Hub. We will set that IP address as HZN_LISTEN_IP. If you do not set this in advance, other machines will not be able to connect to the hub.
  • Open Horizon uses Mongo 6. If you want to run Open Horizon using only open source tools, you must set a variable to override the version of Mongo. Set the MONGO_IMAGE_TAG environment variable to 4.0.6.
  • If you are using Podman or any container engine that is not Docker, you must set the DOCKER_ENGINE variable appropriately. For example, if you are using Podman, run this command:
    export DOCKER_ENGINE=podman

Gathering edge node files

Several files are needed to install the Open Horizon agent on your edge devices and edge clusters and register them with Open Horizon. These agent files are stored in the CSS Cloud Sync Service (CSS) component of the Model Management System (MMS). If you know the components of the Exchange that you want to use, and their IP addresses and ports, you can bundle those edge node files now. However, if you are uncertain of those details, you might want to bundle those files after you install Open Horizon. For more information, see Gather edge node files.

What’s Next

Continue setting up your new management hub by performing the steps in Install Open Horizon.