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.

...

Code Block
languagebash
# mkdir -p /opt/akraino/tools 
# curl -L "https://nexus.akraino.org/service/local/artifactrepositories/snapshots/maven/redirect?r=snapshots&g=org.akraino.redfish&a=redfish&v=content/org/akraino/redfish/redfish/1.0.0-SNAPSHOT&e=/redfish-1.0.0-20180805.222845-10.tgz" | tar -xozv -C /opt/akraino/tools

...

Code Block
languagebash
# mkdir -p /opt/akraino/region
# curl -L "https://nexus.akraino.org/service/local/artifactrepositories/maven/redirect?r=snapshots&g=org.akraino.snapshots/content/org/akraino/regional_controller&a=/regional_controller&v=/1.0.0-SNAPSHOT&e=/regional_controller-1.0.0-20180807.212444-5.tgz" | tar -xozv -C /opt/akraino/region

...

  • SRV_NAME is the Bare Metal Server name
  • SRV_OOB_IP is the Bare Metal Server iDRAC IP
  • SRV_IP is the Bare Metal Server IP
  • Passwords are chosen for SRV_OOB_PWD and SRV_PWD
  • All remaining SRV_ prefixed options are adjusted as deemed appropriate
  • Remove all references to BUILD_WEBIP and BUILD_WEBPORT 

Code Block
languagebash
# host name for server
SRV_NAME=aknode42

# server oem - Dell or HPE (case sensitive)
SRV_OEM=Dell

# out of band interface information for server (idrac/ilo/etc)
SRV_OOB_IP=192.168.41.42
SRV_OOB_USR=root
SRV_OOB_PWD=ROOT_PASSWORD

# mac address of server to be used during the build - not required for Dell servers
# SRV_MAC=3c:fd:fe:b8:10:60

# name of network interface used during build when ipxe.efi is booted and when os is booted
# ipxe numbers ports from 0-n in pci bus order.
# the netx value will depend on how many nics are in the server
# and which pci device number is assigned to the slot
SRV_IPXE_INF=net4

# the build interface is the nic used by the Ubuntu installed to load the OS
SRV_BLD_INF=enp94s0f0

# the boot device is the device name on which the OS will be loaded
SRV_BOOT_DEVICE=sdg

# ipxe script to use - based on the os version and kernel to install
# valid options are script-hwe-16.04.5-amd64.ipxe or script-16.04.5-amd64.ipxe
SRV_BLD_SCRIPT=script-hwe-16.04.5-amd64.ipxe

# template xml file to set bios and raid configuration settings
SRV_BIOS_TEMPLATE=dell_r740_g14_uefi_base.xml.template
SRV_BOOT_TEMPLATE=dell_r740_g14_uefi_httpboot.xml.template
SRV_HTTP_BOOT_DEV=NIC.Slot.3-1-1

# VLAN to use during build and for final network configuration
SRV_VLAN=41

# basic network information for dhcp config and final server network settings
SRV_MTU=9000
SRV_IP=192.168.2.42
SRV_SUBNET=192.168.2.0
SRV_NETMASK=255.255.255.0
SRV_GATEWAY=192.168.2.200
SRV_DNS=192.168.2.85
SRV_DOMAIN=lab.akraino.org
SRV_DNSSEARCH=lab.akraino.org
SRV_NTP=ntp.ubuntu.org

# root password for server being built
SRV_PWD=SERVER_PASSWORD

# network bond information
SRV_BOND=bond0
SRV_SLAVE1=enp94s0f0
SRV_SLAVE2=enp94s0f1

...

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 reinstallation. This will ensure a "clean slate" Bare Metal Server before trying again.

Create an Akraino run command (rc) file in /opt/akraino/region:

...

The Regional Controller Node installation is now complete.

Akraino Portal Operations

Login

Visit the portal URL http://REGIONAL_NODE_IP:8080/AECPortalMgmt/ where REGIONAL_NODE_IP is the Portal IP.

Use the following credentials:

  • Username: akadmin
  • Password: akraino

Upon successful login, the Akraino Portal home page will appear.