Introduction

This document will describe the Initial setup of Site Controller on an Ubuntu Core 16 distribution, using docker containers. This applies to any platform running Ubuntu Core 16, including, but not limited to, the Dell Edge Gateway 5000

This guide should not be taken as the final version, as it only refers to the current SC Docker installation, which is in a prototype state.


Prerequisites

Required installation files


SiteController is available through official purchase of a license or directly through azeti for development tests / integration tests. Upload the required files to the ubuntu server and proceed from there.

Configure the time zone

Before you begin the installation, make sure that you have the system with the right time configuration and a timezone configured in your system. Please read the file /etc/timezone to check that it is including your location. This file should contain a pair (Example: Europe/Berlin), that corresponds to the names that you can find in /usr/share/zoneinfo.

Core software installation

All the following commands must be done as root. You can add "sudo" to the beginning of all the commands or use "sudo su" in order to be root and continue with the instructions.


Once the system is installed, you will need to do a basic configuration of the system in order to connect to the cloud server. You should have received all the credentials beforehand, contact your provider in case you miss some information.

  1. Create a directory for the Sitecontroller under the docker snap (/root/snap/docker/common) and cfg subdirectory under it

    mkdir /root/snap/docker/common/SiteController
    mkdir /root/snap/docker/common/SiteController/cfg
  2. Copy the docker-compose.yml to the main directory and the SiteController.cfg to the cfg directory

    cp docker-compose.yml /root/snap/docker/common/SiteController/
    cp SiteController.cfg /root/snap/docker/common/SiteController/cfg/
  3. If not already configured, introduce the login credential to the azeti private repository on docker hub

    /snap/bin/docker login
  4. Change to the main directory and execute the docker compose command. The images will be downloaded and the service started automatically.

    cd /root/snap/docker/common/SiteController/
    /snap/bin/docker.compose up -d --build

To start the site controller on a device where it was already installed, use the command from the yml directory and as root:


sudo su
cd /root/snap/docker/common/SiteController/
/snap/bin/docker.compose up -d 


Related articles

Related articles appear here based on the labels you select. Click to edit the macro and add or change labels.

Related issues