v0.12.1

Changes

• Fix writing of O-DF attributes
• Fix handling of slashes '/' in O-DF id or name

Migration Guide

If you want to migrate your current ODF and subscription data from version 0.9.x to the new version then follow these steps below:

1. Update to version 0.9.2(added backup possibility in this version) without destroying the database files
2. Connect to the CLI using for example netcat:
   1. nc localhost 8180
   2. >backup subs odf
3. This creates json file 'subs' for subscriptions and odf file 'odf' for the data
4. Install version 0.10.0 and move the files 'subs' and 'odf' to the extraction directory
5. Connect again with netcat and restore the data to the server from the files:
   1. nc localhost 8180
   2. >restore subs odf

Release version 0.11.3

Changelog

Breaking changes

• Might break your updating procedure: Configuration changed place from configs/ to conf/.
• Journal DB data format was changed. Data needs to be removed or migrated.

Core

• Updated Akka versions
• Added reference.conf file in the project -> Contains default config parameters. (application.conf can be empty and program will still work. Application config is merged with reference.conf so application.conf settings overwrites any default values).
• Fixed some issues with O-DF path containing '/'-characters
• Delete request implementation. Removes all leafs and their children of given O-DF structure. Delete is an extension to O-MI, until it is accepted to the next version of O-MI standard.
• Possibility to disable historical DB in application.conf; The O-MI Node will still work with its journal DB which has the O-DF structure and the latest value for each InfoItem.
• Changed internal O-DF data models. This may affect some parts of internal agents that uses the old types. Converter functions can be found in types.Odf.OldTypeConverter and types.Odf.NewTypeConverter.

Other

• Web client: Fix request and O-DF selection disappearing when selecting O-DF before selecting O-MI message type
• Agent examples: Parking agent improvements
• Added automatic migration script when installing newer version with dpkg
• Dockerhub release

Release version 0.10.1

Fix for restoring database in the case that there are empty infoitems left int the database from previous updates.

Release version 0.10.0

Migration Guide

If you want to migrate your current ODF and subscription data from version 0.9.x to the new version then follow these steps below:

1. Update to version 0.9.2(added backup possibility in this version) without destroying the database files
2. Connect to the CLI using for example netcat:
   1. nc localhost 8180
   2. >backup subs odf
3. This creates json file 'subs' for subscriptions and odf file 'odf' for the data
4. Install version 0.10.0 and move the files 'subs' and 'odf' to the extraction directory
5. Connect again with netcat and restore the data to the server from the files:
   1. nc localhost 8180
   2. >restore subs odf

Changelog

• Reduce amount of logging on default logging level
• Logback.xml in config directory in release (to configure logging levels)
• Keepalive for websocket connections
• -2 interval subscriptions for new items in the tree
• Backup system for easier migration between vesions
• Subscription IDs are now randomly generated
• Possibility to switch to InfluxDB from config
• Performance improvements

Release version 0.9.2

Added possibility to backup database and subscriptions using CLI. This feature is meant to be used when migrating from previous versions to newer versions to avoid possible incompatibility issues.

usage:
connect to the node CLI with for example nc on linux

>backup <File name for subscription information> <File name for ODF data>

to restore:

>restore <File name of subscriotion information> <File name of the ODF data>

for example ´backup odf subs´ will write the odf and subscriptions to files ´odf´ and ´subs´ respectively
and to restore ´restore odf subs´.

Release version 0.9.1

Adds configuration parameter for enabling callback authorization. Disabled by default until fully implemented.

Release version 0.9.0

NOTE: If you have questions or comments, come to our new chat room:

WARNING: You need to remove journals which contain O-DF hierarchy and MetaDatas.

• For linux /var/logs/o-mi-node/journalDBs/
• For windows logs/journalDBs/ in root directory.
• To keep current meta data you can use ./tools/getAllData.py <server_url>.

Changelog

• Added O-MI Call extension. WebClient tool user interface will be updated later to include O-MI call. You can write call messages manually in the "Request" box.
• Unknown/Proprietary attributes supported for O-DF and saved in the node.
• Callback restricted to addresses that have same IP as sender.
  Prevents misusing O-MI Node to send callbacks to any server.
• Agent configuration format changed. See section below.
• Agent API changes:
  • Constructor and props method take now dbHandler and requestHandler as parameters.
    Request are SEND directly to dbHandler from now on, not to the AgentSystem.
    USE writeToDB and readFromDB methods.
  • Use Akka Actor's preStart and postStop instead of start and stop.
  • Agent do not receive Start, Stop and Restart messages anymore.
  • Also added some helper methods.

Minor changes

• Moved guides to docs directory.
• Added user information to request objects.
• External Authorization module settings added to config.
• Improved XML Schema for O-MI and O-DF.
  • xmlns="omi.xsd" changed to xmlns="http://www.opengroup.org/xsd/omi/1.0/". Currently replaced, when received.
  • xmlns="odf.xsd" changed to xmlns="http://www.opengroup.org/xsd/odf/1.0/". Currently replaced, when received.

Bugfixes

• Fixed library issue in webclient.

Upcoming

• Guide to create custom database implementation.
• New O-DF datatypes that are map like.

New agent configuration format

  {
    name = "<agent name>"
    class = "<full class path of agent>"
    language = "<scala or java>"
    responsible = {
      "<path that agent is responsible for>" = "< w for write and c for call>"
      ...
    }
    ...
    < custom agent specific fields>
  }

Field responsible is only needed for responsible agents.

Release version 0.8.2-warp10

Changelog

New

• Now stores files to database with "/" as a Path separator (Issue #6). THIS IS NOT COMPATIBLE WITH PREVIOUS RELEASE. You need to read and read all data from old database and write it all to this versions database(there is a python script in the tools directory called getAllData.py that reads all data from given server pyhon3 getAllData.py -o \<output file\> host).
• O-MI and O-DF logos are now vector graphics

Bugfixes

• Fix xml.js failing to load when first loading up the website

Release version 0.8.1

Changelog

New

• Added local js/css libraries on the webclient for restricted networks or cdn failures

Bugfixes

• Fixed bug with poll subscriptions returning more data than was requested
• Fixed bug where removing branches with CLI caused writing new data to fail

Release version 0.8.0

Changelog

New

• Added O-MI and O-DF logos
• Support for websocket callback addresses (ws://my.callback/)
• Better handling for pre-parsing errors
• Analytical data for infoitems
• Authorization for HTTP GET data discovery
• Changes to Internal Agent Interfaces

Analytics

• Can be configured in application.conf
• Types of supported analytics:
  • average number of reads & writes
  • amount of reads & writes & unique users in a time window