Open Horizon Management Hub Developer Instance

Owned by Lincoln Lavoie
Last updated: Feb 17, 2023 by Joseph Pearson
2 min read

Overview

The LF Edge's Open Horizon project delivers containerized services and ML assets, and manages the service software lifecycle, on edge nodes and clusters.  The project's Management Hub components store the metadata for describing the services, deployment policies, and encrypted communications.  They also propose agreements to edge nodes for potential deployments.  But the Agent component (anax) autonomously determines what will actually happen on the edge node, makes all decisions, and initiates all communications.  For an edge node or cluster to manage workloads, they must be registered with a Hub instance (and can only be registered with one Hub at a time). 

The Open Horizon project is providing a public Hub instance for the LF Edge community to use, provide working examples, and to assist developers.  This Hub instance will be the current release of Open Horizon, and will be replaced whenever a new release is deployed every few months.  See the Shared Community Lab's Acceptable Usage Policy for usage guidelines.

New Users

To obtain a free user account on the Hub, send your request to the #open-horizon-devops chat channel on the Open Horizon chat server.

Once credentials have been sent to you by an Administrator, follow those directions.  The Quick Start page on the documentation site also has detailed instructions on how to install the Agent.

Administrators

Pre-requisite information

Before adding the new user, collect the following information:

  • Will you need to create a single user account or multiple?
  • Which ones need to be an organization admin?
  • Will a user account also need to be added to an existing organization?
  • What is the preferred org name, user name, user password, user email?

How to add new users

To add a new user, first add a new tenant organization if the user is not being added exclusively to an existing org. 

  1. Authenticate with the Hub as a Hub admin.  If you are not authenticated with a Hub admin account, the following step will throw an error.
  2. Create the organization for the user.  If you are creating a personal organization, use the same name as the username.
    hzn exchange org create --description="Personal organization for example code" <org name>
  3. Verify that the new organization exists:
    hzn exchange org list
  4. Create the new user account (add -A if the account is for an Organization admin):
    hzn exchange user create -o <org name> -A <user login> <user password> <user email>
  5. Verify that the new user exists:
    hzn exchange user list -o <org name> <user name>
  6. Send a private message to the user email account with instructions.