Difference between revisions of "Foxbox"

From UmsWiki
Jump to: navigation, search
 
(7 intermediate revisions by 3 users not shown)
Line 66: Line 66:
  
 
==System Login==
 
==System Login==
Once modem is [[#Prepare Modem|prepared]] and booted (the modem will make a single beep when booted), browse to <nowiki>http://192.168.1.2</nowiki> and click login in upper right corner.
+
Once the modem is [[#Prepare Modem|prepared]] and booted (the modem will make a single beep when booted), open a browser and go to <nowiki>http://192.168.1.2</nowiki> and click login in the upper right corner.
[[File:Foxbox Login.png|none|frame]]
+
[[File:Foxbox Login.png|none|1180x1180px|thumb]]
Login box will popup, and here login with USERNAME: admin and PASSWORD: admin
+
A login box will pop up. Login with username 'admin' and password 'admin'.
[[File:Foxbox Login Modal.png|none|frame]]
+
[[File:Foxbox Login Modal.png|none|510x510px|thumb]]
  
 
==Main Page==
 
==Main Page==
After login the system info page appears.
+
After logging in, the system info page appears. This page shows status for the modem.[[File:Foxbox index menu closed.png|none|1300x1300px|thumb]]Click on [[File:Foxbox menu button.png|frameless|23x23px]] to open the menu.
 
+
[[File:Foxbox index menu open.png|none|1300x1300px|thumb]]
Shows status of the modem.
 
[[File:Foxbox index menu closed.png|none|frame]]Click the [[File:Foxbox menu button.png|frameless|23x23px]] to open menu
 
[[File:Foxbox index menu open.png|none|frame]]
 
  
 
==Network Configuration==
 
==Network Configuration==
Click “Network Config” in menu
+
Go to the menu and click 'Network Config'.
  
Change IP settings and press “Save Configuration”, [[Foxbox#Reboot|Reboot]] modem on “inLogic Modem Settings” page.
+
Change the IP settings and press 'Save Configuration'. Go to the 'inLogic Modem Settings' page and [[Foxbox#Reboot|reboot]] the modem.
[[File:Foxbox Network Config.png|none|frame]]
+
[[File:Foxbox Network Config.png|none|1300x1300px|thumb]]
  
 
==Modem Settings==
 
==Modem Settings==
  
===Frontend and Hostname Settings===
+
===Frontend and Hostname settings===
 
 
====Hostname====
 
Click “inLogic Modem Settings”
 
 
 
Set Modem Hostname as FQDN.
 
 
 
Scroll down and Click “Save” and the modem will restart.
 
[[File:Foxbox Hostname inLogic Modem Settings.png|none|frame]]
 
  
 
====Frontend====
 
====Frontend====
Click “inLogic Modem Settings”
+
Open the menu and go to 'inLogic Modem Settings'.
  
Change FrontEnd Address to fit your configuration.
+
Change the 'FrontEnd Address' to fit your configuration.
  
Scroll down and Click “Save”
+
Scroll down and click 'Save'.
[[File:Foxbox Frontend inLogic Modem Settings.png|none|frame]]
+
[[File:Foxbox Frontend inLogic Modem Settings.png|none|1300x1300px|thumb]]
  
===Certificate(https) Settings===
+
===Hostname===
Click “inLogic Modem Settings” and scroll down to “Certificate(https) Settings”
+
Open the menu and go to 'inLogic Modem Settings'.
  
Copy/Paste Certificate from .crt or .pem file into Certificate box (incl. the “-----BEGIN CERTIFICATE-----” and “-----END CERTIFICATE-----” lines).
+
Set the modem hostname as 'FQDN'.
  
Copy/Paste Private key into Private key box (incl. the “-----BEGIN RSA PRIVATE KEY-----“ and “-----END RSA PRIVATE KEY-----” lines). Click “Save” and the modem will restart.
+
Scroll down and click 'Save'. The modem will restart.
[[File:Foxbox Certificate inLogic Modem Settings.png|none|frame]]
+
[[File:Foxbox Hostname inLogic Modem Settings.png|none|1300x1300px|thumb]]
  
===User Settings===
+
====User Settings====
In the menu click “inLogic Modem Settings” and scroll down to “User Settings”
+
Open the menu and go to 'inLogic Modem Settings' and scroll down to 'User Settings'.
  
To change default admin user password (default “admin”), write new password in Password box just below admin username.
+
To change default admin user password (default 'admin'), write the new password in the Password box, just below admin username.
  
To change default sendsms user password (default “sendsms”), write new password in Password box just below sendsms username.
+
To change default sendsms user password (default 'sendsms'), write the new password in the Password box just below sendsms username.
  
Click “Save” to confirm password change.
+
Click 'Save' to confirm password change.
[[File:Foxbox UserSettings inLogic Modem Settings.png|none|frame]]
+
[[File:Foxbox UserSettings inLogic Modem Settings.png|none|1300x1300px|thumb]]
  
 
===SIM Settings===
 
===SIM Settings===
In the menu click “inLogic Modem Settings” and scroll down to “SIM Settings”
+
Open the menu and go to 'inLogic Modem Settings' and scroll down to 'SIM Settings'.
  
Enable / Disable PIN for modems and set PIN if needed.
+
Do not enable pin settings for any modem. It does not work. All ping codes must be removed from the cards.
  
Click “Save”. After save Click [[Foxbox#Reboot|Reboot]].
+
Click 'Save' and click [[Foxbox#Reboot|Reboot]].
[[File:Foxbox SIMSettings inLogic Modem Settings.png|none|frame]]
+
[[File:Foxbox SIMSettings inLogic Modem Settings.png|none|1300x1300px|thumb]]
  
 
==Control Panel==
 
==Control Panel==
In the menu click "Control Panel".
+
Open the menu and go to 'Control Panel'.
  
Use Control Panel to see State of SMS Engine, turn on/off SMS Engine.
+
Here, you can see staus, as well as turn on and off, the SMS Engine.[[File:Foxbox_Control_Panel.png|none|1300x1300px|thumb]]
[[File:Foxbox_Control_Panel.png|none|frame]]
 
  
 
==SMS==
 
==SMS==
  
 
===Inbox===
 
===Inbox===
Click “Inbox” in menu to see a log of incoming messages.
+
To see a log for incoming messages, open the menu and go to 'Inbox'.
[[File:Foxbox Inbox.png|none|frame]]
+
[[File:Foxbox Inbox.png|none|1300x1300px|thumb]]
  
 
===Outbox===
 
===Outbox===
Click “Outbox” in menu to see a log of outgoing messages.
+
To see a log for outgoing messages, open the menu and go to 'Outbox'.
[[File:Foxbox Outbox.png|none|frame]]
+
[[File:Foxbox Outbox.png|none|1300x1300px|thumb]]
 
 
 
===Write New===
 
===Write New===
Click “Write New” in menu to see a log of outgoing messages.
+
To write a new SMS, open the menu and go to 'Write New'.
  
<span style="background-color: #FFFF00">Choose what modem to send from or leave as is to choose first free modem.</span>
+
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.
  
<span style="background-color: #00FF00">Insert mobile phone number to send to. (international prefix is mandatory)</span>
+
Enter the phone number you wish to send your SMS to in the 'To' field. Please note that international prefix is mandatory.
  
<span style="background-color: #0000FF; color: #FFFFFF">Write text to send.</span>
+
Write your message in the 'Message' field.
  
Click “Send” to continue.
+
When you have finished, click 'Send'.[[File:Foxbox Write New.png|none|1300x1300px|thumb]]
[[File:Foxbox Write New.png|none|frame]]
 
  
 
==Time Zone Settings==
 
==Time Zone Settings==
Time zone and NTP server settings
+
Open the menu and go to 'Time Zone Settings'.
  
For External NTP servers check Enable External NTP (default) and choose External NTP Region (Default Europe)
+
The NTP & Time Zone Settings is by default set to enable external NTP.
  
For Internal NTP, uncheck Enable External NTP and write comma separated list of NTP servers in Internal NTP textbox.
+
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 set your Time Zone, click Time Zone dropdown and choose your zone.
+
To change your time zone, choose a time zone from the 'Time Zone' drop down menu.
  
Click Save to change configuration.
+
Click 'Save' to change your settings.[[File:Foxbox Time Zone Settings.png|none|1300x1300px|thumb]]
[[File:Foxbox Time Zone Settings.png|none|frame]]
 
  
 
==Tools==
 
==Tools==
Click "inLogic Modem Settings" in menu and go to bottom of page.
+
Open the menu and go to 'Modem Settings'.
 +
===Shell===
 +
Use 'in browser' shell to change advanced settings.
  
===Shell===
+
<u style="color:red;">Use with caution!</u> Please note that if you make any changes without consulting inLogic first, support will be charged accordingly to our hourly rate.[[File:Foxbox Shell inLogic Modem Settings.png|none|1300x1300px|thumb]]
In browser shell to change advanced settings (USE with caution)
 
[[File:Foxbox Shell inLogic Modem Settings.png|none|frame]]
 
  
 
===Reboot===
 
===Reboot===
Reboot modem.
+
In order to reboot the modem, click on the 'Reboot Modem' button.
[[File:Foxbox Reboot inLogic Modem Settings.png|none|frame]]
+
[[File:Foxbox Reboot inLogic Modem Settings.png|none|1300x1300px|thumb]]
  
 
===Root Settings===
 
===Root Settings===
Change of root password requires login to shell.
+
Change of root password requires login to shell. Default root password is 'odroid'.
  
Login to shell, run passwd command and follow instructions on screen.
+
Login to shell, run password command and follow the instructions on screen.
[[File:Foxbox Root inLogic Modem Settings.png|none|frame]]
+
 
 +
This is not possible from the web interface.[[File:Foxbox Root inLogic Modem Settings.png|none|1300x1300px|thumb]]
  
 
==Update certificate==
 
==Update certificate==
  
===Step one===
+
===Step one - creating a certificate.pem file===
Make sure you have the certificate as a­ . crt or .pem file. You should have a certificate with a private key. Some providers send 2 or more files contain this. To handle the certificate, we need to extra the information from the certificate and private key – and combine these two into one certificate.
+
Make sure you have the certificate as a­ . crt or .pem file. You should have received a certificate with a private key from your provider. Some providers send two or more files containing this.
  
If you use notepad to open the certificate, you should see something like this
+
To handle the certificate, we need to extract the information from the certificate and private key and combine these two into one certificate.
 +
 
 +
If you use notepad to open the certificate (recommended), you will see this:
 
  -----BEGIN CERTIFICATE-----  
 
  -----BEGIN CERTIFICATE-----  
 
  Lots of data here...
 
  Lots of data here...
 
  -----END CERTIFICATE-----
 
  -----END CERTIFICATE-----
When you open the private key certificate it should look some what similar to this.
+
When you open the private key certificate, you should see this:
 
  -----BEGIN RSA PRIVATE KEY-----  
 
  -----BEGIN RSA PRIVATE KEY-----  
 
  Lots of data here...
 
  Lots of data here...
 
  -----END RSA PRIVATE KEY-----
 
  -----END RSA PRIVATE KEY-----
Or something like this
+
Or this:
 
  -----BEGIN PRIVATE KEY-----  
 
  -----BEGIN PRIVATE KEY-----  
 
  Lots of data here...
 
  Lots of data here...
 
  -----END PRIVATE KEY-----
 
  -----END PRIVATE KEY-----
Now create a new txt file in a folder, copy the content of the private key into the file.
+
Start by creating a new .txt file in a folder and then copy the content of the private key into the new .txt file.
  
After that open the certificate file and copy the content and paste it after the private key.
+
Now, open the certificate file, copy the content and paste it in after the private key.
  
Your file should look something like this:
+
Your file should look like this:
 
  -----BEGIN PRIVATE KEY-----
 
  -----BEGIN PRIVATE KEY-----
 
  MIIEvQIBAD...
 
  MIIEvQIBAD...
Line 215: Line 203:
 
  MIICsjCCAZqgAw...
 
  MIICsjCCAZqgAw...
 
  -----END CERTIFICATE-----
 
  -----END CERTIFICATE-----
Now save the file by selecting all files types instead of txt and name the file certificate.pem
+
Save the file by selecting all file types instead of .txt and name the file 'certificate.pem'.
  
===Steep two - installation===
+
===Step two - installation===
To install the certificate, you will need FTP software, you can freely select any of these
+
To install the certificate, you will need FTP software (you can freely select the FTP software you prefer).
  
After that connect to the foxbox using the IP address of the server. I’m using FileZilla for this example.
+
Now, connect to the Foxbox using the server's IP address. This example uses 'FileZilla'.
 +
[[File:Filezilla_foxbox_update_certificate.jpg|none|thumb|839x839px]]
  
[[File:Filezilla_foxbox_update_certificate.jpg|1186x1186px]]
 
  
When the client has connected, and you get the folder view, you can navigate to /etc/sms/scripts, this can be done but using the folder view to navigate back and into the path or you can simple paste the path into remote site bar and press enter.
+
When the client has connected, you will have the folder view where you can navigate to '/etc/sms/scripts'. You can use the folder view to navigate back to the path or you can simply paste the path into the remote site bar and press enter.
  
Now you should be able to locate the certificate.pem file inside the folder to verify you’re at the correct path.
+
Now, you should be able to locate the certificate.pem file inside the folder.
  
Now navigate the local file view to the new certificate that we created inside step 1 and upload it to the foxbox.
+
Continue by navigating the local file view to the new certificate that we created in step 1 and upload it to the Foxbox.
  
 
===Steep three===
 
===Steep three===
Now open or download the SSH client program, i’m using putty for this example.
+
Open or download the SSH client program. This example uses 'putty'.
  
When you have the ssh client opened, please connect using the IP address of the foxbox server.
+
When you have the ssh client open, please connect using the Foxbox server's IP address.
  
When you are connected please use the root user to login as it’s the only user with permissions to restart the apache server.
+
When successfully connected, please use the root user to login, as it is the only user with permissions to restart the apache server.
  
To restart the apache server enter:  
+
In order to restart the apache server, please type:  
 
  /etc/init.d/apache2 restart
 
  /etc/init.d/apache2 restart
And press enter.
+
Press enter.
  
When the service is restarted successfully, there should appear a green text with the text OK, if unsuccessful the text will be written in red contain the error message.
+
When the service is restarted successfully, 'OK' will appear in green text. If the service was unsuccessful, the error message will appear in red text.
  
Now go the url of the foxbox and verify the certificate has been changed and is valid.
+
After successfully restarting, open the Foxbox url and verify that the certificate has been changed and is valid.
  
===Extra information===
+
===Additional information===
Extra information about the product, users and programs used in the tutorial.
+
Additional information about the product, users, and programs used in the tutorial.
  
 
====Usernames and passwords====
 
====Usernames and passwords====
Line 255: Line 243:
 
!Description
 
!Description
 
|-
 
|-
|
+
|admin
|
+
|admin
|
+
|Admin user
 +
|-
 +
|sendSMS
 +
|sendSMS
 +
|Only allowed to send SMS
 
|-
 
|-
|
+
|root
|
+
|foxbox
|
+
|Root user, main system user
 
|-
 
|-
|
+
|foxbox
|
+
|foxbox
|
+
|Foxbox user is scaled down root user
 
|}
 
|}
  

Latest revision as of 09:59, 30 January 2019

UMS SMS Modem.. ( Certificate is required for use of Modem )

Foxbox.png

Network Port Openings

TCP port openings from server to modem.

Port Usage
22 SSH access
80 HTTP access
443 HTTPS access
3306 Database access

TCP port openings from modem to server.

Port Usage
80 HTTP access
443 HTTPS access

Prepare Modem

Inside Foxbox
Insert sim cards (sim2 cardholder is on the backside of the board)

01 – Plug-in antenna connectors

02 – Plug-in Ethernet cable

03 – Plug-in power cable

04 – Optional serial cable

05 – Optional USB extention

System Login

Once the modem is prepared and booted (the modem will make a single beep when booted), open a browser and go to http://192.168.1.2 and click login in the upper right corner.

Foxbox Login.png

A login box will pop up. Login with username 'admin' and password 'admin'.

Foxbox Login Modal.png

Main Page

After logging in, the system info page appears. This page shows status for the modem.

Foxbox index menu closed.png

Click on Foxbox menu button.png to open the menu.

Foxbox index menu open.png

Network Configuration

Go to the menu and click 'Network Config'.

Change the IP settings and press 'Save Configuration'. Go to the 'inLogic Modem Settings' page and reboot the modem.

Foxbox Network Config.png

Modem Settings

Frontend and Hostname settings

Frontend

Open the menu and go to 'inLogic Modem Settings'.

Change the 'FrontEnd Address' to fit your configuration.

Scroll down and click 'Save'.

Foxbox Frontend inLogic Modem Settings.png

Hostname

Open the menu and go to 'inLogic Modem Settings'.

Set the modem hostname as 'FQDN'.

Scroll down and click 'Save'. The modem will restart.

Foxbox Hostname inLogic Modem Settings.png

User Settings

Open the menu and go to 'inLogic Modem Settings' and scroll down to 'User Settings'.

To change default admin user password (default 'admin'), write the new password in the Password box, just below admin username.

To change default sendsms user password (default 'sendsms'), write the new password in the Password box just below sendsms username.

Click 'Save' to confirm password change.

Foxbox UserSettings inLogic Modem Settings.png

SIM Settings

Open the menu and go to 'inLogic Modem Settings' and scroll down to 'SIM Settings'.

Do not enable pin settings for any modem. It does not work. All ping codes must be removed from the cards.

Click 'Save' and click Reboot.

Foxbox SIMSettings inLogic Modem Settings.png

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.

Foxbox Control Panel.png

SMS

Inbox

To see a log for incoming messages, open the menu and go to 'Inbox'.

Foxbox Inbox.png

Outbox

To see a log for outgoing messages, open the menu and go to 'Outbox'.

Foxbox Outbox.png

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. Please note that international prefix is mandatory.

Write your message in the 'Message' field.

When you have finished, click 'Send'.

Foxbox Write New.png

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.

Foxbox Time Zone Settings.png

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 inLogic first, support will be charged accordingly to our hourly rate.

Foxbox Shell inLogic Modem Settings.png

Reboot

In order to reboot the modem, click on the 'Reboot Modem' button.

Foxbox Reboot inLogic Modem Settings.png

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.

This is not possible from the web interface.

Foxbox Root inLogic Modem Settings.png

Update certificate

Step one - creating a certificate.pem file

Make sure you have the certificate as a­ . crt or .pem file. You should have received a certificate with a private key from your provider. Some providers send two or more files containing this.

To handle the certificate, we need to extract the information from the certificate and private key and combine these two into one certificate.

If you use notepad to open the certificate (recommended), you will see this:

-----BEGIN CERTIFICATE----- 
Lots of data here...
-----END CERTIFICATE-----

When you open the private key certificate, you should see this:

-----BEGIN RSA PRIVATE KEY----- 
Lots of data here...
-----END RSA PRIVATE KEY-----

Or this:

-----BEGIN PRIVATE KEY----- 
Lots of data here...
-----END PRIVATE KEY-----

Start by creating a new .txt file in a folder and then copy the content of the private key into the new .txt file.

Now, open the certificate file, copy the content and paste it in after the private key.

Your file should look like this:

-----BEGIN PRIVATE KEY-----
MIIEvQIBAD...
-----END PRIVATE KEY-----
-----BEGIN CERTIFICATE-----
MIICsjCCAZqgAw...
-----END CERTIFICATE-----

Save the file by selecting all file types instead of .txt and name the file 'certificate.pem'.

Step two - installation

To install the certificate, you will need FTP software (you can freely select the FTP software you prefer).

Now, connect to the Foxbox using the server's IP address. This example uses 'FileZilla'.

Filezilla foxbox update certificate.jpg


When the client has connected, you will have the folder view where you can navigate to '/etc/sms/scripts'. You can use the folder view to navigate back to the path or you can simply paste the path into the remote site bar and press enter.

Now, you should be able to locate the certificate.pem file inside the folder.

Continue by navigating the local file view to the new certificate that we created in step 1 and upload it to the Foxbox.

Steep three

Open or download the SSH client program. This example uses 'putty'.

When you have the ssh client open, please connect using the Foxbox server's IP address.

When successfully connected, please use the root user to login, as it is the only user with permissions to restart the apache server.

In order to restart the apache server, please type:

/etc/init.d/apache2 restart

Press enter.

When the service is restarted successfully, 'OK' will appear in green text. If the service was unsuccessful, the error message will appear in red text.

After successfully restarting, open the Foxbox url and verify that the certificate has been changed and is valid.

Additional information

Additional information about the product, users, and programs used in the tutorial.

Usernames and passwords

A list of username and passwords
Username Password Description
admin admin Admin user
sendSMS sendSMS Only allowed to send SMS
root foxbox Root user, main system user
foxbox foxbox Foxbox user is scaled down root user

SSH Clients

A list of SSH Clients
Program name URL
PuTTy https://www.putty.org/

Open source FTP Client

A list of FTP clients
Program name URL
WinSCP https://winscp.net/eng/index.php
FileZilla https://filezilla-project.org/