Ueransim: Penggunaan
Sumber: https://github.com/aligungr/UERANSIM/wiki/Usage
Penggunaan Dasar
Setelah menyelesaikan konfigurasi dan pengaturan, sekarang kita dapat mulai menggunakan UERANSIM.
Jalankan perintah berikut untuk memulai gNB:
nr-gnb -c myconfig.yaml
Jalankan perintah berikut untuk memulai UE:
nr-ue -c myconfig.yaml
Kita juga dapat mengatur jumlah UE dengan:
nr-ue -c myconfig.yaml -n 10
Dengan cara ini, 10 UE akan di start dan di run dalam proses. Nomor IMSI di tambah satu untuk setiap UE (mulai dari IMSI yang ditentukan dalam file konfigurasi). Kita juga dapat mengganti parameter IMSI di file konfigurasi melalui baris perintah dengan:
nr-ue -c myconfig.yaml -i imsi-286010000000001
atau
nr-ue -c myconfig.yaml -n 10 -i imsi-286010000000001
Penggunaan Command Line Interface (CLI)
UERANSIM menyediakan nr-cli tool untuk gNB dan UE.
CATATAN: UE dan gNB memiliki perintah CLI yang berbeda. Misalnya di gNB Anda dapat memeriksa status koneksi AMF, atau di UE Anda dapat memicu de-registration.
Penggunaan:
nr-cli <node-name>
Di sini kita perlu mengganti <node-name> dengan nama UE atau gNB. Sebagai contoh:
nr-cli imsi-001010000000001
Kita dapat menanyakan UE dan gNB saat ini di lingkungan kita menggunakan:
$ nr-cli --dump
imsi-001010000000001 imsi-001010000000002 imsi-001010000000003
Setelah menjalankan perintah nr-cli <node-name>, shell interaktif akan terbuka jika node yang diberikan ada dan berjalan di lingkungan. Kita sekarang dapat menjalankan perintah lebih lanjut untuk node ini.
Untuk melihat perintah yang tersedia, gunakan perintah.
Misalnya:
user@pc:~/UERANSIM/build$ ./nr-cli UERANSIM-gnb-001-01-1 -------------------------------------------------------------------------------------------- $ commands amf-info | Show some status information about the given AMF amf-list | List all AMFs associated with the gNB info | Show some information about the gNB status | Show some status information about the gNB ue-count | Print the total number of UEs connected the this gNB ue-list | List all UEs associated with the gNB --------------------------------------------------------------------------------------------
Kita dapat menyelidiki lebih lanjut penggunaan dan informasi bantuan untuk sub-perintah. Misalnya:
$ amf-info --help $ ue-list --version dll.
Kita juga dapat menggunakan opsi -e/--exec jika kita ingin menjalankan perintah secara langsung daripada menggunakan shell interaktif. Misalnya:
nr-cli imsi-001010000000001 --exec "status"
Untuk lebih detail, silahkan lihat
nr-cli --help
Penggunaan Data Plane
UERANSIM menyediakan interface TUN untuk menggunakan konektivitas internet UE. Dengan versi v2.2.1 semua konfigurasi TUN diterapkan secara otomatis.
Interface TUN diatur untuk setiap sesi PDU. Setelah berhasil membuat sesi PDU, UE secara otomatis melakukan operasi berikut:
- Interface TUN dibuat.
- Tabel route, IP rule, dan route IP dikonfigurasi.
CATATAN: Konfigurasi route mungkin berbenturan dengan pengaturan kita saat ini. Kita dapat memulai UE dengan nr-ue --no-route-config jika kita tidak menginginkan konfigurasi route otomatis (item 2). Namun interface TUN selalu dibuat setelah pembentukan sesi PDU (item 1).
CATATAN: Menggunakan UE dan Core Network di komputer yang sama biasanya menimbulkan masalah. Harap gunakan 2 mesin berbeda untuk UERANSIM dan jaringan inti. (Anda dapat menggunakan mesin virtual atau mesin non-virtual.)
Penggunaan interface TUN
If you want to manually utilize the interface, just bind your TCP/IP socket to uesimtunX interface.
For example:
ping -I uesimtun0 google.com
or
sudo curl --interface uesimtun0 google.com
etc. However we also provide our experimental ./nr-binder tool to utilize UE's connection easily.
Jika kita ingin menggunakan interface secara manual, cukup bind soket TCP/IP kita ke interface uesimtunX.
Sebagai contoh:
ping -I uesimtun0 google.com
atau
sudo curl --interface uesimtun0 google.com
dll. Namun kami juga menyediakan alat ./nr-binder eksperimental dari UERANSIM untuk memanfaatkan koneksi UE dengan mudah.
Penggunaan TUN via ./nr-binder
Kita dapat bind interface uesimtunX ke hampir semua aplikasi menggunakan tool ./nr-binder.
CATATAN: Konfigurasi route otomatis harus diaktifkan untuk menggunakan ./nr-binder. yaitu jangan memulai UE dengan --no-routing-config jika kita ingin menggunakan fitur nr-binder.
CATATAN: ./nr-binder bersifat eksperimental dan mungkin tidak berfungsi untuk beberapa aplikasi.
Penggunaan:
./nr-binder {PDU-SESSION-IP-ADDRESS} {PERINTAH} {ARGS}
Sebagai contoh:
./nr-binder 10.45.0.2 curl google.com
Dengan cara ini, perintah curl akan menggunakan koneksi internet UE dengan IP 10.45.0.2. (Di sini 10.45.0.2 adalah alamat IP sesi PDU yang ingin kita gunakan. Kita mungkin perlu menggantinya dengan alamat sesi PDU kita sendiri.)
Anda juga dapat menggunakan browser web seperti Firefox. Sebagai contoh:
./nr-binder 10.45.0.2 firefox
Setelah menjalankan perintah ini, semua lalu lintas jaringan yang terjadi di Firefox, akan menggunakan konektivitas internet UE.
CATATAN: Silakan matikan semua proses Firefox sebelum menjalankan perintah di atas.
Troubleshooting
Jika kita tidak dapat terhubung ke internet, pastikan kondisi berikut terpenuhi:
- UERANSIM dan jaringan inti berhasil dikonfigurasi.
- Sesi PDU berhasil dibuat.
- Alamat IP yang diberikan kepada nr-binder sama persis dengan alamat IP dari Sesi PDU IP terkait.
CATATAN: Konfigurasi perutean di UERANSIM bersifat eksperimental dan bukan merupakan fitur utama perangkat lunak. UERANSIM hanya menjamin untuk membuat interface TUN, tetapi konfigurasi route IP tidak dijamin untuk melayani tujuan apa pun. Kita harus langsung bind aplikasi kita ke interface TUN untuk memanfaatkan konektivitas internet UE.