Jump to content

Command Line Interfaces RutOS: Difference between revisions

no edit summary
No edit summary
No edit summary
Line 1: Line 1:
==Introduction==
==Introduction==


A '''command line interface''' ('''CLI''') is a means of interacting with a computer program or system where the user (or client) issues commands to the program in the form of successive lines of text (command lines). A program that handles the interface is called a '''command language interpreter''' or '''shell'''.
A '''command line interface''' ('''CLI''') is a means of interacting with a computer program or system where the user (or client) issues commands to the program in the form of successive lines of text (command lines). A program that handles the interface is called a '''command language interpreter,''' or '''shell'''.


Teltonika-Networks devices support a variety of different command line interfaces all of which will be described in this article. Only the methods of reaching and logging in via a specified CLI will be described here and not any specific command usage.
Teltonika-Networks devices support a variety of different command line interfaces, all of which will be described in this article. Only the methods of reaching and logging in via a specified CLI will be described here, not any specific command usage.


In all cases, CLI login information for Teltonika-Networks devices routers is:
In all cases, the CLI login information for Teltonika-Networks devices is:


* User name: '''root'''
* User name: '''root'''
Line 12: Line 12:
==CLI (WebUI)==
==CLI (WebUI)==


RUTxxx routers 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.  
----
 
* Simply '''''log in to the WebUI''''' by typing the '''''router's LAN IP address''''' into the '''''URL field of your web browser''''' and '''''press Enter on your keyboard''''';
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'''.
* 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'''''.


[[File:RutOS WebUI Login fixed.png|border|class=tlt-border]]
[[File:RutOS WebUI Login fixed.png|border|class=tlt-border]]


* Then locate the '''''CLI''''' section under the System tab;
Then locate the '''CLI''' section under the System tab. Type in the login name "'''root"''' and the '''router's admin password'''. You should be greeted with a message such as this:
* Type in the login name '''''root''''', press '''''Enter''''', type in the '''''router's admin password''''' and press '''''Enter''''' again. You should be greeted with a message such as this:


[[File:RutOS WebUI CLI logged in fixed.png|border|class=tlt-border]]
[[File:RutOS WebUI CLI logged in fixed.png|border|class=tlt-border]]
Line 30: Line 28:
===Linux===
===Linux===
----
----
Linux operating systems support many applications that can be used to log in to a RUTxxx router via SSH, but the most common is '''Terminal''', which we'll be using for this example.
Linux operating systems support many applications that can be used to log in to a router or a gateway via SSH, but the most common is '''Terminal''', which we'll be using for this example.


* Open a new Terminal window, type '''ssh [email protected]''' and press "Enter". 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''' and press "Enter". Then type in the router's admin password and press "Enter" 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|class=tlt-border]]
After this, you should be greeted with a window such as the one depicted in the figure above.


====RSA key====
====RSA key====
Line 44: Line 40:
===Windows===
===Windows===
----
----
To login to a RUTxxx router via SSH using a Windows OS you will need an SSH client application. The most common is '''PuTTY''' - 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 access SSH on the Windows OS, you will need an SSH client application. The most common is '''PuTTY''' - 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]'''.
----
 
* Launch PuTTY and select the '''SSH''' option under the "Connection type" field. 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|class=tlt-border]]
----
 
* In the next window type in the login name ''root'', press "Enter", type in the router's admin password and press "Enter" again. 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|class=tlt-border]]


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


Line 63: Line 57:
==RS232/RS485 console (only with RUT955)==
==RS232/RS485 console (only with RUT955)==


It is also possible to control a RUT955 router via RS232 or RS485 consoles. For this, however, you will need the adequate cables:
It is also possible to control routers or gateways via RS232 or RS485 consoles if they have those serial ports. For this, you will need the adequate cables:
<font size="-1">
 
{| class="wikitable" style="border:2px solid white; background: white"
{| class="wikitable" style="border:2px solid white; background: white"
|+
|+
Line 71: Line 65:
| style="border:1px solid white; width: 400px" |'''USB to RS232 (Male) cable''' <br> [[File:Usb to rs232 male.png|187px|left]]
| style="border:1px solid white; width: 400px" |'''USB to RS232 (Male) cable''' <br> [[File:Usb to rs232 male.png|187px|left]]
|-
|-
|}
|}You can log in to the RS485 console with a 2-wire cable or you can use the RS485 jack that comes with the router for one end; the other end of the cable basically depends on your end device's capabilities (it can be USB, RS232, etc.)
</font>
 
You can log in to the RS485 console with a 2-wire cable. You can use the RS485 jack that comes with the router for one end; the other end of the cable basically depends on your end device's capabilities (it can be USB, RS232, etc.)


===Router configuration===
===Router configuration===
----
----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 for the router's side is fairly simple. Just log in to the router's WebUI, go to '''Services → RS232/RS485''', place a checkmark next to the "Enable" field and select "Serial type: Console" (the same is true for both RS232 and RS485):


[[File:Rs232 console configuration v4.png|border|class=tlt-border]]
[[File:Rs232 console configuration v4.png|border|class=tlt-border]]
You can leave the rest of the settings as defaults or set them in accordance with your needs. Don't forget to click save after you have made the changes.


===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:
 
  $ sudo apt-get update
  $ sudo apt-get update
  $ sudo apt-get install minicom
  $ sudo apt-get install minicom