Skip to content
This repository has been archived by the owner on Apr 25, 2024. It is now read-only.

Commit

Permalink
Configure network using the NMS
Browse files Browse the repository at this point in the history
  • Loading branch information
Gmerold committed Oct 17, 2023
1 parent d2c05e5 commit 043f502
Show file tree
Hide file tree
Showing 5 changed files with 21 additions and 97 deletions.
Binary file added docs/images/configure_5g_network.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/create_subscriber.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/network_configured.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/tutorial/02_deploy_sdcore.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ juju deploy sdcore-router router --trust --channel=edge
Create a file called `overlay.yaml` in your current working directory and place the following
content in it:

```yaml
```{code-block} yaml
:caption: overlay.yaml
applications:
traefik-k8s:
Expand Down
116 changes: 20 additions & 96 deletions docs/tutorial/03_configure_sdcore.md
Original file line number Diff line number Diff line change
@@ -1,109 +1,33 @@
# 3. Configure SD-Core

Configuring the 5G core network is done making HTTP requests to the `webui` service. Here we will
create a subscriber, a device group and a network slice.
Configuration of the 5G core network is done using the NMS (Network Management System) graphical
interface. Here we will create a subscriber, a device group and a network slice.

Run `juju status` and note the IP address next to the `webui` unit.
Access the NMS at `https://<model name>-nms.<your hostname>` and click on the `Configure` button
and create a new network with MCC of `208` and MNC of `93`:

```console
ubuntu@host:~$ juju status
Model Controller Cloud/Region Version SLA Timestamp
core microk8s-localhost microk8s/localhost 3.1.2 unsupported 11:55:31-04:00

App Version Status Scale Charm Channel Rev Address Exposed Message
[...]
webui active 1 sdcore-webui edge 5 10.152.183.128 no

Unit Workload Agent Address Ports Message
[...]
webui/0* active idle 10.1.19.189
```

```{note}
Here the address is `10.1.19.189`, yours will likely be different. Make sure to replace it in
the next command.
```{image} ../images/configure_5g_network.png
:alt: Create 5G network
:align: center
```

Export your `webui` IP address to a variable:
Create a new subscriber using following values:

```console
export WEBUI_IP="10.1.19.189"
```text
IMSI: 208930100007487
OPC: 981d464c7c52eb6e5036234984ad0bcf
Key: 5122250214c33e723a5dd523fc145fc0
Sequence Number: 16f3b3f70fc2
```

Create a new subscriber:

```console
curl -v ${WEBUI_IP}:5000/api/subscriber/imsi-208930100007487 \
--header 'Content-Type: text/plain' \
--data '{
"UeId":"208930100007487",
"plmnId":"20801",
"opc":"981d464c7c52eb6e5036234984ad0bcf",
"key":"5122250214c33e723a5dd523fc145fc0",
"sequenceNumber":"16f3b3f70fc2"
}'
```

Create a new device group named "cows" that contains the newly created subscriber:

```console
curl -v ${WEBUI_IP}:5000/config/v1/device-group/cows \
--header 'Content-Type: application/json' \
--data '{
"imsis": [
"208930100007487"
],
"site-info": "demo",
"ip-domain-name": "pool1",
"ip-domain-expanded": {
"dnn": "internet",
"ue-ip-pool": "172.250.1.0/16",
"dns-primary": "8.8.8.8",
"mtu": 1460,
"ue-dnn-qos": {
"dnn-mbr-uplink": 20000000,
"dnn-mbr-downlink": 200000000,
"traffic-class": {
"name": "platinum",
"arp": 6,
"pdb": 300,
"pelr": 6,
"qci": 8
}
}
}
}'
```{image} ../images/create_subscriber.png
:alt: Create subscriber
:align: center
```

Create a network slice called "default" that contains the "cows" device group:
Final result should look like below:

```console
curl -v ${WEBUI_IP}:5000/config/v1/network-slice/default \
--header 'Content-Type: application/json' \
--data '{
"slice-id": {
"sst": "1",
"sd": "010203"
},
"site-device-group": [
"cows"
],
"site-info": {
"site-name": "demo",
"plmn": {
"mcc": "208",
"mnc": "93"
},
"gNodeBs": [
{
"name": "demo-gnb1",
"tac": 1
}
],
"upf": {
"upf-name": "upf-external",
"upf-port": "8805"
}
}
}'
```{image} ../images/network_configured.png
:alt: Properly configured 5G network
:align: center
```

0 comments on commit 043f502

Please sign in to comment.