theodoregc/anax

Horizon agent control system

anax

Introduction

This project contains the Horizon client system source code. Stable versions of the Horizon agent are packaged for many Debian-based distributions. They are available for download at https://github.com/open-horizon/anax/releases. To build the packages yourself, consult https://github.com/open-horizon/horizon-deb-packager. To run the agent, you will need access to systems where the Exchange (https://github.com/open-horizon/exchange-api), the CSS (https://github.com/open-horizon/anax/tree/master/css/image/cloud-sync-service-amd64), and an Agbot (which is just anax deployed as an agbot instead of an agent) are deployed.

Related Projects:

• horizon-deb-packager (https://github.com/open-horizon/horizon-deb-packager): A system for packaging Horizon system debs for multiple distributions and architectures. It also produces Ubuntu snaps
• sync-service (https://github.com/open-horizon/edge-sync-service): A subsystem for managing machine learning models at the edge.

Documentation

• Anax APIs
• Managed Workloads

Development

Preconditions

• Go version >=1.14 is a required dependency, download it here
• To execute the lint and other code checkers (make lint or make check), you must install: go vet, golint, and jshint

Operations

Note that the Makefile silences a lot of its output by default. If you want to see more output from build steps, execute a build like this:

make mostlyclean check verbose=y

Build executable

Regular usage for the same anax runtime platform:

make

Note: If you want to run anax build on another platform (cross-platform build), set up the target architecture and kind of operating system platform (Linux/Darwin) as arch and opsys variables respectively:

# For example, to build ppc64le anax binary for Linux OS on Mac OS host use the commands below
# List of possible values:
#   `arch`: armhf, arm64, amd64, ppc64el
#   `opsys`: Linux, Darwin
export arch=ppc64el
export opsys=Linux
# then call make to run anax build
make

Execute code checks

make lint

Format code

make format

Fetch dependencies

make deps

Note that this target is automatically executed when executing targets check and all. It is not automatically executed when executing test, test-integration, and generating specific executables.

Execute both unit and integration tests

make check

Execute unit tests

make test

Execute integration tests

make test-integration

Debug Logging

• Add "ANAX_LOG_LEVEL=5" to the Environment= configuration in the systemd unit file /etc/systemd/system/horizon.service. Note that the value 5 is the classification of most debug log messages, 6 is used for even more granular log messages, something like a 'trace' level.
• Reload the systemd unit file with systemctl daemon-reload.
• Restart the anax process with systemctl restart horizon.service.

Internationalization

make i18n-catalog
make

Only hzn command supports internationalization. To test, set LANG or HZN_LANG enviromental variable. For example:

HZN_LANG=fr hzn version

Development Environment

Note that this Makefile can construct its own GOPATH and build from it; this is a convenience that can sometimes cause problems for development tooling that expects a project to be in a subdirector of $GOPATH/src. To get full tool support clone this project as $GOPATH/src/github.com/open-horizon/anax.

Deprecated Commands and APIs

• hzn policy patch command is deprecated. Please use hzn policy update to update the node policy.
• hzn exchange node updatepolicy command is deprecated. Please use hzn exchange node addpolicy to update the node policy in the Exchange.