Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
O
OpenXG-RAN
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Analytics
Analytics
CI / CD
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
zzha zzha
OpenXG-RAN
Commits
0700d5d0
Commit
0700d5d0
authored
2 years ago
by
luis_pereira87
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add 5G SA end-to-end, step-by-step, tutorials for OAI CN5G, OAI gNB and COTS UE
parent
50916825
Branches unavailable
2024.w06
2024.w05
2024.w04
2024.w03
2024.w02
2024.w01
2023.w51
2023.w50
2023.w49
2023.w48
2023.w47
2023.w45
2023.w43
2023.w42
2023.w41
2023.w40
2023.w39
2023.w38
2023.w37
2023.w36
2023.w34
2023.w33
2023.w32
2023.w31
2023.w30
2023.w29
2023.w28
2023.w27
2023.w26
2023.w25
2023.w24
2023.w23
2023.w22
2023.w21
2023.w20
2023.w19
2023.w18
2023.w18b
2023.w16
2023.w15
2023.w14
2023.w13
2023.w12
2023.w11
2023.w11b
2023.w10
2023.w10b
2023.w09
2023.w08
2023.w08b
2023.w07
2023.w06
2023.w05
2023.w03
2023.w02
2022.42
2022.41
2022.w51
2022.w50
2022.w49
2022.w48
2022.w47
2022.w46
2022.w45
2022.w43
2022.w42
2022.w42b
2022.w41
2022.w40
2022.w39
2022.w38
2022.w37
2022.w37b
2022.w36
2022.w35
2022.w33
2022.w32
2022.w31
2022.w31b
2022.w30
v2.1.0
v2.0.0
flexran-eol
No related merge requests found
Changes
4
Expand all
Show whitespace changes
Inline
Side-by-side
Showing
4 changed files
with
107 additions
and
39 deletions
+107
-39
doc/NR_SA_CN5G_gNB_B210_COTS_UE_Tutorial.md
doc/NR_SA_CN5G_gNB_B210_COTS_UE_Tutorial.md
+9
-5
doc/NR_SA_CN5G_gNB_N300_COTS_UE_Tutorial.md
doc/NR_SA_CN5G_gNB_N300_COTS_UE_Tutorial.md
+9
-5
doc/tutorial_resources/docker-compose-basic-nrf.yaml
doc/tutorial_resources/docker-compose-basic-nrf.yaml
+70
-26
doc/tutorial_resources/oai_db.sql
doc/tutorial_resources/oai_db.sql
+19
-3
No files found.
doc/NR_SA_CN5G_gNB_B210_COTS_UE_Tutorial.md
View file @
0700d5d0
...
...
@@ -86,6 +86,7 @@ cd ~/oai-cn5g-fed
git checkout master
./scripts/syncComponents.sh
--nrf-branch
develop
--amf-branch
develop
--smf-branch
develop
--spgwu-tiny-branch
develop
--ausf-branch
develop
--udm-branch
develop
--udr-branch
develop
--upf-vpp-branch
develop
--nssf-branch
develop
# Pull docker images
docker pull oaisoftwarealliance/oai-amf:develop
docker pull oaisoftwarealliance/oai-nrf:develop
docker pull oaisoftwarealliance/oai-smf:develop
...
...
@@ -95,7 +96,9 @@ docker pull oaisoftwarealliance/oai-ausf:develop
docker pull oaisoftwarealliance/oai-upf-vpp:develop
docker pull oaisoftwarealliance/oai-spgwu-tiny:develop
docker pull oaisoftwarealliance/oai-nssf:develop
docker pull oaisoftwarealliance/trf-gen-cn5g:latest
# Tag docker images
docker image tag oaisoftwarealliance/oai-amf:develop oai-amf:develop
docker image tag oaisoftwarealliance/oai-nrf:develop oai-nrf:develop
docker image tag oaisoftwarealliance/oai-smf:develop oai-smf:develop
...
...
@@ -105,16 +108,17 @@ docker image tag oaisoftwarealliance/oai-ausf:develop oai-ausf:develop
docker image tag oaisoftwarealliance/oai-upf-vpp:develop oai-upf-vpp:develop
docker image tag oaisoftwarealliance/oai-spgwu-tiny:develop oai-spgwu-tiny:develop
docker image tag oaisoftwarealliance/oai-nssf:develop oai-nssf:develop
docker image tag oaisoftwarealliance/trf-gen-cn5g:latest trf-gen-cn5g:latest
```
## 2.3 OAI CN5G Configuration files
Download and copy
the configuration files to ~/oai-cn5g-fed/docker-compose
:
-
[
docker-compose-basic-nrf.yaml
](
tutorial_resources/docker-compose-basic-nrf.yaml
)
-
[
oai_db.sql
](
tutorial_resources/oai_db.sql
)
Download and copy
configuration files
:
-
Copy
[
docker-compose-basic-nrf.yaml
](
tutorial_resources/docker-compose-basic-nrf.yaml
)
to
`~/oai-cn5g-fed/docker-compose`
-
Copy
[
oai_db.sql
](
tutorial_resources/oai_db.sql
)
to
`~/oai-cn5g-fed/docker-compose/database`
Change permissions on oai_db.sql to prevent mysql permission denied error:
```
bash
chmod
644 ~/oai-cn5g-fed/docker-compose/oai_db.sql
chmod
644 ~/oai-cn5g-fed/docker-compose/
database/
oai_db.sql
```
## 2.4 SIM Card
...
...
@@ -175,7 +179,7 @@ cd cmake_targets
```
bash
cd
~/oai-cn5g-fed/docker-compose
python3 core-network.py
--type
start-basic
--
fqdn
yes
--
scenario
1
python3 core-network.py
--type
start-basic
--scenario
1
```
## 4.2 Run OAI gNB
...
...
This diff is collapsed.
Click to expand it.
doc/NR_SA_CN5G_gNB_N300_COTS_UE_Tutorial.md
View file @
0700d5d0
...
...
@@ -87,6 +87,7 @@ cd ~/oai-cn5g-fed
git checkout master
./scripts/syncComponents.sh
--nrf-branch
develop
--amf-branch
develop
--smf-branch
develop
--spgwu-tiny-branch
develop
--ausf-branch
develop
--udm-branch
develop
--udr-branch
develop
--upf-vpp-branch
develop
--nssf-branch
develop
# Pull docker images
docker pull oaisoftwarealliance/oai-amf:develop
docker pull oaisoftwarealliance/oai-nrf:develop
docker pull oaisoftwarealliance/oai-smf:develop
...
...
@@ -96,7 +97,9 @@ docker pull oaisoftwarealliance/oai-ausf:develop
docker pull oaisoftwarealliance/oai-upf-vpp:develop
docker pull oaisoftwarealliance/oai-spgwu-tiny:develop
docker pull oaisoftwarealliance/oai-nssf:develop
docker pull oaisoftwarealliance/trf-gen-cn5g:latest
# Tag docker images
docker image tag oaisoftwarealliance/oai-amf:develop oai-amf:develop
docker image tag oaisoftwarealliance/oai-nrf:develop oai-nrf:develop
docker image tag oaisoftwarealliance/oai-smf:develop oai-smf:develop
...
...
@@ -106,16 +109,17 @@ docker image tag oaisoftwarealliance/oai-ausf:develop oai-ausf:develop
docker image tag oaisoftwarealliance/oai-upf-vpp:develop oai-upf-vpp:develop
docker image tag oaisoftwarealliance/oai-spgwu-tiny:develop oai-spgwu-tiny:develop
docker image tag oaisoftwarealliance/oai-nssf:develop oai-nssf:develop
docker image tag oaisoftwarealliance/trf-gen-cn5g:latest trf-gen-cn5g:latest
```
## 2.3 OAI CN5G Configuration files
Download and copy
the configuration files to ~/oai-cn5g-fed/docker-compose
:
-
[
docker-compose-basic-nrf.yaml
](
tutorial_resources/docker-compose-basic-nrf.yaml
)
-
[
oai_db.sql
](
tutorial_resources/oai_db.sql
)
Download and copy
configuration files
:
-
Copy
[
docker-compose-basic-nrf.yaml
](
tutorial_resources/docker-compose-basic-nrf.yaml
)
to
`~/oai-cn5g-fed/docker-compose`
-
Copy
[
oai_db.sql
](
tutorial_resources/oai_db.sql
)
to
`~/oai-cn5g-fed/docker-compose/database`
Change permissions on oai_db.sql to prevent mysql permission denied error:
```
bash
chmod
644 ~/oai-cn5g-fed/docker-compose/oai_db.sql
chmod
644 ~/oai-cn5g-fed/docker-compose/
database/
oai_db.sql
```
## 2.4 SIM Card
...
...
@@ -193,7 +197,7 @@ The following steps are recommended. Please change the network interface(s) as r
```
bash
cd
~/oai-cn5g-fed/docker-compose
python3 core-network.py
--type
start-basic
--
fqdn
yes
--
scenario
1
python3 core-network.py
--type
start-basic
--scenario
1
```
## 4.2 Run OAI gNB
...
...
This diff is collapsed.
Click to expand it.
doc/tutorial_resources/docker-compose-basic-nrf.yaml
View file @
0700d5d0
This diff is collapsed.
Click to expand it.
doc/tutorial_resources/oai_db.sql
View file @
0700d5d0
...
...
@@ -151,10 +151,13 @@ CREATE TABLE `AuthenticationSubscription` (
--
INSERT
INTO
`AuthenticationSubscription`
(
`ueid`
,
`authenticationMethod`
,
`encPermanentKey`
,
`protectionParameterId`
,
`sequenceNumber`
,
`authenticationManagementField`
,
`algorithmId`
,
`encOpcKey`
,
`encTopcKey`
,
`vectorGenerationInHss`
,
`n5gcAuthMethod`
,
`rgAuthenticationInd`
,
`supi`
)
VALUES
(
'208950000000031'
,
'5G_AKA'
,
'0C0A34601D4F07677303652C0462535B'
,
'0C0A34601D4F07677303652C0462535B'
,
'{
\"
sqn
\"
:
\"
000000000020
\"
,
\"
sqnScheme
\"
:
\"
NON_TIME_BASED
\"
,
\"
lastIndexes
\"
: {
\"
ausf
\"
: 0}}'
,
'8000'
,
'milenage'
,
'63bfa50ee6523365ff14c1f45f88737d'
,
NULL
,
NULL
,
NULL
,
NULL
,
'208950000000031'
);
(
'2089900007487'
,
'5G_AKA'
,
'fec86ba6eb707ed08905757b1bb44b8f'
,
'fec86ba6eb707ed08905757b1bb44b8f'
,
'{
\"
sqn
\"
:
\"
000000000000
\"
,
\"
sqnScheme
\"
:
\"
NON_TIME_BASED
\"
,
\"
lastIndexes
\"
: {
\"
ausf
\"
: 0}}'
,
'8000'
,
'milenage'
,
'C42449363BBAD02B66D16BC975D77CC1'
,
NULL
,
NULL
,
NULL
,
NULL
,
'2089900007487'
);
INSERT
INTO
`AuthenticationSubscription`
(
`ueid`
,
`authenticationMethod`
,
`encPermanentKey`
,
`protectionParameterId`
,
`sequenceNumber`
,
`authenticationManagementField`
,
`algorithmId`
,
`encOpcKey`
,
`encTopcKey`
,
`vectorGenerationInHss`
,
`n5gcAuthMethod`
,
`rgAuthenticationInd`
,
`supi`
)
VALUES
(
'208990000000001'
,
'5G_AKA'
,
'fec86ba6eb707ed08905757b1bb44b8f'
,
'fec86ba6eb707ed08905757b1bb44b8f'
,
'{
\"
sqn
\"
:
\"
000000000000
\"
,
\"
sqnScheme
\"
:
\"
NON_TIME_BASED
\"
,
\"
lastIndexes
\"
: {
\"
ausf
\"
: 0}}'
,
'8000'
,
'milenage'
,
'C42449363BBAD02B66D16BC975D77CC1'
,
NULL
,
NULL
,
NULL
,
NULL
,
'208990000000001'
);
INSERT
INTO
`AuthenticationSubscription`
(
`ueid`
,
`authenticationMethod`
,
`encPermanentKey`
,
`protectionParameterId`
,
`sequenceNumber`
,
`authenticationManagementField`
,
`algorithmId`
,
`encOpcKey`
,
`encTopcKey`
,
`vectorGenerationInHss`
,
`n5gcAuthMethod`
,
`rgAuthenticationInd`
,
`supi`
)
VALUES
(
'208990000000001'
,
'5G_AKA'
,
'fec86ba6eb707ed08905757b1bb44b8f'
,
'fec86ba6eb707ed08905757b1bb44b8f'
,
'{
\"
sqn
\"
:
\"
000000000020
\"
,
\"
sqnScheme
\"
:
\"
NON_TIME_BASED
\"
,
\"
lastIndexes
\"
: {
\"
ausf
\"
: 0}}'
,
'8000'
,
'milenage'
,
'C42449363BBAD02B66D16BC975D77CC1'
,
NULL
,
NULL
,
NULL
,
NULL
,
'208990000000001'
);
(
'208990000000002'
,
'5G_AKA'
,
'fec86ba6eb707ed08905757b1bb44b8f'
,
'fec86ba6eb707ed08905757b1bb44b8f'
,
'{
\"
sqn
\"
:
\"
000000000000
\"
,
\"
sqnScheme
\"
:
\"
NON_TIME_BASED
\"
,
\"
lastIndexes
\"
: {
\"
ausf
\"
: 0}}'
,
'8000'
,
'milenage'
,
'C42449363BBAD02B66D16BC975D77CC1'
,
NULL
,
NULL
,
NULL
,
NULL
,
'208990000000002'
);
INSERT
INTO
`AuthenticationSubscription`
(
`ueid`
,
`authenticationMethod`
,
`encPermanentKey`
,
`protectionParameterId`
,
`sequenceNumber`
,
`authenticationManagementField`
,
`algorithmId`
,
`encOpcKey`
,
`encTopcKey`
,
`vectorGenerationInHss`
,
`n5gcAuthMethod`
,
`rgAuthenticationInd`
,
`supi`
)
VALUES
(
'208990000000003'
,
'5G_AKA'
,
'fec86ba6eb707ed08905757b1bb44b8f'
,
'fec86ba6eb707ed08905757b1bb44b8f'
,
'{
\"
sqn
\"
:
\"
000000000000
\"
,
\"
sqnScheme
\"
:
\"
NON_TIME_BASED
\"
,
\"
lastIndexes
\"
: {
\"
ausf
\"
: 0}}'
,
'8000'
,
'milenage'
,
'C42449363BBAD02B66D16BC975D77CC1'
,
NULL
,
NULL
,
NULL
,
NULL
,
'208990000000003'
);
-- --------------------------------------------------------
...
...
@@ -203,6 +206,19 @@ CREATE TABLE `SessionManagementSubscriptionData` (
`3gppChargingCharacteristics`
varchar
(
50
)
DEFAULT
NULL
)
ENGINE
=
InnoDB
DEFAULT
CHARSET
=
utf8
;
--
-- Dumping data for table `SessionManagementSubscriptionData`
--
INSERT
INTO
`SessionManagementSubscriptionData`
(
`ueid`
,
`servingPlmnid`
,
`singleNssai`
,
`dnnConfigurations`
)
VALUES
(
'2089900007487'
,
'20899'
,
'{
\"
sst
\"
: 1,
\"
sd
\"
:
\"
1
\"
}'
,
'{
\"
oai
\"
:{
\"
pduSessionTypes
\"
:{
\"
defaultSessionType
\"
:
\"
IPV4
\"
},
\"
sscModes
\"
: {
\"
defaultSscMode
\"
:
\"
SSC_MODE_1
\"
},
\"
5gQosProfile
\"
: {
\"
5qi
\"
: 6,
\"
arp
\"
:{
\"
priorityLevel
\"
: 1,
\"
preemptCap
\"
:
\"
NOT_PREEMPT
\"
,
\"
preemptVuln
\"
:
\"
NOT_PREEMPTABLE
\"
},
\"
priorityLevel
\"
:1},
\"
sessionAmbr
\"
:{
\"
uplink
\"
:
\"
1000Mbps
\"
,
\"
downlink
\"
:
\"
1000Mbps
\"
},
\"
staticIpAddress
\"
:[{
\"
ipv4Addr
\"
:
\"
12.1.1.2
\"
}]}}'
);
INSERT
INTO
`SessionManagementSubscriptionData`
(
`ueid`
,
`servingPlmnid`
,
`singleNssai`
,
`dnnConfigurations`
)
VALUES
(
'208990000000001'
,
'20899'
,
'{
\"
sst
\"
: 1,
\"
sd
\"
:
\"
1
\"
}'
,
'{
\"
oai
\"
:{
\"
pduSessionTypes
\"
:{
\"
defaultSessionType
\"
:
\"
IPV4
\"
},
\"
sscModes
\"
: {
\"
defaultSscMode
\"
:
\"
SSC_MODE_1
\"
},
\"
5gQosProfile
\"
: {
\"
5qi
\"
: 6,
\"
arp
\"
:{
\"
priorityLevel
\"
: 1,
\"
preemptCap
\"
:
\"
NOT_PREEMPT
\"
,
\"
preemptVuln
\"
:
\"
NOT_PREEMPTABLE
\"
},
\"
priorityLevel
\"
:1},
\"
sessionAmbr
\"
:{
\"
uplink
\"
:
\"
1000Mbps
\"
,
\"
downlink
\"
:
\"
1000Mbps
\"
},
\"
staticIpAddress
\"
:[{
\"
ipv4Addr
\"
:
\"
12.1.1.2
\"
}]}}'
);
INSERT
INTO
`SessionManagementSubscriptionData`
(
`ueid`
,
`servingPlmnid`
,
`singleNssai`
,
`dnnConfigurations`
)
VALUES
(
'208990000000002'
,
'20899'
,
'{
\"
sst
\"
: 1,
\"
sd
\"
:
\"
1
\"
}'
,
'{
\"
oai
\"
:{
\"
pduSessionTypes
\"
:{
\"
defaultSessionType
\"
:
\"
IPV4
\"
},
\"
sscModes
\"
: {
\"
defaultSscMode
\"
:
\"
SSC_MODE_1
\"
},
\"
5gQosProfile
\"
: {
\"
5qi
\"
: 6,
\"
arp
\"
:{
\"
priorityLevel
\"
: 1,
\"
preemptCap
\"
:
\"
NOT_PREEMPT
\"
,
\"
preemptVuln
\"
:
\"
NOT_PREEMPTABLE
\"
},
\"
priorityLevel
\"
:1},
\"
sessionAmbr
\"
:{
\"
uplink
\"
:
\"
1000Mbps
\"
,
\"
downlink
\"
:
\"
1000Mbps
\"
},
\"
staticIpAddress
\"
:[{
\"
ipv4Addr
\"
:
\"
12.1.1.3
\"
}]}}'
);
INSERT
INTO
`SessionManagementSubscriptionData`
(
`ueid`
,
`servingPlmnid`
,
`singleNssai`
,
`dnnConfigurations`
)
VALUES
(
'208990000000003'
,
'20899'
,
'{
\"
sst
\"
: 1,
\"
sd
\"
:
\"
1
\"
}'
,
'{
\"
oai
\"
:{
\"
pduSessionTypes
\"
:{
\"
defaultSessionType
\"
:
\"
IPV4
\"
},
\"
sscModes
\"
: {
\"
defaultSscMode
\"
:
\"
SSC_MODE_1
\"
},
\"
5gQosProfile
\"
: {
\"
5qi
\"
: 6,
\"
arp
\"
:{
\"
priorityLevel
\"
: 1,
\"
preemptCap
\"
:
\"
NOT_PREEMPT
\"
,
\"
preemptVuln
\"
:
\"
NOT_PREEMPTABLE
\"
},
\"
priorityLevel
\"
:1},
\"
sessionAmbr
\"
:{
\"
uplink
\"
:
\"
1000Mbps
\"
,
\"
downlink
\"
:
\"
1000Mbps
\"
},
\"
staticIpAddress
\"
:[{
\"
ipv4Addr
\"
:
\"
12.1.1.4
\"
}]}}'
);
-- --------------------------------------------------------
--
...
...
This diff is collapsed.
Click to expand it.
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment