Skip to content

FirstRun Install

Bert Kleewein edited this page Feb 19, 2020 · 1 revision

Installing Horton

Prerequisites

Horton has been tested on several Debian distros and Windows 10.

You may need Docker and/or IoT Edge installed.

There is no need to install Python. The activate_horton scripts will do this for you.

Linux configuration

Life is easier if your user account can run docker commands without using sudo. Run sudo usermod -aG docker $USER. You may need to re-open your bash prompt or reboot your VM for this to take effect. After this, you should be able to run docker ps to see running containers instead of needing to run sudo docker ps

Some scripts make liberal use of sudo. These will run smoother if you give your user account permission to run sudo without entering the user password (standard security disclaimers apply). To do this, run sudo visudo and add the following to the bottom of the file:

my_user   ALL=(ALL) NOPASSWD:ALL

(replace my_user with your local user name).

activate_horton script

To install Horton, clone the repo and run the activate_horton script.

On windows:

F:\repos\e2e-fx>bin\activate_horton.cmd

On linux:

bertk@bertk-newvm-1:~/repos/e2e-fx$ source bin/activate_horton

If successful, you should see a (horton) prefix on your prompt.

On Windows:

Horton environment activated

(horton) F:\repos\e2e-fx>

On linux:

Horton environment activated
(horton) bertk@bertk-newvm-1:~/repos/e2e-fx$

Environment variables

You need the following environment variables set. The connection string is your IoTHub connection string. The E2E_REPO variables are for the Docker container repository that Horton uses. You can get these form the sdkbld keyvault or from a coworker. Make sure these are set whenever you run Horton. Put them in your .bashrc or something like that.

  • IOTHUB_E2E_CONNECTION_STRING
  • IOTHUB_E2E_REPO_ADDRESS
  • IOTHUB_E2E_REPO_PASSWORD
  • IOTHUB_E2E_REPO_USER

Login to container repository

To run Horton, you need to be connected to our container repository.

  • On Windows, run docker login -u %IOTHUB_E2E_REPO_USER% -p %IOTHUB_E2E_REPO_PASSWORD% %IOTHUB_E2E_REPO_ADDRESS%
  • On Linux, run docker login -u $IOTHUB_E2E_REPO_USER -p $IOTHUB_E2E_REPO_PASSWORD $IOTHUB_E2E_REPO_ADDRESS
F:\>docker login -u %IOTHUB_E2E_REPO_USER% -p %IOTHUB_E2E_REPO_PASSWORD% %IOTHUB_E2E_REPO_ADDRESS%
WARNING! Using --password via the CLI is insecure. Use --password-stdin.
Login Succeeded
F:\>