3.6.0

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

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

NOTE: default metadata update semantics has changed in this version. Have a look to this section in documentation about the change. If you want to keep the old behaviour, you have to use overrideMetadata option (eg. POST /v2/op/update?options=overrideMetadata).

Changes (since 3.5.0):

• Add: ignoreType metadata so Orion ignores attribute type semantic (supported by geo-types at the present moment) (#4032) (*)
• Add: URL decode in header values in custom notifications (#4071)
• Add: new option overrideMetadata to change default update attribute behaviour (#4033)
• Fix: attribute update doesn't override metadata by default (new option overrideMetadata has to be used for that) (#4033)
• Fix: unify error traces with "Runtime Error" (some of them where using "Internal Error" or "Orion Bug")
• Fix: increase severity to ERROR in some WARN traces actually meaning Runtime Error conditions
• Fix: ForwardingError alarm logic, which was missing in some cases
• Fix: cache status not correctly updated when several CBs are working in parallel (#4069)
• Fix: over-updating csubs cache (#4063)

(*) Also included in release 3.5.1

3.5.1

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

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

This release includes a feature that was missed in 3.5.0. It's not actually a "hotfix" release (in the sense it is not fixing any critical bug).

Changes (since 3.5.0):

• Add: ignoreType metadata so Orion ignores attribute type semantic (supported by geo-types at the present moment) (#4032)

3.5.0

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

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

Changes (since 3.4.0):

• Fix: avoid duplicated attributes and metadata in arrays in POST /v2/subscriptions and PATCH /v2/subscriptions/{subId} (#2101)
• Fix: $each usage with $push operator to add several items to array (#744)
• Fix: allow HTTPS certificates larger than 2048 bytes (#4012)
• Fix: DateTime attribute macro rendering in custom notifications was numeric instead of ISO8601 (#3894)
• Fix: buffer overflow problem in logs subsystem for from= field, causing crash in some cases (#3884)

3.4.0

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

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

Changes (since 3.3.0):

• Add: failsCounter subscription field, to count the number of consecutive notificaitons fails (#3541)
• Add: maxFailsLimit subscription field, so subscription is automatically passed to inactive after that number of failed notification attemps (#3541)
• Add: $set and $unset attribute update operators (#3814, continuation)
• Add: statusLastChange field in csbus collection (as now status is in the csubs cache and we need this field to know if status in the cache or DB is fresher)
• Fix: throttling misbehaviour after subscription update when csubs cache is in use (#3981)
• Fix: lastNotification missed some times in GET /v2/subscriptions/{id} and GET /v2/subscriptions
• Fix: avoid reset timesSent counter upon PATCH /v2/subscriptions/{subId} when csubs cache is in use
• Fix: crash when updating attribute with empty JSON object or array (#3995) (*)
• Fix: csubs cache logic has to ignore fiware-sevice information if -multiservice is not used
• Fix: subscription throttling was not working with value 1 second
• Fix: add subId/regId in "response NOT OK" WARN log traces (#4013)
• Remove: status "failed" in subscriptions (use failsCounter greater than 0 instead)
• Hardening: refactor PATCH /v2/subscriptions/{subId} logic avoiding over-quering MongoDB and possible (although very rare) crash situations during csub cache (#3701)
• Hardening: noCache flag should be check before removing csub from cache in mongoUnsubscribeContext() (#2879)
• Upgrade Dockerfile base image from centos8.3.2011 to centos8.4.2105

(*) Also included in release 3.3.1

3.3.1

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

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

Changes (since 3.3.0):

• Fix: crash when updating attribute with empty JSON object or array (#3995)

3.3.0

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

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

Changes (since 3.2.0):

• Add: attribute update computed values based in operators: $inc, $min, $max, $mul, $push, $addToSet, $pull, $pullAll (#3814)
• Add: support to user and password in MQTT subscriptions (#3914)
• Add: new alarm MqttConnectionError
• Add: per sub notification.http.timeout (#3842)
• Add: hard limit for -requestTimeout to 1800000 millliseconds (30 min)
• Fix: service path ignored in GET /v2/subscriptions/{subId} (#3945)
• Fix: service path ignored in GET /v2/registrations/{regId} (#3945)
• Fix: legacyForwarding rendering in GET /v2/registrations and GET /v2/registrations/{regId} calls (#3944)
• Fix: deleted attribute incorrectly included in notifications (#3956)
• Fix: return 400 instead of 500 when GeoJSON syntax error occur in ?options=upsert operations (#3949)
• Fix: change -mqttMaxAge from seconds to minutes
• Fix: ForwardingError alarm included in log summary traces
• Fix: lastFailure, lastSuccess and status correct management in MQTT subscriptions
• Hardening: improve MQTT connection logic
• Hardening: upgrade libmosquitto dependency from 2.0.11 to 2.0.12

3.2.0

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

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

Changes (since 3.1.0):

• Add: MQTT notifications (#3001)
• Fix: TextUnrestricted recursively applies to JSON objects and array (#3867)
• Fix: onlyChangedAttrs set to true not working after csubs cache refresh (#3906)
• Fix: PATCH /v2/entities/ID/attrs error doesn't provide info about offending attributes (#2933)
• Fix: -key and -cert files loading (was causing valgrind errors) (#3925)
• Fix: return 400 instead of 500 when GeoJSON syntax error occur (#3347)
• Fix: 400 BadRequest when attempting to DELETE with multi-servicepath or SP with '/#' (instead of silently failing) (#3071)
• Hardening: improve notification pool worker thread termination logic (#3877)
• Remove: deprecated feature initial notification upon subscription creation or update

3.1.0

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

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

Note that initial notifications has been deprecated in this release. You are strongly discouraged of using it. More information about deprecated and removed features here.

Changes (since 3.0.0):

• Add: skipForwarding option in queries to avoid request forwarding to Context Provider (#3851)
• Add: per-service reserved queues/pools to threadpool notification mode (#3843) (experimental feature)
• Add: support to null in DateTime attributes and metadata (#3533)
• Add: support to null in geo:json, geo:point, geo:line, geo:box and geo:polygon attributes (#3533)
• Add: new alarm (id number 6) for forwarding errors (#1794)
• Add: null as allowed value for httpCustom.notification.payload to avoid sending payloads in custom notification (#3272)
• Add: statistic counter re-worked, based in NGSIv2 requests (#3805)
• Add: counter for requests without payload in statistics (#1400)
• Add: debug tracelevels for notifications payload request/response in logs (#2895)
• Fix: use "Forwarding Error" instead of "Other Error" in WARN traces (#1794)
• Fix: potential crash (although under very rare situations) in log trace code
• Fix: support attributes and metadata starting with dollar sign ($) (#3841)
• Fix: avoid duplicating forwarded query requests to CPrs in some cases (this may cause illegal JSON with duplicated attribute keys in the response to clients at the end)
• Fix: support for single entity query forwarding with global registration idPattern (#3463, partially)
• Deprecated: initial notification upon subscription creation or update (along with skipInitialNotification option)

3.0.0

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

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

Changes (since 2.6.0):

• Reference distribution changed from RHEL/CentOS 7 to RHEL/CentOS 8 (#3764)
• Reference MongoDB version changed from 3.6 to 4.4
• Add: SCRAM-SHA-256 as allowed mechanism in -dbAuthMech (#3782)
• Add: tlsAllowInvalidCertificates=true to mongo connection URI along with tls=true when -dbSSL switch is used
• Add: new CLI parameter -dbDisableRetryWrites to set retryWrite parameter to false in DB connections (#3797)
• Add: machine information in GET /version
• Fix: response rightly 500 Internal Error when DB query fails (previously 200 OK with empty entities array was returned)
• Fix: -logForHumans traces including full timestamp information
• Fix: PATCH update operation return right error code, when multiple service paths or service path /# is used (#3640)
• Fix: avoid 500 Internal Error when simulataneous entity creation takes place with -reqMutextPolicy none (either with and without ?options=upsert) (#3821) (*)
• Hardening: MongoDB connection logic largely rewritten
• Hardening: upgrade Mongo driver dependency form C++ legacy-1.1.2 to C 1.17.4 (#3132, #3797, #3695 and probably #3717, #3778, #3326)
• Remove: MONGODB-CR as -dbAuthMech

(*) Included also in Orion 2.6.1

2.6.1

Changes (since 2.6.0):

• Fix: avoid 500 Internal Error when simulataneous entity creation takes place with -reqMutextPolicy none (either with and without ?options=upsert) (#3821)