1,108
edits
Changes
Command Line Interfaces RutOS (view source)
Revision as of 16:54, 22 March 2023
, 16:54, 22 March 2023no edit summary
Teltonika Networks routers and gateways have a command-line interface built-in to their '''Web User Interfaces''' ('''WebUI'''). This is the most accessible method because all you need is a web browser.
Teltonika Networks routers and gateways have a command-line interface built-in to their '''Web User Interfaces''' ('''WebUI'''). This is the most accessible method because all you need is a web browser.
To access the WebUI CLI, '''log in to the WebUI''' by typing the '''router's LAN IP address''' into the '''URL field of your web browser''.''''' After this, you will be greeted with the login window. Type in the user name "'''admin'''" and the '''router's admin password''', and '''click Login'''.
To access the WebUI CLI, '''log in to the WebUI''', and navigate to '''System → CLI'''. Type in the login name "'''root'''" and the '''router's admin password'''. You should be greeted with a message such as this:
[[File:RutOS WebUI CLI logged in fixed 2.png|border|center|class=tlt-border|781x467px]]
[[File:RutOS WebUI CLI logged in fixed.png|border|class=tlt-border]]
==SSH==
==SSH==
Open a new Terminal window, type '''ssh [email protected].''' If this is your first time logging in, you might be asked to clarify whether you really want to log in. In that case, just type '''yes'''. Then type in the '''router's admin password''' to finish the login process.
Open a new Terminal window, type '''ssh [email protected].''' If this is your first time logging in, you might be asked to clarify whether you really want to log in. In that case, just type '''yes'''. Then type in the '''router's admin password''' to finish the login process.
[[ File:Ubuntu_SSH_login.png|border|class=tlt-border]]
[[File:Ubuntu_SSH_login.png|border|center|class=tlt-border|617x375px]]
====RSA key====
====RSA key====
----
There is a possibility to use an RSA key instead of a password when logging in via SSH. This process is described '''[[SSH RSA key authentication (Linux)|here]]''' in detail.
There is a possibility to use an RSA key instead of a password when logging in via SSH. This process is described '''[[SSH RSA key authentication (Linux)|here]]''' in detail.
Launch PuTTY and select the '''SSH''' option. Type in the '''router's LAN IP address''' into the '''"Host Name (or IP address)"''' field, specify the SSH port into the '''"Port"''' field ('''22''' by default), and '''click "Open"''':
Launch PuTTY and select the '''SSH''' option. Type in the '''router's LAN IP address''' into the '''"Host Name (or IP address)"''' field, specify the SSH port into the '''"Port"''' field ('''22''' by default), and '''click "Open"''':
[[File:SSH Putty login.png|border|class=tlt-border]]
[[File:SSH Putty login.png|border|center|class=tlt-border|454x442px]]
In the next window, type in the login name '''root''' and the '''router's admin password'''. You should be greeted with a message such as this:
In the next window, type in the login name '''root''' and the '''router's admin password'''. You should be greeted with a message such as this:
[[File:SSH Putty logged in.png|border|class=tlt-border]]
[[File:SSH Putty logged in.png|border|center|class=tlt-border|821x450px]]
'''Note:''' Newer Windows 10 editions already have a built-in SSH client. see https://docs.microsoft.com/en-us/windows/terminal/tutorials/ssh
'''Note:''' Newer Windows 10 editions already have a built-in SSH client. see https://docs.microsoft.com/en-us/windows/terminal/tutorials/ssh
==== RSA key====
==== RSA key====
----
There is a possibility to use an RSA key instead of a password when logging in via SSH. This process is described '''[[SSH RSA key authentication (Windows)|here]]''' in detail.
There is a possibility to use an RSA key instead of a password when logging in via SSH. This process is described '''[[SSH RSA key authentication (Windows)|here]]''' in detail.
----The configuration on the device side is fairly simple. Just '''log in to the device WebUI''', go to '''Services → Serial Utilities → Console,''' enable the instance, and configure the rest according to your serial device settings. In the example below, default values were used.
----The configuration on the device side is fairly simple. Just '''log in to the device WebUI''', go to '''Services → Serial Utilities → Console,''' enable the instance, and configure the rest according to your serial device settings. In the example below, default values were used.
[[File:Rs232 console configuration v4.png|border|class=tlt-border]]
[[File:Rs232 console configuration v4.png|border|center|class=tlt-border|627x416px]]
===Linux===
===Linux===
----To login from a Linux PC, you'll need an application for serial communication like '''minicom''' or '''gtkterm'''. For this example, we'll be using minicom. You can download it by typing these lines into the Terminal:
----
To login from a Linux PC, you'll need an application for serial communication like '''minicom''' or '''gtkterm'''. For this example, we'll be using minicom. You can download it by typing these lines into the Terminal:
<code><span class="highlight">'''sudo apt-get update'''</span></code> - downloads a list of newest software packages.
<code><span class="highlight">'''sudo apt-get install minicom'''</span></code> - downloads and installs minicom.
Once you have installed minicom, you can run it with the command <code><span class="highlight">'''sudo minicom'''</span></code> from the Linux Terminal. This will open a new console window where you will need to set some things up. Press '''Ctrl + A''' at once on your keyboard, then press '''"Z"''' which will direct you to the settings menu:
[[File:Minicom settings v2.png|border|center|class=tlt-border|757×468px]]
'''update''' downloads a list of newest software packages; '''install minicom''' downloads and installs minicom.
Then press '''"O"''' on your keyboard. This will direct you to the main settings menu. From there you should specify the name of the serial device and the same parameters that you entered in the router's configuration. A picture with corresponding parameters is presented below:
[[File:Minicom settings v2.png|border|class=tlt-border]]
[[File:Minicom settings port v2.png|border|center|class=tlt-border|757×468px]]
Once done, press '''"Enter"'''. In the next menu, you can save these settings as defaults by selecting '''Save setup as dfl''' so that you would not need to set everything up the next time you use the console.
To access the console, press '''"Esc"''' on your keyboard. It will take you to a login window - there enter the login name '''root''' and the '''router's admin password'''.
===Windows===
===Windows===
----
----
To log in from a Windows PC, you'll need an application for serial communication. The most common is '''PuTTY''' - a free, open source SSH and Telnet client, which we'll be using for this example. You can download PuTTY from '''[https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html here]'''.
To log in from a Windows PC, you'll need an application for serial communication. The most common is '''PuTTY''' - a free, open source SSH and Telnet client, which we'll be using for this example. You can download PuTTY from '''[https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html here]'''.
[[File:Putty serial login 1 v2.PNG|border|class=tlt-border]]
First you must find out which '''Serial line''' (or '''COM port''') your cable uses. To do so, go to Windows '''Device Manager''' (you can find it easily via the search field or in the Control Panel). Find '''Ports (COM & LPT)''' in the device list and expand that section. Locate your serial device (depends on the type of cable) and take note of its '''COM port number''' ('''COM3''' in our example):
[[File:Putty serial login 1 v2.PNG|border|center|class=tlt-border|932×566px]]
Launch PuTTY and select the '''Serial''' option under the "Connection type" field. Specify the COM port ('''COM3''' from our example) in the "Serial line" field and the Baud rate from your router's configuration in the "Speed" field ('''9600''' from our example) and click "Open":
[[File:Putty serial login 2 v3.PNG|border|center|class=tlt-border|477×472px]]
In the next window type in the login name ''root'' and the '''router's admin password'''. You should be greeted with a message such as this:
[[File:Putty serial login 3 v2.PNG|border|class=tlt-border]]
[[File:Putty serial login 3 v3.PNG|border|center|class=tlt-border|640×393px]]
== See also==
== See also==