Introduction

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.

...

## 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

Change to the /opt/akraino/region directory and run the start_regional_controller.sh script:

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

root@regional_controller_vm:/# ./start_akraino_portal.sh

This will also take 10 to 20 minutes. 

A successful installation will end with the following message:

...
  
Setting up tempest content/repositories
Setting up ONAP content/repositories
Setting up sample vnf content/repositories
Setting up airshipinabottle content/repositories
Setting up redfish tools content/repositories
SUCCESS:  Portal can be accessed at http://10.51.34.230:8080/AECPortalMgmt/
SUCCESS:  Portal install completed

Note: The enumerated IP shown (10.51.34.230) is an example 'host' address for a RC deployed in a validation lab.

The Regional Controller Node installation is now complete.

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

Please note: It will be necessary to generate rsa keys on the newly commissioned RC which must then be copied and inserted into the 'genesis_ssh_public_key' attribute in site input yaml file used when subsequently deploying each Unicycle pod at any edge site controlled by the newly built RC. This will be covered in the Unicycle installation instructions.

Accessing the new Regional Controller's Portal UI

During the  installation a UI will have been installed on the newly deployed RC. This UI will be used to subsequently deploy all Rover and Unicycle pods to edge locations. The RC's portal can be opened in Chrome via the portal URL http://TARGET_SERVER_IP:8080/AECPortalMgmt/ where TARGET_SERVER_IP is the RC's 'host' IP address. Note: IE or Edge browsers may not currently work with this UI.

Use the following credentials:

• Username: akadmin
• Password: akraino

Upon successful login, the Akraino Portal home page will appear. Please not the extra entries in the MTN3 site is due to the fact this screenshot was taken after a Unicycle pod was deployed from this RC.

Image Added