Table of Contents |
---|
Introduction
The guide covers the installation details which are related to Enterprise Applications on Lightweight 5G Telco Edge (EALTEALTEdge) Blueprint.
This is the first release for this blueprint, the 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 MEP nodes MEC Hosts will be installed. The number of nodes in MECM cluster and MEP MEC Host cluster is configurable.
The MECM is a K8S Cluster and MEP MEC host is as a K3S Cluster.
How to use this document
The document includes details of prerequisites /pre-installation, installation and uninstalls steps.
...
- Ansible-Playbook single command
- Command Line Interface (CLI)
Deployment Architecture
The Deployment Architecture consists of three following nodes
- One Click Deployment Node
...
- MECM
- MEC Hosts.
Note: For Development environment two nodes is sufficient, where one node plays a dual role of One Click Deployment Node and MECM Node with other as MEP Edge Node.MEC Host.
Figure: Deployment Architecture
Note: EALTEdge Blueprint Deployment has been tested on Cloud VM Note: EALTEdge Blueprint Deployment has been tested on Cloud VM and is not tested on Bare-Metal Environment. Though, theoretically scripts deployment should run successfully work in bare metal too , provided hardware and software prerequisites are met. Kindly refer R3 - Test Documentation of Enterprise Applications on Lightweight 5G Telco Edge (EALTEdge) to get details on the tested deployment.
Pre-Installation Requirements
Hardware Requirements
Number of Hardware requirements depends mainly on the Use Case Scenario and the enterprise scale. A use case can have one MECM Cluster , Cluster with single or multiple MEP Edge Nodes clusterMEC Host cluster.
Minimum number of nodes required for a complete EALT Topology EALTEdge Topology is three. (Bare-Metal or Virtual Machines)
1) Deployment Node
2) MECM
3) MEP Edge NodeMEC Host
Note: The Hardware details provided are of Virtual Machine configurations.
Minimum Hardware Requirements
MECM | ||
---|---|---|
HW Aspect | Requirements | |
# of Node(s) | A virtual machine hosted in any Cloud Provider having internet connectivity. | |
# of CPUMinimum 1 socket | 8 | |
Architecture | x86_AMD64 or ARM64 | with Virtualization support. |
RAM | 4 GB, For Deployment in Development environment 8 GB is sufficient. | |
Disk | 120 GB ~ 512GB | |
Networks | 1 |
MEP Edge NodeMEC Host(s) | |
---|---|
HW Aspect | Requirements |
# of Node(s) | 1 MEP Edge NodeMEC Host |
# of CPU | 4 |
Architecture | Minimum 1 socket x86_AMD64 or ARM64. |
RAM1 GB, | For Deployment in Development environment 4 GB is sufficient. |
Disk | 20 GB ~ 256 GB |
Network | 1 |
...
Note: The above specifications are given considering the EALTEdge CI / CD environment. User can try lower configuration considering lightweight components being used.
Recommended Hardware Requirements
MECM | |
---|---|
HW Aspect | Requirements |
# of Node(s) | A |
virtual machine hosted in any Cloud Provider having internet connectivity. |
# of CPU |
8 | |
Architecture | x86_AMD64 or ARM64 |
. | |
RAM | 8 |
GB | |
Disk | 120 GB ~ 512GB |
Networks |
1 |
MEC Host(s) |
---|
HW Aspect | Requirements |
# of Node(s) | 1 |
MEC Host |
# of CPU |
4 | |
Architecture | x86_AMD64 or ARM64 |
. |
RAM |
4 GB | |
Disk | 20 GB ~ |
256 GB |
Network | 1 |
Software Prerequisites
- 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 MEP MEC Host Nodes
- root user created in the Deployment Node, MEC Node and MEP 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.12) installed in Jump Host, required for CLI.
Database Prerequisites
Schema scripts
N/A
Other Installation Requirements
Jump Host Requirements
Network Requirements
- Internet connectivity in Jump Host, MECM and MEP NodesMEC Hosts.
- The MECM Master Node and MEP Master Node should be able to ping each other.
Bare Metal Node Requirements
N/A
Execution Requirements (Bare Metal Only)
N/A
Installation High-Level Overview
The blueprint provides single command and command line interface for installing the EALT EALTEdge blueprint components.
Bare Metal Deployment Guide
Install Bare Metal Jump Host
Note: EALTEdge Blueprint Deployment has been tested on Huawei Cloud Virtual Machines and is not tested on Bare-Metal Environment.
Though theoretically scripts deployment should run successfully in bare metal too provided hardware and software prerequisites are met.
Creating a Node Inventory File
N/A
Creating the Settings Files
N/A
Running
N/A
Virtual Deployment Guide
For Virtual Deployment minimum three Virtual machines, following are the virtual machines and their usage
No | Usage |
---|---|
1 | Jump Host (One Click Deployment Node) |
2 | MECM (Controller) |
3 | MEP MEC Host (Edge) |
All the nodes should have internet connectivity , network interface and network connectivity between the VM's.
In this release providing two ways to install the EALT EALTEdge environment.
i) EALT EALTEdge Deployment using Ansible-Playbook single command.
ii) EALT EALTEdge Deployment using CLI
Standard Deployment Overview
Jump Host Software Installations:
Login to the Jump Host and perform the below steps:
- Install Ansible > 2.5.[ https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html]
- Install git
- Install GoLang > 1.12
- Git clone the Kubespray repo. [https://github.com/kubernetes-sigs/kubespray.git]
- Install python3 and pip3
- cd kubespray && pip install -r requirements.txt
Jump Host Pre-Configurations for MECM Components Installation
Login to the Jump Host and perform the below configuration steps (Steps :
...
cat inventory/mycluster/group_vars/all/all.yml
cat inventory/mycluster/group_vars/k8s-cluster/k8s-cluster.yml
Installing Mode :
...
EALTEdge using Ansible-Playbooks
1. git clone the ealt-edge repo, to download the software to install the EALT EnvironmentEALTEdge Environment.
root@akraino-mec-0002:~# git clone "https://gerrit.akraino.org/r/ealt-edge"
...
3. Modify the Configuration File : ealt-inventory.ini with the details of MECM and MEP NodesMEC Hosts.
root@akraino-mec-0002:~# vi ealt-inventory.ini
...
Once the execution is completed in console will see prompt "EALT EALTEdge Environment Installed , Components Install MECM and MEP Nodes MEC Hosts Successfully"
Other Options:
...
root@akraino-mec-0002:~# ansible-playbook ealt-all.yml -i ealt-inventory.ini --tags "mecm" --extra-vars "operation=install"
To Install only MEP NodeMEC Host
root@akraino-mec-0002:~# ansible-playbook ealt-all.yml -i ealt-inventory.ini --tags "mep" --extra-vars "operation=install"
Installing Mode :
...
EALTEdge using CLI
1. git clone the ealt-edge repo, to download the software to install the EALT EALTEdge Environment.
root@akraino-mec-0002:~# git clone "https://gerrit.akraino.org/r/ealt-edge"
...
3. Edit the Configuration File : ealt-inventory.ini with the details of MECM and MEP NodesMEC Hosts.
root@akraino-mec-0002:~#vi ealt-inventory.ini
4. Execute the below command to install EALT EALTEdge Environment
root@akraino-mec-0002:~#ealt init all
...
Following packages will be installed in the cluster in the respective nodes:-
MECM
...
Docker
...
AppLCM
...
Code is part of Akraino Code Repo.
Includes Broker, Helm Plugin and Catalog
MEP
...
Mozilla Public License 2.0
...
Deploying Application Packages : Using CLI
Precondition : The EALT Environment should be installed. One MECM and one MEP Node atleast.
Pre-configuration : Need to set the below parameters as environment variables on VM where EALT CLI is being installed.
export ONBOARDPACKAGEPATH= <Path where Application CSAR Package is kept in the Node where CLI is running>
export MECMClusterIP=<IP of MECM Node> #IP of Node where MECM is installed.
export MECMClusterPort=30001 #(Node Port of applcm service running on MECM)
Command Supported:-
Application Package Management CLI Commands:
- Package On Boarding : root@akraino-mec-0002:~#ealt app create -f "sample_app.csar "
- Package Info Query: root@akraino-mec-0002:~#ealt app info -i "<package id number>"
- Package Delete: root@akraino-mec-0002:~#ealt app delete -i "<package id number>"
Application Life Cycle Management CLI Commands:
- Application Instance Creation on MEP Node: root@akraino-mec-0002:~#ealt applcm create -i appdid "<id>" -n "<name>" -d "<description>"
- To start the application instance on MEP Node: root@akraino-mec-0002:~#ealt applcm start -i appid "<id>" -n "<hostname>" -o "<hostip>"
- To get the application instance details : root@akraino-mec-0002:~#ealt applcm info -i appid "<id>"
- To terminate the application instance: root@akraino-mec-0002:~#ealt applcm kill -i appid "<id>"
- To delete the application on MEP Node: root@akraino-mec-0002:~#ealt applcm delete -i appid "<id>"
Snapshot Deployment Overview
Not Applicable
Special Requirements for Virtual Deployments
N/A
Install Jump Host
N/A
Verifying the Setup - VM's
N/A
Upstream Deployment Guide
Upstream Deployment Key Features
N/A
Special Requirements for Upstream Deployments
N/A
Scenarios and Deploy Settings for Upstream Deployments
N/A
Including Upstream Patches with Deployment
N/A
Running
N/A
Interacting with Containerized Overcloud
N/A
Verifying the Setup
Verifying EALT Deployment
Currently the verification is manually done.
- Login to the MECM Node and check whether K8S cluster is installed.
- Check grafana and AppLCM services are running as PODS.
- Login to MEP Node and check K3S is installed.
Developer Guide and Troubleshooting
Uninstall Guide
Using Ansible Playbooks
...
: Docker, Kubernetes , Helm, Grafana, Calico, PostgresSQL and AppLCM.
MEC Host: Docker, K3S, Helm, RabbitMQ, Prometheus, CAdvisor, Kong, Vault, Cert-Manager , PostgresSQL, MEP Server and MEP Agent.
Deploying Application Packages : Using CLI
Precondition : The EALTEdge Environment should be installed. One MECM and one MEC Host atleast.
Pre-configuration : Need to set the below parameters as environment variables on VM where EALTEdge CLI is being installed.
export ONBOARDPACKAGEPATH= <Path where Application CSAR Package is kept in the Node where CLI is running>
export MECMClusterIP=<IP of MECM Node> #IP of Node where MECM is installed.
export MECMClusterPort=30001 #(Node Port of applcm service running on MECM)
Command Supported:-
Application Package Management CLI Commands:
- Package On Boarding : root@akraino-mec-0002:~#ealt app create -f "sample_app.csar "
- Package Info Query: root@akraino-mec-0002:~#ealt app info -i "<package id number>"
- Package Delete: root@akraino-mec-0002:~#ealt app delete -i "<package id number>"
Application Life Cycle Management CLI Commands:
- Application Instance Creation on MEC Host: root@akraino-mec-0002:~#ealt applcm create -i appdid "<id>" -n "<name>" -d "<description>"
- To start the application instance on MEC Host: root@akraino-mec-0002:~#ealt applcm start -i appid "<id>" -n "<hostname>" -o "<hostip>"
- To get the application instance details : root@akraino-mec-0002:~#ealt applcm info -i appid "<id>"
- To terminate the application instance: root@akraino-mec-0002:~#ealt applcm kill -i appid "<id>"
- To delete the application on MEC Host: root@akraino-mec-0002:~#ealt applcm delete -i appid "<id>"
Snapshot Deployment Overview
Not Applicable
Special Requirements for Virtual Deployments
N/A
Install Jump Host
N/A
Verifying the Setup - VM's
N/A
Upstream Deployment Guide
Upstream Deployment Key Features
N/A
Special Requirements for Upstream Deployments
N/A
Scenarios and Deploy Settings for Upstream Deployments
N/A
Including Upstream Patches with Deployment
N/A
Running
N/A
Interacting with Containerized Overcloud
N/A
Verifying the Setup
Verifying EALTEdge Deployment
Currently the verification is manually done.
- Login to the MECM Node and check whether K8S cluster is installed.
- Check grafana and AppLCM services are running as PODS.
- Login to MEC Host and check K3S is installed.
Developer Guide and Troubleshooting
Uninstall Guide
Using Ansible Playbooks
root@akraino-mec-0002:~#ansible-playbook ealt-all-uninstall.yml -i ealt-inventory.ini --extra-vars "operation=uninstall"
root@akraino-mec-0002:~#ansible-playbook ealt-all-uninstall.yml -i ealt-inventory.ini --tags "infra" --extra-vars "operation=uninstall"
root@akraino-mec-0002:~#ansible-playbook ealt-all-uninstall.yml -i ealt-inventory.ini --tags "mecm" --extra-vars "operation=uninstall"
root@akraino-mec-0002:~#ansible-playbook ealt-all-uninstall.yml -i ealt-inventory.ini --tags "mep" --extra-vars "operation=uninstall"
Using CLI
root@akraino-mec-0002:~#ealt clean all
root@akraino-mec-0002:~#ealt clean mecm
root@akraino-mec-0002:~#ealt clean mep
Troubleshooting
Error Message Guide
N/A
Maintenance
Blueprint Package Maintenance
Software maintenance
N/A
Hardware maintenance
N/A
Blueprint Deployment Maintenance
N/A
Frequently Asked Questions
N/A
License
Any software developed by the "Akraino Enterprise Applications on Lightweight 5G Telco Edge Project is licensed under the
Apache License, Version 2.0 (the "License");
you may not use the content of this software bundle except in compliance with the License.
You may obtain a copy of the License at <https://www.apache.org/licenses/LICENSE-2.0>
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
License information of EALTEdge Blueprint Components
MECM
S. No | Software | Type | Version | License | Remarks |
1. | Docker | CRI | 18.06 | Apache 2.0 license | |
2. | Kubernetes | Orchestration | 1.16 | Apache 2.0 license | |
3. | Helm | Application Package Manager | 3.0.2 | Apache 2.0 license | |
4. | Grafana | Monitoring | 8-7.66.0 | Apache 2.0 license | |
5. | Calico | CNI Plugin | 3.14.0 | Apache 2.0 license | |
6. | PostgresSQL | DB | 9.6 | PostgreSQL License | |
7. | AppLCM | MECM-Service | 1.0 | Apache 2.0 license | Code is part of Akraino Code Repo. Includes Broker, Helm Plugin and Catalog |
MEC Host
S. No | Software | Type | Version | License Information | Remarks |
1. | Docker | CRI | 19.03 | Apache 2.0 license | |
2. | K3S | Orchestration | 1.18.2 | Apache 2.0 license | |
3. | Helm | Application Package Manager | 3.0.2 | Apache 2.0 license | |
4. | cAdvisor | Container Metrics | v0.36.0 | Apache 2.0 license | |
5 | RabbitMQ | Message Broker | 3.7 | Mozilla Public License | |
6 | Prometheus | Metrics Collector | 9.3.1 | Apache 2.0 license | Internally its installing following metrics exporter NodeExporter, alertManager, kubeStateMetrics, pushgateway |
7 | Kong | API Gateway | 1.5.1 | Apache 2.0 license | |
8 | Vault | Secret Management | 0.5.0 | Mozilla Public License 2.0 | |
9 | Cert-Manager | Certificate Management | 0.15.0 | Apache 2.0 license | |
10. | Postgres SQL | Database | 9.6 | PostgreSQL License | |
10 | MEP Server | EALTEdge MEP Platform Service | 1.0 | Apache 2.0 license | Code is part of Akraino Code Repository. |
11 | MEP Agent | EALTEdge MEP Agent Library | 1.0 | Apache 2.0 license | Code is part of Akraino Code Repository. |
Using CLI
root@akraino-mec-0002:~#ealt clean all
root@akraino-mec-0002:~#ealt clean mecm
root@akraino-mec-0002:~#ealt clean mep
Troubleshooting
Error Message Guide
N/A
Maintenance
Blueprint Package Maintenance
Software maintenance
N/A
Hardware maintenance
N/A
Blueprint Deployment Maintenance
N/A
Frequently Asked Questions
N/A
License
Any software developed by the "Akraino Enterprise Applications on Lightweight 5G Telco Edge Project is licensed under the
Apache License, Version 2.0 (the "License");
you may not use the content of this software bundle except in compliance with the License.
You may obtain a copy of the License at <https://www.apache.org/licenses/LICENSE-2.0>
...
References
Definitions, acronyms and abbreviations
Abbreviations
- EALTEdge - Enterpreise Enterprise Application on Lightweight 5G Telco Edge (EALTEdge).
- MECM - Mobile Multi Access Edge Controller ManagerComputing Manager.
- MEC - Multi Access Edge Computing.
- MEP - Mobile Multi Access Edge Platform.