Command Line Interfaces RutOS: Difference between revisions

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.

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

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.

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

* Then locate the CLI section under the System tab;

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

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.

 

[[File:SSH linux login v3.png|border|class=tlt-border]]

After this, you should be greeted with a window such as the one depicted in the figure above.

 

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]'''.

* 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":

[[File:Putty login 1 v2.PNG|border|class=tlt-border]]

[[File:Putty login v3.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

It is also possible to control a RUT955 router via RS232 or RS485 consoles. For this, however, you will need the adequate cables:

|}

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

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

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

* 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

'''update''' downloads a list of newest software packages; '''install minicom''' downloads and installs minicom.

*Once you've installed minicom, you can run it with the command '''sudo minicom''' 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|class=tlt-border]]

[[File:Minicom settings port v2.png|border|class=tlt-border]]

Once done, press "Enter". In the next menu, you can save these settings as defaults by selecting '''Save setup as dfl''' so that you wouldn't need to set everything up the next time you use the console.

*Press "Esc" on your keyboard to return to the console window and type in the login name ''root'', press "Enter", type in the router's admin password, and press "Enter" again. After this, you will be able to use the RS232/RS485 console.

[[File:Putty serial login 1 v2.PNG|border|class=tlt-border]]

*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 ('''115200''' from our example) and click "Open":

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

[[File:Putty serial login 3 v2.PNG|border|class=tlt-border]]