TOPIC: ODL DOCKER

TOPIC: ODL DOCKER
AUTHOR: DANIEL SMITH
*** PLEASE MERGE **

UPDATED TO REFLECT INPUT FRMO J. BJUREL
  - fixed whitespaces
  - fixed location of .erb file (they should have been in templates - the directory was there just int he wrong spot)
  - removed opcheck.pp from common opnfv class
  - Removed Debug from fuel/build/Makefile :)

UPDATE: Input from S. Berg and F. Bockners incorporated.  Merge required before we can refactor to common puppet manifest directory

This patchset delivers the folowing functionality:
	- implementation of the common/opnfv-puppet structure / move of .pp files and update of f_odl_docker to build / source from there
	- creation of f_odl_doc subclass
	- fetch of latest stable release of ODL
	- fetch of latest docker binary release (TODO: this will be changed in next patchset push)
	- build of docker container with all needed libs and port exposure for DLUX and OVSDB/ODL with Openstack Integration (OVS Manager)
	- deployment of both the target odl docker image as well as the docker runtime binary to the control nodes via puppet script.

GENERATES:
	- docker-latest - binary of docker for use on control node
	- odl_docker_image.tar - a docker container with a ODL controller running DLUX and OVSDB

ENABLE / DISABLE:
        - Comment/Un-comment "SUBDIRS += f_odl_doc in base (fuel/build/) Makefile

Breakdown of Update / Edits per File:
=====================================
fuel/build/Makefile
	- Modified include to capture the newly created f_odl_doc directory

fuel/build/f_odl_docker/Makefile
	- Fetches libraries and produces two outputs:
		docker-latest - binary of docker (actually lxc-docker cause ODL Container is running 12.04 (precise) libraries - i.e java7, tz 12.04, etc)
		odl_docker_image.tar - this is a docker image defined in ./dockefile/Dockerfile and contains the ODL distro + setup and deployment scripts for
					runtime on the target control node.

fuel/build/f_odl_docker/dockerfile/Dockerfile
	- This Dockerfile defined the packages for use in the Docker Container that will run ODL with DLUX and OVSDB submodules.  It also defines the ports to be
		exposed to the HOST OS (and thus as well through docker the ODL Controller exists in a private, but routable via but the fuel (10.20.0.0/16) and the
		tenants public network since docker handles the mapping (see the docker run command in the start_odl_docker.sh script)

fuel/build/f_odl_docker/dockerfile/check_feature.sh
	- Simple expect script that starts up a client and checks that the features are installed (used during visual demo only)
		TODO - Replace with API call to ODL KARAF to install features (LOOKUP - Dont know how to address Karaf programatically - LOOKUP)

fuel/build/f_odl_docker/dockerfile/speak.sh
	- Expect script called by odl_start_docker.sh once karaf is up to install the features that we need (runtime inside container script) called via ENTRYPOINT in Dockerfile
		at runtime on control node.

fuel/build/f_odl_docker/dockerfile/start_odl_docker.sh
	- This is the CMD/ENTRYPOINT defined in docker and is what is called from the controller when you start the container (note: This runs inside the conatiner), not
		to be confused with staring the actual container on the control node).  This script fires up Karaf first time, loads DLUX and OVSDB modules
		and monitors that the container is up.  The container itself is started on the control node via /opt/opnfv/start_odl_container.sh which includes the syntax
		for the port mapping (RANDOM or 1:1).
		TODO -
			integrate into controller monitor script to ensure better handling (stop, start, monitor) of docker processes
			remove expect helper scripts and replace with API/JSON or some other appropriate method to KARAF

fuel/build/f_odl_docker/puppet/modules/opnfv/manifests/odl_doc.pp
	- This puppet manifest defined where the docker binary and docker image should be placed on the target control node. /opt/opnfv/start_odl_container.sh will install
		docker binary package (if necessary) and load ODL docker image into docker, start the image.  This file just ensures placement in /opt/opnfv/odl_docker

fuel/build/f_opnfv_puppet/puppet/modules/opnfv/manifests/init.pp (MODIFICATION):
	- Removed previous includes and updated to have only f_odl_doc added

fuel/build/f_odl_doc/scripts/start_odl_container.sh
	- this is the control script that will start the docker container (to be run on the control node), this is deployed
		this is deployed to /opt/opnfv on the control node via odl_doc puppet manifest file.

JIRA:

DEPRECATED:
Deleted files are no longer needed due to new implementation of ODL.

Change-Id: I26c13cc468a2aba18af78b7a3c78a719033f03e0
Signed-off-by: Daniel Smith <daniel.smith@ericsson.com>