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)

1.9.0

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

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

Changelog (since 1.8.0):

• Add: release_date and doc fields are added to the GET /version output to align with FIWARE scheme (#2970)
• Fix: missing lastSuccess/lastFailure associated to initial notification on subscription creation some times when csub cache is in use (#2974)
• Fix: several invalid memory accesses (based on a workaround, not a definitive solution, see issue #2994)
• Fix: broken JSON due to unscaped quotes (") in NGSIv2 error description field (#2955)
• Hardening: NGSIv1 responses don't use pretty-print JSON format any longer, as NGSIv2 responses work (potentially saving around 50% size) (#2760)

1.8.0

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

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

Changelog (since 1.7.0):

• Add: self-notification loop protection, based on Fiware-Correlator and Ngsiv2-AttrsFormat headers and lastCorrelator field at DB (#2937)
• Add: Fiware-Correlator and NgsiV2-AttrsFormat headers cannot be overwritten by the custom notification logic (#2937)
• Fix: several invalid memory accesses
• Fix: bug in parseArg lib that may cause problem printing the error message for wrong CLI usage (#2926)
• Fix: bug in variable substitution of custom notifications that limited the size of the payload of a custom notification to 1024 bytes (new limit: 8MB)
• Fix: bug in custom notifications making counters and timestamps not being updated (affected subscription fields: lastSuccess, lastFailure, lastNotifiction, count)
• Fix: "request payload too large" (>1MB) as Bad Input alarm (WARN log level)
• Hardening: Several changes in argument passing in mongoBackend library to add 'const' in references to objects that are not altered by the function
• Hardening: Several changes in argument passing in mongoBackend library to avoid passing entire objects on the stack, from "X x" to "const X& x"
• Hardening: Mongo driver migrated to legacy-1.1.2 (several bugfixes in the legacy-1.0.7 to legacy-1.1.2 delta)