Commit c8fe304b authored by arora's avatar arora 🎤
Browse files

updated the docker hub image section

parent 8b2a34dc
......@@ -22,7 +22,7 @@ services:
ipv4_address: 192.168.70.131
oai-amf:
container_name: "oai-amf"
image: oai-amf:v1.1.0
image: rdefosseoai/oai-amf:latest
environment:
- TZ=Europe/paris
- INSTANCE=0
......@@ -87,7 +87,7 @@ services:
ipv4_address: 192.168.70.132
oai-smf:
container_name: "oai-smf"
image: oai-smf:v1.1.0
image: rdefosseoai/oai-smf:latest
environment:
- TZ=Europe/Paris
- INSTANCE=0
......@@ -130,7 +130,7 @@ services:
ipv4_address: 192.168.70.133
oai-spgwu:
container_name: "oai-spgwu"
image: oai-spgwu-tiny:v1.1.0
image: rdefosseoai/oai-spgwu-tiny:latest
environment:
- TZ=Europe/Paris
- PID_DIRECTORY=/var/run
......@@ -200,4 +200,4 @@ networks:
# config:
# - subnet: 192.168.70.128/26
# driver_opts:
# com.docker.network.bridge.name: "demo-oai"
# com.docker.network.bridge.name: "demo-oai"
\ No newline at end of file
......@@ -2,7 +2,7 @@ version: '3.8'
services:
oai-nrf:
container_name: "oai-nrf"
image: oai-nrf:v1.1.0
image: rdefosseoai/oai-nrf:latest
environment:
- NRF_INTERFACE_NAME_FOR_SBI=eth0
- NRF_INTERFACE_PORT_FOR_SBI=80
......@@ -42,7 +42,7 @@ services:
ipv4_address: 192.168.70.131
oai-amf:
container_name: "oai-amf"
image: oai-amf:v1.1.0
image: rdefosseoai/oai-amf:latest
environment:
- TZ=Europe/paris
- INSTANCE=0
......@@ -107,7 +107,7 @@ services:
ipv4_address: 192.168.70.132
oai-smf:
container_name: "oai-smf"
image: oai-smf:v1.1.0
image: rdefosseoai/oai-smf:latest
environment:
- TZ=Europe/Paris
- INSTANCE=0
......@@ -150,7 +150,7 @@ services:
ipv4_address: 192.168.70.133
oai-spgwu:
container_name: "oai-spgwu"
image: oai-spgwu-tiny:v1.1.2
image: rdefosseoai/oai-spgwu-tiny:latest
environment:
- TZ=Europe/Paris
- PID_DIRECTORY=/var/run
......
......@@ -78,7 +78,7 @@ git submodule update
## 1.2. You are interested on the latest features. ##
All the latest features are somehow pushed to the `develop` branches of each cNF repository.
All the latest features are somehow pushed to the `develop` branches of each NF repository.
It means that we/you are able to build and the Continuous Integration test suite makes sure it
does NOT break any existing tested feature.
......
......@@ -138,4 +138,11 @@ components. To capture initial message exchange between smf<-->nrf<-->upf.
455631b3749c demo-oai-public-net bridge local
```
- If the `docker-compose-host` machine is not configured with packet forwarding then it can be done using below command,
```bash
(docker-compose-host)$ sudo sysctl net.ipv4.conf.all.forwarding=1
sudo iptables -P FORWARD ACCEPT
```
You are ready to check out the tutorial that [how 5g core works](./DEPLOY_SA5G_WITH_DS_TESTER.md).
......@@ -12,6 +12,7 @@
</tr>
</table>
Welcome to the tutorial home page of OAI 5g Core project. Here you can find lot of tutorials and help manuals. We regularly update these documents depending on the new feature set.
**Table of Contents**
......
......@@ -48,7 +48,7 @@ $ docker info
# 2. Create an account on Docker Hub #
Go to [https://hub.docker.com/](https://hub.docker.com/) website and create an account.
Go to [docker-hub](https://hub.docker.com/) and create an account.
# 3. Pull base images #
......@@ -65,7 +65,7 @@ Username:
Password:
```
Then pull base images.
All the network functions are using the same base image Ubuntu 18.04. If you want to build image of each network function then pull the base image, else you can pull the network function images from [rdefosseoai docker-hub](https://hub.docker.com/r/rdefosseoai)
On a Ubuntu18.04 host:
......@@ -74,6 +74,15 @@ $ docker pull ubuntu:bionic
$ docker pull mysql/mysql-server:5.7
```
```bash
$ docker pull rdefosseoai/oai-amf
$ docker pull rdefosseoai/oai-nrf
$ docker pull rdefosseoai/oai-spgwu-tiny
$ docker pull rdefosseoai/oai-smf
```
Finally you may logoff --> your token is stored in plain text..
```bash
......@@ -138,4 +147,4 @@ $ docker network inspect bridge
....
```
You are ready to [build the images](./BUILD_IMAGES.md).
You are ready to [build the network function images](./BUILD_IMAGES.md) in case you didn't pull them in previous steps.
\ No newline at end of file
......@@ -17,17 +17,17 @@
This tutorial will help in understanding how to deploy OAI core network using docker-compose. In this tutorial we have used [dsTest](https://www.developingsolutions.com/products/dstest-5g-core-network-testing/) a commercial paid gNB emulator. Though instead of this readers can also use gNBsim (an opensource gNB emulator), you can follow another tutorial for [this](./DEPLOY_SA5G_WITH_GNBSIM.md). Please follow the tutorial step by step to create a stable testbed.
This tutorial will help in understanding how to deploy OAI core network using docker-compose. In this tutorial we have used [dsTest](https://www.developingsolutions.com/products/dstest-5g-core-network-testing/) a commercial paid gNB emulator. Though instead of this readers can also use gNBsim (an opensource gNB emulator), you can follow another tutorial for [this](./DEPLOY_SA5G_WITH_GNBSIM.md). Please follow the tutorial step by step to create a stable working testbed.
Reading time: 20mins
Tutorial replication time: 1hr
**Reading time: ~20mins**
**Tutorial replication time: ~1hr**
Note: In case readers are interested in deploying debuggers/developers core network environment with more logs please follow [this tutorial](./DEBUG_5G_CORE.md)
**TABLE OF CONTENTS**
1. [Pre-requisites](#1-pre-requisites)
2. [Building Container Images](#2-building-container-images)
2. [Network Function Container Images](#2-network-function-container-images)
3. [Configuring Host Machines](#3-configuring-host-machines)
4. [Configuring OAI 5G Core Network Functions](#4-configuring-the-oai-5g-core-network-functions)
5. [Configuring dsTest Scenario](#5-configuring-dstester-scenario)
......@@ -50,17 +50,34 @@ The requried softwares and their respected versions are listed below. To replica
| docker-compose | 1.27.4, build 40524192 |
| Host operating system | Ubuntu 18.04.4 LTS |
| Container operating system | Ubuntu 18.04 |
| dsTest (Licensed) | 5.6 |
| dsTest (Licensed) | 5.5 |
| tshark | 3.4.4 (Git commit c33f6306cbb2) |
| wireshark | 3.4.4 (Git commit c33f6306cbb2) |
The new version of `wireshark` may not be available in the ubuntu repository so it is better to build it from source.
To know how to configure the machine with the above requirements vist [pre-requisites](./DEPLOY_PRE_REQUESITES.md) page.
Most of the times the `docker-compose-host` machine is not configured with packet forwarding then it can be done using below command (if you have already done it in any other section then don't repeat). This is the most important step towards end to end connectivity.
## 2. Building Container Images ##
```bash
(docker-compose-host)$ sudo sysctl net.ipv4.conf.all.forwarding=1
sudo iptables -P FORWARD ACCEPT
```
To know how to configure the machine with the above requirements vist [pre-requisites](./DEPLOY_PRE_REQUESITES.md) page.
## 2. Network Function Container Images ##
- In this demo the image tags which were used are listed below, follow the [Building images](./BUILD_IMAGES.md) to build images with below tags.
- This step can be skip and the images can be pulled from docker-hub, in case there is a problem in pulling the images due to docker limit then readers can build images.
- **NOTE**: Currently the [docker-compose-file](./docker-compose/docker-compose.yml) is configured for pulling images from docker-hub. In you case you build images please change the image-tag accordingly
```bash
(docker-compose-host)$ docker pull rdefosseoai/oai-amf
(docker-compose-host)$ docker pull rdefosseoai/oai-nrf
(docker-compose-host)$ docker pull rdefosseoai/oai-spgwu-tiny
(docker-compose-host)$ docker pull rdefosseoai/oai-smf
```
- In this demo the network function branch and tags which were used are listed below, follow the [Building images](./BUILD_IMAGES.md) to build images with below tags.
| CNF Name | Branch Name | Tag | Ubuntu 18.04 | RHEL8 (UBI8) |
| ----------- | ----------- | -------- | ------------ | ----------------|
......@@ -69,12 +86,28 @@ To know how to configure the machine with the above requirements vist [pre-requi
| NRF | `master` | `v1.1.0` | X | X |
| SPGW-U-TINY | `master` | `v1.1.2` | X | X |
- In case readers are interested in making images using different branch then **they have to build images from scratch they can't use the docker-hub images**.
## 3. Configuring Host Machines ##
All the network functions are connected using `demo-oai-net` bridge. There are two ways to create this bridge either manually or automatically using docker-compose. The manual version will allow packet capturing while network functions are getting deployed. So the initial tested setup packets can be captured for debugging purposes or checking if network functions registered properly to nrf. The second option of automatic deployment is good when initial packet capture is not important.
### 3.1 Creating bridge manually
- Make sure that the below line is commented in [docker-compose file](./docker-compose/docker-compose.yml) and uncomment the line above this,
```
networks:
public_net:
driver: bridge
name: demo-oai-net
ipam:
config:
- subnet: 192.168.70.128/26
driver_opts:
com.docker.network.bridge.name: "demo-oai"
```
- The `docker-compose-host` machine needs to be configured with `demo-oai-net` bridge before deploying core network components. To capture initial message exchange between smf<-->nrf<-->upf.
```bash
......@@ -114,7 +147,7 @@ All the network functions are connected using `demo-oai-net` bridge. There are t
com.docker.network.bridge.name: "demo-oai"
```
- If the `docker-compose-host` machine is not configured with packet forwarding then it can be done using below command,
- If the `docker-compose-host` machine is not configured with packet forwarding then it can be done using below command (important step),
```bash
(docker-compose-host)$ sudo sysctl net.ipv4.conf.all.forwarding=1
......@@ -393,4 +426,4 @@ Using wireshark open scenario-execution.pcap use the filter ngap || http || pfcp
docker-compose -f <file-name> -p <project-name> ps -a
#To stop the containers
docker-compose -f <file-name> -p <project-name> down
```
```
\ No newline at end of file
......@@ -14,8 +14,8 @@
![SA dsTest Demo](./images/5gCN_gnbsim.jpg)
Reading time: 20mins
Tutorial replication time: 1hr
**Reading time: ~ 30mins**
**Tutorial replication time: ~ 1h30mins**
Note: In case readers are interested in deploying debuggers/developers core network environment with more logs please follow [this tutorial](./DEBUG_5G_CORE.md)
......
......@@ -14,8 +14,8 @@
![SA dsTest Demo](./images/5gcn_vpp_upf.jpg)
Reading time: 20mins
Tutorial replication time: 1hr
**Reading time: ~ 30mins**
**Tutorial replication time: ~ 1h30mins**
Note: In case readers are interested in deploying debuggers/developers core network environment with more logs please follow [this tutorial](./DEBUG_5G_CORE.md)
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment