Happy Setup

Happy is only supported on Linux due to its strong dependence on Linux network namespaces.

Install

1. Install required libraries:

   sudo apt-get install python-setuptools bridge-utils python-lockfile python-psutil make

2. Clone the repository:

   git clone https://github.com/openweave/happy.git
   

3. Install Happy:

   cd happy
   make
   

   The make command performs two tasks:
   1. Creates a Happy python package at /usr/local/lib/python2.7/dist-packages
   2. Copies Happy shell scripts to /usr/local/bin
4. Validate the installation by running a Happy command:

   happy-state
   
   State Name:  happy
   
   NETWORKS   Name         Type   State                                     Prefixes
   
   NODES      Name    Interface    Type                                          IPs
   

Weave support

Happy supports Weave via OpenWeave, which requires an OpenWeave build and some additional configuration. The quickest way to integrate OpenWeave with Happy is to build the standalone application.

1. Install the build toolchain and all dependencies required for OpenWeave:

   sudo apt-get update
   sudo apt-get install -y autotools-dev build-essential git lcov /
                        libdbus-1-dev libglib2.0-dev libssl-dev /
                        libudev-dev python2.7 python-software-properties
   sudo apt-get install -y --force-yes gcc-arm-none-eabi
   sudo apt-get update -qq

2. Clone the OpenWeave repository:

   git clone https://github.com/openweave/openweave-core.git
   

3. Build the standalone OpenWeave application:

   cd <path-to-openweave-core>
   make -f Makefile-Standalone
   

4. Set the Weave path in the Happy configuration:

   happy-configuration weave_path <path-to-openweave-core>/build/x86_64-unknown-linux-gnu/src/test-apps
   

5. Update the $PATH environment variable so it knows where to find Happy-related binaries for Weave:

   export PATH=$PATH:<path-to-openweave-core>/src/test-apps/happy/bin
   

6. Test the configuration. You should be able to run Weave commands for Happy:

   weave-state
   
   State Name:  weave
   
   NODES                Name       Weave Node Id    Pairing Code
   
   FABRIC          Fabric Id           Global Prefix
   

Uninstall

1. Ensure all virtual nodes and networks are deleted:

   happy-state-delete

2. Uninstall Happy:

   cd <path-to-happy>
   make uninstall

3. Delete any other remaining Happy files:

   rm -f ~/.happy_state.json
   rm -f ~/.happy_conf.json
   rm -f ~/.happy_state.json.lock
   cd /usr/local/lib/python2.7/dist-packages
   rm -f happy*

If you use an advanced feature like parallel states, each state should be individually deleted. See Uninstall with parallel states for more information.