Skip to content

6.7.0 to 6.8.0

Erlang/OTP version

MongooseIM now requires Erlang/OTP 27 or higher, and OTP 26 is no longer supported. Building with an older release fails immediately, so make sure your build environment is upgraded before you start.

Removal and deprecation

The following features are removed or deprecated.

mod_muc_log removed and configuration cleanup

The mod_muc_log module was removed in this release. Delete mod_muc_log from your configured modules list and remove any mod_muc_log options. Also remove modules.mod_muc.default_room.logging option. If you need message history, enable and configure mod_mam instead.

Translation support removed

System message translations are no longer supported. Remove service_translations from your services configuration and keep message strings in English.

mod_pubsub renamed to mod_pubsub_old and deprecated

The previous PubSub implementation is now available as mod_pubsub_old and is deprecated. The mod_pubsub name now refers to a new, performance-focused implementation that supports only selected PEP functionality.

If your existing configuration uses the old PubSub module name, choose one of the following migration paths:

  • Update the configuration to use mod_pubsub_old instead of mod_pubsub if you need the old implementation's full PubSub feature set, generic PubSub component, collection nodes, plugin-based node implementations, or push-notification PubSub nodes. If you monitor PubSub metrics, update your dashboards and alerts to use the mod_pubsub_old metric names.

  • Use the new mod_pubsub for better performance if your deployment only needs the selected PEP features described in its module documentation.

No data migration between the two implementations

The new mod_pubsub uses its own schema, and there is no script migrating the existing pubsub_* data into it.

mod_muc_light legacy mode deprecated

The legacy_mode option of mod_muc_light, which enables the legacy XEP-0045 compatibility codec, is now deprecated and will be removed in the next release.

Database migration

There are new tables in the database, which are used by the new mod_pubsub implementation and by mod_broadcast. See the migrations in the priv/migrations directory. Although the new tables are only needed by these modules, we recommend applying the migration anyway to keep the database in sync with the latest schema.

The deprecated mod_pubsub_old keeps using the existing pubsub_* tables, so no action is needed for the data stored there.

Metrics

The changes to metrics and instrumentation are listed below.

router_no_route_found is now a global metric

The router_no_route_found metric is no longer scoped by host_type. This event can be emitted when routing reaches the end of the routing chain, where the stanza's host type can be unknown. See Sessions and routing for more information.