1. Manuals
  2. Brands
  3. SMSEagle Manuals
  4. Modem
  5. MHD-8100-3G
  6. User manual

SMSEagle MHD-8100-3G User Manual

Hide thumbs Also See for MHD-8100-3G:
Table of Contents

Advertisement

Quick Links

Download this manual
SMSEAGLE
MHD-8100-3G
MHD-8100-4G
User's Manual

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the MHD-8100-3G and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for SMSEagle MHD-8100-3G

Summary of Contents for SMSEagle MHD-8100-3G

  • Page 1 SMSEAGLE MHD-8100-3G MHD-8100-4G User’s Manual...
  • Page 2 Congratulations on purchasing SMSEAGLE The materials used in this publication are copyright and are not to be duplicated, copied, or used without the prior consent of the copyright holder. Technical specifications and information in this document is subject to change without prior notice being given.

  • Page 3: Table Of Contents

    CONTENTS SMSEagle Software Licensing Information ......................8 What’s In The Box ..............................14 Prepare for First Start ............................. 15 Get to know Connectors, Ports and LED’s ......................21 Basic Operations ..............................23 SMSEagle basic features ............................24 Compose SMS ............................... 25 Importing SMS from CSV and using placeholders ..................
  • Page 4 SMSEagle API ................................84 API Reference (Documentation) ........................84 API Access................................84 Multimodem features ............................. 85 Plugins and integration manuals for NMS & Auth systems ................ 87 Extras ................................... 88 Delivery Reports ..............................88 Connecting directly to SMSEagle database ....................88...
  • Page 5 Injecting short SMS using SQL ........................89 Injecting long SMS using SQL ......................... 90 Database cleaning scripts ..........................92 SNMP agent ................................93 Setting up SNMP v3 access control ......................96 Failover (HA-cluster) feature ........................... 98 Forwarding logs to external server......................101 Automatic software updates check......................
  • Page 6 Information gemäß § 4 Absatz 4 Elektrogesetz (DE) ................117 Restriction of Hazardous Substances Directive (RoHS) ................ 117...
  • Page 7 GET READY TO START | SMSEagle NXS-9700-3G | User’s Manual...

  • Page 8: Smseagle Software Licensing Information

    YOU AGREE TO BE LEGALLY BOUND BY THE HEREIN-CONTAINED TERMS OF THIS LICENSE AGREEMENT. IF YOU DO NOT AGREE TO BE BOUND BY THE TERMS OF THIS EULA, DO NOT USE THE SMSEAGLE DEVICE AND YOU MAY CHOOSE TO PROMPTLY RETURN THE DEVICE FOR A REFUND OF ITS PURCHASE PRICE BY CONTACTING PROXIMUS AT THE ADDRESS ABOVE.
  • Page 9 1.04 "Update" means maintenance of, or a fix to, a version of SMSEagle Software, including, but not limited to a hotfix, patch, or enhancement, none of which function as a standalone service or other software package and which do not have an additional cost for an existing Licensee.
  • Page 10 Intellectual Property laws and treaties. 3.02 RESTRICTIONS ON USE. As a Licensee, You may not: (a) Make use of the SMSEagle Software on more than one device at a time, without prior purchase of additional devices; (b) Share or otherwise make available the SMSEagle Software, in any manner whatsoever, to any third party (c) Modify, adapt, create derivative works from or translate any part of the SMSEagle Software other than what may be used within Your SMSEagle device in accordance with this License;...
  • Page 11 FOR A PARTICULAR USE, AND NONINFRINGEMENT. LIMITATION OF LIABILITY AND REMEDIES IN SPITE OF ANY DAMAGES ARISING FROM OR RELATED TO THE SMSEAGLE DEVICE AND SMSEAGLE SOFTWARE OR ITS OPERATION THAT YOU MAY INCUR FOR ANY REASON, WHICH MAY INCLUDE, BUT ARE NOT LIMITED TO, ANY AND ALL DAMAGES IN CONTRACT, TORT OR...
  • Page 12 DATA COLLECTION STATEMENT. PROXIMUS does NOT collect ANY data you are working with when You use SMSEagle device. We could not see or collect any data saved on SMSEagle device, because we do not have any access to Your device.
  • Page 13 CONTACT INFORMATION If you have questions regarding this EULA, please contact PROXIMUS at: Proximus Sp. z o.o. Ul. Piątkowska 163 60-650 Poznań Poland | Europe tel. + 48 61 6713 413 https:/ /www.smseagle.eu hello@smseagle.eu support@smseagle.eu | SMSEagle MHD-8100 | User’s Manual...

  • Page 14: What's In The Box

    WHAT’S IN THE BOX Your SMSEagle box contains: SMSEagle hardware SMS gateway • 8x External omnidirectional antenna • AC Power cable • Rack mounting brackets • Quick start guide • | SMSEagle MHD-8100 | User’s Manual...

  • Page 15: Prepare For First Start

    PREPARE FOR FIRST START Your SMSEagle is designed so that you can set it up quickly and start using it right away. Follow the steps below to get started. Install antennas STEP 1: ANTENNA INSTALLATION GUIDELINES Install antennas in a location with access to a cellular network radio signal.
  • Page 16 SMSEAGLE DEFAULT NETWORK CONFIGURATION: DHCP CLIENT IS ON IP ADDRESS WILL BE OBTAINED AUTOMATICALLY FROM YOUR DHCP SERVER CONNECT SMSEAGLE TO YOUR LAN AND OBTAIN IP ADDRESS AUTOMATICALLY • connect the device to your LAN using Ethernet cable and ETH1 port SMSEagle will obtain IP address automatically from your DHCP •...
  • Page 17 PREPARE FOR FIRST START LOG IN TO SMSEAGLE Open an internet browser on your PC and go to the IP address assigned to your gateway SMSEAGLE DEFAULT USER: Username: admin Password: password Login to application with above username and password.
  • Page 18 STEP 6: (OPTIONAL) Installing your own SSL certificate SMSEagle device comes with a self-signed SSL certificate. Follow the instructions in the chapter Certificate and HTTPS Redirection if you want to install your own SSL certificate or a free Let’s Encrypt SSL certificate.
  • Page 19 By default, SMSEagle webGUI can be accessed via HTTP or HTTPS. For improved security we recommend using HTTPS. If you would like to redirect HTTP > HTTPS, follow instructions in the chapter SSL Certificate and HTTPS Redirection. Reboot the device STEP 7: Go to Settings >...
  • Page 20 USING OF SMSEAGLE | SMSEagle MHD-8100 | User’s Manual...

  • Page 21: Get To Know Connectors, Ports And Led's

    SIM slot 8x SIM slot - mini size SIM Active LED ACTIVE 8x LED indicator for modem status Antenna ANT1-8 Antenna socket (SMA) Reset RESET Switch for rebooting the device 2x USB 3.0 port | SMSEagle MHD-8100 | User’s Manual...
  • Page 22 Display MHD-8100 display has 5 screens with different information on each scree. Using SW switch, you can change screens of the display. Screen 1: SMSEagle Logo Screen 2: System Usage 1. Device power on time 2. CPU usage in % 3.

  • Page 23: Basic Operations

    SMSEagle is capable to work in various screen resolutions, making it accessible for wide range of devices: computers, laptops, tablets, smartphones, etc. Open a web browser on your device, type in SMSEagle’s IP address (as set in previous chapter). At login screen type in your username/password. Default username and password is given in chapter Prepare for First Start.

  • Page 24: Smseagle Basic Features

    SMSEAGLE BASIC FEATURES Sending & Receiving SMS (managing messages with Inbox, Outbox, Sent Items). Different message • types (normal SMS, flash, WAP push, USSD codes) Sending & Receiving MMS (webGUI & API) • Smartphone-like conversation mode (messages are nicely grouped by phone number). You can •...

  • Page 25: Compose Sms

    Set a message template to be saved and used at another time • Send as Unicode (for special character use) • Send message or Send and Repeat (window remains open, allowing modifications to next message) • | SMSEagle MHD-8100 | User’s Manual...

  • Page 26: Importing Sms From Csv And Using Placeholders

    Importing SMS from CSV and using placeholders SMSEagle software allows you to import SMS text from CSV file and (optionally) use special placeholders in a message body. Placeholders are special fields which are replaced with unique values for each message.

  • Page 27: Folders

    (tabular view). The view type can be changed in menu Settings > Application. Balloons view type: Table view type: To view an MMS attachment, you need to click “show MMS attachment” in the inbox message. | SMSEagle MHD-8100 | User’s Manual...

  • Page 28: Sent Items Status

    (button “Show Details”). Screenshot with examples from Folders>Sent Items>message example There are 3 different icons indicating the sending status: Sending Error • Message Sent • Message Delivered (only • available when Delivery Reports are enabled) | SMSEagle MHD-8100 | User’s Manual...

  • Page 29: Cleanup Folders

    Purging interval (daily, weekly, monthly or annually) • Set the time • Select the folder (Inbox, Outbox or Sent Items) • Set time span of messages • Select to delete modem log files • Calls (Voice feature) * | SMSEagle MHD-8100 | User’s Manual...
  • Page 30 When a TTS call is made SMSEagle device will call a specified phone number or phonebook entry and text message will be read by a built-in voice synthesizer (currently the English language is supported by voice synthesis).

  • Page 31: Phonebook

    MHD-8100-4G devices. Phonebook Web-GUI of SMSEagle device is equipped with Phonebook for managing contacts, groups and shifts. Each user can create private and public contacts, gather contacts in private and public groups. Contacts can also be optionally assigned to working shifts. Contacts and groups from Phonebook allows users efficient sending of messages.
  • Page 32 Assign a selected modem to the contact or leave default modem choice (according to global • settings) Add contact to a Group • Add contact to a Working Shift • Enable/disable Vacation mode (messages are not sent when Vacation mode is enabled) • | SMSEagle MHD-8100 | User’s Manual...

  • Page 33: Phonebook Groups

    Screenshot taken from phonebook groups In Phonebook Group Management view users can: Add/edit/delete groups • Set groups to public or private visbility • View group content (contacts beloning to the group) • Send message to a group • | SMSEagle MHD-8100 | User’s Manual...

  • Page 34: Phonebook Escalation Groups

    STOP word is received. Screenshot from Manage Group view You can change the escalation order by dragging contacts up or down. Screenshot from Manage Groups with set escalation | SMSEagle MHD-8100 | User’s Manual...

  • Page 35: Phonebook Working Shifts

    There are two access levels for a user: User role “Administrator”: • Allows full access & control of the device including settings and User management. User role “User”: • Limits access only allowing to Compose, Folders, Phonebook and Reporting module. | SMSEagle MHD-8100 | User’s Manual...

  • Page 36: Multi-User Capabilities

    Screenshot of Edit/Add User window Multi-User Capabilities As described in the “Users” chapter, SMSEagle software allows to create multiple users with different access levels (Administrator or User). Those users may access the device simultaneously via Web-GUI or API. The following set of features is available in multi-user work scenario: Multiple users may acess the device simultaneously via webGUI or API •...

  • Page 37: Reporting Module

    PDF or CSV file. Screenshot of Reporting module Statistics view The reporting module allows also to view daily statistics of sent/received messages. The statistics view displays number of messages per day and sender/receiver number. | SMSEagle MHD-8100 | User’s Manual...

  • Page 38: Multi-Factor Authentication

    After pressing MFA > Enable button, verification code is sent via SMS (text) to the number specified in Personal data tab. The code must be entered in User Settings > MFA code field to complete the process. | SMSEagle MHD-8100 | User’s Manual...
  • Page 39 If for some reason a user can't receive a text message or don't have access to his phone, a recovery code can be used. The recovery code can be found in User Settings > MFA tab. Remember to save the single-use recovery code in a safe place. Recovery code is recreated after use. | SMSEagle MHD-8100 | User’s Manual...

  • Page 40: Settings

    MFA can also be enabled by an administrator role for selected users. This is done in the menu Users > Edit User. Screenshot from Edit/Add User Settings Settings menu is divided into several tabs for easier maintenance. Application Settings Application settings can be changed under the Settings Tab > Application. | SMSEagle MHD-8100 | User’s Manual...
  • Page 41 You can enable or disable access to database for external applications • You can enable/disable Password complexity verification. When enabled user password must be at • least 8 characters long and include at least one lowercase letter, uppercase letter, number and special character | SMSEagle MHD-8100 | User’s Manual...

  • Page 42: Ip Settings

    IP settings can be changed under the Settings tab > IP Settings. You can enable or disable Get IP address from DHCP • You can input the IP address • You can input the Subnet Mast • You can set the Gateway IP Address • | SMSEagle MHD-8100 | User’s Manual...

  • Page 43: Failover

    You can set automatic time synchronization with NTP timeserver, disable automatic time • synchronization or create NTP server on SMSEagle device (date & time will be obtained from 3G/4G network) You can set NTP timeserver address (or several addresses separated with comma) •...

  • Page 44: Email Alerts

    This feature allows you to find the best location of antenna for environments with poor cellular signal strength. When enabled, signal strength value on SMSEagle dashboard will refresh every 3s. This allows you to try different location of antenna and find a spot with the best signal.
  • Page 45 You can save debug information in system log (enable this only for troubleshooting) • Notice: To prevent false alarms we recommend to set parameter “Send alert when error counter exceeds” to value > 2. | SMSEagle MHD-8100 | User’s Manual...

  • Page 46: Call Forward

    Call forward settings can be accessed under the Settings tab > Call forward. You can choose to forward all incoming calls to a chosen number • MMS Settings can be accessed under the Settings tab > MMS. | SMSEagle MHD-8100 | User’s Manual...

  • Page 47: Data Connection

    Here you can control a mobile data connection on your device. It can be used, for example, to utilize SMSEagle as a backup Internet source. Data connection is NOT REQUIRED for normal operation of SMSEagle device. Leave it disabled (OFF) if you don't want to use it.

  • Page 48: Snmp

    SNMP deamon is required only when you want to monitor your device from external monitoring solutions like Network Monitoring Systems, etc. You can read more about custom SNMP metrics available on SMSEagle device in SNMP agent chapter. SSL Certificate and HTTPS Redirection SSL settings can be accessed under the Settings tab >...

  • Page 49: Backup/Restore

    SSL Certificate BY default, SMSEagle device is equipped with a self-signed SSL certificate. If you want to install your own certificate on the device, please obtain a valid certificate file issued by a Certificate Authority. To upload the certificate, please provide the certificate file and private key in PEM format. The certificate cannot be password protected.

  • Page 50: Snmp

    You can choose to additionally restore the database • *WARNING* Restore backup settings only works with the same version of device and software SNMP SNMP Settings can be accessed under the Settings tab > SNMP | SMSEagle MHD-8100 | User’s Manual...

  • Page 51: Updates

    Update settings can be accessed under the menu Settings > Updates tab. SMSEagle software is under process of continual improvement. We listen to our customers, and new releases are based on our customer’s inputs/requests. Software updates are released frequently, and offer access to new features and fixes to reported issues.
  • Page 52 Screenshot from “General Settings-Updates” Notice: Your SMSEagle device must have a HTTPS connectivity with address updates.smseagle.eu in order for this feature to work. | SMSEagle MHD-8100 | User’s Manual...

  • Page 53: Failover (Ha-Cluster) Feature

    SMSEagle NXS-family devices have their own failover mechanism based on HA-cluster. This feature allows you to assure high availability of SMSEagle devices in critical environments. To enable failover (HA-cluster) you need 2 devices ('aka' nodes). The failover feature monitors devices working in the cluster, and detects...
  • Page 54 When the daemon running at MASTER device detects failure of at least one described feature it immediately automatically switches cluster's IP assignment to the BACKUP device (node) providing continuous usage of the SMSEagle HA-cluster for the user. Devices (nodes) should see each other on the network. By default, HA-nodes use 224.0.0.18 multicast IP address for VRRP (Virtual Router Redundancy Protocol) for communication between two nodes.
  • Page 55 Failover feature uses KEEPALIVED-MIB for SNMP monitoring. DEVICE CLUSTER STATE EXAMPLE OF READING VALUE USING NET-SNMP LIBRARY a) Command for reading the result value: snmpget -v 2c -c public ip-of-smseagle .1.3.6.1.4.1.9586.100.5.2.3.1.4.1 Result: KEEPALIVED-MIB::vrrpInstanceState.1 = INTEGER: master(2) Comment: Current device state is master | SMSEagle MHD-8100...
  • Page 56 | SMSEagle MHD-8100 | User’s Manual...

  • Page 57: Smseagle Plugins

    Basic features of SMSEagle software are extended by plugins that provide extra features to the software. Below you will find a description of plugins available in each SMSEagle device. All plugins are an integral part of SMSEagle software. That means that all described plugins are installed in a standard software of SMSEagle device and are available for free.
  • Page 58 ICMP (ping) to monitor a server with ICMP protocol • or PORT (TCP/UDP) to monitor your service on a selected port (SMSEagle will check if port is open) • or SNMP to monitor objects via SNMP protocol (supported return types: numeric, string) •...
  • Page 59 MONITORING FREQUENCY Monitoring tasks are performed in a parallel mode. Software automatically optimizes number of parallel tasks and frequency of tasks taking into account the performance of the device and adjusts monitoring period when needed. | SMSEagle MHD-8100 | User’s Manual...
  • Page 60 SNMP trap is a popular mechanism used to manage and monitor devices’ activities via SNMP protocol. What makes the Trap unique is that they are triggered instantaneously by an agent, rather than waiting for a status request from SNMP get query. Screenshot from Network Monitor > SNMP TRAPS window. | SMSEagle MHD-8100 | User’s Manual...

  • Page 61: Email To Sms Plugin

    The text of the email is the text of the SMS message (optionally you can append email subject at the beginning of SMS message). Example: email message sent to the address: 123456789@192.168.0.101 will be converted to SMS message and delivered to phone number 123456789. | SMSEagle MHD-8100 | User’s Manual...
  • Page 62 LDAP plugin must be configured on your SMSEagle device. USING FQDN IN EMAIL ADDRESS It is also possible to use Fully Qualified Domain Name in an email address sent to SMSEagle box (eg.: 123456789@mydomain.com). Please refer to our FAQ article:...
  • Page 63 Screenshot from Email to SMS > Add new rule You can name your rule • You can set forwarding to Always or For specified senders / when email contains • You can choose sending modem no. • | SMSEagle MHD-8100 | User’s Manual...
  • Page 64 ‘Send only subject without email body’. Only the email subject will be inserted in the SMS message the text of an email will be cropped to the value ‘Maximum number of characters. Maximum • allowed length of SMS message is 1300 characters | SMSEagle MHD-8100 | User’s Manual...

  • Page 65: Email To Sms Poller

    IP in the email address. This requires configuring proper domain and DNS entries at your DNS server - both A and MX entries, pointing to the SMSEagle's IP. With this configured email sent to newly configured domain will reach the SMSEagle, and be properly processed by the plugin.
  • Page 66 SEND TO USERNAME/GROUP If you want to send SMS to a contact or group from SMSEagle phonebook, put the contact/group name in SUBJECT field. SEND TO LDAP CONTACTS/GROUPS If your company uses LDAP (Active Directory or OpenLDAP) for contacts management, you may use LDAP Contacts or Groups to send email to SMS text message.
  • Page 67 Screenshot from Email to SMS Poller > Add new rule You can name your rule • You can set forwarding to Always or For specified senders / when email contains • You can choose sending modem no. • | SMSEagle MHD-8100 | User’s Manual...
  • Page 68 Settings tab > parameter "Protocol" choose "IMAP + Oauth2 (Office 365)" • Host: enter IMAP server for Office365 (default: outlook.office365.com) • Username: enter email address of the mailbox which will be used for Email2SMS Poller • | SMSEagle MHD-8100 | User’s Manual...

  • Page 69: Sms To Email Plugin

    SMS to email of last sender (so called Two-way Email2SMS & SMS2Email) In this mode, when SMSEagle receives incoming SMS, it checks if earlier anyone was sending SMS to the number from incoming SMS using Emai2SMS. If last sender is found, the incoming SMS is forwarded to the email address of last sender.
  • Page 70 Screenshot from SMS to Email > Rules> Add or Edit rule In the rule definition you may choose to forward all incoming messages or just messages from specified senders/with specific text. | SMSEagle MHD-8100 | User’s Manual...

  • Page 71: Sms Forward

    SMS (and phonebook contact name if found) • Date, time when SMS is received • SMS message • Example email text sent from plugin: From: +483334455 (John Doe) Received: 2017-06-01 14:38:12 Message: My SMS message SMS Forward | SMSEagle MHD-8100 | User’s Manual...
  • Page 72 • phone number or name of group from phonebook. User may define many forwarding rules in the plugin. • Each rule is processed independently. • There is a possibility to enable/disable each rule. • | SMSEagle MHD-8100 | User’s Manual...

  • Page 73: Callback Url Plugin (Webhooks)

    If the plugin is enabled, each defined rule will trigger HTTP(S) request to a defined URL. HTTP(S) request can be of type GET or POST. PLUGIN CONFIGURATION Plugin “Callback URL” allows to add unlimited number of rules. Each rule can be enabled or disabled by user. | SMSEagle MHD-8100 | User’s Manual...
  • Page 74 ‘URL’ field defines remote address of your callback script • ‘Test URL’ button allows to test whether your Callback URL configuration is correct. SMSEagle will • make a callback request with test parameters and will verify the response of remote server ‘URL method’...

  • Page 75: Periodic Sms

    After sending HTTP(S) GET/POST request to your callback URL, SMSEagle will be expecting HTTP response: 200 [OK]. If other or no response is received from your callback URL, SMSEagle will keep retrying every X minute for 24 hours. Retry interval can be set in main plugin Window: Periodic SMS The plugin “Periodic SMS”...

  • Page 76: Autoreply Plugin

    • Message type (SMS, USSD Code) • The content of the SMS text • The recipients (phone number(s) separated with comma or group(s) from phonebook) • Screenshot from “Add new rule” window Autoreply plugin | SMSEagle MHD-8100 | User’s Manual...
  • Page 77 If autoreply message text should be sent as Unicode characters • Plugin also allows to define sending limit for autoreply messages. It is possible to set limitation of max 5 messages / 10 minutes / phone number. | SMSEagle MHD-8100 | User’s Manual...

  • Page 78: Ldap Plugin

    SMSEagle device using directory services. PLUGIN CONFIGURATION Choose “LDAP” from left side menu in SMSEagle web-GUI to access plugin configuration. After enabling the plugin, user needs to fill in all requested fields according to AD settings.
  • Page 79 Screenshot from “LDAP settings” window Click “Save” and “Test connection” to make sure that SMSEagle is connected with AD server. Screenshot showing successful connection to AD server. | SMSEagle MHD-8100 | User’s Manual...
  • Page 80 • name in SMSEagle webGUI > LDAP > "Admin group name in LDAP" create in your directory services a new group for SMSEagle user role. Enter the created group name • in SMSEagle webGUI > LDAP > "User group name in LDAP"...

  • Page 81: Blacklist

    • userPrincipalName • During first login using LDAP authentication type, the system will create a new user on SMSEagle device, linked to the LDAP account. This account settings will be synchronized with LDAP during every login. Blacklist This feature allows you to add a number to a Blacklist. When a number is on this list, the device automatically blocks any sent and received SMS from the number as well as deletes the messages from your inbox.
  • Page 82 You may add excluded phone number(s). The following wildcards may be used for multiple • numbers: *NUMBER, *NUMBER*, NUMBER* (where * replaces any chars) You may add a comment (a reason) for blacklisting the number • | SMSEagle MHD-8100 | User’s Manual...

  • Page 83: Subscriptions (Newsletter)

    This feature allows to enable newsletter-style subscriptions via SMS. When someone sends a message to your SMSEagle which includes a defined text, the sending number will be automatically added to a Phonebook group. This group can be later used to send messages via web-GUI/API/Email To SMS.

  • Page 84: Smseagle Api

    API. API Access Before you can use SMSEagle API you must enable API access in web-GUI (menu Users). Below you can find the description how to enable API on your device. Screenshot from menu “Users” with marked “Access to API” link.

  • Page 85: Multimodem Features

    If you want to allow access to resources of all other users, you must check the checkbox “Access to resources of all users” in Access to API window. MULTIMODEM FEATURES | SMSEagle MHD-8100 | User’s Manual...
  • Page 86 SMSEagle MHD-8100 device is equipped with eight built-in modems. You can manage modem settings in web-gui menu Settings > Maintenance Tab. There are following options available for multimodem device: Multimodem selection strategy This setting is responsible for modem choice strategy when sending SMS messages from SMSEagle. The...

  • Page 87: Plugins And Integration Manuals For Nms & Auth Systems

    SMSEagle has a number of ready-to-use plugins and integration manuals for an easy and quick integration of SMSEagle device with external software (Network Monitoring Systems, Authentication Systems and other). The list grows constantly and is published on SMSEagle website. For a complete and up to date list of plugins please go to: https://www.smseagle.eu/integration-plugins/...

  • Page 88: Extras

    EXTRAS Delivery Reports SMSEagle software allows you to enable delivery reports for each sent SMS. Delivery reports is afeature that allows to receive a confirmation that SMS was received on recipients phone. In order to enable delivery reports, please go to web-GUI > menu Settings and set “Delivery Reports” to “Yes”...

  • Page 89: Injecting Short Sms Using Sql

    Once database access is enabled, it is possible to connect to the database from external application using the following credentials: OSTGRE DATABASE CREDENTIALS Host: IP address of your device Database name: smseagle User: smseagleuser Password: postgreeagle Injecting short SMS using SQL The simplest example is short text message (limited to 160 chars):...

  • Page 90: Injecting Long Sms Using Sql

    In the above example the message will belong to user with id_user 1 (default 'admin'). You can find id_user values for other users in table public."user". Field SenderID contains identification number of SMSEagle modem. For modem 1 SenderID = smseagle1, SenderID = smseagle2 for modem 2, etc.
  • Page 91 'Default_No_Compression', INSERT INTO user_outbox ( id_outbox, id_user ) SELECT CURRVAL(pg_get_serial_sequence('outbox','ID')), Note: Adding UDH means that you have less space for text, in above example you can use only 153 characters in single message. | SMSEagle MHD-8100 | User’s Manual...

  • Page 92: Database Cleaning Scripts

    1) Create a file inside /etc/cron.d/ directory with your desired name (eg. pico db_cleaner) 2) Example content of this file: 0 0 1 * * root /opt/scripts/db_delete_allfolders This will run cleaning script every 1 day of month. | SMSEagle MHD-8100 | User’s Manual...

  • Page 93: Snmp Agent

    It is used mostly in network management systems to monitor network-attached devices for conditions that warrant administrative attention” (source: Wikipedia). SMSEagle device has a built-in Net-SNMP agent. The SNMP agent provides access to Linux Host MIB tree of the device, and additionally (using extension NET-SNMP-EXTEND-MIB) allows access to custom metrics specific to SMSEagle.
  • Page 94 -v 2c -c public localhost .1.3.6.1.4.1.8072.1.3.2.3.1.2.11.71.83.77.95.83.105.103.110.97.108.49 Result: NET-SNMP-EXTEND-MIB::nsExtendOutputFull."GSM_Signal1" = STRING: 54 Comment: 3G/4G Signal strength value is 54% EXAMPLE OF READING GSM_NETNAME1 VALUE USING NET-SNMP LIBRARY a) Command for reading the result value: | SMSEagle MHD-8100 | User’s Manual...
  • Page 95 DISMAN-EVENT-MIB::sysUpTimeInstance = Timeticks: (216622) 0:36:06.22 Comment: Linux system is up for 36 hours, 6.22 minutes EXAMPLE OF BROWSING SMSEAGLE EXTENSION PARAMETERS IN MIB TREE USING NET-SNMP LIBRARY a) Command for reading the result value: snmpwalk -v 2c -c public ip-of-smseagle .1.3.6.1.4.1.8072.1.3.2.3.1.2 Result: NET-SNMP-EXTEND-MIB::nsExtendOutputFull."GSM_Signal1"...

  • Page 96: Setting Up Snmp V3 Access Control

    EXAMPLE OF BROWSING SMSEAGLE EXTENSION PARAMETERS IN MIB TREE USING MIB-BROWSER Setting up SNMP v3 access control By default, SMSEagle devices uses SNMP v2 access control. Using v3 can strengthen security, however is not mandatory. To easily switch to SNMP v3 access control we’ve prepared special shell script located at /opt/smseagle directory.
  • Page 97 6. To delete USER please run: ./snmpv3 del 7. To disable v2 access policy run: ./snmpv3 disablev2 8. To enable v2 access policy run: ./snmpv3 enablev2 | SMSEagle MHD-8100 | User’s Manual...

  • Page 98: Failover (Ha-Cluster) Feature

    SMSEagle NXS-family devices their own failover mechanism based on HA-cluster. This feature allows you to assure high availability of SMSEagle devices in critical environments. To enable failover (HA-cluster) you need at least 2 devices ('aka' nodes). The failover feature monitors devices working in the cluster, and...
  • Page 99 When the daemon running at MASTER device detects failure of at least one described feature, it immediately automatically switches cluster's IP assignment to the BACKUP device (node) providing continuous usage of the SMSEagle HA-cluster for the user. Devices (nodes) should see each other on the network. By default, HA-nodes use 224.0.0.18 multicast IP address for VRRP (Virtual Router Redundancy Protocol) for communication between two nodes.
  • Page 100 Failover feature uses KEEPALIVED-MIB for SNMP monitoring. DEVICE CLUSTER STATE EXAMPLE OF READING VALUE USING NET-SNMP LIBRARY a) Command for reading the result value: snmpget -v 2c -c public ip-of-smseagle .1.3.6.1.4.1.9586.100.5.2.3.1.4.1 Result: KEEPALIVED-MIB::vrrpInstanceState.1 = INTEGER: master(2) Comment: Current device state is master | SMSEagle MHD-8100...

  • Page 101: Forwarding Logs To External Server

    PORT – port on receiving server PROTOCOL one of the values: tcp, udp Example: • *.* action(type="omfwd" target="192.168.0.250" port="10514" protocol="tcp" action.resumeRetryCount="10" queue.type="linkedList" queue.size="10000") • SSL-encryption of your log traffic: please have a look at this article: https://www.rsyslog.com/doc/v8-stable/tutorials/tls_cert_summary.html | SMSEagle MHD-8100 | User’s Manual...

  • Page 102: Automatic Software Updates Check

    (if the phone number is entered in the account) with a notification about new software update. Screenshot from “General settings-Maintenance” Notice: Your SMSEagle device must have a HTTPS connectivity with address www.smseagle.eu in order for this feature to work. | SMSEagle MHD-8100...

  • Page 103: Knowledgebase & Support Portal

    Knowledgebase & Support Portal More information and useful hints about SMSEagle device configuration can be found in our online knowledgebase and support portal at: https://support.smseagle.eu | SMSEagle MHD-8100 | User’s Manual...
  • Page 104 I I I TROUBLESHOOTING | SMSEagle MHD-8100 | User’s Manual...

  • Page 105: Troubleshooting

    (or pressing Reset switch). 3. If you still cannot connect with the device, it is possible to restore to factory IP settings by using the SW button. | SMSEagle MHD-8100 | User’s Manual...

  • Page 106: Restoring Factory Defaults

    3. Release SW button after 10 seconds (you will see “Factory reset” on display) 4. Wait until system reboots. Please note, that after reboot the device will be finishing the process of factory reset, therefore it can take longer for the system to start. | SMSEagle MHD-8100 | User’s Manual...
  • Page 107 SERVICE & REPAIR | SMSEagle MHD-8100 | User’s Manual...

  • Page 108: Service & Repair

    Go to menu Settings > Sysinfo > “Download device logs”. Provide log package to support team when requested. MAC address Each SMSEagle device has its unique MAC address. MAC address is printed on the device body or can be found in menu Settings > IP Settings | SMSEagle MHD-8100...
  • Page 109 TECH SPECS & SAFETY INFORMATION | SMSEagle MHD-8100 | User’s Manual...

  • Page 110: Tech Specs & Safety Information

    E-GSM 900: Class 4, DCS 1800: Class1  EDGE 900: Class E2, EDGE 1800: Class E2  FDD I: Class 3, FDD VIII: Class 3  MHD-8100-4G: Wavebands: UMTS, LTE LTE FDD: B1/B2/B3/B4/B5/B7/B8/B12/B13/B18/B19/B20/B25/B26/B28 LTE TDD: B38/B39/B40/B41 | SMSEagle MHD-8100 | User’s Manual...
  • Page 111 SOFTWARE PLATFORM Operating system: Ubuntu 18.04 • built-in Apache2 web server • built-in PostgreSQL database server • built-in Postfix email server • built-in SNMP agent • built-in NTP-client • built-in Failover (HA-cluster) service • | SMSEagle MHD-8100 | User’s Manual...
  • Page 112 • failover mechanism for built-in modems • modern responsive web interface • | SMSEagle MHD-8100 | User’s Manual...

  • Page 113: Important Safety Information

    SAR regulation. DISCLAIMER: The manufacturer is not responsible for any damages caused by inappropriate installation, not maintaining the proper technical condition or using a product against its destination. | SMSEagle MHD-8100 | User’s Manual...

  • Page 114: Regulatory Statements

    REGULATORY STATEMENTS EU Declaration of Conformity Hereby, Proximus Sp. z o.o., owner of SMSEagle brand, declares that the radio equipment type SMSEagle MHD-8100-3G, MHD-8100-4G is in compliance with Directive 2014/53/EU. The full text of the EU declaration of conformity is available at the following internet address: www.smseagle.eu/certification...

  • Page 115: Fcc Supplier's Declaration Of Conformity

    (2) this device must accept any interference, including interference that may cause undesired operation of the device. This Class B digital apparatus meets the requirements of the Canadian Interference-Causing Equipment Regulations. CAN ICES-3 (B)/NMB-3(B) | SMSEagle MHD-8100 | User’s Manual...

  • Page 116: Avis De Conformité À La Réglementation D'industrie Canada

    CAN ICES-3 (B)/NMB-3(B) UK Declaration of Conformity Hereby, Proximus Sp. z o.o., owner of SMSEagle brand, declares that the radio equipment type SMSEagle MHD-8100-3G, MHD-8100-4G is in compliance with The Radio Equipment Regulations 2017. The full text of the EU declaration of conformity is available at the following internet address: www.smseagle.eu/certification...
  • Page 117 Restriction of Hazardous Substances Directive (RoHS) European Union RoHS SMSEagle devices sold in the European Union, on or after 3 January 2013 meet the requirements of Directive 2015/863 on the restriction of the use of certain hazardous substances in electrical and electronic equipment (“RoHS 3”).
  • Page 118 Proximus Sp. z o.o. Ul. Piątkowska 163, 60-650 Poznań, Poland l Europe T +48 61 6713 413 E hello@smseagle.eu www.smseagle.eu | SMSEagle MHD-8100 | User’s Manual...

This manual is also suitable for:

Mhd-8100-4g

Table of Contents