How to configure my ALEOS gateway to communicate with AirVantage?

Configure your ALEOS gateway

AirLink ALEOS gateways are configured by default to communicate with AirVantage every day (24 hours). This periodic check can be disabled if you are not using AirVantage, and the frequency can be changed in ACEmanager or from AirVantage.

As of the release of ALEOS 4.6.0, we have introduced a new device management protocol that controls the communication between the gateway and AirVantage. Any devices that ship with ALEOS 4.7.0 or later will default to LWM2M. Devices that are upgraded to ALEOS 4.7.0 or later will have the Services > ALMS > AirLink Management Services > ALMS Protocol set to “Try LWM2M, Fallback MSCI”. This allows the gateway to attempt to switch to LWM2M, but remain on MSCI if your firewall configuration does not allow the device to communicate.

If your devices are communicating with LWM2M, you can confirm the configuration of a gateway in ACEmanager or AirVantage as follows, otherwise use the MSCI configuration below.

• Services > ALMS > AirLink Management Services > ALMS Protocol is enabled and set to LWM2M (preferred) or MSCI.
• Services > ALMS > AirLink Management Services > ALMS Protocol in Use identifies the current protocol used to communicate for the last session.
• Services > ALMS > Device Initiated Interval (minutes) set to the communication period of your choice (the default value is 1440 minutes).

With LWM2M, the server URL is defined by the server during the registration process, and is not configured in ACEmanager or AirVantage

If you chose to continue to use MSCI, you need to configure the MSCI section:

• Services > ALMS > MSCI > Server URL is set to: https://na.m2mop.net/device/msci/com
• Services > ALMS > MSCI > TLS Verify Peer Certificate is enabled (option available on ALEOS only)

For devices that cannot use LWM2M, the configuration will be slightly different. You can confirm the configuration of a gateway in ACEmanager or AirVantage:

• Services > ALMS > AirLink Management Services is enabled
• Services > ALMS > Server URL is set to: https://na.m2mop.net/device/msci/com
• Services > ALMS > SSL Verify Peer Certificate is enabled (option available on ALEOS only)
• Services > ALMS > Device Initiated Interval (minutes) set to the communication period of your choice.

Important Note:

You should always use HTTPS and not HTTP in the server URL (HTTPS being the default value for ALEOS) so that communications between the gateway (ALEOS) and AirVantage are encrypted. This ensures your information is not transferred unencrypted, and leverages the benefits of HTTPS such as confidentiality, integrity and server authentication.

Register your gateway

To register your ALEOS gateway, you need the Serial Number and IMEI for AirLink MP, RV, GX, ES, and LS families or IMEI or ESN for Raven, PinPoint, MP families. The ESN is the one in Hexadecimal format. Serial number is printed on the sticker label at the rear of device and is 15 or 16 digits long. Do not include the dash ‘-’ if there is one. Letters in the serial number must be in UPPER CASE. Serial Number should match the Status > About > Serial Number or GlobalID (for older versions of ALEOS) in ACEmanager.

Firewall and DNS configuration

For information on firewall configuration, see How to configure my infrastructure when devices are in a private APN .

ALEOS connection troubleshoot

The field Services > ALMS > Status shows the status of the ALMS connection:

For devices communicating on LWM2M the status will change as the device communicates. If the device is communicating successfully, the status should be “Registration Update: Success” with a time stamp.

For devices communicating with MSCI, the status will be one of:

• Success: device successfully contacted ALMS during its latest communication
• Disable: ALMS communications are disabled. Appears when the AirVantage Management Service drop-down menu is set to Disable.
• ALEOS is waiting for connectivity: this transitory status appears when the gateway is in Connect-on-traffic mode and is trying to connect to the network for an AVMS check-in. When the device connects to the network, the AVMS check-in is sent and the status changes.

A complete list of error messages is available in ALEOS Software configuration guide. .