Versions Compared

Key

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

Table of Contents
Introduction

The guide covers the installation details which are related to Enterprise Applications on Lightweight 5G Telco Edge (EALTEdge) Blueprint.  

...

Introduction

The guide covers the installation details which are related to Enterprise Applications on Lightweight 5G Telco Edge (EALTEdge) Blueprint.  

This guide covers detailed information of the various types of deployments, detailed steps and what are the various components it will install. In addition, the guide provides information on hardware requirements, prerequisite software and minimum hardware requirements. On successful deployment, MECM and MEC Hosts will be installed. The number of nodes in MECM cluster and MEC Host cluster is configurable. 

The MECM CENTER Node is a K8s Cluster and MEC host EDGE Node is a K3s Cluster. 

How to use this document

...

Note: EALTEdge Blueprint Deployment has been tested on Cloud VM and is not tested on Bare-Metal Environment. Though, theoretically deployment should work  in bare metal,  provided hardware and software prerequisites are met. Kindly refer R3 R4 - Test Documentation of Enterprise Applications on Lightweight 5G Telco Edge (EALTEdge) to get details on the tested deployment.

...

Minimum Hardware Requirements

MECMCENTER Node

HW AspectRequirements
# of Node(s)A virtual machine hosted in any Cloud Provider having internet connectivity.
# of CPU8
Architecturex86_AMD64 or ARM64.
RAM

8 GB

Disk120 GB ~ 512GB
Networks1


MEC HostEDGE Node(s)

HW AspectRequirements
# of Node(s)1 MEC Host

# of CPU

4
Architecturex86_AMD64 or ARM64.
RAM

4 GB

Disk20 GB ~ 256 GB
Network1

...

Recommended Hardware Requirements

MECMCENTER Node

HW AspectRequirements
# of Node(s)A virtual machine hosted in any Cloud Provider having internet connectivity.
# of CPU8
Architecturex86_AMD64 or ARM64.
RAM

8 GB

Disk120 GB ~ 512GB
Networks1


MEC HostEDGE Node(s)

HW AspectRequirements
# of Node(s)1 MEC Host

# of CPU

4
Architecturex86_AMD64 or ARM64.
RAM

4 GB

Disk20 GB ~ 256 GB
Network1

...

  • Virtual Machines preinstalled with Ubuntu 16.04 /18.04 for MECM Node.
  • Virtual Machines preinstalled with Ubuntu 16.04 / 18.04 or CentOS 7.X for MEC Host Nodes
  • root user created in the Deployment Node, MEC Node and MEC Host Node.
  • SSH Server running in all the Nodes.
  • Ansible > 2.5 installed in One Click Deployment Node (Jump Host)
  • git installed in Jump Host.
  • Kubespray code is downloaded (https://github.com/kubernetes-sigs/kubespray.git)
  • GO Lang (version greater than 1.1514.32) installed in Jump Host, required for CLI.

...

Network Requirements

  • Internet connectivity in Jump OCD Host, MECM  CENTER  and MEC HostsEDGE Nodes.
  • The MECM Master CENTER Node and MEP Master EDGE Node should be able to ping each other.

...

For Virtual Deployment minimum three Virtual machines, following are the virtual machines and their usage

No

Usage

1

Jump Host (One Click Deployment Node)

Center CENTER Node

3Edge EDGE Node


All the nodes should have internet connectivity , network interface and network connectivity between the  VM's. 

...

  1. Install Ansible > 2.9.6 [ https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html]
  2. Install git
  3. Install GoLang > 1.1514+
  4. Git clone the Kubespray repo. [https://github.com/kubernetes-sigs/kubespray.git]
  5. Install python3 and pip3
  6. cd kubespray && pip install -r requirements.txt

...

3. Modify the Configuration File : ealt-inventory.ini with the details of MECM CENTER and MEC HostsEDGE Nodes

root@akraino-mec-0002:~# vi ealt-inventory.ini

...

Once the execution is completed in console will see prompt "EALTEdge Environment Installed  , Components Install MECM CENTER and MEC Hosts EDGE Nodes Successfully"


Other Options:

...

1. git clone the ealt-edge repo, to download the software to install the EALTEdge Environment.

root@akraino-mec-0002:~# git clone "https://gerrit.akraino.org/r/ealt-edge"

2. go to CLI directory 

root@akraino-mec-0002:~#cd ealt/infra/cli/

root@akraino-mec-0002:~#chmod +x build _cli.sh

root@akraino-mec-0002:~#source build_cli.sh

root@akraino-mec-0002:~#cd ~/ealt-edge/ocd/infra/playbooks

Note: The CLI Commands to setup the environment should be executed only from above path.

3.  Edit the Configuration File : ealt-inventory.ini with the details of MECM and MEC Hosts. 

root@akraino-mec-0002:~#vi ealt-inventory.ini

4. Execute the below command to install EALTEdge Environment 


root@akraino-mec-0002:~#ealt init all 

Above command will install the various component. Refer the below table for detail information. 

Other CLI Commands:

Command to Install only Edge Node (MEP Node)

root@akraino-mec-0002:~#ealt init edge

Deploying Application Packages : Using CLI

This feature is currently not supported in Release 4.  Will be modified based on the upstream EdgeGallery Project's feature on the next Release.


Snapshot Deployment Overview

...

  1. Login to the Center Node and check whether K8S cluster is installed. 
  2. Check the below mentioned components and services are running as Pods / Services in Kubernetes cluster
    1. PostgresSQL
    2. AppLCM
    3. Appo
    4. Inventory
    5. Apm
    6. MECM - FrontEnd
    7. Appstore
    8. Developer Portal
    9. Service Center
    10. User Management
  3. Login to Edge Host and check K3S is installed. 

Components and Services running in CENTER Node 


Components and Services running EDGE Node

Image Added


Developer  Guide and Troubleshooting

...

root@akraino-mec-0002:~#ealt clean all 
root@akraino-mec-0002:~#ealt clean edgeServices Part Pod Snapshots Need to attach

Troubleshooting

Error Message Guide

...

S. NoSoftwareTypeVersionLicenseRemarks
1.KubesprayK8S Tool2.13Apache 2.0 license


2.HelmApplication Package Manager3.0.2Apache 2.0 license

...

S. NoSoftwareTypeVersionLicenseRemarks
1.

Docker

CRI

19.03+

Apache 2.0 license


2.KubernetesOrchestration1.19.3Apache 2.0 license
3.HelmApplication Package Manager3.0.2Apache 2.0 license
4.Grafana

Monitoring

MEC-Graphana

8-7.66.0Apache 2.0 licenseCode part of Edge Gallery
5.CalicoCNI Plugin
Apache 2.0 license
6.PostgresSQLMECM-Service12.3PostgreSQL LicenseCode part of Edge Gallery
7.

AppLCM


MECM-Service0.9Apache 2.0 license

Code part of Edge Gallery

8.AppoMECM-Service (MECM-Appo)0.9Apache 2.0 licenseCode part of Edge Gallery
9InventoryMECM-Service0.9Apache 2.0 licenseCode part of Edge Gallery
10ApmMECM-Service0.9Apache 2.0 licenseCode part of Edge Gallery
11User ManagementPart of Center Node0.9Apache 2.0 licenseCode part of Edge Gallery
12

MECM - FrontEnd

MECM-Service0.9Apache 2.0 licenseCode part of Edge Gallery
13.AppstoreService (Part of Center Node)0.9Apache 2.0 licenseCode part of Edge Gallery
14.Developer PortalService (Part of Center Node)0.9Apache 2.0 licenseCode part of Edge Gallery
15Service CenterService (Part of Center Node)0.9Apache 2.0 licenseCode part of Edge Gallery

...

S. NoSoftwareTypeVersionLicense Information Remarks
1.DockerCRI19.03+Apache 2.0 license
2.K3SOrchestration
Apache 2.0 license
3.HelmApplication Package Manager3.0.2Apache 2.0 license
4.cAdvisorContainer Metricsv0.36.0Apache 2.0 license
5RabbitMQMessage Broker3.7Mozilla Public LicenseNo code modifications done. RabbitMQ image is deployed as is.
PrometheusMetrics Collector9.3.1Apache 2.0 licenseCode part of Edge Gallery
7mepm-postgres

Service

Database

9.6PostgreSQL LicenseCode part of Edge Gallery
8MEPPod0.9Apache 2.0 licenseCode part of Edge Gallery
9MECM-MEPMMEPM-Service0.9Apache 2.0 licenseCode part of Edge Gallery

...