hit counter script
RACOM M!DGE Operating Manual
  1. Manuals
  2. Brands
  3. RACOM Manuals
  4. Network Router
  5. M!DGE
  6. Operating manual
RACOM M!DGE Operating Manual

RACOM M!DGE Operating Manual

Gprs/umts/hspa/lte
Hide thumbs Also See for M!DGE:
Table of Contents

Advertisement

Quick Links

Download this manual
Operating manual
GPRS/UMTS/HSPA/LTE router
1.3
9/19/2013
RACOM s.r.o. • Mirova 1283 • 592 31 Nove Mesto na Morave • Czech Republic
Tel.: +420 565 659 511 • Fax: +420 565 659 512 • E-mail: racom@racom.eu
.
M!DGE
.
www.racom.eu

Advertisement

Table of Contents
loading

Related Manuals for RACOM M!DGE

Summary of Contents for RACOM M!DGE

  • Page 1 Operating manual M!DGE GPRS/UMTS/HSPA/LTE router 9/19/2013 RACOM s.r.o. • Mirova 1283 • 592 31 Nove Mesto na Morave • Czech Republic www.racom.eu Tel.: +420 565 659 511 • Fax: +420 565 659 512 • E-mail: racom@racom.eu...

  • Page 3: Table Of Contents

    5. Bench test / Step by Step Guide ....................21 5.1. Connecting the hardware ....................21 5.2. Powering up your M!DGE ....................21 5.3. Connecting M!DGE to a programming PC ................. 21 5.4. Basic Setup ........................22 6. Installation ............................. 23 6.1.
  • Page 4 B. Revision History .......................... 111 List of Figures 1. Router M!DGE UMTS and M!DGE LTE ..................6 2.1. Front panel and terminal panel of M!DGE ..................9 4.1. Dimensions in milimetres ......................12 4.2. Antenna connectors SMA ......................12 4.3. 2× Eth RJ45 Plug - pin numbering ..................... 13 4.4.

  • Page 5: Important Notice

    Data may be delayed, corrupted (i.e., have errors), or be totally lost. Significant delays or losses of data are rare when wireless devices such as the M!DGE are used in an appropriate manner within a well‐constructed network. M!DGE should not be used in situations where failure to transmit or receive data could result in damage of any kind to the user or any other party, including but not limited to personal injury, death, or loss of property.

  • Page 6: Getting Started

    As an alternative. you can configure a static IP address on your PC (e.g. 192.168.1.2/24) so that it is operating in the same subnet as the M!DGE. The M!DGE default IP address for first Eth interface is 192.168.1.1, the subnet mask is 255.255.255.0.

  • Page 7: M!Dge Router

    M!DGE together with RACOM RipEX radio router offers an unrivalled solution for combining GPRS and UHF/VHF licensed radio in a single network. Even a single RipEX in the centre of a M!DGE network allows for efficient use of addressed serial SCADA protocols.

  • Page 8: Standards

    • SNMP 1.3. Standards EN 301 489-1 V1.7.1 EN 301 489-7 V1.3.1 EN 61 000-6:2005 EN 50 121-3-2:2006 EN 50 121-4:2006 Electrical Safety EN 60950-1:2006 IP rating IP40 IEEE 802.3i IEEE 802.3u IEEE 802.3af M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.

  • Page 9: M!Dge In Detail

    M!DGE in detail 2. M!DGE in detail Fig. 2.1: Front panel and terminal panel of M!DGE All M!DGE/MG102 Wireless Routers run M!DGE/MG102 Software. Software offers the following key features: • Interfaces and Connection Management (section Section 7.2, “INTERFACES”) ○ Dial-out (on demand, permanent) ○...
  • Page 10 ○ Configuration via Web Manager ○ Configuration via Command Line Interface (CLI) accessible via Secure Shell (SSH) and telnet ○ Batch configuration with text files ○ User admnistration ○ Troubleshooting tools ○ Over the air software update M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.

  • Page 11: Implementation Notes

    3.3. Centre of the network In every network, the centre plays a key role and has to be designed according to customer's require- ments. Several possible solutions are described in the application note M!DGE/MG102 CENTRE – Application note 3.4. VPN tunnels security of customer's data arriving through the mobile network is often very important.

  • Page 12: Product

    The LTE model is equipped with two antenna connectors. The ANT connect- or (above) serves as a main antenna connection, the second connector is auxiliary and serves for better commu- nication with BTS (diversity). Fig. 4.2: Antenna connectors SMA M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.

  • Page 13: 2× Eth Rj45 Plug - Pin Numbering

    100BaseT) signal TX− RX− Fig. 4.3: 2× Eth RJ45 Plug - pin numbering 4.2.3. USB M!dge uses USB 1.1, Host A interface. USB interface is wired as standard: Tab. 4.2: USB pin description USB pin signal wire +5 V Data(−)

  • Page 14: Screw Terminal

    V+ (12–48 V=) (–15 % +20 %) = 10.2–57.6 VDC. RS232 – RxD RS232 – RxD RS232 – RxD Digital output. Dry contact relay. Normally open with M!DGE DO1: without powering Digital output. Dry contact relay. Normally open with M!DGE DO2: without powering.

  • Page 15: Indication Leds

    Keep it pressed for at least 3 seconds for reboot and at least 10 seconds for a factory reset. The start of the factory reset is confirmed by all LEDs lighting up for one second. The button can be released afterwards. 4.3. Indication LEDs Fig. 4.6: Indication LEDs © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...

  • Page 16: M!Dges Interfaces And Status Indicators

    VPN connection is enabled and not connected yellow on Closed yellow off Opened yellow on Closed yellow off Opened yellow on Input set yellow off Input not set yellow on Input set yellow off Input not set M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.

  • Page 17: Technical Specifications

    Product 4.4. Technical specifications © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...

  • Page 18: Technical Specifications

    125 × 45 × 110 mm, 450 g (1 lbs) Type Approval CE, R&TTE (see EC Declaration of Conformity) Options Antennas Various antennas suitable for your application are available Mounting kit Flat bracket mounting kit M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.

  • Page 19: Model Offerings

    10. This key extends the number to 25. 4.6. Accessories 4.6.1. F bracket Fig. 4.7: Flat bracket Flat-bracket Installation bracket for flat mounting. For details on use see chapter Mounting and chapter Dimensions. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...

  • Page 20: Demo Case

    Product 4.6.2. Demo case A rugged plastic case for carrying up to three RipEX's and one M!DGE 3G SCADA router. It also contains all the accessories needed to perform an on-site signal measurement, complete application bench-test or a functional demostration of both radiomodems and the 3G router. During a field test, units can be powered from the backup battery and external antenna can be connected to one of the RipEX units through the „N“...

  • Page 21: Bench Test / Step By Step Guide

    Switch on your power supply. Status LED flashes for a few seconds and after 8 seconds it starts blinking to a green light. After approximately 30 seconds your M!DGE will have booted and will be ready; the Status LED remains shining on.

  • Page 22: Basic Setup

    192.168.1.10 mask 255.255.255.0) so that it is operating in the same subnet as the M!DGE. The factory default IP address is 192.168.1.1 The default subnet mask is 255.255.255.0. Start a Web Browser on your PC. Type the M!DGE/MG102 IP address in the address bar: http://192.168.1.1 Please set a password for the admin user account.

  • Page 23: Installation

    Installation 6. Installation 6.1. Mounting M!DGE Wireless Router is designed for a DIN rail mounting or on a panel using flat bracket. Please consider the safety instructions in Chapter 10, Safety, environment, licensing. 6.2. Antenna mounting M!DGE Wireless Routers will only operate reliably over the GSM network if there is a strong signal.

  • Page 24: 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. M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.

  • Page 25: Interfaces

    This link will be used whenever possible. 2nd priority: The first fallback technology. You can keep it ready (faster) or establish it only when the fallback actually occurs. Up to four priorities shall be used. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 26 The connection supervision is used for switching between several connections if available. In addition it is possible set an emergency action for case that no connection is available with maximal down time. Actions are: • None • Restart link services • Reboot system M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 27 Port Settings This menu can be used to individual assigning of each Ethernet port to a LAN interface in case you want to have different subnets per port or use one port as WAN interface. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 28 Two individual windows will be used when different LAN is set in Port settings menu. For each of them you can define whether LAN or WAN interface has to be used. Note The default IP address for LAN 1 interface is 192.168.1.1/24, for LAN2 192.168.2.1/24 M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 29 Web Configuration Static configuration of M!DGE's own IP address and Subnet mask is available for LAN mode. Note Setting of the IP address is conected with the DHCP Server (if enabled) - menu SERVICES- DHCP Server. WAN mode enables the following possibilities:...
  • Page 30 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!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 31 Some modems also support to run Unstructured Supplementary Service Data (USSD) requests, e.g. for querying the available balance of a pre-paid account. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 32 Authentication The authentication scheme being used, if required this can be PAP or/and CHAP Username The username used for authentication Password The password used for authentication Furtheron, you may configure the following advanced settings: M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 33 The keys are made up of your admin password. They can be generated and downloaded. You may also define multiple keys in this file (line-after-line) in case your admin password differs if applied to multiple M!DGE routers. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 34 (serial console is mentioned especially for maintenance reasons in case that the web interface should not be used from any reason) • device server or • SDK (for more about this possibility see chapter SDK) M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 35 Protocol on serial port: The protocol implicitly defined on the serial port. TCP or Telnet Configuration Port: The TCP port that is used by this application. Time-out: Time-out: UDP Configuration Local Port: Local UDP port © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 36 Specifies the number of stop bits used to indicate the end of a frame. Software flow control: In XON/XOFF software flow control, either end can send a stop (XOFF) or start (XON) character to the other end to control the rate of incoming data. M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 37 Web Configuration Hardware flow control: While 3 wired conection is used with M!DGE hardware flow control is not available. 7.2.6. Digital I/O The Digital I/O page displays the current status of the I/O ports and can be used to turn output ports on or off.

  • Page 38: Routing

    The route is a host route, typically the netmask is set to 255.255.255.255. Network The route is a network route, consisting of an address and net- mask which forms the subnet to be addressed M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 39 Type of service The TOS value within the header of the packet Route to Specifies the target interface or gateway to where the packet should get routed to. 7.3.3. Bridging Information about bridge status. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 40 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.
  • Page 41 If MIP is run as home agent, you will have to set up a home address and netmask first and configure various nodes afterwards which are made up of the following settings: Home network address: The home address of the network Home network mask: The mask for the home network. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...

  • Page 42: Firewall

    TELNET) by default but block any other packets coming from the WAN interface. Administrative status: Enable or disable packet filtering. Allow WAN administration: This option will predefine the rules for services on the WAN link as follows: M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 43 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. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 44 Inbound rules can be used to modify the target section of IP packets and, for instance, forward a service or port to an internal host. By doing so, they will expose the service and make it reachable e.g. from the Internet. You may also establish 1:1 NAT to a complete host. M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 45 Used UDP/TCP port of matching packets Rewrite source address: Address to which the source address of matching packets shall be rewritten Rewrite source port: Port to which the source port of matching packets shall be rewritten © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...

  • Page 46: Vpn

    Refer to section ‘OpenVPN Client Management’ to learn more about how to manage clients and generate the files. Operation mode: Choose client or server mode for this tunnel M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 47 Can be used to send a periodic keep alive packet in order to keep the tunnel up despite inactivity Redirect gateway: By redirecting the gateway, all packets will be directed to the VPN tunnel. Please ensure that essential services (such as DNS or NTP © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 48 (with default name “ccd”) containing client-specific configuration files. Note OpenVPN tunnels require a correct system time. Please ensure that all NTP servers are reachable. When using host names a working DNS server is required as well. M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 49 IPsec includes various cryptographic protocols and ciphers for key ex- change and data encryption and can be seen as one of the strongest VPN technologies in terms of security. Administration © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 50 IKE Diffie-Hellman Group: IKE Diffie-Hellman Group Perfect Forward Secrecy (PFS): Use Perfect Forward Secrecy. This feature heavily increases security as PFS avoids penetration of the key-exchange protocol and pre- vents compromising the keys negotiated earlier. M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 51 3706) keep alives (R_U_THERE, R_U_THERE_ACK) that are sent for this connection (default 30 seconds) Failure count: The number of unanswered DPD R_U_THERE requests until the IPsec peer is considered dead (The router will then try to re-establish a dead connection automatically) © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 52 A client tunnel requires the following paramters to be set: Server address: The address of the remote server Username: The username used for authentication Password: The password used for authentication M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 53 GSM only. Naturally, a concurrent use of mobile Dial-Out and Dial-In connection is not possible. Note The Dial-in Server is not supported by the M!DGE/MG102i LTE hardware. Administrative status Enabled/disabled - incoming call shall be /shall not be answered...

  • Page 54: 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: 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 55 .WANLINK1_TYPE = string[4]: "wwan" .WANLINK1_DIAL_FAILURES = string[1]: "0" .WANLINK1_REGISTRATION_STATE = string[23]: "registeredInHomeNetwork" .WANLINK1_SIM = string[4]: "SIM1" .WANLINK1_INTERFACE = string[5]: "wwan0" .WANLINK3_STATE = string[8]: "disabled" .WANLINK1_SIGNAL_STRENGTH = string[3]: "-73" .WANLINK4_STATE = string[8]: "disabled" .WANLINK2_STATE = string[8]: "disabled" © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 56 (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"); printf ("The NTP server is now running with IP address: "); printf (nb_config_get("network.NTP.server")); M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 57 Files written to /tmp will be hold in memory and will be cleared upon a restart of the script. As your scripts operate in the sandbox, you will have no access to tools on the system (such as ifconfig). Administration © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 58 The status page informs you about the current status of the SDK. 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!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 59 Web Configuration Job Management © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 60 You are ready to set up a job afterwards, it can be created by using the following parameters: Name: A meaningful name to identify the job Trigger: Specifies the trigger that should launch the job Script: Specifies the script to be executed M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 61 : schnack argv3 : s c h n u c k In case of syntax errors, arena will usually print error messages as follows (indicating the line and pos- ition where the parsing error occurred): © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 62 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!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 63 WAN link negotiation. By pointing DNS requests to the router, one can reduce outbound DNS traffic as it is caching already resolved names but it can be also used for serving fixed addresses for particular host names. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 64 7.6.4. Dynamic DNS 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). M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 65 Password: The password used for authentication 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. 7.6.5. E-mail client The E-Mail client can be used to send notifications to a particular E-Mail address upon certain events or by SDK scripts.
  • Page 66 By using the event manager you can notify one or more recipients by SMS or E-Mail upon certain system events. The messages will contain a description provided by you and a short system info. M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 67 DIO OUT1 turned off dio-out2-off DIO OUT2 turned off gps-up GPS signal is available gps-down GPS signal is not available openvpn-up OpenVPN connection came up openvpn-down OpenVPN connection went down ipsec-up IPsec connection came up © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 68 This page lets you turn the SMS event notification service on 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,...
  • Page 69 SMS control: Receiving SMS can be enabled or disabled. Disabling receiving SMS means that controlling M!DGE via SMS will not be possible Routing & Filtering By using SMS routing you can specify outbound rules which will be applied whenever message are sent.
  • Page 70 There is a small SMS inbox reader which can be used to view or delete the messages. Please note that the inbox will be cleared each midnight in case it exceeds 512 kBytes of flash usage. M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 71 Please note, that a regular system shell will only be provided for the root user, the CLI will be launched for any other user whereas normal users will only be able to view status values, the admin user will obtain privileges to modify the system. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 72 7.6.9. SNMP Agent M!DGE is equipped with a SNMP daemon, supporting basic MIB tables (such as ifTable), plus additional enterprise MIBs to manage multiple systems. M!DGE OID starts with 1.3.6.1.4.1.33555.10 prefix. The corresponding VENDOR MIB can be downloaded from the router.
  • Page 73 Start-up trap is implemented using the standard cold Start & warm Start traps. System-shutdown trap is sent, when the system is rebooted via the web interface reboot function or when the watchdog reboots the system. M!DGE extensions contain support for: • Rebooting the device •...
  • Page 74 We strongly recommend to use HTTPS when accessing the web service via a WAN interface as the communication will be encrypted and thus avoids any misuse of the system. In order to enable HTTPS you would need to generate or upload a server certificate in the section SYSTEM-Keys and Certificates. M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 75 DHCP on the backup device or even better, split the DHCP lease range in order to prevent any lease duplication. Note M!DGE assigns a priority of 100 to the master and 1 to the backup router. Please adapt the priority of your third-party device appropriately. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 76 Role of this system (either master or backup) VID: The Virtual Router ID (you can theoretically run multiple instances) Interface: Interface on which VRRP should be performed Virtual gateway address: Virtual gateway address formed by the participating hosts M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.

  • Page 77: System

    Network Time Protocol (NTP) is a protocol for synchronizing the clocks of computer systems over packet-switched, variable-latency data networks. M!DGE can synchronize its system time with a NTP server. If enabled, time synchronization is usually triggered after a WAN link has come up but before starting any VPN connections.
  • Page 78 Sync will perform the time synchronisation immediatelly. System Information System information page displays various details of your M!DGE. Update of the page takes several seconds. M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 79 Web Configuration Restart This menu can be used to restart the system. Any WAN links will be dropped. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 80 Define a password Password confirmation: Confirm the password Remote Authentication A remote RADIUS server can be used to authenticate users. This applies for the Web Manager and other services supporting and incorporating remote authentication. M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 81 Software downgrade is not supported. Software downgrade may lead to loss of configuration and inac- cessibility of the device. Manual Software Update This menu can be used to run a manual software update of the system © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 82 Status: Enable/disable automatic software update Time of day: Every day at this time M!DGE will do a check for updates URL: The server URL where the software update package should be down- loaded from. Supported protocols are TFTP, HTTP(s), and FTP...
  • Page 83 Web Configuration 7.7.4. Configuration Configuration via the Web Manager becomes tedious for large volumes of devices. M!DGE therefore offers automatic and manual file-based configuration to automate things. Once you have successfully set up the system you can back up the configuration and restore the system with it afterwards. You can either upload a single configuration file (.cfg) or a complete package (.zip) containing the configur-...
  • Page 84 (e.g. by your service staff). Please ensure that this corresponds to a working configuration. A real factory reset to the default settings can be achieved by restoring the ori- ginal factory configuration and initiating the factory reset again. M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 85 Web Configuration 7.7.5. Troubleshooting Network Debugging Various tools reside on this page for further analysis of potential configuration issues. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 86 Web Configuration M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 87 Web Configuration 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!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 88 Web Configuration M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 89 Note For both direct E-mail and Online support form a connection to the Internet has to be avail- able. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 90 PKCS12 container format which can include certificates and keys protected by password RSAThe certificate owner’s loca- An encryption algorithm based on the fact that factorization of large tion integers is difficult DSS/DSA An encryption algorithm based on the discrete logarithm problem M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 91 Those attributes form a so-called subject name, mainly used for matching a certificate or when signing certificate requests: Subject: C=CZ, ST=Czech Republic, L=Czech Republic, O=RACOM, OU=Networking, CN=midge/emailAddress=support@racom.eu Depending on your configuration, keys and certificates may be used for particular services, for instance if OpenVPN uses a certificate-based authentication or if you want to access the Web Manager over HTTPS.
  • Page 92 Web Configuration Availability means that the license should be able to aloow this funcionality for the actual HW. M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.

  • Page 93: Logout

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

  • Page 94: Command Line Interface

    (Command Line Utility) Usage: [-ilh] <command> ~ $ cli -i MIDGE Command Line Interface (version 0.1) (C) Copyright RACOM s.r.o, Czech Republic Enter 'help' for a list of available commands or hit the TAB key for auto-completion. Ready to serve. >...

  • Page 95: Print Help

    [<command>] Available commands: Get config parameters Set config parameters status Get status information send Send message or mail update Update system facilities restart Restart service reset Reset system to factory defaults reboot Reboot system © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...

  • Page 96: Getting Config Parameters

    "off" after the next start-up procedure. > set dio.out1=off > set dio.out2=off 8.5. Getting Status Information The status command can be used to get various status information of the system. M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.

  • Page 97: Sending E-Mail Or Sms

    The send command can be used to send a message via E-Mail/SMS to the specified address or phone number. > send −h Name: cli−send (Send message or mail) Usage: send [−h] <type> <dest> <msg> Options: <type> type of message to be sent (mail or sms) © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...

  • Page 98: Updating System Facilities

    Firewall and NAPT lighttpd HTTP server openvpn OpenVPN connections ipsec IPsec connections pptp PPTP connections snmpd SNMP daemon syslog Syslog daemon telnet Telnet server dropbear SSH server vrrpd VRRP daemon usbipd USB/IP daemon surveyor Supervision daemon M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.

  • Page 99: Resetting System

    > get cliphp.status cliphp.status=0 >set cli.php.status=1 > get cliphp.status cliphp.status=1 cliphp.status=0 Service is disabled cliphp.status=1 Service is enabled This section describes the CLI-PHP interface for Version 2, the general usage is defined as follows: © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 100 Examples: 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. M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.
  • Page 101 '=' 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: © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 102 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 M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.

  • Page 103: Troubleshooting

    Action was succesful – an informative message with several important actions informing about positive result. Yellow Warning – please consider the information. Error – command was not performed, typically with recommended action which is required before the possible succesful action. © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...

  • Page 104: Troubleshooting Tools

    9.3. Troubleshooting tools 9.3.1. Pinger Connection from the M!DGE router you can check using a build in pinger available in SYSTEM- Troubleshooting - Network Debugging. Traceroute command is availablein the same menu for tracing the packets from the M!DGE router to the Host.

  • Page 105: Safety, Environment, Licensing

    The M!DGE/MG102 Wireless Routers must not be opened. Only the replacement of the SIM card is permitted. Voltage at all connectors of the communication module is limited to SELV (Safety Extra Low Voltage) and must not be exceeded.

  • Page 106: 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 107: Glossary

    IPSec Internet Protocol Security 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 http://www.ce.org © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 108 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 M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.

  • Page 109: Index

    21 F bracket, 19 product factory reset, 84 Conformity, 105 features, 17 key features, 7 file configuration, 83 firewall, 42 redundancy, 75 reset, 84 ROHS, 106 router, 7 glossary, 107 routing, 38 grounding, 23 © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...
  • Page 110 17 standards, 8 start, 6 system, 77 information, 78 restart, 79 setings, 77 technical specification, 17 time&region, 77 troubleshooting, 85, 103 update, 81 USB, 33 VPN, 46 WAN, 25 web configuration, 24 WEEE, 106 M!DGEGPRS/UMTS/HSPA/LTE router – © RACOM s.r.o.

  • Page 111: Revision History

    Revision History Appendix B. Revision History Revision 1.1 2012-10-09 1. XML version Revision 1.2 2012-12-07 Updated chapter 7 for FW version 3.6.40.x Revision 1.3 2012-12-12 Updated chapter 8 – Command Line Interface © RACOM s.r.o. – M!DGEGPRS/UMTS/HSPA/LTE router...

Table of Contents