Licensing
Radio Edge Cloud is Apache 2.0 licensed. The goal of the project is the packaging and installation of upstream Open Source projects. Each of those upstream projects is separately licensed. For a full list of packages included in REC you can refer to https://logs.akraino.org/production/vex-yul-akraino-jenkins-prod-1/ta-ci-build-amd64/313/work/results/rpmlists/rpmlist (the 313 in this URL is the Akraino REC/TA build number, see https://logs.akraino.org/production/vex-yul-akraino-jenkins-prod-1/ta-ci-build-amd64/ for the latest build.) All of the upstream projects that are packaged into the REC/TA build image are Open Source.
Introduction
This document outlines the steps to deploy Radio Edge Cloud (REC) cluster. It has a minimum of three controller nodes. Optionally it may include worker nodes if desired. REC was designed from the ground up to be a highly available, flexible, and cost-efficient system for the use and support of Cloud RAN and 5G networks. The production deployment of Radio Edge Cloud is intended to be done using the Akraino Regional Controller which has been significantly enhanced during the Akraino Release 1 timeframe, but for evaluation purposes, it is possible to deploy REC without the Regional Controller. Regardless of whether the Regional Controller is used, the installation process is cluster oriented. The Regional Controller or a human being initiates the process on the first controller in the cluster, then that controller automatically installs an image onto every other server in the cluster using IPMI and Ironic (from OpenStack) to perform a zero touch install.
...
Recent builds can be obtained from the Akraino Nexus server. Choose either "latest" or a specific build number from the old release images directory for builds prior to the AMD/ARM split or the AMD64 builds or the ARM64 builds and download the file install.iso..iso.
Akraino Release | REC or TA ISO Build | Build Date | Notes |
---|
1 | Build 9. This build has been removed from Nexus (probably due to age) |
Akraino Release | REC or TA ISO Build | Build Date | Notes |
---|
1 | draw.io Diagram |
---|
border | true |
---|
viewerToolbar | true |
---|
fitWindow | false |
---|
diagramDisplayName | Download Build 9 |
---|
lbox | true |
---|
revision | 3 |
---|
diagramName | Download |
---|
simpleViewer | true |
---|
width | links | auto |
---|
tbstyle | top |
---|
diagramWidth | 123 | 2019-05-30 | Build number 9 is known to NOT work on Dell servers or any of the ARM options listed below. If attempting to install on Dell servers, it is suggested to use builds from no earlier than June 10th |
2 draw.io Diagram |
---|
|
border | true |
---|
viewerToolbar | true |
---|
fitWindow | false |
---|
diagramDisplayName | Download Build 9 |
---|
lbox | true |
---|
revision | 3 |
diagramNameDownload Build 237 | simpleViewer | true |
---|
width | links | auto |
---|
tbstyle | top |
---|
diagramWidth | 123Build 237. This build has been removed from Nexus (probably due to age) | 2019-11-18 | It is possible that there may still be some issues on Dell servers. Most testing has been done on Open Edge. Some builds between June 10th and November 18th have been successfully used on Dell servers, but because of a current lack of Remote Installer support for Dell (or indeed anything other than Open Edge), the manual testing is not as frequent as the automated testing of REC on Open Edge. If you are interested in testing or deploying on platforms other than Open Edge, please join the Radio Edge Cloud Project Meetings.join the Radio Edge Cloud Project Meetings. | 3 - AMD64 | Build 237. This build has been removed from Nexus (probably due to age) | 2020-05-29 | This is a minor update to Akraino Release 2 of AMD64 based Radio Edge Cloud |
3 - ARM64 | Arm build 134. This build has been removed from Nexus (probably due to age) | 2020-04-13 | This is the first ARM based release of Radio Edge Cloud |
4 - AMD64 | | 2020-11-03 | The ARM build is unchanged since Release 3 |
Options for booting the ISO on your target hardware include NFS, HTTP, or USB memory stick. You must place the ISO in a suitable location (e.g., NFS server, HTTP(S) server or USB memory stick before starting the boot process. The file bootcd.iso, which is also in the same directory, is used only when deploying via the Akraino Regional Controller using the Telco Appliance Remote Installer. You can ignore bootcd.iso when following the manual procedure below.
...
Section |
---|
|
Column |
---|
| Nokia OpenEdge ServersUsing the BMC, configure a userid and password on each blade and ensure that the VMedia Access checkbox is checked. The expected physical configuration as described in Radio Edge Cloud Validation Lab is that each server in the cluster has two SSD 480GB SATA 1dwpd M.2 2280 on a riser card inside the server and two SSD 960GB SATA 3dwpd 2.5 inch on the front panel. There is no RAID configuration used. The reference implementation in the Radio Edge Cloud Validation Lab uses one M.2 drive as the physical volume for LVM and both 2.5 inch SSDs as Ceph volumes. |
Column |
---|
| Dell ServersProvision the disk configuration of the server via iDRAC such that the desired disks will be visible to the OS in the desired order. The installation will use /dev/sda as the root disk and /dev/sdb and /dev/sdc as the Ceph volumes. |
Column |
---|
| Ampere ServersDarrin Vallis Download and print hardware configuration guide for REC test installation Each server requires 2 SSDs Each server requires 3 NIC ports and 1 BMC connection "Dumb" switch or vLAN is connected to two NIC ports 1 NIC port and BMC are connected to router via switch REC ISO will recognize Ampere based Lenovo HR330 1U, HR350 2U or openEDGE sleds with "Hawk" motherboard Designate 1 server as Node 1. It runs all code to complete the installation Boot each server with a monitor attached to the VGA port. Note the BMC IP address. Boot note 1 into Operating System. Note Linux names for all Ethernet ports on hardware guide. Download and edit user_config.yaml cidr is range of IPs infra_external has network access infra_internal is VLAN or dumb switch without network access infra_storage are IPs on internal network used for storage Interface_net_mapping must be set with NIC port names previously obtained for Node 1 hwmgmt is IP addresses of all BMCs. Node 1 is the master |
Column |
---|
| Marvell Servers@ Carl Yang <carlyang@marvell.com> |
|
...
Section |
---|
|
Column |
---|
| Nokia OpenEdge ServersLogin to the controller-1 BMC ip using a web browser (https://xxx.xxx.xxx.xxx). Go to Settings/Media Redirection/General Settings. Select the Remote Media Support. Select the Mount CD/DVD. Type the NFS server IP address. Type the NFS share path. Select the nfs in Share Type for CD/DVD. Click Save. Click OK to restart the VMedia Service. Go to Settings/Media Redirection/Remote Images. Select the image for the first CD/DVD device from the drop-down list. Click the play button to map the image with the server’s CD/DVD devices. The Redirection Status changes to Started when the image redirection succeeds. Go to Control & Maintain/Remote Control to open the Remote Console. Reset the server. Press F11 to boot menu and select boot from CD/DVD device. |
Column |
---|
| HP ServersLogin to iLo for Controller 1 for the installation Go to Remote Console & Media Scroll to HTML 5 Console http://XXX.XXX.XXX.XX:XXXX/REC_RC1/install.iso -> Virtual Media URL → < IP to connect for NFS file system>/<file path>/install.iso Check “Boot on Next Reset” -> Insert Media Reset System |
Column |
---|
| Dell ServersGo to Configuration/Virtual Media Scroll down to Remote File Share and enter the url for ISO into the Image File Path field. http://XXX.XXX.XXX.XX:XXXX/REC_RC1/install.iso < IP to connect for NFS file system>/<file path>/install.iso> Select Connect. Open Virtual Console, and go to Boot Set Boot Action to Virtual CD/DVS/ISO Then Power/Reset System Be sure to read the note below on Dell servers |
Column |
---|
| Ampere ServersDarrin Vallis Download install.aarch64.iso from the latest Telco Appliance build. Files in the directory with aarch64 in the name are for ARM. To determine the release number, note the build time and date of install.aarch64.iso, then go up one level to the TA images directory and match the date/time with a build. A complete list of ARM aarch64 builds is available here. Mount install.aarch64.iso as NFS share on Linux file system in same network as REC cluster Download and unzip ampere_virtual_media_v2.zip Edit mount_media.sh and dismount_media.sh. Set IPMI_LOCATION to IP address of Node 1 BMC, NFS_IP to IP of NFS server, ISO_LOCATION to NFS path for install.aarch64.iso Run mount_media.sh. This will connect install.aarch64.iso as a CDROM on Node 1 Boot Node 1 into BIOS. Force boot from CD by selecting "Save & Exit" tab on BIOS, Boot Override → CDDROM REC Telco Appliance will begin installation See instructions below |
Column |
---|
| Marvell Servers@ Carl Yang <carlyang@marvell.com> |
|
...