FMS | www.fmsweb.
de
Customizing The Dude
MUM Budapest 2011
by Patrik Schaub
FMS Internetservice, www.fmsweb.de
[email protected], Phone: +49 761 2926500 copyright FMS 2011
FMS | www.fmsweb.de
About FMS
FMS | www.fmsweb.de
About FMS
Founded in 1999
MikroTik
Distribution (www.mikrotik shop.de)
Training (www.mikrotik training.de)
Consulting and service contracts
Custom AAA development / API development
Supplementary products
Product development
FMS | www.fmsweb.de
What else is FMS doing Microwaves
Microwave solutions
Licensed and light licensed band
Unlicensed band
Multiple vendors
SIAE Microelettronica, Italy
SAF Tehnika, Latvia
Services
General Consulting
Planning of advanced setups
Protected setups (1+1) or ring topologies
Aggregated links, x * (1+0)
FMS | www.fmsweb.de
What else is FMS doing – Last mile
Our #1 solution: MikroTik
WIMAX
(Outdoor) DSLAMs, ADSL/VDSL
Fttx
FMS | www.fmsweb.de
Visit our Distributor Table
?
? ? ?
See the proto type:
Ogma Connect 2600
Get the news:
Low cost Restless Powerbox
Win an intelligent Power Supply:
Restless Powerbox Compact
FMS | www.fmsweb.de
Customisation
3 real world examples
FMS | www.fmsweb.de
Example#1
Enhance Auto Discovery for
RouterBOARD devices
FMS | www.fmsweb.de
Objectives
Discover RouterBOARD type
Show right image
FMS | www.fmsweb.de
Standard Auto Discovery Output
FMS | www.fmsweb.de
Enhanced Auto Discovery Output
FMS | www.fmsweb.de
Steps to take
1. Create a new device type for each
RouterBOARD
2. Set appearance options for device types
3. Set discovery options for device types
FMS | www.fmsweb.de
1) Create new Device Type
FMS | www.fmsweb.de
2) Set apperance options
Icon:
Image (JPG, GIF) or
vectorbased (SVG)
Upload to Dude like
Other files
FMS | www.fmsweb.de
3) Set discovery options
How to identify a device type by scanning?
Guessing by combination of scanned services
By availability of a vendor dependent service
By SNMP query
Requires support by the device
Which OID to check?
FMS | www.fmsweb.de
SNMP Walk
FMS | www.fmsweb.de
Create Probe
FMS | www.fmsweb.de
Modify new probe
FMS | www.fmsweb.de
Identification
Required Probe =
CheckForRB750Series
Allowed Probes =
CheckForRB750Series
+ anything
FMS | www.fmsweb.de
Identification
Result:
Devices with „RouterOS RB750“ in SNMP answer
will be detected as device type „RB750 Series“
Remark:
„Treat Service as available only if up“ ensures,
that other answers will be interpreted as „service
not available“
FMS | www.fmsweb.de
Services Tab
Checked box =
a service, that was available
during „discover“ will not be
added to the monitoring list of
the device
Ignore device detection probe
FMS | www.fmsweb.de
Details about SNMP OID
Many vendors give system information by SNMP
OID 1.3.6.1.2.1.1.1.0
RouterOS behaviour
until ROS 4.x value = router
from ROS 5.x value = RouterOS RB750G
FMS | www.fmsweb.de
Different behaviour in ROS 4 and 5
FMS | www.fmsweb.de
Example 2
ALFO Performance
FMS | www.fmsweb.de
SIAE ALFO Full Outdoor Microwave
The vendor
SIAE from Italy
Market leader in Germany
Carrier grade
The device
ALFO, 100MBit Full Outdoor
Medium priced
Often used for connecting
MikroTik base stations
FMS | www.fmsweb.de
Identification
As in the last example
With SNMP based probe:
OID: 1.3.6.1.2.1.1.1.0
(iso.org.dod.internet.mgmt.mib 2.system.sysDescr.0)
Compare: Regex
Value: ALFO MIB
FMS | www.fmsweb.de
Link Labels
FMS | www.fmsweb.de
Link Labels
FMS | www.fmsweb.de
Edit Labels
FMS | www.fmsweb.de
Label
Function [snmp_wireless_link_info()]
String Rx:
Variable [Interface.InBitRate]
[snmp_wireless_link_rx_rate()]
String Tx:
Variable [Interface.OutBitRate]
Function [snmp_wireless_link_tx_rate()]
FMS | www.fmsweb.de
Custom ALFO Labels
FMS | www.fmsweb.de
Label 1
10.20.1.11
Rx: [oid("1.3.6.1.4.1.3373.12.10.1.1.13.0","5","300","10.20.1.11","ALFO")] dBm
Tx: [oid("1.3.6.1.4.1.3373.12.10.1.1.12.0","5","300","10.20.1.11","ALFO")] dBm
Rx: [Interface.InBitRate]
Tx: [Interface.OutBitRate]
10.20.1.12
Rx: [oid("1.3.6.1.4.1.3373.12.10.1.1.13.0","5","300","10.20.1.12","ALFO")] dBm
Tx: [oid("1.3.6.1.4.1.3373.12.10.1.1.12.0","5","300","10.20.1.12","ALFO")] dBm
FMS | www.fmsweb.de
OID Function
oid("1.3.6.1.4.1.3373.12.10.1.1.13.0","5","300","10.20.1.11","ALFO")
Function: oid()
1. parameter: # of OID to get
2. parameter: Cache time in seconds
3. parameter: Negative cache time in minutes
4. parameter: Device IP
5. parameter: SNMP profile
FMS | www.fmsweb.de
Functions and Functions Description
FMS | www.fmsweb.de
Label 2
Label source is a function
call: [alfo_capacity()]
Custom function
Additional challenge:
Required information not
directly available by SNMP
ALFO MIB will provide combined number code for
operational mode (Ch. BW and Modulation)
Using nested if statements for creating output
FMS | www.fmsweb.de
Create new Function
FMS | www.fmsweb.de
Label 2 – individual function
if (oid_raw("1.3.6.1.4.1.3373.12.8.4.0")=13,
"
Bandwidth: 100MBit/s (FD)
Channel: 28MHz
Modulation: 32QAM
",if (oid_raw("1.3.6.1.4.1.3373.12.8.4.0")=8,
"
Bandwidth: 34MBit/s (FD)
Channel: 14MHz
Modulation: 16QAM
",if (oid_raw("1.3.6.1.4.1.3373.12.8.4.0")=11,
"
Bandwidth: 68MBit/s (FD)
Channel: 28MHz
Modulation: 16QAM
","unknown")))
FMS | www.fmsweb.de
Device Types Example#3
VMware Server and ESX
FMS | www.fmsweb.de
VMware server 2 and ESX 3
Separate types for different products
Even better visualization with different icons
Web access and tools
FMS | www.fmsweb.de
TCP Probe
VMware Server 2 and ESX3 have different
management ports
Use TCP probes for identification
VMware Server2 Ports: 902, 8222, 8333
VMware ESX 3 Ports: 902
FMS | www.fmsweb.de
VMware Console Probe
(TCP, connect only)
FMS | www.fmsweb.de
VMware Server GUI Probe
(TCP wo/w connect)
FMS | www.fmsweb.de
Device Type Identification
VMWare Type Server 2 ESX Server
Require 8333 902
Allow 902 902
8222
8333
FMS | www.fmsweb.de
Result of Discover
FMS | www.fmsweb.de
Device Type > General > URL
Change Default URL:
http > https
Port 80 > 8333
URL will be available
as variable:
[DeviceType.Url]
FMS | www.fmsweb.de
Device Type > General > URL
FMS | www.fmsweb.de
Add desired functionality
1. Create tool in the tools section
2. Select appropriate device types
(can not be changed afterwards)
3. Will appear in the tools menus
FMS | www.fmsweb.de
Create new tool
FMS | www.fmsweb.de
Custom Tools (Webbased)
Browse datastore
[DeviceType.Url]/folder?dcPath=ha datacenter
Download infrastructure client
[DeviceType.Url]/client/VMware viclient.exe
[DeviceType.Url] has been adapted for Server2
Server 2: [DeviceType.Url] = https://URL:8333
ESX 3: [DeviceType.Url] = http://URL
FMS | www.fmsweb.de
Webbased Tools
FMS | www.fmsweb.de
Custom Tools (Applications)
Launch VI client:
"C:\Programme\VMware\Infrastructure\Virtual
Infrastructure Client\Launcher\VpxClient.exe" –s
[Device.FirstAddress]
Launch VI client and log in:
"C:\Programme\VMware\Infrastructure\Virtual
Infrastructure Client\Launcher\VpxClient.exe" –s
[Device.FirstAddress] u [Device.UserName] –p
[Device.Password]
FMS | www.fmsweb.de
“Launch VI client” in Detail
FMS | www.fmsweb.de
Finished: VMware Server 2 Device Type
FMS | www.fmsweb.de
Using tool „Log into VI Client“
FMS | www.fmsweb.de
Thank you for listening
FMS Internetservice, www.fmsweb.de
[email protected], Phone: +49 761 2926500 copyright FMS 2011