Sample Open Horizon setup

Owned by Przemysław Cuber
Last updated: Aug 10, 2021
8 min read

Basic information about Open Horizon project playlist on YouTube.

Open Horizon project playlist on YouTube

Open Horizon quick start

Open Horizon HUB and Agent installation

The following sample setup has been done with Ubuntu server 20.04 on Virtual Machine as a HUB and Ubuntu server 20.04 on raspberry PI 3B as Agent.



Ubuntu server installation described under

https://open-horizon.github.io/common-requests/install.html

The first movie shows Ubuntu Server installation. The same steps has to be performed on both HUB and Agent. The second movie shows procedure of Open Horizon HUB installation that was performed on VM.

Open Horizon HUB installation



The "deploy-mgmt-hub.sh" script has to downloaded  README.md first and variable "HZN_LISTEN_IP" set to 0.0.0.0.

curl -sSL https://raw.githubusercontent.com/open-horizon/devops/master/mgmt-hub/deploy-mgmt-hub.sh

Then run the script.



deploy-mgmt-hub.sh output
sudo ./deploy-mgmt-hub.sh [sudo] password for ubuntu: ------- Checking input and initializing... Management hub services will listen on http://0.0.0.0 Updating apt-get package index... Installing prerequisites, this could take a minute... ------- Downloading template files... Substituting environment variables into template files... ------- Downloading/starting Horizon management hub services... Downloading management hub docker images... Pulling openhorizon/amd64_agbot:latest ... Pulling openhorizon/amd64_exchange-api:latest ... Pulling openhorizon/amd64_cloud-sync-service:latest ... Pulling postgres:latest ... Pulling mongo:latest ... Pulling openhorizon/sdo-owner-services:latest ... Starting management hub containers... Creating network "hzn_horizonnet" with driver "bridge" Creating volume "hzn_postgresvol" with default driver Creating volume "hzn_mongovol" with default driver Creating volume "hzn_agbotmsgkeyvol" with default driver Creating volume "hzn_ocsdb" with default driver Pulling postgres (postgres:latest)... latest: Pulling from library/postgres 33847f680f63: Pull complete 1b09e96014b3: Pull complete eb49b6d9d1f3: Pull complete 4057ebf78d2d: Pull complete f92d870e2c4f: Pull complete b03847575a18: Pull complete 475945131fa9: Pull complete c042b5a6607d: Pull complete cfe883b776dc: Pull complete 61af04e5c3eb: Pull complete 4e9965ae9062: Pull complete 7b9708b81aa6: Pull complete 871877336770: Pull complete Digest: sha256:6647385dd9ae11aa2216bf55c54d126b0a85637b3cf4039ef24e3234113588e3 Status: Downloaded newer image for postgres:latest Creating postgres ... done Creating mongo ... done Creating exchange-api ... done Creating css-api ... done Creating sdo-owner-services ... done Creating agbot ... done Waiting for the exchange......... ------- Creating the user org, the admin user in both orgs, and an agbot in the exchange... Creating exchange hub admin user, and the admin user and agbot in the system org... Creating exchange user org and admin user... ------- Downloading/installing/configuring Horizon agent and CLI... Downloading the Horizon agent and CLI packages... Installing the Horizon agent and CLI packages... Configuring the Horizon agent and CLI... Warning: can not find a public IP on this host, so the agent-install.cfg file that will be added to CSS will not be usable outside of the this host. You can explicitly specify the public IP via HZN_LISTEN_PUBLIC_IP. Publishing /tmp/horizon-all-in-1/agent-install.cfg in CSS as public object agent-install.cfg in the IBM org... Digital sign with SHA1 will be performed for data integrity. It will delay the MMS object publish. Start hashing the file... Data hash is generated. Start digital signing with the data hash... Digital sign finished. Object agent-install.cfg added to org IBM in the Model Management Service ------- Installing Horizon example services, policies, and patterns... Using examples repo branch v2.29 derived from the hzn version Cloning https://github.com/open-horizon/examples.git to /tmp/open-horizon/examples ... Switching to branch v2.29 ... Warning: examples branch 'v2.29' does not exist, falling back to the master branch Publishing services and patterns of edge/services/cpu_percent to IBM org... Publishing services and patterns of edge/services/gps to IBM org... Publishing services and patterns of edge/services/helloworld to IBM org... Publishing deployment policy of edge/services/helloworld to myorg org... Publishing services and patterns of edge/services/helloMMS to IBM org... Publishing services and patterns of edge/services/nginx-operator to IBM org... Publishing deployment policy of edge/services/nginx-operator to myorg org... Publishing services and patterns of edge/evtstreams/cpu2evtstreams to IBM org... Publishing deployment policy of edge/evtstreams/cpu2evtstreams to myorg org... Successfully published all examples to the exchange. Removing /tmp/open-horizon/examples directory. ------- Creating and registering the edge node with policy to run the helloworld Horizon example... Waiting for the agent to be ready Horizon Exchange base URL: http://127.0.0.1:3090/v1 Node myorg/node1 does not exist in the Exchange with the specified token, creating/updating it... node added or updated Node node1 created. Will proceeed with the given node policy. Updating the node policy... Initializing the Horizon node with node type 'device'... Note: no input file was specified. This is only valid if none of the services need variables set. However, if there is 'userInput' specified in the node already in the Exchange, the userInput will be used. Changing Horizon state to configured to register this node with Horizon... Horizon node is registered. Workload services should begin executing shortly. Waiting for up to 180 seconds for following services to start: IBM/ibm.helloworld Status of the services you are watching: IBM/ibm.helloworld Progress so far: agreement proposal has been received Status of the services you are watching: IBM/ibm.helloworld Progress so far: agreement is accepted Status of the services you are watching: IBM/ibm.helloworld Progress so far: execution is started Status of the services you are watching: IBM/ibm.helloworld Success ----------- Summary of what was done: 1. Started Horizon management hub services: agbot, exchange, postgres DB, CSS, mongo DB 2. Created exchange resources: system org (IBM) admin user, user org (myorg) and admin user, and agbot Automatically generated these passwords/tokens: EXCHANGE_ROOT_PW=T2lICI9q5xvwtkeLPRrGZkcp5RUSwG EXCHANGE_HUB_ADMIN_PW=3G84oId3MEk4S5BjOF3m6KRNfph5BT EXCHANGE_SYSTEM_ADMIN_PW=khDHsRMe4Ca29gPZNp17dDirnbm1W0 AGBOT_TOKEN=aYGhdC7i6JPohkt4LXGkdq7NT99P1U EXCHANGE_USER_ADMIN_PW=1eAVOw1dWRKve5b5KIkRk2PcBjXLnO HZN_DEVICE_TOKEN=Zm4Y1wFgrUD2D1MTrtn1UmyBaOnn8u Important: save these generated passwords/tokens in a safe place. You will not be able to query them from Horizon. 3. Installed and configured the Horizon agent and CLI (hzn) 4. Created a Horizon developer key pair 5. Installed the Horizon examples 6. Created and registered an edge node to run the helloworld example edge service 7. Added the hzn auto-completion file to ~/.bashrc (but you need to source that again for it to take effect in this shell session) For what to do next, see: https://github.com/open-horizon/devops/blob/master/mgmt-hub/README.md#all-in-1-what-next Before running the commands in the What To Do Next section, copy/paste/run these commands in your terminal: export HZN_ORG_ID=myorg export HZN_EXCHANGE_USER_AUTH=admin:1eAVOw1dWRKve5b5KIkRk2PcBjXLnO ubuntu@ubun2:~$

In later steps it is required to manage Docker as a non-root user. Perform the following steps to achieve that.

Create the docker group.

sudo groupadd docker

Add your user to the docker group.

Verify that docker containers are running under 0.0.0.0.

Agent installation

Agent deb packages are available for different architectures under Agent releases. For more information check section "Agent installation and registration".

Configuration after installation Open Horizon Management Hub and Agent

Next steps requires setting proper environmental variables on both HUB and Agent sites according to SDO-OH-EXF-dev-simple.

Environemtal variables

HUB requires to set HZN_ORG_ID and HZN_EXCHANGE_USER_AUTH. For Agent all those variables has to be set.

Check configuration

Local HUB variables



Agent environmental variables



NOTE: Environmental variables can be added to ~/.bashrc file so it will be set automatically at startup.



Run commands from How to use Open Horizon on both HUB and Agent to check configuration. Sample output is as follows.

HUB hzn version



HUB hzn node list



HUB hzn agreement list



Agent hzn version



Agent hzn node list



Agent hzn agreement list



Check whether exchange container is accessible outside on HUB and agent site

Sample output

Investigate:

https://github.com/open-horizon/anax/blob/master/docs/api.md

Agent installation and registration

Install docker

follow

https://docs.docker.com/engine/install/ubuntu/

Install required dependencies by Agent.



then download and install agent package from

https://github.com/open-horizon/anax/releases

Follow

https://open-horizon.github.io/docs/installing/advanced_man_install.html

to change

like following

Next restart horizon service to apply changed settings.

Check configuration





Check available patterns

Register agent. Instead of

run

from
https://github.com/open-horizon/examples/blob/master/edge/services/helloworld/README.md#preconditions



Check whether docker container is running.

Check logs from running container.



TODO Check what is the procedure for using custom containers.