Jump to content

Command Line Interfaces RutOS: Difference between revisions

no edit summary
No edit summary
No edit summary
Line 36: Line 36:
===Linux===
===Linux===
----
----
Linux operating systems support many applications that can be used to login 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 RUTxxx router 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 login. 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]''' 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:  


[[File:SSH linux login v3.png]]
[[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.
After this, you should be greeted with a window such as the one depicted in the figure above.


====RSA key====
====RSA key====
Line 52: Line 52:
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 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":
* 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]]
[[File:Putty login 1 v2.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'', 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 login v3.png|alt=]]
[[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
*Newer Windows 10 editions already have a built-in SSH client. see https://docs.microsoft.com/en-us/windows/terminal/tutorials/ssh


----
----
Line 80: Line 80:
</font>
</font>


You can login 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.)
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 for the router's side is fairly simple. Just login to the router's WebUI, go to '''Services → RS232/RS485''', place a check mark next to the "Enable" field and select "Serial type: Console" (the same is true for both RS232 and RS485):
*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]]
Line 92: Line 92:
===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
Line 101: Line 101:
*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:
*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]]
[[File:Minicom settings v2.png|border|class=tlt-border]]
----
----
*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:
*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 port v2.png]]
[[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.
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.
*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.


===Windows===
===Windows===
----
----
To login from a Windows PC, you'll need an application for serial communication. 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 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]'''.
----
----
*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):
*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]]
[[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":
*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":


[[File:Putty serial login 2 v2.PNG]]
[[File:Putty serial login 2 v2.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'', 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]]
[[File:Putty serial login 3 v2.PNG|border|class=tlt-border]]


== See also==
== See also==