Installing a new RC on a VM from the Build Server is a subset of the process of installing a new RC on a bare metal server. The major difference being the Build Server does not configure the target RC server's BIOS nor install the linux operating system but rather only installs the Network Cloud Regional Controller software only.

Installation of the 16.04 Ubuntu operating system on the target RC is left as a pre-requisite task for the installer.

Introduction

This installation procedure creates a new Regional Controller on a pre-prepared VM. The VM which will become the RC is termed the 'Target RC' or just 'Target VM' in this guide.

Unlike when an RC is built by the Build Server on a bare metal server this installation is performed directly on a pre-prepared Ubuntu 16.04 VM and only installs the Network Cloud specific and other software packages on the Target VM to create a new Regional Controller. Once the RC is build it is used to subsequently deploy either Rover or Unicycle pods.  

The installation procedure is executed directly on the Target VM and automatically installs the following on the Target Server:

• Install Network Cloud Regional Controller specific software including
  • PostgreSQL DB
  • Camunda Workflow and Decision Engine
  • Akraino Web Portal
  • LDAP configuration
• Install a number of supporting supplementary software components including
  • OpenStack Tempest tests
  • YAML builds
  • ONAP scripts
  • Sample VNFs

Preflight requirements

Networking

During the layer stages of the installation the Target Server's 'host' interface must have connectivity to the internet to be able to download the necessary repos and packages.

Software

When the RC is installed on a VM the an Ubuntu 16.04 Linux operating system must be installed and updated before the a RC can be built.

Preflight checks

None

Preflight RC Region Specific Input Data 

None

Deploying the RC 

RC Specific Software Installation

If you haven't done so already, elevate yourself to root:

user@regional_controller_vm:/# sudo -i

Clone the Akraino Regional Controller repository:

## Download the latest Regional_controller artifacts from LF Nexus ##
  
root@regional_controller_vm:/# mkdir -p /opt/akraino/region
 
root@regional_controller_vm:/# NEXUS_URL=https://nexus.akraino.org
 
root@regional_controller_vm:/# curl -L "$NEXUS_URL/service/local/artifact/maven/redirect?r=snapshots&g=org.akraino.regional_controller&a=regional_controller&v=0.0.2-SNAPSHOT&e=tgz" | tar -xozv -C /opt/akraino/region

At this point there will be one new directories where the cloned NC artifacts have been created.

root@regional_controller_vm:/# ls /opt/akraino/
 
region