Version: current

Device Information new

General information

Identity

Setting the System's Identity provides a unique identifying name for when the system identifies itself to other routers in the network and when accessing services such as DHCP, Neighbour Discovery and default wireless SSID. The default system Identity is set to MikroTik. System Identity has a maximum character length of 64.

[admin@MikroTik] > /system/identity/set name=mygateway

Note

The /system/note feature allows you to assign arbitrary text notes or messages that will be displayed on each login right after the banner. For example, you may distribute warnings between system administrators this way, or describe what that particular router actually does. To configure the system note, you may upload a plain text file named sys-note.txt on the router's FTP server, or, additionally, edit the settings through the CLI:

[admin@MikroTik] > /system/note/set note="\n You are logged in the gateway router. Be careful with the configuration!"

Now open a new terminal:

  MMM      MMM       KKK                          TTTTTTTTTTT      KKK
  MMMM    MMMM       KKK                          TTTTTTTTTTT      KKK
  MMM MMMM MMM  III  KKK  KKK  RRRRRR     OOOOOO      TTT     III  KKK  KKK
  MMM  MM  MMM  III  KKKKK     RRR  RRR  OOO  OOO     TTT     III  KKKKK
  MMM      MMM  III  KKK KKK   RRRRRR    OOO  OOO     TTT     III  KKK KKK
  MMM      MMM  III  KKK  KKK  RRR  RRR   OOOOOO      TTT     III  KKK  KKK

  MikroTik RouterOS 7.0beta3 (c) 1999-2019       https://www.mikrotik.com/

[?]             Gives the list of available commands
command [?]     Gives help on the command and list of arguments

[Tab]           Completes the command/word. If the input is ambiguous,
                a second [Tab] gives possible options

/               Move up to base level
..              Move up one level
/command        Use command at the base level

 You are logged in the gateway router. Be careful with the configuration!
[admin@MikroTik] > 

SNMP

It is also possible to change the router system identity by an SNMP set command:

snmpset -c public -v 1 192.168.0.0 1.3.6.1.2.1.1.5.0 s New_Identity

snmpset - Linux-based SNMP application used for SNMP SET requests to set information on a network entity.
public - Router's community name.
192.168.0.0 - IP address of the router.
1.3.6.1.2.1.1.5.0 - SNMP value for router's identity.

Clock

TODO

Resource

The general resource menu shows overall resource usage and router statistics like uptime, memory usage, disk usage, version, etc.

[admin@MikroTik] > system resource print
             uptime: 25m12s
            version: 7.0beta3 (development)
         build-time: 2019-10-15 12:39:08
   factory-software: 6.43
        free-memory: 960.7MiB
       total-memory: 1024.0MiB
                cpu: ARMv7
          cpu-count: 4
           cpu-load: 0%
     free-hdd-space: 424.8MiB
    total-hdd-space: 512.2MiB
  architecture-name: arm
         board-name: RB4011iGS+5HacQ2HnD
           platform: MikroTik

Hardware Attachments

LCD

LCDs mainly are used to display system information, but LCDs also allow you to do the following:

Reboot the device.
Reset the unit's configuration.
Add an IP address.
Disable the interface.

For example, if we want to see statistical information on the LCD, we will configure the following:

[admin@MikroTik] > /lcd/show screen=stat-slideshow

Let's take a look at what the unit shows on the LCD information. The device allows you to capture a screenshot:

[admin@MikroTik] > /lcd/take-screenshot file-name=stat-screenshot
Screenshot taken

Under the /file section you will find the following image captured from the LCD:

RouterOS allows you to change various LCD parameters:

Set an LCD PIN code for safety.
Change color scheme.
Set timeout interval.
Flip screen.
Disable it.
Enable read-only mode.

[admin@MikroTik] > /lcd/print 
            enabled: yes
       touch-screen: enabled
  backlight-timeout: 30m
     read-only-mode: no
      time-interval: min
     default-screen: main-menu
       color-scheme: light
        flip-screen: no

warning

The PIN code number allows protecting sensitive menus on the LCD screen. The PIN number will be requested if Read-Only mode is disabled and you add an IP address, reset or reboot the router. The default PIN is 1234.

LCD Supported Hardware

The MikroTik RouterOS supports the following LCD hardware:
16x2 characters (Baud Rate:9600)
16x4 characters (Baud Rate:9600)
20x2 characters (Baud Rate:9600)
20x4 characters (Baud Rate:9600)
24x2 characters (Baud Rate:9600)
24x4 characters (Baud Rate:9600)
ax89063 (Baud Rate:9600)
ax93304 (Baud Rate:9600)
ax93304n (Baud Rate:9600)
cfa-631 (Baud Rate:115200)
cfa-633 (Baud Rate:19200)
cfa-635 (Baud Rate:115200)
mtb-134 (Baud Rate:2400)
nexcom (Baud Rate:9600)
tw-rc (Baud Rate:9600)
vitek-vc2025-1 (Baud Rate:9600)
vitek-vc2025-2 (Baud Rate:9600)
Crystalfontz (https://www.crystalfontz.com) Intelligent Serial LCD Module 632 (16x2 characters) and 634 (20x4 characters).
Powertip (https://www.powertip.com.tw) PC1602 (16x2 characters), PC1604 (16x4 characters), PC2002 (20x2 characters), PC2004 (20x4 characters), PC2402 (24x2 characters) and PC2404 (24x4 characters).
Portwell (https://www.portwell.com.tw) EZIO-100 (16x2 characters).
Townet (https://www.townet.it/prodotti/remote-control/tw-rc.html) TW-RC REMOTE CONTROL (16x2).
ax93304n (serial port) new ax93304 model with smaller screen buffer (since v5.8).
nexcom (parallel port) (since v5.8).

LED

RouterOS allows configuring each LED's activity the way that the user wishes. It is possible to configure the LEDs to display wireless strength, blink the LEDs on interface traffic activity and many other options.

For example, the default led configuration on CCR1009-7G-1C-1S+:

[admin@MikroTik] > system/leds/pr
Flags: * - default
Columns: TYPE, INTERFACE, LEDS
#     TYPE                INTERFACE     LEDS             
0  *  interface-speed     sfp-sfpplus1  sfp-sfpplus1-led1
1  *  interface-activity  sfp-sfpplus1  sfp-sfpplus1-led2
2  *  interface-activity  combo1        combo1-led     

The listed devices support turning off their LEDs (LED dark mode), however, some LEDs still cannot be turned off due to the device design factors.

Indoor devices

RouterBoard	LED description
RBcAP2n; RBcAP2nD (cAP)	Turns off all LEDs
RBcAPGi-5acD2nD (cAP ac)	Turns off all LEDs
RBwsAP5Hac2nD (wsAP ac lite)	Turns off all LEDs
RB760iGS (hEX S)	Turns off all LEDs
CRS305-1G-4S+	Turns off all LEDs except Ethernet LED and Power LED
CRS309-1G-8S+	Turns off all LEDs except Ethernet LEDs
RB951Ui-2HnD	Turns off all LEDs except Power LED
RB951Ui-2nD (hAP); RB952Ui-5ac2nD (hAP ac lite); RB952Ui-5ac2nD-TC (hAP ac lite TC)	Turns off all LEDs except Power LED
RB962UiGS-5HacT2HnT (hAP ac)	Turns off all LEDs except Port5 PoE LED
RBD52G-5HacD2HnD-TC (hAP ac^2)	Turns off all LEDs
RBD25G/RB25GR-5HPacQD2HPnD (Audience)	Turns off all LEDs except Ethernet LEDs

Wireless Systems

RouterBoard	LED description
RBwAPG-60ad (Wireless Wire)	Turns off all LEDs
RBLHGG-60ad (Wireless Wire Dish)	Turns off all LEDs
RBSXTsq-60ad (SXTsq Lite60); RBCube-60ad (Cube Lite60)	Turns off all LEDs
RB912UAG-6HPnD (BaseBox 6)	Turns off all LEDs
RB912R-2nD-LTm (ltAP mini / ltAP mini LTE kit)	Turns off all LEDs
RBLtAP-2HnD (LtAP)	Turns off all LEDs except Ethernet LEDs
RBLHG2nD (LHG 2); RBLHG2nD-XL (LHG XL 2)	Turns off all LEDs
RBLHG5nD (LHG 5); RBLHG5HPnD (LHG HP5); RBLHG5HPnD-XL (LHG XL HP5)	Turns off all LEDs
RBLHGG-5acD (LHG 5 ac); RBLHGG-5acD-XL (LHG XL 5 ac); RBLHGG-5HPacD2HPnD (LHG XL 52 ac); RBSXTsqG-5acD (SXTsq 5 ac)	Turns off all LEDs except Ethernet LED
RBLDF-2nD (LDF 2); RBLDF-5nD (LDF 5); RBLHGR	Turns off all LEDs
RBLDFG-5acD (LDF 5 ac)	Turns off all LEDs except Ethernet LED
RBwAPGR-5HacD2HnD (wAP ac)	Turns off all LEDs except Ethernet LED

Modem Signal Strength example

The whole modem-signal strength range is [-113..-51] and the modem-signal-threshold increases the weakest signal limit to -91 so the signal range for the LED indication is [-91..-51]. That range is divided into equal parts depending on the number of LEDs configured for modem-signal LED triggers. The first LED turns on when the signal is above -91 and the last LED turns on when the signal reaches -51.

/system/leds
add interface=lte1 leds=led1,led2,led3,led4,led5 modem-signal-treshold=-91 type=modem-signal

Modem Access Technology example

These LED trigger examples turn on LEDs in order of modem technology generation: GSM; 3G; LTE.

1 LED: led1 turns on when LTE is active:

/system/leds
add interface=lte1 leds=led1 modem-type=modem-technology

2 LEDs: led1 - 3G; led2 - LTE;

/system/leds
add interface=lte1 leds=led1,led2 modem-type=modem-technology

3 LEDs: led1 - GSM; led2 - 3G; led3 - LTE

/system/leds
add interface=lte1 leds=led1,led2,led3 modem-type=modem-technology

UPS

The UPS monitor feature works with APC UPS units that support “smart” signalling over serial RS232 or USB connection. The UPS monitor service is not included in the default set of packages, so it needs to be downloaded and installed manually with the ups.npk package. This feature enables the network administrator to monitor the UPS and set the router to ‘gracefully’ handle any power outage with no corruption or damage to the router. The basic purpose of this feature is to ensure that the router will come back online after an extended power failure. To do this, the router will monitor the UPS and set itself to hibernate mode when the utility power is down and the UPS battery has less than 10% of its battery power left. The router will then continue to monitor the UPS (while in hibernate mode) and then restart itself when the utility power returns. If the UPS battery is drained and the router loses all power, the router will return to full operation when the ‘utility’ power returns.

The UPS monitor feature on the MikroTik RouterOS supports:

Hibernate and safe reboot on power and battery failure.
UPS battery test and run-time calibration test.
Monitoring of all "smart" mode status information supported by UPS.
Logging of power changes.

Connecting the UPS unit

The serial APC UPS (BackUPS Pro or SmartUPS) requires a special serial cable (unless connected with USB). If no cable came with the UPS, a cable may be ordered from APC or one can be made "in-house". Use the following diagram:

Router Side (DB9f)	Signal	Direction	UPS Side (DB9m)
2	Receive	IN	2
3	Send	OUT	1
5	Ground		4
7	CTS	IN	6

If using a RouterBOARD device, make sure to set your "RouterBOOT setup key" to Delete instead of the default Any key. This is to avoid the accidental opening of the setup menu if the UPS unit sends some data to the serial port during the RouterBOARD startup. This can be done in the RouterBOOT options during boot time or via the RouterBoard Settings in Winbox:

Select key which will enter setup on boot:
 * 1 - any key
   2 - <Delete> key only
your choice:

Runtime Calibration

The rtc command causes the UPS to start a run time calibration until less than 25% of full battery capacity is reached. This command calibrates the returned run time value.

/system/ups/rtc <id>

warning

The test begins only if the battery capacity is 100%.

Quick Example

To enable the UPS monitor for port serial1:

[admin@MikroTik] /system/ups> add port=serial1 disabled=no
[admin@MikroTik] /system/ups> print
Flags: X - disabled, I - invalid
 0    name="ups" port=serial1 offline-time=5m min-runtime=5m
      alarm-setting=immediate model="SMART-UPS 1000" version="60.11.I"
      serial="QS0030311640" manufacture-date="07/18/00"
      nominal-battery-voltage=24V
[admin@MikroTik] /system/ups>

When running on utility power:

[admin@MikroTik] /system/ups> monitor 0
          on-line: yes
       on-battery: no
      RTC-running: no
     runtime-left: 20m
   battery-charge: 100%
  battery-voltage: 27V
     line-voltage: 226V
   output-voltage: 226V
             load: 45%
      temperature: 39C
        frequency: 50Hz
  replace-battery: no
      smart-boost: no
       smart-trim: no
         overload: no
      low-battery: no

[admin@MikroTik] /system/ups>

When running on battery:

[admin@MikroTik] /system/ups> monitor 0
          on-line: no
       on-battery: yes
   transfer-cause: "Line voltage notch or spike"
      RTC-running: no
     runtime-left: 19m
    offline-after: 4m46s
   battery-charge: 94%
  battery-voltage: 24V
     line-voltage: 0V
   output-voltage: 228V
             load: 42%
      temperature: 39C
        frequency: 50Hz
  replace-battery: no
      smart-boost: no
       smart-trim: no
         overload: no
      low-battery: no

[admin@MikroTik] /system/ups>

General information​

Identity​

Note​

SNMP​

Clock​

Resource​

Hardware Attachments​

LCD​

LCD Supported Hardware​

LED​

Indoor devices​

Wireless Systems​

Modem Signal Strength example​

Modem Access Technology example​

UPS​

Connecting the UPS unit​

Runtime Calibration​

Quick Example​