Configuration - my5G/my5G-RANTester GitHub Wiki

Configurations:

Configuration File

The options that can be set is in configuration file and explained below:

NG-RAN or gNB Configuration:

  • controlif: IP and Port for N2 interface for NG-RAN. NG-RAN will use IP and Port to communicates with AMF and receive NAS/NGAP packets from AMF via SCTP socket. It's usually your machine's ip. Change depending on your environment.
  • dataif: IP and Port for N3 interface for NG-RAN. NG-RAN will use IP and Port to communicates with UPF and receive GTP packets from UPF via UDP socket. It's usually your machine's ip. Change depending on your environment.
  • plmnlist: contains MCC (Mobile Country Code value)/ MNC (Mobile Network Code), TAC (Tracking Area Code) and gnbid information. These information must be consistent with AMF configuration and UE's SUCI.
  • slicesupportlist: The list of slices supported by this gNB by tracking area. It's usually the slice that you will want to connect in the 5G Core.

UE Configuration:

  • msin: MSIN number of the UE and it is part of IMSI information. The MCC and MNC must be included in hplmn field.
  • key: Permanent Subscription Key. The key must be the same set in web ui of 5GC for UE. This field is used for authentication of UE. Currently the my5GTester only supports 5G-AKA authentication method.
  • opc: Operator Code Value. The key must be the same set in web ui of 5GC for UE. This field is used for authentication of UE.
  • amf: Authentication Management Field (AMF). This field is used for authentication of UE.
  • sqn: Sequence Number. The default value will work in the basics case, e.g, registration of UE. If you want to trigger resynchronization of Sequence Number (SQN) in authentication process with 5GC, try to change this value.
  • dnn: refers information about PDU Session. In this case, specifies the data network for the PDU Session and can be used for SMF/UPF selection.
  • hplmn: the MCC and MNC part of IMSI information for the UE.
  • snssai: refers information about PDU Session. In this case, specifies the slice for the PDU Session and can be used for SMF/UPF selection.

AMF Configuration:

  • Ip: AMF IP address. This information is part of N2 endpoint.
  • Port: AMF Port address. This information is part of N2 endpoint

Command Line Options

To see all command options try:

$ ./app --help
INFO[0000] my5G-RANTester version 1.0                   
NAME:
   app - A new cli application

USAGE:
   app [global options] command [command options] [arguments...]

COMMANDS:
   ue, ue                Testing an ue attached with configuration
   gnb, gnb              Testing an gnb attached with configuration
   load-test, load-test  Load endurance stress tests.
   Example for testing multiple UEs in queue (sequential): load-test -n 5 

   help, h  Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --help, -h  show help (default: false)

To see more information about tests see the Usage page.