SDC Build Instructions

Before starting to make sure you have a working development environment.

You can follow the Setting Up Your Development Environment Page.

Table Of Contents:

The computer must have the following software packages installed:

• Latest node version, currently 6.9.5 or higher (Installs the needed version of npm as well) you can download from here: https://nodejs.org/

• Latest maven vesrion, currently 3.3.9

• JDK 8, you can download from here: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

Create a sdc folder and run the following command

Now all you need to is to build the project:

SDC is deployed using a HEAT template that bootstraps a VM machine on the Rackspace cloud. Assuming that the deployment runs as expected then the following System setup, prerequisites and requirements should automatically be put in place.

This document describes the manual processes required to perform any one of the automated steps, if the deployment did not run to completion as expected.

The document deals with several key topics:

• System setup and prerequisites

• Manual system setup

• SDC application setup

• SDCconsumers setup

Operating system requirements

• Ubuntu v16.04

• Volume allocated and named /data

• Docker service installed, up and running

• Docker is connected to the Docker hub repository

SDC application requirements

• <environment>.json located under: /data/ASDC/environments

• docker_health.sh script located under: /data/scripts

• docker_run.sh script located under: /data/scripts

The manual system setup consists of :

• Installing the Docker service

• Updating Ubuntu to the latest version available on the Rackspace repository

• Allocating volume for /data

• Setting the connection to the Docker hub repository

Installing the Docker service

1. Start the Rackspace machine
   A. Login to Rackspace console
   B. Start the Rackspace VM
   C. Login to the Rackspace server with the credentials given by Rackspace
   
   
   

2. Check Ubuntu uname:
   uname -r
   
   The output needs to be grater then 3.13.0-91-generic:

   For example: root@vm1-asdc:/data# uname -r 4.4.0-51-generic

3. Install the Docker service:
   A. Login to the new machine as root and run:

   apt-get update apt-get install apt-transport-https ca-certificates (Press Y) apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D echo "deb https://apt.dockerproject.org/repo ubuntu-trusty main" | tee /etc/apt/sources.list.d/docker.list apt-get update apt-cache policy docker-engine apt-get -y install linux-image-extra-$(uname -r) linux-image-extra-virtual apt-get -y install docker-engine service docker start

   B. Verify that Java is installed:
   java -version
   
   C. If Java is not installed then run:
   
   
   

   apt-get install default-jre apt-get update

4. A system restart is required; reboot the server.