Versions Compared

Key

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

This guide instructs how to build and install an Akraino Edge Stack (AES) Regional Controller node.

...

Info

This installation guide refers to the following by way of example:

  • 192.168.2.43 (aknode43)Build Server (Linux Server with a Docker Container)
  • 192.168.2.42 44 (aknode44)Bare Metal Server
  • 192.168.41.44Bare Metal Server iDRAC

Steps herein presume the use of a root account. All steps are performed from the Build Server.

A clean, out-of-the-box Ubuntu environment is strongly recommended before proceeding.

...

Code Block
languagebash
# python --version
# Python 2.7.12 
# apt install --upgrade sshpass xorriso 
python-requests Reading package lists... Done Building dependency tree Reading state information... Done python-requests is already the newest version (2.9.1-3). sshpass is already the newest version (1.05-1). xorriso is already the newest version (1.4.2-4ubuntu1). 0 upgraded, 0 newly installed, 0 to remove and 107 not upgraded

...

Code Block
languagebash
# nmap -sS 192.168.41.44 
Starting Nmap 7.01 ( https://nmap.org ) at 2018-07-10 13:55 UTC Nmap scan report for 192.168.41.44 Host is up (0.00085s latency). Not shown: 996 closed ports PORT STATE SERVICE 22/tcp open ssh 80/tcp open http 443/tcp open https 5900/tcp open vnc Nmap done: 1 IP address (1 host up) scanned in 1.77 seconds

...

Repositories are located under /opt/akraino:

Code Block
# mkdir /opt/akraino

Clone the Redfish Bootstrapping Script repository for use as part of Akraino tools:

Code Block
languagebash
# mkdir -p /opt/akraino/tools


## Download the latest redfish artifacts from LF Nexus 
## Run the below commands in sequence
NEXUS_URL=https://nexus.akraino.org
PROJECT=redfish
VERSION=0.0.2-SNAPSHOT
XMLFILE="${NEXUS_URL}/service/local/repositories/snapshots/content/org/akraino/${PROJECT}/${PROJECT}/${VERSION}/maven-metadata.xml"
curl -O "${XMLFILE}"
V2=`grep value maven-metadata.xml | sed -e 's;</value>;;' -e 's;.*<value>;;' | uniq`
TGZFILE="${NEXUS_URL}/service/local/repositories/snapshots/content/org/akraino/${PROJECT}/${PROJECT}/${VERSION}/${PROJECT}-${V2}.tgz"
curl -O "${TGZFILE}"
echo “Latest code from LF Nexus is $V2”
tar -xzvf "${PROJECT}-${V2}.tgz" -C /opt/akraino/tools

Clone the Akraino Regional Controller repository:

Code Block
languagebash
# mkdir -p /opt/akraino/region 


## Download the latest Regional_controller artifacts from LF Nexus ##
PROJECT=regional_controller
VERSION=0.0.2-SNAPSHOT
XMLFILE="${NEXUS_URL}/service/local/repositories/snapshots/content/org/akraino/${PROJECT}/${PROJECT}/${VERSION}/maven-metadata.xml"
curl -O "${XMLFILE}"
V2=`grep value maven-metadata.xml | sed -e 's;</value>;;' -e 's;.*<value>;;' | uniq`
TGZFILE="${NEXUS_URL}/service/local/repositories/snapshots/content/org/akraino/${PROJECT}/${PROJECT}/${VERSION}/${PROJECT}-${V2}.tgz"
curl -O "${TGZFILE}"
echo “Latest code from LF Nexus is $V2”
tar -xzvf "${PROJECT}-${V2}.tgz" -C /opt/akraino/region

...

Copy the Bare Metal Server configuration template into /opt/akraino/server-config/AKRAINO_NODE_RC, where AKRAINO_NODE_RC is the Bare Metal Server name followed by rc:

Code Block
languagebash
# mkdir -p /opt/akraino/server-config
# cp /opt/akraino/tools/serverrc.template /opt/akraino/server-config/aknode44rc
#
vi /opt/akraino/server-config/aknode44rc

...

Begin the OS installation:

Code Block
languagebash
# /opt/akraino/tools/install_server_os.sh --rc /opt/akraino/server-config/aknode44rc --no-confirm

...

A successful installation will start and end as follows:

Code Block
languagebash
# /opt/akraino/tools/install_server_os.sh --rc /opt/akraino/server-config/aknode44rc --no-confirm 
Beginning /opt/akraino/tools/install_server_os.sh as user [root] in pwd [/opt/akraino/server-config] with home [/root] Tools are ready in [/opt/akraino] WARNING: Preparing to build server [aknode44] using oob ip [192.168.41.44]. Beginning in 10 seconds .......... Beginning bare metal install of os at Mon Jul 2 18:57:32 UTC 2018 ... Processing triggers for libc-bin (2.23-0ubuntu10) ... SUCCESS: Completed bare metal install of regional server [aknode44] at Mon Jul 2 20:09:35 UTC 2018 SUCCESS: Try connecting with 'ssh root@192.168.2.42' as user root Elapsed time was 9 minutes and 22 seconds

...

Update the Akraino run command (rc) file in /opt/akraino/region:

Code Block
languagebash
# vim /opt/akraino/region/akrainorc

...

Begin the region server software installation:

Code Block
languagebash
# /opt/akraino/region/install_akraino_portal.sh

...

Warning
titleIn Case of Errors

The Regional Controller installation is not idempotent at this time. If errors are encountered during this phase, it is recommended that the errors be triaged and resolved, followed by an Operating System re-installation. This will ensure a "clean slate" Bare Metal Server before trying again.

A successful installation will end as follows. Note that any time estimates (e.g., "This step could take up to 15 minutes") and elapsed times are likely inaccurate.

...