Ueransim: Konfigurasi

From OnnoWiki
Jump to navigation Jump to search

Sumber: https://github.com/aligungr/UERANSIM/wiki/Configuration


Konfigurasi adalah bagian terpenting, dan hampir semua masalah disebabkan oleh konfigurasi yang salah (baik UERANSIM atau sisi core network).

nr-ue menerima file konfigurasi UE sebagai parameter, dan nr-gnb menerima file konfigurasi gNB sebagai parameter. Sintaksnya adalah sebagai berikut:

nr-ue -c myconfig1.yaml
nr-gnb -c myconfig2.yaml

UERANSIM menyediakan beberapa contoh file konfigurasi yang terletak di folder config. Kita dapat mengeditnya, atau menulis file kita sendiri. Tapi jangan mencoba menggunakan konfigurasi contoh apa adanya tanpa mengatur parameter untuk lingkungan kita sendiri.

Contoh baris perintah untuk menggunakan konfigurasi sampel:

cd ~/UERANSIM/build
./nr-gnb -c ../config/open5gs-gnb.yaml
./nr-ue -c ../config/open5gs-ue.yaml
./nr-gnb -c ../config/free5gc-gnb.yaml
./nr-ue -c ../config/free5gc-ue.yaml

Konfigurasi UE

  • supi: Nomor IMSI UE harus ditulis di kolom ini. Perhatikan bahwa UERANSIM hanya mendukung IMSI sebagai SUPI, artinya NAI tidak didukung. Kolom ini wajib diisi kecuali untuk pendaftaran darurat.
  • mcc: Nilai Mobile Country Code dari HPLMN (Home PLMN). Nilai ini harus konsisten dengan SUPI.
  • mnc: Nilai Mobile Network Code HPLMN (Home PLMN). Nilai ini harus konsisten dengan SUPI. Nilai MNC dapat berupa 2 digit atau 3 digit. Perhatikan bahwa nilai 2 digit secara semantik berbeda dari nilai 3 digit. misalnya 25 berbeda dengan 025. Lebih jelasnya dapat dilihat di TS 23.501
  • key: Ini adalah kunci langganan permanen yang ditetapkan untuk UE spesifik.
  • op: Nilai Operator code (dalam OP atau OPC) harus ditulis di sini. Kita harus menetapkan opType sebagai OP jika kita menulis nilai OP di sini, dan kita harus menetapkan opType sebagai OPC jika kita menulis nilai OPC di sini. Kita dapat menggunakan kunci OP atau OPC.
  • amf: Authentication Management Field (AMF) harus ditulis disini. Perhatikan bahwa ini adalah hal yang berbeda dari fungsi core network AMF (Access and Mobility Management Function)
  • imei: Nomor IMEI perangkat. IMEI digunakan jika tidak ada SUPI yang disediakan dan untuk pendaftaran darurat dll. Nilai ini umumnya tidak digunakan.
  • imeiSv: Nomor IMEISV perangkat. IMEISV digunakan jika tidak ada SUPI dan IMEI yang disediakan dan untuk pendaftaran darurat dll. Nilai ini umumnya tidak digunakan.
  • gnbSearchList: Ini adalah daftar alamat IP gNB untuk simulasi tautan radio. Kita dapat menulis beberapa alamat IP untuk beberapa gNB. UE akan mencoba mengambil beberapa gNB dari daftar ini. Alamat IP harus cocok dengan parameter linkIp di file konfigurasi gNB. Jika tidak, UE tidak dapat terhubung ke gNB. Secara default kami menulis 127.0.0.1 di file konfigurasi sampel, kita harus ubah parameter ini dan linkIp sesuai dengan lingkungan kita jika kita menggunakan UE dan gNB di mesin yang berbeda.
  • uacAic: Unified Access Control (UAC), Access Identities Configuration (AIC) harus dikonfigurasi di bidang ini. mps adalah singkatan dari Multimedia Priority Service dan mcs adalah singkatan dari Mission Critical Service. Lihat TS 31.102 untuk konfigurasi UAC AI.
  • uacAcc: Unified Access Control (UAC), Access Control Class (ACC) harus dikonfigurasi di kolom ini. normalClass mengambil nilai dalam rentang [0, 9], dan kelas dari 11 hingga 15 adalah untuk high priority access. Lihat TS 31.102 untuk konfigurasi UAC ACC.
  • sesi: Ini adalah daftar sesi PDU awal. Sesi ini dibuat secara otomatis setelah UE berhasil mendaftar ke core network 5G. Kita dapat menambahkan beberapa sesi PDU ke daftar ini. (Tidak lebih dari 15). Jika kita tidak menginginkan sesi PDU awal, kita dapat sepenuhnya menghapus parameter sesi. Sesi memiliki parameter type, apn, dan slice. Hanya IPv4 yang didukung untuk saat ini sebagai jenis sesi PDU. field apn adalah opsional dan menentukan Access Point Name. parameter slice bersifat opsional dan menentukan S-NSSAI untuk sesi PDU khusus ini. Parameter sd juga opsional, tetapi sst selalu diperlukan jika parameter slice disertakan. Kita dapat menghapus parameter opsional atau menetapkan nol ke bidang yang relevan.
  • configured-nssai: NSSAI dikonfigurasi untuk UE ini oleh HPLMN (Home PLMN). Isi NSSAI sudah dijelaskan di atas.
  • default-nssai: NSSAI yang Dikonfigurasi Default untuk perangkat UE ini. Isi NSSAI sudah dijelaskan di atas.
  • integrity/ciphering: Di sini kita dapat mengatur algoritma integritas dan ciphering yang didukung untuk UE spesifik. Biasanya UERANSIM mendukung semua algoritme tetapi kita dapat menonaktifkan beberapa di antaranya secara manual dengan konfigurasi ini.
  • integrityMaxRate: Bidang ini menentukan laju integrity protection maximum data rate untuk user plane puntuk UE ini. Nilai yang mungkin adalah 64kbps dan penuh seperti yang ditentukan oleh TS 24.501.


Konfigurasi gNB

  • mcc/mnc: Field ini sudah dijelaskan di atas.
  • nci: Bidang ini menentukan Identitas Sel NR. Juga idLength menentukan panjang bit ID gNB yang merupakan bagian dari Identitas Sel NR ini. Lebih lanjut ada di TS 38.413
  • tac: Nilai Tracking Area Code (TAC) untuk sel ini.
  • linkIp: IP lokal untuk simulasi link radio untuk gNB ini. UE harus terhubung ke alamat IP ini untuk simulasi radio. Alamat IP harus cocok dengan parameter gnbSearchList di file konfigurasi UE. Jika tidak, UE tidak dapat terhubung ke gNB. Secara default UERANSIM menulis 127.0.0.1 di file konfigurasi sampel, tetapi ubah parameter ini dan gmbSearchList sesuai dengan lingkungan kita jika kita menggunakan UE dan gNB di mesin yang berbeda.
  • ngapIp: IP Lokal untuk interface N2 untuk gNB ini. AMF akan mengirimkan paket SCTP ke alamat IP ini, oleh karena itu atur IP ini dengan tepat. Jika tidak, AMF tidak dapat terhubung ke gNB dan terjadi kesalahan batas waktu SCTP. Secara default EURANSIM menulis 127.0.0.1 di file konfigurasi sampel, tetapi ubah ini sesuai dengan lingkungan kita jika kita menggunakan gNB dan AMF di mesin yang berbeda. (Juga disarankan agar selalu menggunakan UERANSIM dan core network di mesin yang berbeda.)
  • gtpIp: IP lokal untuk interface N3 untuk gNB ini. UPF akan mengirimkan paket GTP ke alamat IP ini, oleh karena itu atur IP ini dengan tepat. Jika tidak, UPF tidak dapat mengirim datagram ke gNB dan fungsi data plane tidak dapat berfungsi. Secara default EURANSIM menulis 127.0.0.1 di file konfigurasi sampel, tetapi ubah ini sesuai dengan lingkungan kita jika kita menggunakan gNB dan UPF di mesin yang berbeda. (Juga saran kami selalu menggunakan UERANSIM dan jaringan inti di mesin yang berbeda.)
  • gtpAdvertiseIp: Jika kita ingin memisahkan alamat mendengarkan GTP dan alamat akses eksternal, kita dapat menset nilai ini untuk mengganti Downlink User-Plane Transport Layer Address yang di advertise ke UPF. Field ini opsional dan tidak wajib untuk sebagian besar orang. Ini sangat berguna jika terjadi NAT antara gNB dan UPF. Kami tidak menyertakan kolom ini dalam contoh file konfigurasi.
  • amfConfigs: Daftar alamat IP AMF dan informasi port untuk interface N2 (NGAP). Ini adalah titik akhir lain dari apa yang kita atur di alamat ngapIp. Kali ini kita harus menetapkan nilai ini sebagai alamat IP AMF. Secara default EURANSIM menulis 127.0.0.X di contoh file konfigurasi, tetapi kita perlu mengubah ini sesuai dengan lingkungan kita jika kita menggunakan gNB dan AMF di mesin yang berbeda. Nilai ini biasanya berupa daftar, tetapi saat ini hanya AMF yang ditentukan pertama yang digunakan. Mekanisme seleksi AMF yang lebih kompleks akan diterapkan di masa mendatang.
  • slices: Field ini dijelaskan dalam konfigurasi UE. Dan itu adalah daftar slice yang didukung oleh gNB.
  • ignoreStreamIds: Beberapa core network mungkin tidak menangani nomor aliran SCTP dengan benar. Set field ini ke true jika kita ingin mengabaikan kesalahan tersebut.

Environment

  • Pastikan semua node dalam pengaturan kita (UE, gNB, dan core network) dapat terhubung satu sama lain melalui jaringan, dan beberapa aturan firewall tidak memblokir lalu lintas 5G antar node.
  • Protokol SCTP dengan nomor port default 38412 digunakan antara gNB dan AMF. Protokol GTP dengan nomor port yang ditetapkan 2152 digunakan antara gNB dan UPF. Protokol RLS dengan nomor port yang ditetapkan 4997 digunakan antara gNB dan UE.

Referensi

Pranala Menarik