Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Instructions for installing Airship+Tungsten Fabric using the Regional Controller and the TF Blueprint

Install the Regional Controller

The Regional Controller should already be running somewhere (hopefully on a machine or
VM dedicated for this purpose). See instructions on how to start the regional
controller.  https://wiki.akraino.org/display/AK/Starting+the+Regional+Controller


Clone the nc/tf repository using 

Code Block
git clone https://gerrit.akraino.org/r/nc/tf


Setup ssh keys and put them on web -server 

Regional Controller goes to the remote node by ssh, so it needs ssh private key. It can be provided as http URL.  (It's not secure for production, it's only OK for the demo).

...

Hint: python provisional web server can be used on the localhost. Use python3 -m http.server


 Edit the file setup-env.sh 

Update all the environment variables define the ip addresses nodes, web server baseurl, etc. Define where the Regional Controller is located, as well as the login/password to use
(the login/password shown here are the built-in values and do not need to be changed, if you have not changed them on the Regional Controller):

Code Block
languagebash
export RC_HOST=<IP or DNS name of Regional Controller>
export USER=admin
export PW=admin123


Generate yaml files from templates

Code Block
languagebash
source setup-env.sh
cat objects.yaml.env | envsubst > objects.yaml
cat TF_blueprint.yaml.env | envsubst > TF_blueprint.yaml 


Clone the api-server repository.

This provides the CLI tools used to interact with the Regional Controller. Add the scripts from this repository to your PATH:

Code Block
languagebash
git clone https://gerrit.akraino.org/r/regional_controller/api-server
export PATH=$PATH:$PWD/api-server/scripts


Load the objects

Load objects defined in objects.yaml into the Regional Controller using:

Code Block
languagebash
rc_loaddata -H $RC_HOST -u $RC_USER -p $RC_PW -A objects.yaml


Load the blueprint

Load the blueprint  into the Regional Controller using:

Code Block
languagebash
rc_cli -H $RC_HOST -u $RC_USER -p $RC_PW blueprint create TF_blueprint.yaml


Get and export UUIDs

Get the UUIDs of the edgesite and the blueprint from the Regional Controller using:

...

Code Block
languagebash
export ESID=<UUID of edgesite in the RC>
export BPID=<UUID of blueprint in the RC>


Generate POD.yaml

Code Block
languagebash
cat POD.yaml.env | envsubst > POD.yaml


Create the POD

Create the POD using

Code Block
languagebash
rc_cli -H $RC_HOST -u $RC_USER -p $RC_PW pod create POD.yaml

This will cause the POD to be created, and the deploy.sh workflow script to be
run on the Regional Controller's workflow engine. This in turn will login to remote node by ssh
and install airship+ tungstenfabric demo on it


Checking POD status

If you want to monitor ongoing progess of the installation, you can issue periodic calls
to monitor the POD with:

...