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

Installing Open Horizon Overview

The Open Horizon All-in-One (AIO) script is a tool for installing, restarting, upgrading, and removing all Open Horizon components. This includes the Management Hub, the anax Agent, the CLI, and example services and deployment policies. Please note that Open Horizon does not include a container or model registry, nor an automation solution like Ansible Automation Platform.

Once Open Horizon’s Management Hub is running, and at least one Agent is registered with that Hub, you will be able to automatically deploy containerized applications and ML models to the Agent’s host. This is activated by publishing, at minimum, a Service Definition file describing a microservice or distributed application, and a Deployment Policy describing the circumstances under which a service can be matched to an edge node. Once those exist, the act of publishing a deployment policy, or registering a node, will cause services and policies to be evaluated by the AgreementBot looking for potential matches. If matches are found, proposed, and accepted by all parties, the deployment process begins.

Installation summary

  • This content describes the steps to deploy the following components.
    • Open Horizon Exchange API.
    • Open Horizon Agreement Bot (AgBot).
    • Open Horizon Cloud Sync Service (CSS).
    • Open Horizon FIDO Device Onboard (FDO).
    • Open Horizon Secrets Manager.

Environment Variables

You may want to persist configuration variables in a file (example: mycreds.env) or in your .bashrc or equivalent file. Exporting the values in the current session will work for this installation only and will not make them available to future sessions.

Ensure that you are running with elevated privileges before setting variables and installing the Hub: sudo -i

export MONGO_IMAGE_TAG=4.0.6
export CSS_IMAGE_TAG=1.10.1-1577
export HZN_LISTEN_IP=132.177.125.232 # <-- use your IP address, not this one

NOTE: If you’d like to use TLS 1.3 (https) for secure services, and you’re not using macOS®, set the following variables.

export HZN_TRANSPORT=https
export VAULT_DISABLE_TLS=false

Installation

IMPORTANT: At the end of a successful installation, credentials and secrets will be shown once on the screen. Administrators, please capture this information and save it for future use. There is no way to recover this.

Use the deploy-mgmt-hub.sh script to deploy the Open Horizon management hub services, agent, and CLI on this host. To deploy the management hub services (agbot, exchange, css, fdo, postgre, mongo), the agent, and the CLI on the current host, run the following command:

curl -sSL https://raw.githubusercontent.com/open-horizon/devops/master/mgmt-hub/deploy-mgmt-hub.sh | bash -s -- -A -R -E

This command also registers the edge node and loads the Open Horizon custom sample services, policies, and patterns.

To read about the script and the flags that you can use, see https://github.com/open-horizon/devops/blob/master/mgmt-hub/deploy-mgmt-hub.sh.

Followup

To ensure that the user on the host can see Docker® containers, run the following command:

sudo usermod -aG docker $USER

What’s Next

Follow the steps in post installation to continue setting up your new management hub.