Difference between revisions of "Ueransim: Konfigurasi"
Jump to navigation
Jump to search
Onnowpurbo (talk | contribs) |
Onnowpurbo (talk | contribs) |
||
| Line 1: | Line 1: | ||
Sumber: https://github.com/aligungr/UERANSIM/wiki/Configuration | 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 | + | 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-ue -c myconfig1.yaml | ||
nr-gnb -c myconfig2.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 | cd ~/UERANSIM/build | ||
| Line 22: | Line 21: | ||
./nr-ue -c ../config/free5gc-ue.yaml | ./nr-ue -c ../config/free5gc-ue.yaml | ||
| − | ==UE | + | ==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. | ||
| + | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
==gNB Configuration== | ==gNB Configuration== | ||
Revision as of 10:51, 21 December 2022
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.
gNB Configuration
- mcc/mnc: This fields are already explained above.
- nci: This field specifies the NR Cell Identity. Also idLength specifies the bit length of the gNB ID which is a part of this NR Cell Identity. More on TS 38.413
- tac: Tracking Area Code (TAC) value for this cell.
- linkIp: Local IP for radio link simulation for this gNB. UE should connect to this IP address for radio simulation. The IP address must match with gnbSearchList parameter in the UE config file. Otherwise UE cannot connect to the gNB. By default we wrote 127.0.0.1 in the sample configuration files, but change this and gnbSearchList parameter according to your environment if you use UE and gNB in different machines.
- ngapIp: Local IP for N2 interface for this gNB. AMF will send SCTP packets to this IP address, therefore set this IP precisely. Otherwise AMF cannot connect to the gNB and SCTP timeout error occurs. By default we wrote 127.0.0.1 in the sample configuration files, but change this according to your environment if you use gNB and AMF in different machines. (Also our suggestion is always using UERANSIM and core network in different machines.)
- gtpIp: Local IP for N3 interface for this gNB. UPF will send GTP packets to this IP address, therefore set this IP precisely. Otherwise UPF cannot send datagrams to the gNB and data plane functions cannot work. By default we wrote 127.0.0.1 in the sample configuration files, but change this according to your environment if you use gNB and UPF in different machines. (Also our suggestion is always using UERANSIM and core network in different machines.)
- gtpAdvertiseIp: If you want to separate GTP listening address and external access address, you can set this value to override Downlink User-Plane Transport Layer Address which is advertised to UPF. This field is optional and not required for most of the people. It is especially useful in case of a NAT between gNB and UPF. We didn't include this field in the sample config files.
- amfConfigs: List of AMF IP address and port information for N2 (NGAP) interface. This is the other endpoint of what you set in ngapIp address. This time you should set this value as AMF's IP address. By default we wrote 127.0.0.X in the sample configuration files, but change this according to your environment if you use gNB and AMF in different machines. This value is normally a list, but currently only first specified AMF is used. More complex AMF selection mechanism will be implemented in the future.
- slices: This field is explained in the UE configurations. And it is the supported list of slices by the gNB.
- ignoreStreamIds: Some core networks may not handle SCTP stream numbers properly. Set this field to true if you want to ignore such errors.
Environment
- Make sure that all of the nodes in your setup (UE, gNB, and core network) can connect to each other over the network, and some firewall rule does not block the 5G traffic between nodes.
- SCTP protocol with default port number 38412 is used between gNB and AMF. GTP protocol with assigned port number 2152 is used between gNB and UPF. RLS protocol with assigned port number 4997 is used between gNB and UE.