Skip to main content

Mango 5.3.x Release Notes

Release notes for all Mango 5.3.x patch releases. The latest release in this series is 5.3.1 (January 23, 2025).

Mango 5.3.1 — January 23, 2025

core

  • Regression fix for v5.3.0: the Docker mango user GUID is set to 999 instead of 1000.

udmi-publisher

  • Completed support for UDMI proxy device state messaging.
  • Completed support for UDMI proxy device sequencer testing.
  • Added UI switch to disable MQTT config subscription temporarily.
  • Added support for UDMI ES256 key format.
  • Added quick access link to UDMI system settings from the UDMI publisher page for admin users.
  • Showed numeric ID (ref) fields in the UDMI published points UI.
  • Disabled discarded published queue warning for UDMI publishers.
  • Removed JVM system metrics publishing from proxied devices.
  • Fixed UDMI reconnection, termination, and connection race conditions.
  • Upgraded UDMI library from v1.5.2-radix.1 to v1.5.2-radix.4.

Mango 5.3.0 — October 30, 2024

core

  • Added the ability in the device browser to select all device properties to create points from them.
  • Added a multi-select dropdown in the device browser so the select-all checkbox only selects desired properties.
  • Added gRPC services for retrieving translations and UI bootstrap data.
  • Fixed a bug which prevented restoring MySQL backups.
  • Improved SQL backup code with more tests for reliability and maintainability.
  • Fixed a bug in shutdown tasks which could prevent Mango from shutting down indefinitely.
Breaking Change

The Docker image now runs as the non-root user mango:mango (999:999). The default home directory changed from /root to /opt/mango-data and the working directory changed from /opt/mango to /opt/mango-data. For existing Docker deployments, ownership of Docker bind mounts must be migrated to the mango user.

  • Fixed a bug where changes to data point tags were not captured in the audit trail.
  • Certificate authority service can now be disabled by setting pki.ca.name=disabled in mango.properties.
  • The SSL/TLS/HTTPS connector will now bind to the address specified by web.host, independently configurable via the ssl.host property.
  • Released Docker images now support multiple architectures: linux/amd64 and linux/arm.
  • Added mango group and user to the Docker image; Docker image size reduced from 735 MB to 525 MB.
  • Allowed configuration of permissions for individual gRPC services via the system permissions page.
  • SQL database backup and restore now logs output to sql_backup.log and sql_restore.log instead of the console.
  • Spring Security is now enabled at a lower level on the Mango "runtime context" instead of just the web context.
  • Support Mango JWT and OAuth bearer tokens for authentication when accessing gRPC services.
Breaking Change

Properties named rateLimit.rest.*.quanitity (misspelled) have been renamed to rateLimit.rest.*.quantity. Update your mango.properties if you have customized these values.

  • Added support for read-only read replica SQL database connections.
  • Added gRPC services: UserService (current user), DataPointService (query by tags), EventService (query + real-time stream).
  • Added properties grpc.web.services.* and grpc.channel.* for configuring named gRPC channels with target, deadline, TLS, certificates, and keys.
  • Added modules.allow-list and modules.deny-list properties for selective module loading.
  • Added installation.immutable property to prevent Mango from creating, modifying, or deleting files in the installation directory.
  • Added a gRPC-Web proxy to Mango (disable with grpc.web.enabled=false in mango.properties).

ui

  • Fixed misalignment of marker icons and shadows for tile map markers.
  • Added a system setting to disable module upgrades.

ems

  • Added context help pages to EMS module pages.
  • Added a new device table with property filters component for layout configuration.

mqtt-client-ds

  • Fixed a bug with MQTT persistent subscriptions.

persistent-pub-ds

  • Fixed a bug that prevented setting point values from the data source back to the publisher when multiple publishers were connected.
  • Fixed a bug that prevented the gRPC data source from adding, removing, or updating points unless the publisher reconnected.
  • The gRPC publisher now supports sending a bearer token (Mango JWT or OAuth) to authenticate.

udmi-publisher

  • Adjusted UDMI device and point naming validation to allow non-BDNS and non-DBO names.
  • Upgraded UDMI libraries to 1.5.1.
  • Fixed a bug where the UDMI publisher was unable to handle pointset config apply when there are disabled data points.