RACOM M!DGE2 User Manual
  1. Manuals
  2. Brands
  3. RACOM Manuals
  4. Network Router
  5. M!DGE2
  6. User manual
RACOM M!DGE2 User Manual

RACOM M!DGE2 User Manual

Gprs/umts/hspa+/lte router
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
User manual
GPRS/UMTS/HSPA+/LTE
fw 4.2.x.x
6/11/2019
version 1.2
RACOM s.r.o. | Mirova 1283 |
Tel.: +420 722 937 522 | E -mail: racom@racom.eu
.
M!DGE2
router
.
592 31 Nove Mesto na Morave | Czech Republic
www.racom.eu

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the M!DGE2 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for RACOM M!DGE2

Summary of Contents for RACOM M!DGE2

  • Page 1 User manual M!DGE2 GPRS/UMTS/HSPA+/LTE router fw 4.2.x.x 6/11/2019 version 1.2 RACOM s.r.o. | Mirova 1283 | 592 31 Nove Mesto na Morave | Czech Republic www.racom.eu Tel.: +420 722 937 522 | E -mail: racom@racom.eu...

  • Page 3: Table Of Contents

    8.6. Manage keys and certificates ................... 163 8.7. Getting status information ....................164 8.8. Scan ..........................165 8.9. Sending e-mail or SMS ....................166 8.10. Restarting services ......................166 8.11. Debug ..........................167 8.12. Resetting system ......................167 © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 4 4.7. Digital output parameters ......................16 4.8. Voltage Polarity connector misconnection Risks ................ 16 4.9. M!DGE interfaces and status indicators ..................18 4.10. Technical specifications ......................19 4.11. Pin Assignments of COM/IO module ..................24 M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 5: Important Notice

    • Under no circumstances is RACOM or any other company or person responsible for incidental, acci- dental or related damage arising as a result of the use of this product. RACOM does not provide the user with any form of guarantee containing assurance of the suitability and fit for purpose.

  • Page 6: Getting Started

    Insert a SIM card into the SIM socket. Make sure the SIM is enabled for data transmission. 2. Connect and fit the cellular antenna If needed, contact RACOM for suitable antennas and other details. 3. Connect the LAN cable Connect one M!DGE Ethernet port to your computer using an Ethernet cat.5 cable.

  • Page 7: M!Dge Router

    Thanks to the compact size and versatility of M!DGE, wireless routers prove indispensable in many SCADA and telemetry, as well as POS, ATM, lottery and security/surveillance applications. M!DGE together with RACOM RipEX radio router offers an unrivalled solution for combining cellular and UHF/VHF licensed radios in a single network.

  • Page 8: Standards

    EN 301 489-17 V3.2.0 EN 301 489-24 V1.5.1 EN 301 489-52 V1.1.1 RF Spectrum EN 300 328 V2.1.1 EN 301 511 V9.0.2 EN 301 908-1 V11.1.1 EN 301 908-2 V11.1.1 EN 301 908-13 V11.1.1 M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 9: M!Dge In Detail

    ○ NAPT / Port Forwarding ○ Stateful Inspection Firewall ○ Firewall • Virtual Private Networking (VPN) (Section 7.5, “VPN”) ○ OpenVPN Server/Client ○ IPsec Peer ○ PPTP Server/Client ○ GRE Peer • Services (Section 7.6, “SERVICES” ) © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 10 ○ Batch configuration with text files ○ User administration ○ Troubleshooting tools ○ Over the air software update ○ Licensing (extra features) ○ Keys and certificates (HTTPS, SSH, OpenVPN, ...) ○ Legal Notice M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 11: Implementation Notes

    VPN tunnels solution is closely connected with the center and is also described in application note "M!DGE/MG102i - VPN Configuration" http://www.racom.eu/eng/products/m/midge/app/scada.html http://www.racom.eu/eng/products/m/midge/app/midge-mg102i_centre.html http://www.racom.eu/eng/products/m/midge/app/VPN_config.html © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 12: Product

    Fig. 4.2: Antenna connectors SMA The M!DGE router is equipped with two antenna connectors. The ANT connector serves as a main antenna connection, the AUX connector is auxiliary and serves for better communication with BTS (diversity). M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 13: 4× Eth Rj45 Plug

    M!DGE uses USB 2.0, Host A interface. USB interface is wired as standard: Tab. 4.3: USB 2.0 Host Port Specification Feature Specification Speed Low, Full & Hi-Speed Current max. 500 mA Max. cable length Cable shield mandatory Connector type Type A © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 14: Usb Pin Description

    Product Tab. 4.4: USB pin description USB pin signal wire +5 V Data (−) white Data (+) green black M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 15: Microsim Cards Slots

    4.2.5. Screw terminal Screw terminal plug type Stelvio Kontek CPF5/15 or MRT3P/15V01 can be used. Fig. 4.5: Screw terminal Screw terminal plug types: Phoenix Contact 1847204 (MC 1.5/10-STF-3.5) for 10 pins plug and © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 16: Screw Terminal Pin Assignment

    DP [1] − − DO1-1 − − Nde [2] Nde [2] DO1-2 − − DO2-1 − − Nde [3] Nde [3] DO2-2 − − DI1− − − OK [4] Nde [4] DI1+ − − M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 17: Reset Button

    ○ Press at least 15 seconds to release a recovery procedure. ○ The start of the recovery procedure is confirmed by all LEDs lighting up RED for a second. Note Contact our technical support (support@racom.eu) for recovery procedure details and required files. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 18: Indication Leds

    - User application (state set by user in SDK or LXC) green on System operation state: normal green blinking System operation state: warning or in a transition red on System operation state: emergency, watchdog, failure M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 19: Technical Specifications

    UMTS Terrestrial Radio Access (UTRA) Frequency Division Duplex (FDD) DL Rx diversity 2G GSM/GPRS/EDGE 3GPP Release 8 Enhanced Data rate GSM Evolution (EDGE) GSM EGPRS Radio Access (GERA) Time Division Multiple Access (TDMA) © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 20 −40 to +70 °C (−40 to +158 °F) Environmental Humidity: 0 to 95 % (non condensing) Conditions MTBF (Mean Time Between Failure) > 220.000 hours (> 25 years) Overvoltage Category: Pollution Degree: Mounting DIN rail mounting M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 21 45 W × 110 D × 125 H mm (1.77 × 4.33 × 4.92 in) Weight Ca. 450g (0.99 lbs) Type Approval CE, FCC Options Antennas Various antennas suitable for your application are available Mounting kit Flat bracket mounting kit © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 22: Model Offerings

    Note: ‘P’ and ‘A’ are available for high volumes only • Slot – Proprietary extension slot Possible values: N – not used C – The second RS232/485 + 1×DI,1×DO, Part No.: M!DGE2-HW-COM/IO pin description signal RS-232 GND (non-isolated) RS-232 RxD (non-isolated); RS485 A (Half-Duplex) RS-232 TxD (non-isolated);...
  • Page 23 M!DGE, M!DGE2 • Order code – the complete product code, which is used on Quotations, Invoices, Delivery notes etc. In order to find out the correct Order code, please use RACOM WebService https://webservice-new.racom.eu/main/eshop.list?t=10 © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 24: Model Offerings

    Server Licence Enlargement of feature items count - see table below Feature Standard Server licence DHCP reservations Local host names NAPT rules Firewall rules Firewall address groups OpenVPN clients Static routes DynDNS server M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 25: Accessories

    Product 4.7. Accessories 4.7.1. F bracket Flat-bracket Installation bracket for flat mounting. For usage details see chapter Mounting and chapter Dimensions. Fig. 4.8: Flat bracket Fig. 4.9: Flat bracket dimensions © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 26: Bench Test / Step-By-Step Guide

    SIM card are read only after a power cycle. 5.1.2. Connect the cellular antenna Fit a cellular antenna. For details see RACOM web or contact RACOM for suitable antennas. 5.1.3. Connect the LAN cable Connect one M!DGE Ethernet port to your computer using an Eth cat.5 cable.

  • Page 27: Basic Setup

    2. Entering the PIN code for the SIM card 3. Configuring the Access Point Name (APN) 4. Starting the mobile connection Note Router M!DGE can be safely turned off by unplugging the power supply. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 28: Installation

    M!DGE can be powered with an external power source capable of voltages from 9.6 to 28.8 Volts DC. M!DGE should be powered using a certified (CSA or equivalent) power supply, which must have a limited and SELV circuit output. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 29: Web Configuration

    The highest priority link which has been established successfully will become the so-called hotlink which holds the default route for outgoing packets. Detailed information about status of each WAN interface is available in a separate window. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 30: Interfaces

    1st priority: This link will be used whenever possible. 2nd priority: The first fallback technology. Up to four priorities can be used. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 31 Typically, such connected device (e.g. firewall) will not need any special configuration facing M!DGE, it will just use its mobile IP address (usually the public IP address). © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 32 This option is configurable within WWAN links only. Remember that LAN1 cannot be used as the port for the IP passthrough functionality. • LAN10 is not usable within M!DGE routers. Do not select it. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 33 The link will be considered up again if at least one host is reachable. You may further specify an emergency action if no uplink can be established at all. Configurable actions are: • None • Restart link services • Reboot system © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 34 Configure the Emergency action which should be taken after the maximum downtime is reached. Using "reboot" performs the system reboot. The option "restart services" restarts all link-related applica- tions including the modem reset. No action is done if the "none" M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 35 If it is desired to have both ports in the same LAN you may assign them to the same interface. Please note that the ports will be bridged by software and operated by running the Spanning Tree Protocol. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 36 In case of negotiation problems, you may assign the modes manually but it has to be ensured that all devices in the network utilize the same settings then. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 37 IP Settings Two individual tabs will be used when different LANs are set in the Port settings menu. Each of them can be configured either in the LAN mode or in the WAN mode. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 38 Alias IP address enables configuring the LAN interface with a second IP address/subnet. Configure MTU of a given Ethernet interface. Note Setting of the IP address is interconnected with the DHCP Server (if enabled) - menu the SERVICES - DHCP Server menu. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 39 Leave it blank unless you have many services and need to specify the one you need to connect to. Access Concentrator This may be left blank and the client will connect to any Name: access concentrator. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 40 WWAN interfaces with one modem but different SIM cards. Close attention has to be paid when other services (such as SMS or Voice) are operating on that modem as a SIM switch will affect their operation. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 41 LAC of any given location area. It can be used to force the modem to register to a particular mobile cell in case of competing stations. You may further initiate mobile network scan for getting networks in range and assign a LAI manually. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 42 *99***1#. For circuit switched 2G connections you can enter the fixed phone number to be dialed in the international format (e.g. +420xx). Access point name The access point name (APN) being used M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 43 Enables or disables the data compression for PPP-based connec- tions. Data compression reduces the packet size to improve throughput. Has to be supported by your provider. Client address Specifies a fixed client IP address on the mobile interface. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 44 Netmask Netmask of the local interface (available only if "Enabled with local inter- face" was selected) Optional MTU size for the local interface (available only if "Enabled with local interface" was selected) M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 45 Following files must exist in the root directory of a FAT16/32 formatted stick: • For authentication: autorun.key • For a software update: sw-update.img • For a configuration update: cfg-<SERIALNO>.zip or cfg.zip © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 46 "sha-256 hash calculator"). 7.2.6. Serial Port The serial protocol can function in various ways, configure it using the Edit button on the right. If the USB Administration is enabled, an extra SERIAL2 (USB) is available. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 47 Special implementation of various serial protocols like Modbus, IEC101, DNP3, ... See the details below. This option enables controlling the serial interface via the SDK scripts (similar to C programming). See chapter SDK for more details. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 48 While 3 wired connection is used with M!DGE hardware flow control: control is not available. Server Protocol on IP port: “Telnet” or “TCP raw” Configuration: Port: The TCP port used by the application. Timeout: Endless or numbered (in seconds). M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 49 Modem bridge Direct connection between the LTE modem tty and the serial interface (e.g. for dial-in connections to Metering unit). Configure the RS232 as required and choose the mobile modem required. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 50 Number Remote phone number. IP address Remote IP address. Port Remote port number. Note More details in the Serial SCADA Protocols application note. http://www.racom.eu/eng/products/m/midge/app/ser/index.html M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 51 The default Idle size differs based on the serial baud rate configuration. Remember that the default Idle sizes are set to the minimal possible values: 115200 57600 38400 19200 9600 4800 2400 1200 © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 52 All timeouts in the parameters described below are derived from the time when the packet is sent into the COM driver, i.e. it includes the transfer time of the packet. Take this into account especially when there is a low Baud rate set in the COM settings. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 53 Master and Slave SCADA units. Because of that, it is necessary to set which type of SCADA unit is connected to the Unit. Important For the SCADA Master, set Master, for the SCADA Slave, set Slave. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 54 This UDP port is used as the destination UDP port in the UDP datagram in which the serial SCADA packet received from COM1 is encapsulated. The default UDP port for COM can be M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 55 ○ Broadcast accept List box: On, Off Default = Off If On, broadcast messages from the Master SCADA device to all Slave units are accepted and sent to connected Slave SCADA unit. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 56 Slave • Protocol frames List box: 1C, 2C, 3C, 4C Default = 1C One of the possible C24 Protocol frames can be selected. • Frames format List box: Format1, Format2, Format3, Format4, Format5 M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 57 More Comli Masters can be used within one network and one Slave can be polled by more Masters. Broadcasts packets are not used, so the configuration is using only some parameters described in Common parameters. Mode of Connected device © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 58 • Broadcast - Note: There is not the option to set the Broadcast address, since DNP3 broadcast messages always have addresses in the range 0xFFFD – 0xFFFF. Broadcasting is not supported by mobile networks, thus it is not possible to set the broadcast to On.. Address translation Table Mask M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 59 Master station broadcast is generated when the address byte is 0x00. ITT Flygt ITT Flygt is a serial polling-type communication protocol used in Master–Slave applications. ITT Flygt protocol configuration uses all parameters described in Common parameters. Mode of Connected device Master Broadcast © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 60 Profibus. The Profibus DP is supported even by M!DGE, but it will work satisfactorily only with mobile networks with very short transport delays, like LTE or UMTS. The Profibus protocol configuration uses all parameters described in Common parameters. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 61 (Slave) is not received within the timeout, i.e. the respective Slave is out of order, the central Unit stops the local answering to RB packets from the master for the respective Slave. Address translation Table © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 62 There is a handshake STX(0x02) – DLE(Ox10) at the start of communication and DLE+ETX – DLE at the end. This handshake is performed by M!DGE/RipEX locally, it is not transferred over the network. Communication goes as follows: LocalRTU→STX→LocalRipex LocalRipex→DLE→LocalRTU LocalRTU→DATA+DLE+ETX+BCC→LocalRipex LocalRipex→DATA→RemoteRipex* LocalRipex→DLE→LocalRTU RemoteRipex→STX→RemoteRTU RemoteRTU→DLE→RemoteRipex RemoteRipex→DATA+DLE+ETX+BCC→RemoteRTU RemoteRTU→DLE→RemoteRipex M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 63 Unit waits for DLE. When it is Low, the Unit send DLE. Note: Obviously, two devices which are communicating together must be set so that one has High priority and the other has Low. • BCC © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 64 Unit and appended to the received data. UNI is the "Universal" protocol utility designed by RACOM. It is supposed to be used when the applic- ation protocol is not in the Unit list. The key condition is that messages generated by the Master applic- ation device always contain the respective Slave address and that address (or its relevant part) position, relative to the beginning of the message (packet, frame), is always the same (Address position).
  • Page 65 This mode is suitable for the Master–Master communication scheme or a combination of the UNI and ASYNC LINK protocols. Broadcast Address translation Table Mask Slave Broadcast accept © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 66 Besides on and off you may keep the status after reboot at default which corresponds to the default state as the hardware will be initialized at power-up. The digital inputs and outputs can also be monitored and controlled by SDK scripts. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 67 TTL logic (L: 0 to 0.8 V, H: 2 to 3.3 V), minimal connected load 100 Ω GNSS status This pages provides further information about the satellites in view and values derived from them: © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 68 The PRN code of the satellite (also referred as satellite ID) as stated in GPGSA Elevation stated in GPGSV The elevation (up-down angle between the dish pointing direction) frames in degrees as stated in GPGSV frames M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 69 Enable or disable the GNSS module Operation mode The mode of operation, either standalone or assisted (for AGPS) Antenna type The type of the connected GPS antenna, active 3 VDCt powered Accuracy The desired accuracy in meters © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 70 JSON format (i.e. newer libgps is used) the json mode can be specified. Note Please consider to restrict access to the server port, either by a specifying a dedicated client network or by using a firewall rule. Satelites M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 71: Routing

    7.3. ROUTING 7.3.1. Static Routes This menu shows all routing entries of the system, which can consist of active and configured ones. (Netmasks can be specified in CIDR notation, e.g. 24 expands to 255.255.255.0). © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 72 You can check the corresponding routing via the "Route lookup" functionality. Just fill in the desired IP address and click on the "Lookup" button. The detailed information about the chosen route will be dis- played. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 73 The interface on which the packet enters the system Source address The packet source address Source netmask The packet source netmask Destination address The packet destination address Destination netmask The packet destination netmask Protocol Protocol used (ANY, UDP or TCP) © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 74 Nexthop address to be used as a default gateway for the selected in- terface 7.3.4. Multicast Multicast routing (MCR) can be configured and managed by a daemon. Only one MCR daemon can be used at a time. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 75 Specifies whether multicast routing is active. Incoming interface The upstream interface on which multicast groups are joined and on which multicast packets come in. Distribute to Specifies the downstream interfaces to which multicast packets will be forwarded. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 76 (available range: 1 - 4294967295). Redistribute connected routes Redistribute routes to networks which are directly connected to the M!DGE router. Redistribute local routes Redistribute routes from the M!DGE router’s own routing table. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 77 The Networks tab allows to add IP network prefixes that shall be distributed via BGP in addition to the networks that are redistributed from other sources as defined on the general tab. Prefix Prefix of the network to be distributed. Prefix length Length of the prefix to be distributed. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 78 The interfaces tab is used to define OSPF specific settings for the IP interfaces of the router. If no settings are defined for a specific interface, default settings will be used. Interface The name of the interface for which settings shall be defined. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 79 Our implementation supports RFC 3344, 5177, 3024 and 3519 and interoperability with Cisco has been verified. However, M!DGE routers can run as node and home agent which makes them able to replace expensive kits in the backbone for smaller scenarios. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 80 UDP encapsulation: Specifies whether UDP encapsulation shall be used Mobile network address: Optionally specifies a subnet which should be routed to the box Mobile network mask: The netmask for the optional routed network M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 81 The mask for the home network. Shared secret The shared secret used for the mobile node authentication at the home agent. This can be either a 128-bit hexadecimal value or a random length ASCII string. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 82 The bandwidth congestion method. In case of the auto option, the system will try to apply limits in a best-effort way. However, it is sug- gested to set fixed bandwidth limits as they also offer a way of tuning the QoS behaviour. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 83 A low priority queue which may hold less-critical services for which shaping is intended. Each queue can be configured as follows: Name: The name of the QoS queue. Priority: A numerical priority for the queue, lower values indicate higher priorities. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 84 Specifies a network address and netmask used to match the destination (target) address of packets Protocol: Specifies the protocol for packets to be matched Type of Service: Specifies the ToS/DiffServ for packets to be matched M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 85: Firewall

    (TCP ports 80, 443, 22 and 23): Address / Port Groups This menu can be used to form address or port groups which can be later used for firewall rules in order to reduce the number of rules. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 86 Used IP protocol of matching packets. Destination port(s): Destination port of matching packets. You can specify a single port or a range of ports here. Note that protocol must be set to UDP/TCP when using port filters. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 87 Interface The outgoing interface on which connections will be masqueraded. Source address The source address or network from which matching packets are masqueraded. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 88 Incoming interface: Interface from which matching packets are received Source The source address or network from which matching packets are received. Map: Choosing whether the rule applies to the host or to the network. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 89 "network") Rewrite to address/port: Address/port to which the source address/port of matching packets will be rewritten to Rewrite to network/netmask: Network/netmask to which the source network/netmask of matching packets will be rewritten to © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 90: Vpn

    Operation mode: Choose the client or server mode for this tunnel Note M!DGE can be running up to 4 OpenVPN tunnels in the Client mode, but only one tunnel in the Server mode. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 91 OpenVPN's HMAC usage is to first encrypt a packet, then HMAC the resulting cipher text. If OpenVPN receives a packet with a bad HMAC, it drops this packet. HMAC usually adds 16 or 20 Bytes per packet. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 92 Check peer certificate against local CRL. Server Mode A server tunnel typically requires the following files: • server.conf (OpenVPN configuration file), • ca.crt (root certificate file), • server.crt (certificate file), • server.key (private key file), M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 93 The downloaded expert mode file needs to be unzipped and then individual client expert files can be uploaded to the respective routers. Note See the OpenVPN configuration example in our Application notes. http://www.racom.eu/eng/products/m/midge/app/vpn/OpenVPN.html © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 94 IP address/port of packets. It encapsu- lates packets in UDP and therefore requires a slight overhead which has to be taken into account when running over smallsized MTU interfaces. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 95 The action when a DPD enabled peer is declared dead. Hold (default) means the eroute is put into the hold status, while clear means the eroute and SA will both be cleared. Restart means that the SA will be immediately renegotiated. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 96 Web Configuration IKE Proposal RACOM routers support IKEv1 or IKEv2 authentication via the pre-shared keys (PSK) or certificates within a public key infrastructure. Using PSK requires the following settings: PSK: The pre-shared key used Local ID Type: The identification type for the local router which can be FQDN, username@FQDN...
  • Page 97 IPsec Proposal Encapsulation mode: Only the tunnel encapsulation mode is enabled IPsec protocol: Only the ESP IPsec protocol is enabled Encryption algorithm: The IKE encryption method (3DES, AES128, AES192, AES256, blowfish128, 192 and 256) © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 98 The NAT address must reside in the network previously specified as the local network. Note Since the firmware 3.7.40.103, the maximum number of networks for individual IPsec tunnels has increased from 4 to 10. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 99 Specifies on which IP address should be listened for incoming client connections Server address: The server address within the tunnel Client address range: Specifies a range of IP addresses assigned to each client http://www.racom.eu/eng/products/m/midge/app/vpn/IPsec.html © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 100 Once configured, individual clients can be configured with different credentials and IP addresses. A client tunnel requires the following parameters to be set: Server address: The address of the remote server Username: The username used for authentication Password: The password used for authentication M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 101 Besides the admin account you can configure further users in the user accounts section, which shall be allowed to dial-in. Please note that Dial-In connections are generally discouraged. As they are im- plemented as GSM voice calls, they suffer from unreliability and poor bandwidth. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 102: Services

    7.6. SERVICES 7.6.1. SDK RACOM routers are shipping with a Software Development Kit (SDK) which offers a simple and fast way to implement customer-specific functions and applications. It consists of: 1. An SDK host which defines the runtime environment (a so-called sandbox), that is, controlling access to system resources (such as memory, storage and CPU) and, by doing so, catering for the right scalability.
  • Page 103 .WANLINK2_SIGNAL_STRENGTH = string[3]: "-69" .WANLINK2_DATA_DOWNLOADED = string[6]: "747608" .WANLINK2_DATA_UPLOADED = string[7]: "1225984" .WANLINK1_DATA_UPLOADED = string[3]: "n/a" .WANLINK2_ADDRESS = string[11]: "10.203.0.28" .WANLINK2_NETWORK = string[7]: "O2 - CZ" .WANLINK1_DIAL_SUCCESS = string[1]: "0" .WANLINK2_PDP = string[4]: "PDP1" © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 104 /* Check the current NTP server and set it to the IP address 192.168.0.2 and enable the NTP synchronisation */ printf ("The NTP server was previously using IP address: "); printf (nb_config_get("network.ntp.server0")); printf("\n\n"); M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 105 Files written to/tmp will be hold in the memory and will be cleared upon a script restart.. As your scripts operate in the sandbox, you will have no access to the system tools (such as ifconfig). Administration © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 106 The status page informs you about the current SDK status. It provides an overview about any finished jobs, you can also stop a running job there and view the script output in the troubleshooting section where you will also find links for downloading the manuals and examples. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 107 Specifies the time condition for time-based triggers (e.g. hourly) Timespec: The time specification which, together with the condition, specifies the time(s) when the trigger should be pulled Event: The system event upon which the trigger should be pulled © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 108 ("The NTP server was previously using IP address: "); printf (nb_config_get("network.ntp.server0")); printf("\n\n"); nb_config_set("network.ntp.server0=192.168.0.2"); if (nb_config_get ("network.ntp.status") == "0"){ printf ("and was not running."); printf("\n\n"); nb_config_set ("network.ntp.status=1"); else { printf ("and was running."); printf("\n\n"); M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 109 Having a closer look to the script, you will see that you will also be able to restrict the list of permitted senders. Please inspect the system log for troubleshooting any issues. The following commands are supported: status An SMS with the following information will be returned • Signal strength © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 110 Switch digital output 2 off A response to the status command typically looks like: System: MIDGE midge (0002A9FFC32E) WAN1: WWAN1 is up (10.204.8.3, Mobile1, HSPA, -65 dBm, LAI 23003) DIO: IN1=off, IN2=off, OUT1=off, OUT2=on M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 111 DNS server address if not configured elsewhere. It is possible to specify different addresses here. Static Hosts: The option to add a static host configured with the IP address, MAC ad- dress and/or hostname. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 112 The secondary default name server which will be used instead of ne- gotiated name servers. You may further configure static hosts for serving fixed IP addresses for various hostnames. Please remember to point local hosts to the router’s address for resolving them. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 113 Dynamic DNS client on this box is generally compatible with various DynDNS services on the Internet running by means of definitions by the DynDNS organization (see www.dyndns.com for server imple- mentations). Administrative status: Enabled or disabled © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 114 TSIG key The TSIG key encoded in base64. Please note that your RACOM router can operate as DynDNS service as well, provided that you hold a valid SERVER license and have your hosts pointed to the DNS service of the router.
  • Page 115 SMTP server port (typically 25) Authentication: Choose the required authentication method to authenticate against the SMTP server Encryption: The optional encryption for the e-mail messaging (none or TLS) Username: User name for authentication Password: Password for authentication © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 116 After configuring E-mail successfully, you can also test e-mail messages. 7.6.7. Events By using the event manager you can notify remote systems about system events. A notification can be sent using E-Mail, SMS or SNMP traps. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 117 (702) Outgoing voice call is being established DDNS ddns-update-failed (802) Dynamic DNS update failed ddns-update-succeeded (801) Dynamic DNS update succeeded DIALIN dialin-down (409) Dial-In connection went down dialin-up (408) Dial-In connection came up © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 118 (505) System has been started system-time-updated (508) System time has been updated TEST test (506) test event usb-eth-added (903) USB Ethernet device has been added usb-eth-removed (904) USB Ethernet device has been removed M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 119 This page lets you turn on the SMS event notification service and enable remote control via SMS. Administration On RACOM routers it is possible to receive or send short messages (SMS) over each mounted modem (depending on the assembly options). Messages are received by querying the SIM card over a modem, so prior to that, the required assignment of a SIM card to a modem needs to be specified on the SIMs page.
  • Page 120 Please note that numbers have to be entered in international format including a valid prefix. On the other hand, you can also define rules to drop outgoing messages, for instance, when you want to avoid using any expensive service or international numbers. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 121 This page can be used to test whether SMS sending in general or filtering/routing rules works. The maximum length per message part is limited to 160 characters, we also suggest to exclusively use characters which are supported by the GSM 7-bit alphabet. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 122 Other users may have access as usual, but with restricted privileges. Disable password-based login: By turning on this option, all users will have to authenticate by SSH keys which can be uploaded to the router. Note You can manually upload the authorized keys. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 123 GNSS and WLAN on M!DGE are available with special extension only. M!DGE extensions contain support for: • Rebooting the device • Updating to a new system software via FTP/TFTP/HTTP • Updating to a new system configuration via FTP/TFTP/HTTP • Getting WWAN/GNSS/WLAN/DIO information © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 124 • get software update status: snmpget -v 3 -u admin -n "" -l authNoPriv -a MD5 -x DES -A admin01admin01 192.168.1.1 1.3.6.1.4.1.33555.10.40.14.0 Return value can be either of: (1) succeeded, (2) failed, (3) inprogress, (4) notstarted. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 125 Listening port SNMP agent port Once the SNMP agent is enabled, SNMP traps can be generated using SDK scripts or can be triggered by various Events (see the SYSTEM → Events menu). SNMP Authentication © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 126 In order to enable HTTPS you would need to generate or upload a server certificate in the section SYSTEM-Keys and Certificates. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 127 Either information that the certificate is 'installed' or a link to create such certificate. HTTPS security: Choose the HTTPS security level - follow the help within the menu itself. Enable CLI-PHP: Enable CLI-PHP service (see Section 8.16, “CLI–PHP”) © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 128 In case DHCP has been activated, please keep in mind that you will need to reconfigure the DHCP gateway address offered by the server and let them point to the virtual gateway address. In order to M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 129 The Modbus TCP daemon listens for the local TCP connection on the TCP port 502 by default. After the connection is established, the communication can be initiated. Any incoming Modbus TCP datagram is investigated and based on the Modbus TCP "Unit ID" Byte and Address translation Table/mask rules, © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 130 The TCP port for a session with local Modbus TCP Master. It can also be a remote Modbus TCP Master resulting in a TCP session over the cellular network instead of UDP. TCP inactivity [s] The TCP inactivity timeout in seconds. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 131 TCP messages and processed like it comes from a serial (RS232) port. When data reaches the destination M!DGE, it can be transferred to the RTU either via a serial interface or via TCP (UDP), using the Terminal server again. http://www.racom.eu/eng/products/m/ripex/app/modbus/index.html © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 132 Set the TS Type - either TCP or UDP session TCP Timeout: If the Type is TCP, configure the required TCP timeout (i.e. close the TCP session if there is no communication for a given time period) M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 133 M!DGE and locally connected application to any value up to 10 on each Terminal server. Protocol follows the same principles as a protocol on RS232 interface. The default UDP port is 8892 (transporting data usually over cellular network). © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 134 Web Configuration 7.6.16. Voice Gateway You can set up a voice gateway on the M!DGE2 router which can be used to connect mobile calls to VoIP clients and vice versa. Administration: The following parameters can be used to set it up:...
  • Page 135 DSP pro- cessing on board and could give added delay to the system. Volume level: Specifies the modem’s volume level. 1 = low. 9 = high. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 136 The type of action which shall be applied for the call: DROP will silently hangup the call, ROUTE will route the call to the specified endpoint. Destination Specfies the target endpoint (i.e. where to call is routed to). M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 137: System

    Windows is included in TFTP32 which can be provided if requested. In general, the unit comes with an internal flash device which can be used to store data or you can use the external USB disk. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 138 M!DGE can synchronize its system time with an NTP server. If enabled, time synchronization is usually triggered after a WAN link has come up but before starting any VPN connections. Further time synchronizations are scheduled in the background every 60 minutes. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 139 This option can be used to reflect daylight saving changes (e.g. switching from summer to standard time) depending on the selected time zone. Sync will perform the time synchronization immediately. Virtualization Virtualization gives customers the possibility to execute their own applications. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 140 Any other user represents a user with lower privileges, for instance it has only permission to view the status page or retrieve status values when using the CLI. Username: Define a user name. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 141 Enable or disable remote authentication. Use for login: This option enables remotely-defined users to access the Web Man- ager. Primary RADIUS configuration: Server address: RADIUS server address. Secret: Secret used to authenticate against the RADIUS server. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 142 Status LED. The backuped configuration will be applied at bootup and the Status LED will blink faster during this operation. Depending on your configuration, this may take a while. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 143 Every day at this time M!DGE will do a check for updates URL: The server URL where the software update package should be downloaded from. Supported protocols are TFTP, HTTP(s), and FTP Firmware Update © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 144 (such as certificates). File Configuration This section can be used to download the currently running system configuration (including essential files such as certificates). M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 145 You can choose between missing configuration directives stay the same as in the currently running configuration. Automatic Updates Status: Enable/disable automatic configuration update Time of day: Time of day when the system will check for updates © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 146 Important If you store the currently running configuration as the factory defaults, have in mind that the password is also stored within this configuration. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 147 Define the target host (IP or hostname), Time-To-Live (TTL - number of hops on the resulting route) and the timeout in seconds (max. time to wait for the final respond). The tcpdump utility generates a network capture (PCAP) of an interface which can be later analyzed with Wireshark. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 148 Download button. The captured file can be also downloaded from the /tmp/ directory via the appropriate file manager. The darkstat utility can be used to visualize your current network connections and traffic on a particular interface. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 149 After the utility initialization, it can be viewed in a separate window. Displaying graphs and individual host statistics are supported. System Debugging Log files can be viewed, downloaded and reset here. Please study them carefully in case of any issues. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 150 Web Configuration Default debugging levels for individual daemons are as follows: • configd – 4 • watchdog – 4 • swupdate – 5 • wwan-managerc – 5 • led-manager – 5 M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 151 Note For both direct E-mail and Online support form a connection to the Internet has to be available. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 152 VPN or WLAN in case of certificate based authentication. You can also revoke and invalidate certi- ficates again (for instance if they have been compromised or lost). The entry pages shows an overview about installed keys and certificates. The following sections may appear: M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 153 Download key and certificate in ZIP format (files will be encoded in PEM format) create signing request: Generate key locally and create a signing request to retrieve a certi- ficate signed by another authority © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 154 The certificate owner’s common name, mainly used to identify a host E-Mail The certificate owner’s email address Expiry period The number of days a certificate will be valid from now on Key size The length of the private key in bits M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 155 CA fingerprint: The fingerprint of the certificate used to identify the remote authority. If left empty, any CA will be trusted. Fingerprint algorithm: The fingerprint algorithm for identifying the CA (MD5 or SHA1). © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 156 • Click the padlock in the address bar • Click the More Information and the View Certificate button • Select the Details tab and press the Export button • Choose a path for the file (e.g. website.pem) M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 157 Availability means that the licence can be applied to the current hardware. The valid license is active if the status "licensed" is displayed in the respective line. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 158 We remind you that the source code of any package can be obtained by contacting our technical support at support@racom.eu. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 159: Logout

    Web Configuration 7.8. LOGOUT Log out from Web Manager. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 160: Command Line Interface

    Please note that each CLI session will perform an automatic logout as soon as a certain time of inactivity (10 minutes by default) have been reached. It can be turned off by the command no-autologout. The CLI can be exited by running exit. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 161: General Usage

    Yank the top of the deleted text into the buffer at point. Please note, that it can be required to apply quotes (") when entering commands with arguments con- taining whitespaces. The following sections are trying to explain the available commands. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 162: Print Help

    See the following example for reading configuration DIO values: > get dio.out1 dio.out1=on > get dio.out2 dio.out2=on M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 163: Setting Config Parameters

    Install SSH authorized keys 8.6. Manage keys and certificates The update command can be used to manage keys and certificates. > cert -h Usage: cert [-h] [-p phrase] <operation> <cert> [<url>] Possible operations: © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 164: Getting Status Information

    Digital IO status audio Audio module status CAN module status uart UART module status redundancy Redundancy status SMS status firewall Firewall status QoS status neigh Neighborhood status location Current location users Active users M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 165: Scan

    Available interfaces: Mobile1 (wwan0) See the example below: > scan -s Mobile1 NETWORK1_NAME="EUROTEL - CZ" NETWORK1_LAI="23002" NETWORK1_RAT="GSM" NETWORK1_SERVICE="CSD" NETWORK1_STATUS="Current" NETWORK2_NAME="vodafone CZ" NETWORK2_LAI="23003" NETWORK2_RAT="GSM" NETWORK2_SERVICE="CSD" NETWORK2_STATUS="Forbidden" NETWORK3_NAME="T-Mobile CZ" NETWORK3_LAI="23001" NETWORK3_RAT="GSM" NETWORK3_SERVICE="CSD" © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 166: Sending E-Mail Or Sms

    OpenVPN connections pptp PPTP connections QoS daemon smsd SMS daemon snmpd SNMP daemon surveyor Supervision daemon syslog Syslog daemon telnet Telnet server voiced Voice daemon vrrpd VRRP daemon wlan WLAN interfaces wwan-manager WWAN manager M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 167: Debug

    The reset command can be used to reset the router back to factory defaults. > reset -h Usage: reset [-h] [facility] Available reset facilities: factory Reset system to factory defaults statistics Reset link statistics © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 168: Rebooting System

    The service can later be turned on/off by setting the cliphp.status configuration parameter: > get cliphp.status cliphp.status=0 > set cliphp.status=1 > get cliphp.status cliphp.status=1 cliphp.status=0 Service is disabled cliphp.status=1 Service is enabled M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 169 OK: status command successful ERROR: authentication failed status – Display status information Key usage: command=status[&arg0=<section>] Notes: Available sections can be retrieved by running command=status&arg0=−h. System status can be displayed without authentication. Examples: http://192.168.1.1/cli.php?version=2&output=html&usr=admin&pwd=admin01&command= © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 170 '=' char, i.e. [arg0=key0, arg1=val0], [arg2=key1, arg3=val1], [arg4=key2, arg5=val2], etc Examples: http://192.168.1.1/cli.php?version=2&output=html&usr=admin&pwd= admin01&command=set&arg0=snmp.status&arg1=1 http://192.168.1.1/cli.php?version=2&output=html&usr=admin&pwd= admin01&command=set&arg0=snmp.status&arg1=0&arg2=openvpn.status&arg3=1 restart – Restart a system service Key usage: command=restart&arg0=<service> Notes: Available services can be retrieved by running 'command=restart&arg0=−h' Examples: http://192.168.1.1/cli.php?version=2&output=html&usr=admin&pwd= M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 171 - Run factory reset Key usage: command=reset Examples: http://192.168.1.1/cli.php?version=2&output=html&usr=admin&pwd=admin01&command=reset update - Update system facilities Key usage: command=update&arg0=<facility>&arg1=<URL> Notes: Available facilities can be retrieved by running 'command=update &arg0=−h' Examples: http://192.168.1.1/cli.php?version=2&output=html&usr=admin&pwd=127 admin01&command=update&arg0=software&arg1=tftp://192.168.1.254/latest http://192.168.1.1/cli.php?version=2&output=html&usr=admin&pwd= admin01&command=update&arg0=config&arg1=tftp://192.168.1.254/user− config.zip http://192.168.1.1/cli.php?version=2&output=html&usr=admin&pwd= admin01&command=update&arg0=license&arg1=http://192.168.1.254/xxx.lic © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 172 (the at−sign can be encoded with \%40) . The E−Mail client must be properly configured prior to using that function. In case of stdout , the downloaded techsupport file will be called 'download'. Examples: http://192.168.1.1/cli.php?version=2&output=mime&usr=admin&pwd=admin01& command=send&arg0=techsupport&arg1=stdout http://192.168.1.1/cli.php?version=2&output=html&usr=admin&pwd=admin01& command=send&arg0=techsupport&arg1=abc\%40abc.com&arg2=subject M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 173 The argument card specifies the card module index (e.g. 0 for wwan0 ). The USSD code can consist of digits , plus signs , asterisks (can be encoded with \%2A) and dashes (can be encoded with \%23) . Examples: http://192.168.1.1/cli.php?version=2&output=html&usr=admin&pwd=admin01& command=send&arg0=ussd&arg1=0&arg2=\%2A100\%23 © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 174: Troubleshooting

    Connection from the M!DGE router can be checked using the built-in pinger available in the SYSTEM → Troubleshooting → Network Debugging menu. The traceroute command is available in the same menu for tracing the packets from the M!DGE router to the Host. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 175 Troubleshooting 9.3.2. Log Files Information about boot-up process and about running processes can be found in the Linux-like Log files, see the SYSTEM→ Troubleshooting → System Debugging menu. © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 176: Safety, Environment, Licensing

    Always keep a distance bigger than 40cm from the antenna in order to keep your exposure to electro- magnetic fields below the legal limits. This distance applies to Lambda/4 and Lambda/2 antennas. Larger distances apply for antennas with higher gain. Adhere to the instructions documented in this user’s manual. M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.

  • Page 177: Rohs And Weee Compliance

    Equipment) and 2012/19/EU WEEE (Waste Electrical and Electronic Equipment) environmental directives. Used equipment must be collected separately, and disposed of properly. Racom has instigated a programme to manage the reuse, recycling, and recovery of waste in an environmentally safe manner using processes that comply with the WEEE Directive.

  • Page 178: Eu Declaration Of Conformity

    Jiri Hruska, CEO RACOM s.r.o. | Mirova 1283 | 592 31 Nove Mesto na Morave | Czech Republic www.racom.eu Tel.: +420 565 659 511 | E-mail: racom@racom.eu ver. 1.2 Fig. 10.1: EU Declaration of Conformity M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 179 С настоящото RACOM s.r.o. декларира, че този тип радиосъоръжение M!DGE 2 е в съответствие с Директива 2014/53/ЕС. Por la presente, RACOM s.r.o. declara que el tipo de equipo radioeléctrico M!DGE 2 es con- forme con la Directiva 2014/53/UE. Tímto RACOM s.r.o. prohlašuje, že typ M!DGE 2 rádiového zařízení M!DGE 2 je v souladu se směrnicí...
  • Page 180 Safety, environment, licensing Prin prezenta, RACOM s.r.o. declară că tipul de echipamente radio M!DGE 2 este în conform- itate cu Directiva 2014/53/UE. RACOM s.r.o. týmto vyhlasuje, že rádiové zariadenie typu M!DGE 2 je v súlade so smernicou 2014/53/EÚ. RACOM s.r.o. potrjuje, da je tip radijske opreme M!DGE 2 skladen z Direktivo 2014/53/EU.

  • Page 181: Eu Declaration Of Conformity

    Jiri Hruska, CEO RACOM s.r.o. | Mirova 1283 | 592 31 Nove Mesto na Morave | Czech Republic www.racom.eu Tel.: +420 565 659 511 | E-mail: racom@racom.eu ver. 1.0 Fig. 10.2: EU Declaration of Conformity © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 182: Country Of Origin

    Nove Mesto na Morave, 1 of November 2018 Jiri Hruska, CEO RACOM s.r.o. • Mírová 1283 • 592 31 Nové Město na Moravě • Czech Republic www.racom.eu Tel.: +420 565 659 511 • Fax: +420 565 659 512 • E-mail: racom@racom.eu Fig.

  • Page 183: Warranty

    The serviced equipment shall be returned by RACOM to the customer by prepaid freight. If circumstances do not permit the equipment to be returned to RACOM, then the customer is liable and agrees to reim- burse RACOM for expenses incurred by RACOM during servicing the equipment on site. When equipment does not qualify for servicing under warranty, RACOM shall charge the customer and be reimbursed for costs incurred for parts and labour at prevailing rates.

  • Page 184: Glossary

    ISDN Integrated Services Digital Network Internet Service Provider Local Area Network NAPT Network Address Port Translation Network Address Translation Point of Presence POP, POP3 Post Office Protocol, Version 3 Point to Point Protocol M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
  • Page 185 Subscriber Identity Module Software Transmission Control Protocol TFTP Trivial File Transfer Protocol User Datagram Protocol UMTS Universal Mobile Telecommunications System Universal Resource Locator Virtual Private Network WEEE Waste Electrical and Electronic Equipment environmental directives © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 186: Index

    28 e-mail, 115 ethernet, 35 offerings, 24 event manager, 116 power supply, 28 F bracket, 25 connect, 26 factory reset, 146 product features, 19 Conformity, 178 key features, 7 conformity file configuration, 144 © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...
  • Page 187 6 system, 137 bootloader, 138 leds, 138 restart, 140 settings, 137 syslog, 137 technical specification, 19 terminalserver, 131 time&region, 138 troubleshooting, 147, 174 update, 142 USB, 45 Virtualization, 139 voicegateway, 134 VPN, 90 © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

  • Page 189: Revision History

    Revision History Appendix B. Revision History Revision 1.0 2018-10-01 1st version Revision 1.1 2018-12-04 update fw 4.2.x.x Revision 1.2 2019-10-06 GNSS © RACOM s.r.o. – M!DGE2 GPRS/UMTS/HSPA+/LTE router...

Table of Contents