RIAPS Platform v1.1.16 Release Notes

Gabor Karsai

This is  the release notice for the 1.1.16 release of RIAPS – thanks to Mary for putting together the release!

-          Gabor


THIS RELEASE IS A BREAKING CHANGE!  Meaning that you must update both the VM and BBBs to the same version.  New VMs and BBB images are available on the download page.  Update scripts are available if you need to update your current VM and BBBs, but note that updating will affect any security key setup you have in place. 


  • Due to an update in the security packages, it is HIGHLY recommended to update the BBB nodes by re-flashing the SD card with a new image.  There is an update script available, but it takes ~ 20-30 mins to update.
  • This version removes riaps-systemd.  Because of this removal, riaps-pycom will need to be completely removed (purged) and then reinstalled (done in the VM update script).  You will have to setup the network interface again.  There is a new secure_keys script that should be utilized with this version.  Make sure to have all nodes in the system available when rekeying the system.
  • User configurable files are now located in /etc/riaps and then soft linked back to the /usr/local/riaps/ folders.  Files of interest are:

·         riaps.conf

·         riaps-log.conf

·         riaps-hosts.conf (VM only)

·         Security Keys – id_rsa.pub, id_rsa.key, riaps-sys.cert, x509.pem

  • API Documentation now available, see https://riaps.github.io/apidoc.html
  • Helpful commands now available:
    • riaps_fab riaps.securityOn (for VM add “-H localhost”)
    • riaps_fab riaps.securityOff
  • Projects with C++ components need to be updated – the auto generated base class (<component>Base.cc) needs an additional parameter


auto conf = PyConfigConverter::convert(type_spec, actor_spec);


auto conf = PyConfigConverter::convert(type_spec, actor_spec, args);




Release Notes




* Add ReadTheDocs setup, where doxygen is processed into sphinx files

* Improved API documentation

* Removed riaps-systemd debian package, moved to riaps-pycom package.  This package (riaps-systemd) should be removed before installing the new riaps-pycom package

* Added apparmor file for riaps_actor to make available this advanced security feature

* Put riaps key files into conffile file to allow installation of riaps-pycom without overwriting the user’s security key setup.

* Moved conffile location to /etc/riaps and created soft links to /usr/local/riaps/etc/ and /usr/local/riaps/keys/ for user modified files.


Bug Fixes

* Add apparmor_monkeys library install for security feature (PR #28)

* Parse arguments for C++ actors/components

* Validation zmq address in discovery beacons

* Local ports are also encrypted when security is on

* Port security check for mixed component applications

* Use configured interface for publish/request/answer port (instead of first found interface)

* Security-induced issues addressed

* Duplicate app names are rejected

* EC certs are validated upon actor start

* Update privileges of riaps_fab to be an executable like all the other scripts

* Parse Cpp Args added to code generation template

* Set riaps-sys.cert file permissions to 444

* Add comment to riaps.conf for timeout unit of measure

* Device components to support the same API (for ID-s) as a normal component

* Apparmor problem fixes - New Python package required: apparmor_monkeys

* Apparmor file - moved comments to their own lines - seemed to be interfering with profile building

* Remove group code for now, save for when interface with C++ implementation is available

* Timeout on p2p responses caused a mistaken removal of a peer from the group. The correct remedy is to increase the p2p timeouts.

* Exception error thrown, print statement has too many elements

* Fix hostname file install and fabfile edit issue

* Fix inside port handlers, logging package in python, handler case issues (#164)

* Error message on port again exception

* Improved package removal scripts


Kindest regards,

Mary Metelko  |  System Architect

Institute for Software Integrated Systems

Vanderbilt University

1025 16th Avenue South, Nashville, TN 37212

Ph:  615-875-8008

Email:  mary.a.metelko@...

Web:    http://www.isis.vanderbilt.edu/