2.2.0

Important note: in the case you use attributes with id metadata (deprecated since 1.13.0), a migration procedure on existing data has to be applied (or DB has to be dropped), see details here.

Full documentation at: http://fiware-orion.readthedocs.io/en/2.2.0/

NGSIv2 API reference (v2.0): http://telefonicaid.github.io/fiware-orion/api/v2/stable

Changes (since 2.1.0):

• Add: skipInitialNotification URI param option to make initial notification in subscriptions configurable (#920)
• Add: forcedUpdate URI param option to always trigger notifications, no matter if actual update or not (#3389)
• Add: log notification HTTP response (as INFO for 2xx or WARN for other codes)
• Add: notification.lastFailureReason field in subscriptions to get the reason of the last notification failure
• Add: notification.lastSuccessCode field in subscriptions to get the HTTP responde code of the last successful notification
• Fix: NGSIv1 updates with geo:line|box|polygon|json removes location DB field of NGSIv2-located entities (#3442)
• Fix: specify notification/forwarding error cause in log messages (#3077)
• Fix: from=, corr=, srv=, subsrv= correctly propagated to logs in notifications (#3073)
• Fix: avoid "pending" fields in logs
• Fix: use "" for srv= and subsrv= in logs when service/subservice header is not provided
• Fix: bug in notification alarm raising in -notificationMode transient and persistent
• Remove: deprecated feature ID metadata (and associated NGSIv1 operations)

2.1.0

Full documentation at: http://fiware-orion.readthedocs.io/en/2.1.0/

NGSIv2 API reference (v2.0): http://telefonicaid.github.io/fiware-orion/api/v2/stable

Note that Rush support has been deprecated in this release. You are strongly discouraged of using it.

Changelog (since 2.0.0):

• Add: Oneshot Subscription (#3189)
• Add: support to MongoDB 3.6 (#3070)
• Fix: problems rendering structured attribute values when forwarded queries are involved (#3162, #3363, #3282)
• Fix: NGSIv2-NGSIv1 location metadata issues (#3122)
• Fix: wrong inclusion of "location" metadata in geo:json notifications (#3045)
• Fix: metadata filter was lost during csub cache refresh (#3290)
• Fix: NGSIv1-like error responses were used in some NGSIv2 operations
• Fix: cache sem is not taken before subCacheItemLookup() call (#2882)
• Fix: wrong Runtime Error logs on GET /v2/registrations and GET /v2/registrations/{id} calls (#3375)
• Deprecate: Rush support (along with -rush CLI parameter)
• Remove: isDomain field in NGSIv1 registrations (it was never used)

2.0.0

Full documentation at: http://fiware-orion.readthedocs.io/en/2.0.0/

NGSIv2 API reference (v2.0): http://telefonicaid.github.io/fiware-orion/api/v2/stable

Note that NGSIv1 API has been deprecated in this release. You are strongly discouraged of using it. NGSIv2 should be always used.

Changelog (since 1.15.0):

• Fix: GET /v2/subscriptions and GET /v2/subscriptions/{id} crashes for permanent subscriptions created before version 1.13.0 (#3256) (*)
• Fix: correct processing of JSON special characters (such as \n) in NGSIv2 rendering (#3280, #2938)
• Fix: correct error payload using errorCode (previously orionError was used) in POST /v1/queryContext and POST /v1/updateContext in some cases
• Fix: bug in metadata compound value rendering in NGSIv2 (sometimes "toplevel" key was wrongly inserted in the resulting JSON object)
• Fix: missing or empty metadata values were not allowed in NGSIv2 create/update operations (#3121)
• Fix: default types for entities and attributes in NGSIv2 was wrongly using "none" in some cases
• Fix: with NGSIv2 replace operations the geolocalization field is inconsistent in DB (#1142, #3167)
• Fix: duplicated attribute/metadata keys in JSON response in some cases for dateCreated/dateModified/actionType
• Fix: proper management of user attributes/metadata which name matches the one of a builtin (the user defined shadows the builtin for rendering but not for filtering)
• Fix: pre-update metadata content included in notifications (and it shouldn't) (#3310)
• Fix: duplicated items in ?attrs and ?metadata URI params (and "attrs" and "metadata" in POST /v2/op/query and subscriptions) cause duplicated keys in responses/notifications (#3311)
• Fix: dateCreated and dateModified included in initial notification (#3182)
• Hardening: modification of the URL parsing mechanism, making it more efficient, and the source code easier to follow (#3109, step 1)
• Hardening: refactor NGSIv2 rendering code (throughput increase up to 33%/365% in entities/subscriptions rendering intensive scenarios) (#1298)
• Hardening: Mongo driver now compiled using --use-sasl-client --ssl to enable proper DB authentication mechanisms
• Deprecated: NGSIv1 API (along with related CLI parameters: -strictNgsiv1Ids and -ngsiv1Autocast)

(*) Also inclued in 1.15.1

1.15.1

Changelog (since 1.15.0):

• Fix: GET /v2/subscriptions and GET /v2/subscriptions/{id} crashes for permanent subscriptions created before version 1.13.0 (#3256)

1.15.0

Full documentation at: http://fiware-orion.readthedocs.io/en/1.15.0/

NGSIv2 API reference (release candidate 2018.07): http://telefonicaid.github.io/fiware-orion/api/v2/stable

Changelog (since 1.14.0):

• Add: upsert option for the POST /v2/entities operation (#3215)
• Add: transient entities functionality (new NGSIv2 builtin attribute: dateExpires) (#3000)
• Add: "attrs" field in POST /v2/op/query (making "attributes" obsolete) (#2604)
• Add: "expression" field in POST /v2/op/query (#2706)
• Fix: large integer wrong rendering in responses (#2603, #2425, #2506)
• Remove: "scopes" field in POST /v2/op/query (#2706)

1.14.0

Full documentation at: http://fiware-orion.readthedocs.io/en/1.14.0/

NGSIv2 API reference (release candidate 2018.04): http://telefonicaid.github.io/fiware-orion/api/v2/stable

Changelog (since 1.13.0):

• Add: support for APIv2 notifications (POST /v2/op/notify), which opens up for true APIv2 federation (#2986)
• Add: camelCase actionTypes in POST /v2/op/update (append, appendStrict, update, delete and replace) (#2721)
• Fix: bug having entities without attibutes AND matching registrations made the attr-less entity not be returned by GET /v2/entities (#3176)
• Fix: bug when using "legacy" format for custom v2 notifications (#3154)
• Fix: check for providers is done only in UPDATE or REPLACE actionType case in update entity logic (#2874)
• Fix: wrong 404 Not Found responses when updating attribute using NGSIv2 and CB forwards it correctly (#2871)

1.13.0

Full documentation at: http://fiware-orion.readthedocs.io/en/1.13.0/

NGSIv2 API reference (release candidate 2018.04): http://telefonicaid.github.io/fiware-orion/api/v2/stable

Note that metadata ID has been deprecated in this release and will be removed in the very next one [at the end it will take a bit longer, it will not be in 1.14.0]

Changelog (since 1.12.0):

• Add: support for GET /v2/registrations (#3005)
• Add: support for GET /v2/registrations/ (#3008)
• Add: support for POST /v2/registrations to create registrations in APIv2 (#3004)
• Add: support for DELETE /v2/registrations/ (#3006)
• Add: support for CORS requests for /v2/registrations and /v2/registrations/ (#3049)
• Hardening: refactor request routing logic (#3109, step 1)
• Bug that may lead contextBroker to crash when passing null character "\u0000" with ID parameter in query context payload (#3119)
• Add: CORS Preflight Requests support for /version (#3066)
• Deprecated: ID metadata (and associated NGSIv1 operations)

1.12.0

Full documentation at: http://fiware-orion.readthedocs.io/en/1.12.0/

NGSIv2 API reference (release candidate 2017.11): http://telefonicaid.github.io/fiware-orion/api/v2/stable

Changelog (since 1.11.0):

• Add: support for entity id and type in orderBy parameter (#2934)
• Add: NGSIv1 autocast for numbers, booleans and dates (using flag -ngsiv1Autocast) (#3112)

1.11.0

Full documentation at: http://fiware-orion.readthedocs.io/en/1.11.0/

NGSIv2 API reference (release candidate 2017.11): http://telefonicaid.github.io/fiware-orion/api/v2/stable

Changelog (since 1.10.0):

• Reference distribution changed from RHEL/CentOS 6 to RHEL/CentOS 7
• Add: new BROKER_LOG_LEVEL variable at /etc/config/contextBroker to set log level
• Add: new GENERATE_COREDUMP variable at /etc/config/contextBroker to enable core generation and archiving (useful for debugging)
• Add: handler for SIGHUP termination signal
• Fix: using SIGTERM instead of SIGHUP for stopping broker in init.d service script
• Fix: Invalid description in POST /op/query error response (#2991)
• Fix: Bug that may cause contextBroker to crash when passing inappropriate parameter in query context payload (#3055)
• Fix: Correct treatment of PID-file (#3075)

1.10.0

Full documentation at: http://fiware-orion.readthedocs.io/en/1.10.0/

NGSIv2 API reference (release candidate 2017.11): http://telefonicaid.github.io/fiware-orion/api/v2/stable

Changelog (since 1.9.0):

• Add: CORS Preflight Requests support for all NGSIv2 resources, -corsMaxAge switch, CORS exposed headers (#501, #3030)
• Fix: null not working in q/mq filter in subscriptions (#2998)
• Fix: case-sensitive header duplication (e.g. "Content-Type" and "Content-type") in custom notifications (#2893)
• Fix: bug in GTE and LTE operations in query filters (q/mq), both for GET operations and subscriptions (#2995)
• Fix: Wrong "max one service-path allowed for subscriptions" in NGSIv2 subscription operation (#2948)