Ueransim: Penggunaan - Revision history

Unknown user: /* Referensi */

2022-12-21T05:56:09Z

Referensi

← Older revision		Revision as of 05:56, 21 December 2022
Line 157:		Line 157:

	* https://github.com/aligungr/UERANSIM/wiki/Usage		* https://github.com/aligungr/UERANSIM/wiki/Usage

			==Pranala Menarik==

			* [[5G]]

Unknown user: /* Troubleshooting */

2022-12-21T05:55:52Z

Troubleshooting

← Older revision		Revision as of 05:55, 21 December 2022
Line 146:		Line 146:
	==Troubleshooting==		==Troubleshooting==

	~~If you are not able to connect to the~~ internet, ~~make sure that the following conditions are satisfied~~:		Jika kita tidak dapat terhubung ke internet, pastikan kondisi berikut terpenuhi:

	* UERANSIM and core network successfully configured.
	* A PDU Session is successfully established.
	* IP address given to nr-binder is exactly same with the IP address of the related IP PDU Session.
	NOTE: Routing configurations in UERANSIM are experimental and it's not a primary feature of the software. UERANSIM only guarantees to create a TUN interface, but IP routing configurations are not guaranteed to serve any purpose. You should directly bind your applications to the TUN interface in order to utilize the UE's internet connectivity, as described in this document.


			* 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.

	==Referensi==		==Referensi==

	* https://github.com/aligungr/UERANSIM/wiki/Usage		* https://github.com/aligungr/UERANSIM/wiki/Usage

Unknown user: /* Penggunaan Data Plane */

2022-12-21T05:54:12Z

Penggunaan Data Plane

← Older revision		Revision as of 05:54, 21 December 2022
Line 83:		Line 83:
	==Penggunaan Data Plane==		==Penggunaan Data Plane==

	UERANSIM ~~provides a~~ TUN ~~interface in order to use~~ UE~~'s internet connectivity~~. ~~With the version~~ v2.2.1 ~~all~~ TUN ~~configurations are automatically applied~~.		UERANSIM menyediakan interface TUN untuk menggunakan konektivitas internet UE. Dengan versi v2.2.1 semua konfigurasi TUN diterapkan secara otomatis.

	A TUN ~~interface is setup for each~~ PDU ~~session~~. ~~After successful establishment of a~~ PDU ~~session~~, ~~the~~ UE ~~automatically performs the following operations~~:		Interface TUN diatur untuk setiap sesi PDU. Setelah berhasil membuat sesi PDU, UE secara otomatis melakukan operasi berikut:

	A TUN ~~interface is created~~.		* Interface TUN dibuat.
	~~A routing table~~, an IP rule, ~~and an~~ IP ~~route are configured.~~		* Tabel route, IP rule, dan route IP dikonfigurasi.
	NOTE: Routing configurations may clash with your current settings. You can start the UE with nr-ue --no-route-config if you don't want the automatic routing configurations (item 2). However TUN interface is always created after a PDU session establishment (item 1).

	~~NOTE~~: ~~Using~~ UE ~~and~~ Core Network ~~on the same computer usually causes problems~~. ~~Please use~~ 2 ~~different machines for~~ UERANSIM ~~and core network~~. (~~You can use~~ virtual ~~machines or~~ non-virtual ~~machines~~.)		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==

	~~Using the TUN Interface~~
	If you want to manually utilize the interface, just bind your TCP/IP socket to uesimtunX interface.		If you want to manually utilize the interface, just bind your TCP/IP socket to uesimtunX interface.

Line 104:		Line 107:
	etc. However we also provide our experimental ./nr-binder tool to utilize UE's connection easily.		etc. However we also provide our experimental ./nr-binder tool to utilize UE's connection easily.

	~~Using the TUN via ./nr-binder~~
	~~You can bind the uesimtunX interface to almost any application using ./nr-binder tool.~~

	~~NOTE~~: ~~Automatic routing configurations must be enabled for using~~ .~~/nr~~-~~binder~~. i.e. ~~don't start the UE with --no-routing-config if you want to use~~ nr-binder ~~feature~~.		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.


	~~NOTE:~~ ./nr-binder ~~is experimental and may not work for some applications.~~		==Penggunaan TUN via ./nr-binder==

	~~Usage:~~		Kita dapat bind interface uesimtunX ke hampir semua aplikasi menggunakan tool ./nr-binder.

	./nr-binder ~~{PDU~~-~~SESSION~~-IP-~~ADDRESS} {COMMAND} {ARGS}~~		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.

	~~For example~~:		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		./nr-binder 10.45.0.2 curl google.com

	~~In this way~~, curl ~~command will use~~ UE~~'s internet connection with~~ IP 10.45.0.2. (~~Here~~ 10.45.0.2 ~~is the~~ IP ~~address of the~~ PDU ~~session that you want to utilize~~. ~~You may need to replace it with your own~~ PDU ~~session address~~.)		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.)

	~~You can also use~~ web ~~browsers such as~~ Firefox. ~~For example~~:		Anda juga dapat menggunakan browser web seperti Firefox. Sebagai contoh:

	./nr-binder 10.45.0.2 firefox		./nr-binder 10.45.0.2 firefox

	~~After running this command~~, ~~all network traffic occurred in~~ Firefox, ~~will use~~ UE~~'s internet connectivity~~.		Setelah menjalankan perintah ini, semua lalu lintas jaringan yang terjadi di Firefox, akan menggunakan konektivitas internet UE.

	~~NOTE~~: ~~Please kill all~~ Firefox ~~processes before running the command above~~.		CATATAN: Silakan matikan semua proses Firefox sebelum menjalankan perintah di atas.

	==Troubleshooting==		==Troubleshooting==

Unknown user: /* Usage of the Data Plane */

2022-12-21T05:42:46Z

Usage of the Data Plane

← Older revision		Revision as of 05:42, 21 December 2022
Line 81:		Line 81:
	nr-cli --help		nr-cli --help

	==~~Usage of the~~ Data Plane==		==Penggunaan Data Plane==

	UERANSIM provides a TUN interface in order to use UE's internet connectivity. With the version v2.2.1 all TUN configurations are automatically applied.		UERANSIM provides a TUN interface in order to use UE's internet connectivity. With the version v2.2.1 all TUN configurations are automatically applied.

Unknown user: /* Usage of the Command Line Interface (CLI) */

2022-12-21T05:42:13Z

Usage of the Command Line Interface (CLI)

← Older revision		Revision as of 05:42, 21 December 2022
Line 25:		Line 25:
	nr-ue -c myconfig.yaml -n 10 -i imsi-286010000000001		nr-ue -c myconfig.yaml -n 10 -i imsi-286010000000001

	==~~Usage of the~~ Command Line Interface (CLI)==		==Penggunaan Command Line Interface (CLI)==

	~~We provide~~ nr-cli tool ~~for both~~ gNB ~~and UEs~~.		UERANSIM menyediakan nr-cli tool untuk gNB dan UE.

	~~NOTE~~: UE ~~and~~ gNB ~~have different~~ CLI ~~commands~~. ~~For example in~~ gNB ~~you can check the~~ AMF ~~connection status~~, ~~or in~~ UE ~~you can trigger~~ de-registration~~. More details are explained in the present document~~.		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.

	~~Usage~~:		Penggunaan:

	nr-cli <node-name>		nr-cli <node-name>

	~~Here you need to replace~~ <node-name> ~~with a~~ UE or gNB ~~name~~. ~~For example~~:		Di sini kita perlu mengganti <node-name> dengan nama UE atau gNB. Sebagai contoh:


	nr-cli imsi-001010000000001		nr-cli imsi-001010000000001

	~~You can query the current~~ UE ~~and gNBs in the environment using~~:		Kita dapat menanyakan UE dan gNB saat ini di lingkungan kita menggunakan:

	$ nr-cli --dump		$ nr-cli --dump
Line 47:		Line 48:
	imsi-001010000000003		imsi-001010000000003

	~~After running~~ nr-cli <node-name> ~~command~~, ~~an interactive~~ shell ~~will be open if given~~ node ~~is present and running in the environment~~. ~~You can now execute further commands for this~~ node.		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.

	~~To see available commands, use commands.~~

	~~For Example~~:		Untuk melihat perintah yang tersedia, gunakan perintah.
			Misalnya:

	user@pc:~/UERANSIM/build$ ./nr-cli UERANSIM-gnb-001-01-1		user@pc:~/UERANSIM/build$ ./nr-cli UERANSIM-gnb-001-01-1
Line 63:		Line 64:
	ue-list \| List all UEs associated with the gNB		ue-list \| List all UEs associated with the gNB
	--------------------------------------------------------------------------------------------		--------------------------------------------------------------------------------------------
	~~You can further investigate usage and help information for sub-commands.~~

	~~For example~~:		Kita dapat menyelidiki lebih lanjut penggunaan dan informasi bantuan untuk sub-perintah.
			Misalnya:

	$ amf-info --help		$ amf-info --help
	$ ue-list --version		$ ue-list --version
	~~etc~~.		dll.

			Kita juga dapat menggunakan opsi -e/--exec jika kita ingin menjalankan perintah secara langsung daripada menggunakan shell interaktif.
			Misalnya:

	~~You can also use~~ -e/--exec ~~option if you want to directly execute the command instead of using the interactive shell.~~		nr-cli imsi-001010000000001 --exec "status"

	~~For example:~~		Untuk lebih detail, silahkan lihat

	~~nr-cli imsi-001010000000001 --exec "status"~~		nr-cli --help
	~~For more details, see~~ nr-cli --help

	==Usage of the Data Plane==		==Usage of the Data Plane==

Unknown user at 04:30, 21 December 2022

2022-12-21T04:30:09Z

← Older revision		Revision as of 04:30, 21 December 2022
Line 1:		Line 1:
	Sumber: https://github.com/aligungr/UERANSIM/wiki/Usage		Sumber: https://github.com/aligungr/UERANSIM/wiki/Usage

	~~Basic Usage~~		==Penggunaan Dasar==
	~~After completing configurations and setups, now you can start using UERANSIM.~~

	~~Run the following command to start the~~ gNB:		Setelah menyelesaikan konfigurasi dan pengaturan, sekarang kita dapat mulai menggunakan UERANSIM.

			Jalankan perintah berikut untuk memulai gNB:

	nr-gnb -c myconfig.yaml		nr-gnb -c myconfig.yaml

	~~Run the following command to start a~~ UE:		Jalankan perintah berikut untuk memulai UE:

	nr-ue -c myconfig.yaml		nr-ue -c myconfig.yaml

	~~You can also set the number of UEs by~~:		Kita juga dapat mengatur jumlah UE dengan:

	nr-ue -c myconfig.yaml -n 10		nr-ue -c myconfig.yaml -n 10

	~~This way~~, 10 ~~UEs will~~ start ~~and~~ run ~~in the process~~. IMSI ~~number is incremented by one for each of the UEs~~ (~~starting from the~~ IMSI ~~specified in the config~~ file). ~~You can also override~~ IMSI ~~parameter in the config~~ file ~~over the command line by~~:		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		nr-ue -c myconfig.yaml -i imsi-286010000000001
	or
			atau

	nr-ue -c myconfig.yaml -n 10 -i imsi-286010000000001		nr-ue -c myconfig.yaml -n 10 -i imsi-286010000000001

	Usage of the Command Line Interface (CLI)		==Usage of the Command Line Interface (CLI)==

	We provide nr-cli tool for both gNB and UEs.		We provide nr-cli tool for both gNB and UEs.

Line 74:		Line 78:
	For more details, see nr-cli --help		For more details, see nr-cli --help

	Usage of the Data Plane		==Usage of the Data Plane==

	UERANSIM provides a TUN interface in order to use UE's internet connectivity. With the version v2.2.1 all TUN configurations are automatically applied.		UERANSIM provides a TUN interface in order to use UE's internet connectivity. With the version v2.2.1 all TUN configurations are automatically applied.

Line 121:		Line 126:
	NOTE: Please kill all Firefox processes before running the command above.		NOTE: Please kill all Firefox processes before running the command above.

	Troubleshooting		==Troubleshooting==

	If you are not able to connect to the internet, make sure that the following conditions are satisfied:		If you are not able to connect to the internet, make sure that the following conditions are satisfied:

	UERANSIM and core network successfully configured.		* UERANSIM and core network successfully configured.
	A PDU Session is successfully established.		* A PDU Session is successfully established.
	IP address given to nr-binder is exactly same with the IP address of the related IP PDU Session.		* IP address given to nr-binder is exactly same with the IP address of the related IP PDU Session.
	NOTE: Routing configurations in UERANSIM are experimental and it's not a primary feature of the software. UERANSIM only guarantees to create a TUN interface, but IP routing configurations are not guaranteed to serve any purpose. You should directly bind your applications to the TUN interface in order to utilize the UE's internet connectivity, as described in this document.		NOTE: Routing configurations in UERANSIM are experimental and it's not a primary feature of the software. UERANSIM only guarantees to create a TUN interface, but IP routing configurations are not guaranteed to serve any purpose. You should directly bind your applications to the TUN interface in order to utilize the UE's internet connectivity, as described in this document.

Unknown user: Created page with "Sumber: https://github.com/aligungr/UERANSIM/wiki/Usage Basic Usage After completing configurations and setups, now you can start using UERANSIM. Run the following command..."

2022-12-21T04:20:18Z

Created page with "Sumber: https://github.com/aligungr/UERANSIM/wiki/Usage Basic Usage After completing configurations and setups, now you can start using UERANSIM. Run the following command..."

New page

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

Basic Usage
After completing configurations and setups, now you can start using UERANSIM.

Run the following command to start the gNB:

nr-gnb -c myconfig.yaml

Run the following command to start a UE:

nr-ue -c myconfig.yaml

You can also set the number of UEs by:

nr-ue -c myconfig.yaml -n 10

This way, 10 UEs will start and run in the process. IMSI number is incremented by one for each of the UEs (starting from the IMSI specified in the config file). You can also override IMSI parameter in the config file over the command line by:

nr-ue -c myconfig.yaml -i imsi-286010000000001
or
nr-ue -c myconfig.yaml -n 10 -i imsi-286010000000001

Usage of the Command Line Interface (CLI)
We provide nr-cli tool for both gNB and UEs.

NOTE: UE and gNB have different CLI commands. For example in gNB you can check the AMF connection status, or in UE you can trigger de-registration. More details are explained in the present document.

Usage:

nr-cli <node-name>

Here you need to replace <node-name> with a UE or gNB name. For example:

nr-cli imsi-001010000000001

You can query the current UE and gNBs in the environment using:

$ nr-cli --dump

imsi-001010000000001
imsi-001010000000002
imsi-001010000000003

After running nr-cli <node-name> command, an interactive shell will be open if given node is present and running in the environment. You can now execute further commands for this node.

To see available commands, use commands.

For Example:

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
--------------------------------------------------------------------------------------------
You can further investigate usage and help information for sub-commands.

For example:

$ amf-info --help
$ ue-list --version
etc.

You can also use -e/--exec option if you want to directly execute the command instead of using the interactive shell.

For example:

nr-cli imsi-001010000000001 --exec "status"
For more details, see nr-cli --help

Usage of the Data Plane
UERANSIM provides a TUN interface in order to use UE's internet connectivity. With the version v2.2.1 all TUN configurations are automatically applied.

A TUN interface is setup for each PDU session. After successful establishment of a PDU session, the UE automatically performs the following operations:

A TUN interface is created.
A routing table, an IP rule, and an IP route are configured.
NOTE: Routing configurations may clash with your current settings. You can start the UE with nr-ue --no-route-config if you don't want the automatic routing configurations (item 2). However TUN interface is always created after a PDU session establishment (item 1).

NOTE: Using UE and Core Network on the same computer usually causes problems. Please use 2 different machines for UERANSIM and core network. (You can use virtual machines or non-virtual machines.)

Using the TUN Interface
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.

Using the TUN via ./nr-binder
You can bind the uesimtunX interface to almost any application using ./nr-binder tool.

NOTE: Automatic routing configurations must be enabled for using ./nr-binder. i.e. don't start the UE with --no-routing-config if you want to use nr-binder feature.

NOTE: ./nr-binder is experimental and may not work for some applications.

Usage:

./nr-binder {PDU-SESSION-IP-ADDRESS} {COMMAND} {ARGS}

For example:

./nr-binder 10.45.0.2 curl google.com

In this way, curl command will use UE's internet connection with IP 10.45.0.2. (Here 10.45.0.2 is the IP address of the PDU session that you want to utilize. You may need to replace it with your own PDU session address.)

You can also use web browsers such as Firefox. For example:

./nr-binder 10.45.0.2 firefox

After running this command, all network traffic occurred in Firefox, will use UE's internet connectivity.

NOTE: Please kill all Firefox processes before running the command above.

Troubleshooting
If you are not able to connect to the internet, make sure that the following conditions are satisfied:

UERANSIM and core network successfully configured.
A PDU Session is successfully established.
IP address given to nr-binder is exactly same with the IP address of the related IP PDU Session.
NOTE: Routing configurations in UERANSIM are experimental and it's not a primary feature of the software. UERANSIM only guarantees to create a TUN interface, but IP routing configurations are not guaranteed to serve any purpose. You should directly bind your applications to the TUN interface in order to utilize the UE's internet connectivity, as described in this document.

==Referensi==

* https://github.com/aligungr/UERANSIM/wiki/Usage