MikroTik Router OS V3.0 User Manual

							watch-address. The default setting means that if watch-address is set and is not reachable, the router
will reboot about every 6 minutes.
send-email-from(text; default:) - e-mail address to send the support output file from. If not set,
the value set in /tool e-mail is used
send-email-to(text; default:) - e-mail address to send the support output file to
send-smtp-server(text; default:) - SMTP server address to send the support output file through.
If not set, the value set in /tool e-mail is used
watch-address(IP address; default:none) - if set, the system will reboot in case 6 sequental pings
to the given IP address (sent once per 10 seconds) will fail
•none- disable this option
watchdog-timer(yes | no; default:no) - whether to reboot if system is unresponsive for a minute
Example
 	 
 
	
 	 
 

  	
 

 
 	
	
	 

V%


 
!&%+%&%!
 	  	 
	 	
[admin@MikroTik] system watchdog> set auto-send-supout=yes \\... [email protected] send-smtp-server=192.0.2.1[admin@MikroTik] system watchdog> printwatch-address: nonewatchdog-timer: yesno-ping-delay: 5mautomatic-supout: yesauto-send-supout: yessend-smtp-server: 192.0.2.1send-email-to: [email protected][admin@MikroTik] system watchdog>
Page 470 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners. 
						

							UPS Monitor
Document revision 2.3 (February 6, 2008, 4:08 GMT)
This document applies to MikroTik RouterOS V3.0
Table of Contents
TableofContents
Summary
Specifications
Description
UPSMonitorSetup
PropertyDescription
Notes
Example
RuntimeCalibration
Description
Notes
Example
UPSMonitoring
PropertyDescription
Example
General Information
Summary
 0$! 

 	
  
 +$3 0$! 

 
	
 
 `	
a 
	
 ( 	 !-:-  0!)




  	
 
	 
 

 	

	
 
 

 
 0$! 	
 
 
 
 

Z	[ 	
 	
  
	 
 
 

  		 
 
 
  	   

	
  
 
 
	
 
 
   	 

 	
 	
 

  	   
 


  

 
 0$! 	
 
 
 
 
	
  
 
 

   
 	
 
 0$!
	

  	  
	
 /.U  
 	

  
  
  

 


 
 

 
 0$!
& 
 
	
  	
 

 
	
 
 	
 
 
 

  

 * 
 0$! 	

 
	
 	
 
 
  	  
 
   	 
  	

 
 
 Z

[ 



 0$! 

 	
 
 
  
 ! 

•
	
 	
 	 
 
  	
 	

 	
•0$! 	

 

 	
 
 
 		

 

•


  	 H	
H  
	
 
	

 
  0$!
•
   	

Specifications
Page 471 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners. 
						

							Packages required:ups
License required:level1
Home menu level:/system ups
Standards and Technologies:APCssmartprotocol
Hardware usage:Not significant
Description
Cabling
 	 +$3 0$! &)	0$! $  !	
0$! 8 	 	 	 	 &
 


 
 0!)
* 
 	 	 
 
 0$! 	 	 	    +$3  
 	
  	 H
7H 0 


 		
Router Side (DB9f)SignalDirectionUPS Side (DB9m)
2ReceiveIN2
3SendOUT1
5Ground4
7CTSIN6
9
 
	
  	 	 


 
 0!)  	(		
UPS Monitor Setup
Home menu level:/system ups
Property Description
alarm-setting(delayed|immediate|low-battery|none; default:immediate) - UPS sound alarm
setting:
•delayed- alarm is delayed to the on-battery event
•immediate- alarm immediately after the on-battery event
•low-battery- alarm only when the battery is low
•none- do not alarm
load(read-only: percentage) - the UPSs output load as a percentage of full rated load in Watts.
The typical accuracy of this measurement is ±3% of the maximum of 105%
manufacture-date(read-only: text) - the UPSs date of manufacture in the format mm/dd/yy
(month, day, year)
min-runtime(time; default:5m) - minimal run time remaining. After a utility failure, the router
will monitor the runtime-left value. When the value reaches the min-runtime value, the router will
go to hibernate mode
•0- the router will go to hibernate mode when the battery low signal is sent indicating that the
battery power is below 10%
model(read-only: text) - less than 32 ASCII character string consisting of the UPS model name
(the words on the front of the UPS itself)
Page 472 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners. 
						

							nominal-battery-voltage(read-only: integer) - the UPSs nominal battery voltage rating (this is not
the UPSs actual battery voltage)
offline-after(read-only: time) - when will the router go offline
offline-time(time; default:5m) - how long to work on batteries. The router waits that amount of
time and then goes into hibernate mode until the UPS reports that the utility power is back
•0- the router will go into hibernate mode according the min-runtime setting and 10% of battery
power event. In this case, the router will wait until the UPS reports that the battery power is
below 10%
port(name) - communication port of the router
serial(read-only: text) - a string of at least 8 characters directly representing the UPSs serial
number as set at the factory. Newer SmartUPS models have 12-character serial numbers
version(read-only: text) - UPS version, consists of three fields: SKU number, firmware revision,
country code. The county code may be one of the following:
•I- 220/230/240 Vac
•D- 115/120 Vac
•A- 100 Vac
•M- 208 Vac
•J- 200 Vac
Notes
*
  
 
	 0$! 

 
 	 
   	(		
Example
 
	 
 0$! 

  

!
[admin@MikroTik] system ups> add port=serial1 disabled=no[admin@MikroTik] system ups> printFlags: X - disabled, I - invalid0 name=ups port=serial1 offline-time=5m min-runtime=5malarm-setting=immediate model=SMART-UPS 1000 version=60.11.Iserial=QS0030311640 manufacture-date=07/18/00nominal-battery-voltage=24V[admin@MikroTik] system ups>
Runtime Calibration
Command name:/system ups rtc
Description

	
 	 
 0$! 
 
	
 	 
 
 		

 

  
	
 -
						

							Example
[admin@MikroTik] system ups> rtc 0
UPS Monitoring
Command name:/system ups monitor
Property Description
battery-charge(percentage) - the UPSs remaining battery capacity as a percent of the fully
charged condition
battery-voltage- the UPSs present battery voltage. The typical accuracy of this measurement is
±5% of the maximum value (depending on the UPSs nominal battery voltage)
frequency(percentage) - when operating on-line, the UPSs internal operating frequency is
synchronized to the line within variations within 3 Hz of the nominal 50 or 60 Hz. The typical
accuracy of this measurement is ±1% of the full scale value of 63 Hz
line-voltage- the in-line utility power voltage
load(percentage) - the UPSs output load as a percentage of full rated load in Watts. The typical
accuracy of this measurement is ±3% of the maximum of 105%
low-battery- only shown when the UPS reports this status
on-battery(yes|no) - Whether UPS battery is supplying power
on-line(yes|no) - whether power is being provided by the external utility (power company)
output-voltage- the UPSs output voltage
overloaded-output- only shown when the UPS reports this status
replace-battery- only shown when the UPS reports this status
runtime-calibration-running- only shown when the UPS reports this status
runtime-left(time) - the UPSs estimated remaining run time in minutes. You can query the UPS
when it is operating in the on-line, bypass, or on-battery modes of operation. The UPSs remaining
run time reply is based on available battery capacity and output load
smart-boost-mode- only shown when the UPS reports this status
smart-ssdd-mode- only shown when the UPS reports this status
transfer-cause(text) - the reason for the most recent transfer to on-battery operation (only shown
when the unit is on-battery)
Example
6
 


 
 

 
[admin@MikroTik] system ups> monitor 0on-line: yeson-battery: noRTC-running: noruntime-left: 20mbattery-charge: 100%battery-voltage: 27Vline-voltage: 226V
Page 474 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners. 
						

							output-voltage: 226Vload: 45%temperature: 39Cfrequency: 50Hzreplace-battery: nosmart-boost: nosmart-trim: nooverload: nolow-battery: no
[admin@MikroTik] system ups>
6
 


 
 	


[admin@MikroTik] system ups> monitor 0on-line: noon-battery: yestransfer-cause: Line voltage notch or spikeRTC-running: noruntime-left: 19moffline-after: 4m46sbattery-charge: 94%battery-voltage: 24Vline-voltage: 0Voutput-voltage: 228Vload: 42%temperature: 39Cfrequency: 50Hzreplace-battery: nosmart-boost: nosmart-trim: nooverload: nolow-battery: no
[admin@MikroTik] system ups>
Page 475 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners. 
						

							VRRP
Document revision 1.6 (February 6, 2008, 4:08 GMT)
This document applies to MikroTik RouterOS V3.0
Table of Contents
TableofContents
GeneralInformation
Summary
Specifications
Description
Notes
VRRPRouters
Description
PropertyDescription
Notes
AsimpleexampleofVRRPfailover
Description
ConfiguringMasterVRRProuter
ConfiguringBackupVRRProuter
Testingfailover
General Information
Summary
O
	 
 
	
 $
 &O$ 

	

 
 
  
 !  #3-::C 	


O$ 
   
 
 

	

 	 
      
 & 	 O$

 
 
 


 	
 	  	(		 
 &	  	 O
	 
 
 
	 	
( F	 
 	
 	
	
 
 

  
	
 -
						

								
 
 	 (
	 
 + 
  	 (
	 
 	
  
 
  
 
 
	

•?.0#83
	
 
 
 
 	
 	 
 8
 
 
 

	
% *$ 	  	 

 
 +!F 
 
 	 (
	 
  
 
 O$ 	(


 	
 
 	 

	 
 &
 
	
 	 ( 
 
 	  &
 




•I.,AN5
	
 
 
 O$ 
 

 
 	(		
 	
 
	
  
 	
 
 *
 


 	
 	
 8
 
 
 

	
% *$ 	 ! 	
  
	(		 & 	
 	

 8

	 O$ 	
 	 
 

  	
 	
 
 	
  	
	 
 
 
 #  
	 
 (
	 
  #3-::C
Notes
O$  

 

  
 OA+9 

	 	 
   
 	( 
 +3 	  	 OA+9


	 

  
 +3 	  
 	 

	 
  
 

VRRP Routers
Home menu level:/interface vrrp
Description
+ 
  O$ 
 	  	 (
	 
  		 
  
 
 
 

  -
						

							name(name) - assigned name of the VRRP instance
on-backup(name; default:) - script to execute when the node switch to backup state
on-master(name; default:) - script to execute when the node switch to master state
password(text; default:) - password required for authentication depending on method used can
be ignored (if no authentication used), 8-character long text string (for plain-text authentication) or
16-character long text string (128-bit key required for AH authentication)
preemption-mode(yes | no; default:yes) - whether preemption mode is enabled
•no- a backup node will not be elected to be a master until the current master fail even if the
backup node has higher priority than the current master
•yes- the master node always has the priority
priority(integer: 1..255; default:100) - priority of the current node (higher values mean higher
priority)
•255- RFC requires that the router that owns the IP addresses assigned to this instance had the
priority of 255
vrid(integer: 0..255; default:1) - Virtual Router Identifier (must be unique on one interface)
Notes
+ 
 
  
 
 
 	( 
 	




 

	

$
Example
 	 	 O$ 

	
 

 !

	 
 &	


&** 	 (
	 
 


!
[admin@MikroTik] interface vrrp> add interface=ether1 vrid=1 priority=255[admin@MikroTik] interface vrrp> printFlags: X - disabled, I - invalid, R - running, M - master, B - backup0 RM name=vrrp1 mtu=1500 mac-address=00:00:5E:00:01:01 arp=enabledinterface=ether1 vrid=1 priority=255 interval=1 preemption-mode=yesauthentication=none password= on-backup= on-master=[admin@MikroTik] ip vrrp>
9
 
	
 
 

	
  	
( 	
 
   	 
 	 
 
  -
						

							O$ 
 	   
 	 	 
	

 *



 



 
 	 	7( A
  	

	
  	( /;-/GC/.1-D 

 	
  
 
 (  	(		 *



 



  

 

   9+
 &
 	 	7( 
  *$   
	 

 
 	
)I$   !$# 

 
 O$ 6 	( 



 
 
 

 *



 !( $( &*!$
	
 
  
   & 	 
  	  	

 	   
 
 O$ 
 
 
 
 
 
 
 		  
 
	( 

	 
	

 

	 	 
	 	 

	 	( 		
 *$ 	 &

 
	
 	
 
 
 

	  	( 	
 *$ 	 

 
	  
 
 &
  	( 	
 	
 	
	
 
 !379+  	8	
  	  
  ! 
 
( 	
	
	
 
  
 	 
 
	


6  	 
	
 
 

	 
 /;-/GC/.1-D 

  


 
  
	
 
 O$


Configuring Master VRRP router
#
  	   	
 	 O$ 

	
 
 
 
 6   
 
  - add interface=local priority=255[admin@MikroTik] interface vrrp> printFlags: X - disabled, I - invalid, R - running, M - master, B - backup0 RM name=vrrp1 mtu=1500 mac-address=00:00:5E:00:01:01 arp=enabledinterface=local vrid=1 priority=255 interval=1 preemption-mode=yesauthentication=none password= on-backup= on-master=[admin@MikroTik] interface vrrp>
Page 479 of 480Copyright 1999-2007, MikroTik. All rights reserved. Mikrotik, RouterOS and RouterBOARD are trademarks of Mikrotikls SIA.Other trademarks and registred trademarks mentioned herein are properties of their respective owners.