Release Notes for AM/AMM 2.17

1 Release Information

AirLink Manager (AM)/AirLink Mobility Manager (AMM) 2.17 is a major release of the AirLink Manager Platform that introduces a new configuration management approach, introduces certificate management capabilities for the AirLink MG90, improves the High Availability capabilities of the platform, adds support for the AirLink RV55, and provides new features in support of both MG and ALEOS devices in the product.

After completing an upgrade of the AM/AMM, Sierra Wireless recommends that all users refresh their browser cache before accessing AMM 2.17. To continue to improve the security posture of the AM/AMM platform, this release also disables the auto-login capabilities that were previously included in the AM/AMM.

These release notes include the details for AM/AMM 2.17, AMMER 1.0.4 and AVTC 1.01.

1.1 Officially Released Versions

These release notes are inclusive of all AMM R2.15.x+ versions.

AM/AMM 2.17 was officially released to General Availability on February 28, 2020.

1.2 Platform Support

AM/AMM 2.17 has been tested on Dell R240 and R630 servers and on VMWare ESXi.

1.3 Browser Support

AMM 2.17 has been tested on Google Chrome and Firefox. Users that attempt to use a browser that is not supported will get a warning and may experience some issues.

1.4 Sierra Wireless Gateway Support

For oMG gateways, AMM 2.17 supports up to oMG R3.15.1 and MG90 4.x+. For AirLink gateways, AMM 2.17 supports ALEOS firmware version 4.4.3 and higher. Some features of AM/AMM 2.17 require later versions of the ALEOS or MG software.

AMM 2.17 also supports:

• GNX6: G604.08.01 and higher (limited support)
• GNX3-UMTS: G303.08.83 and higher (limited support)
• AirLink RV55 (new)
• Calamp LMU2631CV model (limited support)

2 Key Features and Enhancements

2.1 Configuration Management – Templates

AM/AMM 2.17 redefines the approach to managing device configurations, including the introduction of templates that can be created directly in the management system. Specific features include:

Configuration Templates: allows you to create, manage, and deploy device configurations directly from the AMM. Users can create a configuration from an existing known configuration on a device, or build something new from scratch.

Set Device-Specific Parameters: As part of the template, settings that require device-specific parameters are set through the configuration template wizard using an integrated CSV import/export.

Create and Target Configurations for Offline Devices: Remote configuration of devices can be done through the new Configuration Template and Configuration Control screens while gateways are offline. This functionality allows you to define templates which can be deployed either manually or automatically when the target devices are online.

Simplified Device States: The new Configuration Control screen displays a more user-friendly interface and a reduced set of device configuration states. You can click on states to “drill down” on them to get more information and view more detailed legacy states.

Export Configuration Templates: Users can export configuration templates from one AM/AMM instance and import them into another.

Device Requirements for Template Support: The new configuration management that uses the Templates feature is supported for all of our currently-shipping AirLink devices. As AM/AMM also supports older hardware, there are some limitations as to the device and firmware versions that can be supported:

• AirLink MG90
  • Supports MGOS 4.3+
• AirLink Gateways and Routers Running ALESO
  • 4.4.5 or later (AirLink GX400/440, ES440 and LS gateways)
  • 4.9.0 or later (AirLink GX/ES450, RV, MP and LX gateways and routers)
• The oMG2000/500 class of routers are not supported with the new Configuration Management features. Customers should continue to use the existing configuration management capabilities.

Note: Many features in the AM/AMM are controlled by user access rights. When new features are deployed, they may not be immediately available to all users. As Configuration Management capabilities in previous releases of AM/AMM were not always exposed to all users (particularly on hosted AMMs), you may not have access to the new Template features once your system is upgraded to AM/AMM 2.17. If you do not see the new features, but want them enabled, please contact Sierra Wireless Customer Support and they will enable these new features on your user account.

2.2 Certificate Management (MG90)

AMM 2.17 introduces the first phase of managing device certificates for the AirLink MG90. The Certificate Management screen allows you to trigger the bulk generations and transfer of certificate signing requests (CSRs) and signed certificates from/to gateways.

The Certificate Management features require MGOS 4.3+.

2.3 High Availability (HA)

AM/AMM 2.17 introduces an improved HA capability that provides an active standby deployment that uses a “hot” standby AM/AMM server to increase reliability and simplify the backup process for deployed AM/AMM servers. This feature requires an AM or AMM Enterprise license to leverage multiple server instances.

2.4 Gateway Tree UI Improvements

The Gateway Tree is the primary user interface to organize and view devices in the management system. This release introduces the ability to filter by both heartbeat and platform. The Gateway Tree now also includes a checkbox that automatically selects all visible nodes throughout the tree hierarchy. This can be used in conjunction with the filter options to select a certain group of devices for which you want to invoke an operation.

2.5 User Creation Improvements

This release streamlines and simplifies the process for creating new users. Many of the default parameters are set by default, making it easier to set up new AM/AMM users and ensure their basic user rights are set correctly.

2.6 On-line Documentation

As of AM/AMM 2.17, all user documentation has been moved online at https://source.sierrawireless.com/airvantage/amm/ . Sierra Wireless will no longer produce PDF versions of our AM/AMM documentation.

2.7 Support for the AirLink RV55

The AirLink® RV55 is the industry’s most rugged, compact, LTE-A Pro router. Simple to install, and easy to manage, the RV55 cellular router is designed for connecting critical remote assets and infrastructure, and vehicles. The RV55 is especially well suited for SCADA, distribution management systems, and service vehicle fleets.

The RV55 is also available with Wi-Fi to provide secure, vehicle area networking (VAN) for the mobile workforce and service fleets. The RV55 is designed to meet the harsh environmental and performance requirements of industrial and mobile installations, delivering superior reliability and uninterrupted operation in outdoor or vehicle environments. The RV55 is a certified device that is “Band 14 and FirstNet Ready”.

AM/AMM 2.17 is required to support the AirLink RV55.

3 Minor Feature Enhancements

There are many minor new features added in AM/AMM 2.17.

3.1 “What’s New” Feature

To better inform customers of the features in a new release, AM/AMM 2.17 includes a “What’s New” feature that appears to all users when they log on to the platform. This new information screen will appear on every new release the first time a user logs in to the AM/AMM. The user has two options to close the dialog once they have reviewed the new information:

• The Got it button prevents the pop-up showing on following logins
• The Close button closes the dialog but allows the pop-up window to continue to appear on subsequent logins

3.2 Cancel Software Upgrade

This release adds the ability for the AM/AMM user to cancel software upgrades that have been triggered from the AM/AMM. The ability to cancel has dependencies on platform, firmware versions, and the upgrade stage that a device is currently on. There will be situations where a software upgrade may not be able to be canceled. As part of this implementation the AM/AMM provides a detailed explanation of what can or cannot be done when a user attempts to cancel a software upgrade from the Software Distribution page.

3.3 Renamed the “Config > Deploy > Deploy” Menu to Configuration > Deployment > Configuration Control

As part of the introduction of Templates and the changes to the configuration management process, the menu items names have been changed. This reflects the new processes and is consistent with new terminology and the new pages introduced with the new configuration management processes.

3.4 Added a Link to Software Repository for Gateway Package Downloads

For customers that cannot automatically download new gateway software packages on their AM or AMM, we have added a link to the repository so those users can more easily download the software they need and upload it to their AM or AMM.

3.5 Removed Latitude and Longitude from Default AM/AMM Thresholds

Latitude and Longitude were added as default Stats in a previous release of AM/AMM. As default Stats cannot be removed and the Dashboard has limited space, this causes issues for many customers. Users can always add the Stats to their Dashboard if this data is important to them.

3.6 Provide Full Control Over the Software Repository

Admin users can now delete versions of gateway software from the repository.

3.7 Dead Reckoning (DR) Available as a Stat

With this release, DR state can be enabled as a Stat and reported on the Dashboard.

3.8 GPIO Inputs Supported as Stats for ALEOS-based Devices

With the release of AMMER 1.0.4, we now send digital and analog input state and value transitions for ALEOS-based devices. These can be mapped to Stats and used in a similar way as the GPIO from an MG-based device.

3.9 Removal of the Nav Application

As was communicated to all customers, Sierra Wireless retired the Nav application in the AM/AMM and have now removed this feature from AM/AMM 2.17.

4 New ALEOS Application Framework (AAF) Applications

4.1 AMMER 1.0.4

AMMER 1.0.4 is an incremental update to the AMMER AAF application that is needed to support advanced features on the AM/AMM for ALEOS devices. There were three new features added in AMMER 1.0.4 to support AM/AMM features in AM/AMM 2.17:

• Provide Management Tunnel Status and Address Events
• Send Dead Reckoning configuration state and status to the AM/AMM
• GPIO input line status needs to be forwarded individually to the AM/AMM

4.2 AVTC 1.0.1

Airlink Vehicle Telemetry Configuration (AVTC) is an AAF application that contains details on the collection of proprietary vehicle configuration information. AVTC contains only configuration data and GNX companion firmware. It has no executable component and it is safe to install AVTC on any compatible AirLink device where vehicle telemetry is in use. AVTC is a companion application and requires AVTA or AMMER to report information to ALMS or AMM respectively.

5 Addressed Problems

Customer Reported Field Issues

Addressed CIS Compliance Audit Issues

Software Distribution Issues

GNX Issues

Security Vulnerabilities

Outstanding Problems

There are a number of known issues discovered after code freeze that will be addressed in a future AM/AMM release.

Reference	Problem Description
8656 / 8633	The AMM is not differentiating the various FirstNet SIM Status messages in both the Event Viewer and Stats page. This makes it impossible to determine if there is a FirstNet SIM installed from the AMM. In a future release the AMM will separate these messages and report two stats (one for MiniUSBSS3-FirstNetSIM, and another for MiniUSBSS4-FirstNetSIM) rather than a single FirstNetSIM stat.
8565	Improved support for Time Zone and DST rule changes. The plan is to update the current list of time zones from the underlying operating system in order to support the latest time zone and DST policy changes
7621	The AM/AMM is not properly managing the LinkX-CallUpTime stat during WAN link switches.
7358	The Statistics Graph report has the title Engine Coolant Temperature (Fahrenheit) when units are in Celsius.
7216	There are unexpected directories found in /home/inmotion/ftp/MHS_logs/ for systems with GNX devices connected.
6756	The Heartbeat value in an exported dashboard does not match the HTML display in the system
6523	Some gateways do not show up on the AM/AMM Dashboard due to pagination issues. When the page size is changed from 250 to a number greater than all of the gateways available, the devices will reappear.
6522	There is a known issue where inconsistent gateway data can be displayed when multiple LCI windows are opened to different MGOS devices. It is recommended that only one MGOS LCI screen be opened at a time.
6225	The Main Battery “link” on the dashboard does not allow you the flexible report change that the Statistical Graph report does.
5947	The Operational State should update based on the Ignition On event.
5718	Due to errors in handling daylight savings, the Bandwidth Consumption reports display high data usage during daylight savings.
5647	The Configuration Audit report shows different settings due to different Friendly Names.
5640	The AM/AMM needs to self-recover from memory exhaustion.
5569	The Configuration Audit report generates confusing/misleading VPN information.
4989	When the Statistics Graph report is generated for stats whose values depend on the user’s measurement units setting (i.e., Imperial or metric), the actual display units may not agree with those displayed in the graph’s title, which makes the report confusing.
8680	There is a XSS vulnerability on several of the Admin > Options pages that causes code to run on the User Activity page.
Various	The following security issues were identified after code freeze on the AM/AMM 2.16.2 release – CVE-2018-20852, CVE-2019-13115, CVE-2018-7191, CVE-2018-20836, CVE-2019-11487, CVE-2018-20169, CVE-2018-19824, CVE-2019-13233, CVE-2019-13631, CVE-2008-4609, CVE-2019-8457, CVE-2019-9169, CVE-2016-5131, CVE-2018-12433, CVE-2018-12438, CVE-2019-1010180, CVE-2018-20685, CVE-2019-11068, CVE-2016-4610, CVE-2016-4609, CVE-2016-4608, CVE-2019-11068, CVE-2016-4610, CVE-2016-4609, CVE-2016-4608, CVE-2018-18064, CVE-2016-4472, CVE-2015-1283, For most of these issues, the impact to AM/AMM is considered low and/or RedHat has not provided a fix in time for inclusion with AM/AMM 2.16.2. This will be included in the next AM/AMM release.

AMMER