Ubuntu Xenial (16.04) Setup

On this page:

Introduction

This document will describe the Initial setup of Site Controller on an Ubuntu LTS linux distribution. 

Prerequisites

You will need to know the IP of the system and to have access via ssh.

Required installation files

  • SiteController installation archive (e.g. SiteController-install-1.3-Astra.tar.gz):  SiteController modules and necessary python libraries 


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, e.g. in /root/download and proceed from there.

Configure the time zone

Timezone configuration

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. Install prerequisites for compiling packages

    apt-get install build-essential libc-ares-dev xsltproc docbook-xsl gcc python-dev libssl-dev python-psutil
  2. Add the mosquitto repository for a more recent version

    apt-add-repository ppa:mosquitto-dev/mosquitto-ppa
    apt-get update
    apt-get install mosquitto
  3. Install SiteController (output was truncated)

    root@ubuntu:~/download# tar xzf SiteController-install-1.3.5-Astra.tar.gz 
    root@ubuntu:~/download# cd SiteController-install/
    root@ubuntu:~/download/SiteController-install# ./setup.sh 
    OS type is generic Ubuntu
    Creating new site controller startup configuration ...
    Checking for previous installation of SiteController ...
    No previous installation found. Creating folder ...
    Installing python libraries ...
    Checking for presence of setuptools ... Not present
    Installing setuptools ...
    
    ...
    
    Updating autostart script ...
    Sorry, no autostart script available for your system.
    Adapting configuration to your system ...
    Please provide a unique serial name for your SiteController!
    Allowed characters are upper and lower case ASCII [a-zA-Z],
    digits [0-9], dashes - and underlines _.
    Your entry: > Ubuntu-Test-sebastian
    Serial name set to Ubuntu-Test-sebastian
    Thank you.
    Changing serial id of SiteController from "" to "Ubuntu-Test-sebastian".