Beam Wi-Fi General Help

General articles and help relating to using Beam Wi-Fi devices.

PRB: Guest Wi-Fi Disconnects

posted 26 Sept 2017, 09:03 by Mobile Onboard System Admin   [ updated 26 Sept 2017, 09:08 ]

The Beam Wi-Fi devices (as with many Wi-Fi systems) will automatically disconnect users when there is a period of inactivity.  This is that the resources are not unnecessarily consumed by connections that are not actually doing anything.  This only affects the public/guest Wi-Fi network, and not the Accessory Wi-Fi channel, which has no such limitations.

Beam devices generally have three such settings which are used to control this behaviour.  These settings can be changed in the network router management console.

Keep Alive Timeout
This checks whether the client device is still physically connected to the network router.  If the client hasn't been connected for 10 minutes then their session is terminated.

Idle Timeout
This checks whether a connected client device has actually done anything on the network.  If the client hasn't sent or received any data for more than 20 minutes then their session is terminated.

Session Timeout
If a client device has been connected to the network for more than 2 hours then they will be disconnected from the network and will have to sign-in again in order to continue using it.

HOW TO: Update the Beam Portal Content Remotely

posted 28 Jul 2017, 14:25 by Mobile Onboard System Admin   [ updated 28 Jul 2017, 14:29 ]

This is an Advanced topic and support is only available to Beam Care subscribers.

Version 1.0a


Beam BW130, BW230 and BW280 vehicle Wi-Fi units have an onboard Web portal which the user accesses before they are taken to the Internet.  When we ship out a Beam Wi-fi unit to you it will be pre-installed either with the default Portal design, or a custom portal if that was requested.  In addition there is an area on the portal's Web server which you can publish additional content to, which can be linked to from your default landing page, or used as a separate sub-site.

BeamOS firmware released since May 2015 allows the portal content to be updated remotely using the Beam Content Distribution Service (CDS).  When your Beam unit first boots up and obtains an Internet connection, it will check the Beam CDS cloud server for any file updates, and if available will download them over the 4G connection.  The files will then be copied to the onboard Web server content area, adding any new files and overwriting any existing files.

If you are running other services on your Beam unit which rely on files in this content area, then you'll need to ensure that your content folder structure on the disk is relative to the user content path (Web root), which is:


The Beam CDS is accessed using FTP, allowing you to easily create and copy over file and folder structures of your choosing to the server which will then be distributed over-the-air to your Beam units.  If you have an in-house content management and publishing system then you can also configure that to publish files to the Beam CDS server using FTP.  This can be useful if you want to publish advertising and other content files in an automated way.

The Beam CDS service is available at no extra cost to customers that have our Beam Care subscription.  If you do not have Beam Care then please contact our Sales department for pricing options.

Connecting to the Beam CDS

In order to publish your content using the Beam CDS you will need to request an account.  You can do this by raising a support ticket, stating your company name and a serial number from one of your units.  We will then contact you back with the relevant details.

Once you have your account login, use an FTP client such as Filezilla to access your Beam CDS content area, using the following details:

FTP Server:

FTP Port: 8121

The FTP server uses a Passive (PASV) connection.

These are the Account Settings as set up in Filezilla:

Filezilla Account Settings

Once you have logged into the server, you will be presented with your file system area in the FTP client:

Home Directory Structure

Publication Structure

In the previous screen you will see that there are two parent folders:

group : This contains folders with the group name assigned to more than once device.  When content is copied to a group folder it will be published to any Beam device that connects with that Group Name assigned to it.  Group Names are not normally assigned unless requested as build time, and are reserved customers with a large number of Beam units.  If you want to assign a number of units to a single group then please raise a support ticket.

devices : This contains folders for each individual unit you want to publish new content to.  The folder name will be the same as your device's Serial Number which is usually made up of 8 characters.

Version Control

Each device will contain a version folder which means you can maintain version control on devices.  This is particularly useful if have different devices that come on at different times, and need a previous version installed before a new one can be.  Each device maintains a content version number starting from 1 at factory build time.  You can obtain a units current content version by accessing the Factory Configuration page on your unit's BeamOS portal.  As each version is downloaded from the Beam CDS, the Beam device will increment its version number and will look for new content next time in the incremented version folder on the Beam CDS.

So for example, if your unit's serial number is ABCD1234 then you would copy the relevant version 2 content changes to the folder on the FTP Site:


Anything contained within this folder would then be downloaded to the folder \var\www\html\user\ on the target device, so if the file index.htm was copied to /device/ABDC1234/2/index.htm  on the FTP server, it would be downloaded and stored as \var\www\html\user\index.htm on the Beam unit's flash disk.

Similarly, if the file index.htm was copied to the group folder /group/MYBEAMGROUP/1/index.htm it would be downloaded to \var\www\html\user\index.htm on all Beam devices configured to be part of the MYBEAMGROUP group.

The version folder is the new version number - so if your current configuration is version 1 then your new version folder should be 2.

Enabling the Synchronisation

In the background, there is synchronisation service that copies your files to a high-availability master cloud server.  It's the master cloud server that your Beam units connect to and download the content from.

To ensure that content is not copied to the master cloud server until you are ready, i.e., after you have finished uploading all your content to the FTP server, you are required to copy a control file to your account root directory.  This instructs the synchronisation service that you are finished uploading and that all of the folders can be published.

The control file is simply an empty file with the name sync.ready and you just need to upload it to your account root as shown below:

Once your folder has been published to the master cloud server, the control file will be deleted.  This indicates to you that the copying has been successful, and also prevents continuous copying of unnecessary data to the master cloud server.

Note that it can take up to five minutes for the data to be copied from your account folder to the master cloud server, and that files are only downloaded to your Beam device following a reboot and first-time connection to the Internet.

Be aware that downloading files to your devices over-the-air will consume data as part of your SIM card's mobile data plan which you are responsible for.

PRB: Cannot Connect to Beam Hotspot Portal

posted 28 Jul 2017, 14:16 by Mobile Onboard System Admin   [ updated 16 Aug 2017, 07:27 ]

Sometimes, issues occur whereby certain handsets (notibly iPhones) have problems connecting to the Beam Wi-Fi portal after they have connected to the Guest Wi-Fi network.

The problem occurs when these handsets try to connect to the portal when there is no network connection available on the Beam Wi-Fi unit at that time. This affects the hotspot detection services that operator on the mobile device, and as a result the handset will then think the network connection is of poor quality and will stop trying to connect to it. This, therefore prevents the Beam portal page from loading.

The problem is further compounded as the handsets will remember the network as being of poor quality and will not let the user access the portal even if the Beam Wi-FI has a full network connection.

We recommend the following actions in these cases:

1. Make sure the Beam Wi-Fi unit has fully booted and has connected to the network (solid blue light on the modem or solid green light on the front panel) before trying to connect.

2. If your handset tried connecting when there was no network connection and you now cannot access the Beam then go into your handset's Wi-Fi settings, select the Beam Wi-Fi SSID, tap on 'Forget Network' and then re-join the Beam Wi-Fi. That should resolve the issue and enable the handsets to access the portal.

If, after trying the above you are still not able to access the Beam portal, please raise a support ticket stating the unit's serial number.

INFO: Mobile Network APN Settings

posted 28 Jul 2017, 14:12 by Mobile Onboard System Admin   [ updated 16 Aug 2017, 07:23 ]

Below we have listed some of the common mobile network access point name (APN) details used to configure Beam Units when a particular network's SIM is being used:
Please note: We cannot guarantee the accuracy of the settings and they may change from time-to-time, therefore you should check with your network provider if you are unsure or are having problems.

3 UK (3G)
APN: 3internet
User: <blank>
Pass: <blank>

APN: everywhere
User: <blank>
Pass: <blank>

O2 4G
User: o2web
Pass: password

Vodafone 4G
APN: internet
User: web
Pass: web

1-4 of 4