Skip to content

deprecated.md

Latest commit

 

History

History
82 lines (72 loc) · 7.67 KB

deprecated.md

File metadata and controls

82 lines (72 loc) · 7.67 KB

Deprecated functionality

Deprecated features are features that iotagent-node-lib stills support but that are not maintained or evolved any longer. In particular:

  • Bugs or issues related with deprecated features and not affecting any other feature are not addressed (they are closed in github.com as soon as they are spotted).
  • Documentation on deprecated features is removed from the repository documentation. Documentation is still available in the documentation set associated to older versions (in the repository release branches).
  • Deprecated functionality is eventually removed from iotagent-node-lib. Thus you are strongly encouraged to change your implementations using iotagent-node-lib in order not rely on deprecated functionality.

A list of deprecated features and the version in which they were deprecated follows:

  • Config mongodb.* different from mongodb.uri (and associated env vars IOTA_MONGO_* except IOTA_MONGO_URI) in 4.11.0 (finally removed in 4.14.0)
  • Support to NGSI v1 (finally removed in 2.18.0)
  • Support to Node.js v4 in iotagent-node-lib 2.8.1 (finally removed in 2.9.0)
  • Support to Node.js v6 in iotagent-node-lib 2.9.0 (finally removed in 2.10.0)
  • Support to Node.js v8 in iotagent-node-lib 2.12.0 (finally removed in 2.13.0)
  • Support to Node.js v10 in iotagent-node-lib 2.15.0 (finally removed in 2.16.0)
  • Support to Node.js v12 in iotagent-node-lib 2.24.0 (finally removed in 2.25.0)
  • Support to Node.js v14 in iotagent-node-lib 3.0.0 (finally removed in 3.1.0)
  • Support to Node.js v16 in iotagent-node-lib 4.9.0 (finally removed in 4.10.0)
  • Support to Node.js v18 in iotagent-node-lib 4.9.0 (finally removed in 4.10.0)
  • Support to NGSI-LD v1.3 in iotagent-node-lib 2.25.0 (finally removed in 2.26.0)
  • Support groups (provision) statically defined by configuration
  • Support to in-memory registry (i.e.deviceRegistry.type=memory)
  • eventType configuration (finally removed in 3.0.0)
  • Support to legacy expressions (finally removed in 3.2.0)
  • Bidirectinal pluging (finally removed in 3.4.0)
  • appendMode configuration (IOTA_APPEND_MODE env var) (finally removed in 3.4.0)
  • config.stats section, and push-mode statistics.
  • Services API routes (/iot/services) in favor of the /iot/groups. Both are still supported, but the former is deprecated.

The use of Node.js v14 is highly recommended.

Using old iotagent-node-lib versions

Although you are encouraged to use always the newest iotagent-node-lib version, take into account the following information in the case you want to use old versions:

  • Code corresponding to old releases is available at the iotagent-node-lib GitHub repository. Each release number (e.g. 2.7.0 ) has associated the following: _ A tag, e.g. 2.7.0. It points to the base version. _ A release branch, release/2.7.0. The HEAD of this branch usually matches the aforementioned tag. However, if some hotfixes were developed on the base version, this branch contains such hotfixes.
  • Documentation corresponding to old versions can be found at readthedocs.io. Use the panel in the right bottom corner to navigate to the right version.

The following table provides information about the last iotagent-node-lib version supporting currently removed features:

Removed feature Last iotagent-node-lib version supporting feature That version release date
NGSI v1 API 2.17.0 August 30th, 2021
Support to Node.js v4 2.8.1 December 19th, 2018
Support to Node.js v6 2.9.0 May 22nd, 2019
Support to Node.js v8 2.12.0 April 7th, 2020
Support to Node.js v10 2.15.0 February 18th, 2021
Support to Node.js v12 2.24.0 September 2nd, 2022
Support to Node.js v14 3.0.0 March 30th, 2023
Support to Node.js v16 4.9.0 August 22nd, 2025
Support to Node.js v18 4.9.0 August 22nd, 2025
Support to NGSI-LD 1.3 2.25.0 January 24th, 2023
eventType configuration 2.26.0 March 15th, 2023
Support to Legacy Expressions 3.1.0 April 25th, 2023
bidirectional plugin 3.3.0 August 24th, 2023
appendMode configuration (IOTA_APPEND_MODE env var) 3.3.0 August 24th, 2023
push-mode stats 4.5.0 June 11th, 2024
config mongodb.host (env var IOTA_MONGO_HOST) 4.13.0 February 4th, 2026
config mongodb.port (env var IOTA_MONGO_PORT) 4.13.0 February 4th, 2026
config mongodb.db (env var IOTA_MONGO_DB) 4.13.0 February 4th, 2026
config mongodb.replicaSet (env var IOTA_MONGO_REPLICASET) 4.13.0 February 4th, 2026
config mongodb.user (env var IOTA_MONGO_USER) 4.13.0 February 4th, 2026
config mongodb.password (env var IOTA_MONGO_PASSWORD) 4.13.0 February 4th, 2026
config mongodb.authSource (env var IOTA_MONGO_AUTH_SOURCE) 4.13.0 February 4th, 2026
config mongodb.retries (env var IOTA_MONGO_RETRIES) 4.13.0 February 4th, 2026
config mongodb.retryTime (env var IOTA_MONGO_RETRY_TIME) 4.13.0 February 4th, 2026
config mongodb.ssl (env var IOTA_MONGO_SSL) 4.13.0 February 4th, 2026
config mongodb.extraArgs (env var IOTA_MONGO_EXTRAARGS) 4.13.0 February 4th, 2026