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)

1.7.0

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

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

Changelog (since 1.6.0):

• Add: HTTPS native notifications (#706), fixing at the same time issue #2844
• Add: new option to accept self-signed certifications used by HTTPS notification endpoints: -insecureNotif (#706)
• Add: metrics REST API (#2750)
• Add: new option to set the timeout for REST request: -reqTimeout (#2762)
• Add: the string "ISO6801" can now be used as an alias for "DateTime" as type for attributes and metadata (#2654)
• Add: new CLI '-disableMetrics' to disable metrics (#2750)
• Add: support for quotes (') in string filters to let attribute/metadata names contain dots (#2805)
• Add: Support for null values in string filters (#2359)
• Add: one more semaphore (the metrics semaphore) to the semWait block in GET /statistics and to the list in GET /admin/sem (#2750)
• Fix: libmicrohttpd now uses poll()/epoll() and not select() so fds greater than 1023 can be used for incoming connections (#2724, #2166)
• Fix: modified the upper limit for CLI '-maxConnections', from 1020 to UNLIMITED
• Fix: proper 500 Internal Server Error response with descriptive text when "sort fail" at DB occur (#2752)
• Fix: giving a descriptive response with payload, without reading the request for too big payloads (#2761)
• Fix: check for forbidden chars in entity type and id in POST /v2/op/query request (#2819)
• Fix: removed check for forbidden chars in URI param typePattern (#2819)
• Fix: checking for forbidden characters inside the components of string filters (#1994)
• Fix: including Service-Path in notifications also when the service path is the default one (/). For notifications due to 'standard subscriptions', notifications due to 'custom subscriptions' already work this way (#2584)
• Fix: NGSIv1 updateContext APPEND on existing geo:point attributes (and probably other geo: attributes) failing to update location (#2770)
• Fix: bug when tenants are over 44 bytes long (#2811)
• Fix: pattern matching in q/mq: pattern is always a string (#2226)
• Fix: Partial sanity check for custom url, only if the url contains no replacements using ${xxx} (#2280, #2279)
• Fix: Stricter validity check of URL before accepting a subscription (#2009)
• Fix: if entity::type is given but as an empty string, in payload of POST /v2/subscriptions or PATCH /v2/subscriptions/{sub}, an error is returned (#1985)
• Fix: more intelligent, quote-aware, operator lookup inside q/mq string filters (#2452)
• Fix: weird 'md: { }' added with some update operations (#2831)
• Fix: attribute names that include ':' now are supported, with the single-quote syntax. E.g. q='devices:location' (#2452)
• Fix: admin requests (such as GET /version) with errors now return '400 Bad Request', not '200 OK'
• Fix: attempt to create an entity with an error in service path (and probably more types of errors) now returns '400 Bad Request', not '200 OK' (#2763)
• Fix: not calling regfree when regcomp fails. Potential fix for a crash (#2769)
• Fix: wrongly overlogging metadata abscense in csub docs as Runtime Error (#2796)
• Fix: if HTTP header Content-Length contains a value above the maximum payload size, an error is returned and the message is not read (#2761)
• Fix: no longer accepting a service path with an empty component (e.g. /comp1//comp3) (#2772)
• Fix: bug in notification queue statistics, "in" value (#2744)
• Fix: Accept header errors in NGSIv2 requests were incorrectly being rendered using "OrionError" element (#2765)

1.6.0

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

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

Changelog (since 1.5.0):

• Add: notification failure/recovery information included in subscriptions (#1960)
• Add: support ISO8601 timezones at DateTime attributes and metadata creation/update time and filters (#2632)
• Add: support for partial representation format at DateTime attributes and metadata creation/update and filters (#2631)
• Add: New CLI option: '-logForHumans', to make the screen log output readable for humans (#2609)
• Fix: threadpool mode not actually used for custom notifications, even if -notificationMode is set so (#2622) (*)
• Fix: -logAppend as default in configuration for RPM package (#2637) (*)
• Fix: Default log output for stdout is now the same format as in the log file. Use new CLI option '-logForHumans' to modify this. (#2609)
• Fix: several bugs related with field validation in POST /v2/op/update operation (#2653, #2658, #2659, #2661, #2664, #2665, #2666, #2673, #2674, #2675, #2676, #2681, #2682, #2685)
• Fix: subscription PATCH not working for notification.attrs and notification.exceptAttrs subfields (#2647)
• Fix: PATCH attr wrongly adding metadata item instead of replacing (#1788)
• Fix: POST /v2/op/update with empty entities vector makes the broker to crash (#2720) (*)
• Fix: allow empty elements in Accept header (useless, but allowed by HTTP RFC) (#2722) (*)
• Fix: NGSIv1 queries are wrongly interpreting entity type as a pattern (#2723) (*)
• Fix: improving performance avoiding unneeded calls to gettid in log library (#2716)

(*) Included also in some 1.4.x versions.