InLogic SMS Gateway: Difference between revisions
No edit summary |
|||
Line 1: | Line 1: | ||
== Important == | ==Important== | ||
To be able to send SMS, the inLogic SMS Gateway requires GSM modems with USB interface. We recommend "HUAWEI LTE USB Stick Model: E3372". | To be able to send SMS, the inLogic SMS Gateway requires GSM modems with USB interface. We recommend "HUAWEI LTE USB Stick Model: E3372". | ||
=== Hardware Compatibility List === | ===Hardware Compatibility List=== | ||
[http://consumer.huawei.com/en/mobile-broadband/e3531/specs/ Huawei E3531] | [http://consumer.huawei.com/en/mobile-broadband/e3531/specs/ Huawei E3531] | ||
Line 11: | Line 11: | ||
[http://www.tp-link.com/la/products/details/cat-5090_MA260.html TP-Link MA260] | [http://www.tp-link.com/la/products/details/cat-5090_MA260.html TP-Link MA260] | ||
== Network Port Openings == | ==Network Port Openings== | ||
==== TCP port openings from server to gateway. ==== | ====TCP port openings from server to gateway. TCP port opening where UMS sms sever service run. ==== | ||
{| class="wikitable" | {| class="wikitable" | ||
!Port | !Port | ||
Line 20: | Line 20: | ||
|22 | |22 | ||
|SSH access | |SSH access | ||
|- | |- | ||
|443 | |443 | ||
Line 31: | Line 28: | ||
|} | |} | ||
==== TCP port openings from gateway to server. ==== | ====TCP port openings from gateway to server.==== | ||
{| class="wikitable" | {| class="wikitable" | ||
!Port | !Port | ||
Line 43: | Line 40: | ||
|} | |} | ||
== Prepare Modem == | ==Prepare Modem== | ||
{| | {| | ||
![[File:20180516 104258-50%.jpg|none|thumb|800x800px]] | ![[File:20180516 104258-50%.jpg|none|thumb|800x800px]] | ||
Line 69: | Line 66: | ||
|} | |} | ||
== System Login == | ==System Login== | ||
Once the gateway is [[#Prepare Modem|prepared]] and booted, open a browser and go to http://192.168.1.2. Login through the 'Login' button in the top right corner. | Once the gateway is [[#Prepare Modem|prepared]] and booted, open a browser and go to http://192.168.1.2. Login through the 'Login' button in the top right corner. | ||
[[File:Main Login button.png|none|thumb|1240x1240px]] | [[File:Main Login button.png|none|thumb|1240x1240px]] | ||
Line 75: | Line 72: | ||
[[File:Login.png|none|thumb|1240x1240px]] | [[File:Login.png|none|thumb|1240x1240px]] | ||
== Main Page == | ==Main Page== | ||
After logging in, the system info page appears. This page shows the gateway's status.[[File:Main.png|none|thumb|1240x1240px]] | After logging in, the system info page appears. This page shows the gateway's status.[[File:Main.png|none|thumb|1240x1240px]] | ||
To open the menu, click on this icon: [[File:Foxbox menu button.png|frameless|23x23px]] | To open the menu, click on this icon: [[File:Foxbox menu button.png|frameless|23x23px]] | ||
[[File:Main with menu.png|none|thumb|1240x1240px]] | [[File:Main with menu.png|none|thumb|1240x1240px]] | ||
== Network Configuration == | ==Network Configuration== | ||
Click on menu tab 'Network config'. | Click on menu tab 'Network config'. | ||
Line 86: | Line 83: | ||
[[File:Network Config.png|none|thumb|1240x1240px]] | [[File:Network Config.png|none|thumb|1240x1240px]] | ||
== Modem Settings == | ==Modem Settings== | ||
=== Hostname and Frontend Settings === | ===Hostname and Frontend Settings=== | ||
==== Hostname ==== | ====Hostname==== | ||
Open the menu and go to 'Modem Settings'. | Open the menu and go to 'Modem Settings'. | ||
Set 'Modem Hostname' as FQDN and save your changes. Your modem will now restart.[[File:Modem Settings Hostname.png|none|thumb|1240x1240px]] | Set 'Modem Hostname' as FQDN and save your changes. Your modem will now restart.[[File:Modem Settings Hostname.png|none|thumb|1240x1240px]] | ||
==== Frontend ==== | ====Frontend==== | ||
Open the menu and go to 'Modem Settings'. | Open the menu and go to 'Modem Settings'. | ||
Change 'FrontEnd Address' to fit your configuration and save your settings.[[File:Modem Settings Frontend.png|none|thumb|1240x1240px]] | Change 'FrontEnd Address' to fit your configuration and save your settings.[[File:Modem Settings Frontend.png|none|thumb|1240x1240px]] | ||
=== Certificate Settings (https) === | ===Certificate Settings (https)=== | ||
Open the menu and go to 'Modem Settings'. | Open the menu and go to 'Modem Settings'. | ||
Line 108: | Line 105: | ||
[[File:Modem Settings Certificate.png|none|thumb|1240x1240px]] | [[File:Modem Settings Certificate.png|none|thumb|1240x1240px]] | ||
=== User Settings === | ===User Settings=== | ||
Open the menu and go to 'Modem Settings'. | Open the menu and go to 'Modem Settings'. | ||
Line 118: | Line 115: | ||
[[File:Modem Settings User.png|none|thumb|1240x1240px]] | [[File:Modem Settings User.png|none|thumb|1240x1240px]] | ||
== Control Panel == | ==Control Panel== | ||
Open the menu and go to 'Control Panel'. | Open the menu and go to 'Control Panel'. | ||
Here, you can see staus, as well as turn on and off, the SMS Engine.[[File:Control Panel.png|none|thumb|1240x1240px]] | Here, you can see staus, as well as turn on and off, the SMS Engine.[[File:Control Panel.png|none|thumb|1240x1240px]] | ||
== SMS == | ==SMS== | ||
=== Inbox === | ===Inbox=== | ||
To see a log for incoming messages, open the menu and go to 'Inbox'. | To see a log for incoming messages, open the menu and go to 'Inbox'. | ||
[[File:Inbox.png|none|thumb|1240x1240px]] | [[File:Inbox.png|none|thumb|1240x1240px]] | ||
=== Outbox === | ===Outbox=== | ||
To see a log for outgoing messages, open the menu and go to 'Outbox'. | To see a log for outgoing messages, open the menu and go to 'Outbox'. | ||
[[File:Outbox.png|none|thumb|1240x1240px]] | [[File:Outbox.png|none|thumb|1240x1240px]] | ||
=== Failed === | ===Failed=== | ||
To see a log for failed messages, open the menu and go to 'Failed'. | To see a log for failed messages, open the menu and go to 'Failed'. | ||
[[File:Failed.png|none|thumb|1240x1240px]] | [[File:Failed.png|none|thumb|1240x1240px]] | ||
=== Write New === | ===Write New=== | ||
To write a new SMS, open the menu and go to 'Write New'. | To write a new SMS, open the menu and go to 'Write New'. | ||
Line 147: | Line 144: | ||
When you have finished, click 'Send'.[[File:Write New guide.png|none|thumb|1240x1240px]] | When you have finished, click 'Send'.[[File:Write New guide.png|none|thumb|1240x1240px]] | ||
== Time Zone Settings == | ==Time Zone Settings== | ||
Open the menu and go to 'Time Zone Settings'. | Open the menu and go to 'Time Zone Settings'. | ||
Line 159: | Line 156: | ||
[[File:Time Zone Settings.png|none|thumb|1240x1240px]] | [[File:Time Zone Settings.png|none|thumb|1240x1240px]] | ||
== Tools == | ==Tools== | ||
Open the menu and go to 'Modem Settings'. | Open the menu and go to 'Modem Settings'. | ||
=== Shell === | ===Shell=== | ||
Use 'in browser' shell to change advanced settings. | Use 'in browser' shell to change advanced settings. | ||
<u style="color:red;">Use with caution!</u> Please note that if you make any changes without consulting us first, support will be charged accordingly with our hourly rate. | <u style="color:red;">Use with caution!</u> Please note that if you make any changes without consulting us first, support will be charged accordingly with our hourly rate. | ||
[[File:Modem Settings Shell.png|none|thumb|1240x1240px]] | [[File:Modem Settings Shell.png|none|thumb|1240x1240px]] | ||
=== Root Settings === | ===Root Settings=== | ||
Change of root password requires login to shell. Default root password is 'odroid'. | Change of root password requires login to shell. Default root password is 'odroid'. | ||
Line 173: | Line 170: | ||
[[File:Modem Settings Root.png|none|thumb|1240x1240px]] | [[File:Modem Settings Root.png|none|thumb|1240x1240px]] | ||
== FAQ == | ==FAQ== | ||
===Linux commands=== | |||
====How to change IP settings==== | |||
*nano /etc/network/interfaces.d/eth0 | |||
*nano /etc/resolv.conf | |||
*reboot | |||
====Logs==== | |||
=====Log viewers===== | |||
*tail | |||
*tail -f (this is similar to using cmtrace in windows) | |||
*nano | |||
* nano | *vim | ||
* | |||
==== | =====Log files===== | ||
*/var/log/smstools/smsd.log | |||
* | */var/log/syslog | ||
* | */var/log/mysql/error.log | ||
* | */var/log/apache2/error.log | ||
* | |||
===== | =====See USB devices===== | ||
*lsusb | |||
* lsusb | |||
== Rest API == | ==Rest API== | ||
Theres a REST API to use, to send messages from the inLogic SMS Gateway. | Theres a REST API to use, to send messages from the inLogic SMS Gateway. | ||
Revision as of 15:20, 20 March 2019
Important
To be able to send SMS, the inLogic SMS Gateway requires GSM modems with USB interface. We recommend "HUAWEI LTE USB Stick Model: E3372".
Hardware Compatibility List
Huawei E3372 (inLogic's choice)
Network Port Openings
TCP port openings from server to gateway. TCP port opening where UMS sms sever service run.
Port | Usage |
---|---|
22 | SSH access |
443 | HTTPS access |
3306 | Database access |
TCP port openings from gateway to server.
Port | Usage |
---|---|
80 | HTTP access |
443 | HTTPS access |
Prepare Modem
Plug-in Modems | |||
---|---|---|---|
Plug-in Ethernet cable
Plug-in power cable |
|||
System Login
Once the gateway is prepared and booted, open a browser and go to http://192.168.1.2. Login through the 'Login' button in the top right corner.
You will now see a login box where you can log in with with USERNAME: admin and PASSWORD: admin.
Main Page
After logging in, the system info page appears. This page shows the gateway's status.
To open the menu, click on this icon:
Network Configuration
Click on menu tab 'Network config'.
Change the IP settings and press 'Save Configuration'. When you have saved your settings, Reboot the gateway as instructed below in 'Modem Settings'.
Modem Settings
Hostname and Frontend Settings
Hostname
Open the menu and go to 'Modem Settings'.
Set 'Modem Hostname' as FQDN and save your changes. Your modem will now restart.
Frontend
Open the menu and go to 'Modem Settings'.
Change 'FrontEnd Address' to fit your configuration and save your settings.
Certificate Settings (https)
Open the menu and go to 'Modem Settings'.
Click 'Choose File' and choose a .pfx certificate from your computer.
Entera a .pfx certificate password in the 'Certificate Password' field and click 'Save'.
User Settings
Open the menu and go to 'Modem Settings'.
The default admin user password is 'admin'. To change the default admin user password, write the new password in the 'Password' field just below the 'Username' field admin.
The default sendsms user password is 'sendsms'. To change the default sendsms user password, write the new password in the 'Password' field just below the 'Username' field sendsms.
Click 'Save' to confirm the password change.
Control Panel
Open the menu and go to 'Control Panel'.
Here, you can see staus, as well as turn on and off, the SMS Engine.
SMS
Inbox
To see a log for incoming messages, open the menu and go to 'Inbox'.
Outbox
To see a log for outgoing messages, open the menu and go to 'Outbox'.
Failed
To see a log for failed messages, open the menu and go to 'Failed'.
Write New
To write a new SMS, open the menu and go to 'Write New'.
Choose the modem you wish to send your message from in the drop down menu 'Outgoing channel'. If left blank, the system will choose the first available modem.
Enter the phone number you wish to send your SMS to in the 'To' field. Pleas note that international prefix is mandatory.
Write your message in the 'Message' field.
When you have finished, click 'Send'.
Time Zone Settings
Open the menu and go to 'Time Zone Settings'.
The NTP & Time Zone Settings is by default set to enable external NTP.
For internal NTP, uncheck the 'Enable External NTP' box and write a list of NTP servers separated by comma, in the 'Internal NTP' field.
To change your time zone, choose a time zone from the 'Time Zone' drop down menu.
Click 'Save' to change your settings.
Tools
Open the menu and go to 'Modem Settings'.
Shell
Use 'in browser' shell to change advanced settings.
Use with caution! Please note that if you make any changes without consulting us first, support will be charged accordingly with our hourly rate.
Root Settings
Change of root password requires login to shell. Default root password is 'odroid'.
Login to shell, run password command and follow the instructions on screen.
FAQ
Linux commands
How to change IP settings
- nano /etc/network/interfaces.d/eth0
- nano /etc/resolv.conf
- reboot
Logs
Log viewers
- tail
- tail -f (this is similar to using cmtrace in windows)
- nano
- vim
Log files
- /var/log/smstools/smsd.log
- /var/log/syslog
- /var/log/mysql/error.log
- /var/log/apache2/error.log
See USB devices
- lsusb
Rest API
Theres a REST API to use, to send messages from the inLogic SMS Gateway.
Title | |
---|---|
URL | source/send_sms.php |
Method | POST |
URL Parameters | Username
Password To Message |
Success Response | 200 - Success |
Error Response | 401 - Unauthorized |
Error Resposne | 403 - Forbidden |
Error Response | 500 - Internal server error |
Sample Request | source/send_sms.php?username=smsuser&pwd=testpassword123&from=ums&to=22446688&message=Dette er en test besked |
Notes |
Example
curl -X POST https://modem.ums.dk/source/send_sms.php?username=<USERNAME>&pwd=<PASSWORD>&from=ums&to=<RECIEPIENT>&message=<MESSAGE>