...
The following are announcements related to RMR during the past 30 days; newest announcements first.
2020 March 42021 3 May
Version 34.37.0 pushed. This version now packages a support binary in the run-time package. This support binary executes a simple health check by sending the indicated xAPP a health check request message and reporting success or failure based on the response. This is a minor version bump because external components (e.g. container management) may need to require 3.3.* and above to have this. There was no API change in this release.
2020 February 28
Version 3.2.6 pushed. This fixes a bug in the interface between RMR and the Route manager (RIC-232).
2020 February 26
Version 3.2.5 has three fixes:
...
Fix source address bug in SI95 receive/send funcitons.
...
Fix threading issues involving session disconnection in SI95
4 has been pushed to the release area of the package cloud repository. See the revision history on the RTD site for the changes.
Current Version
Cherry development begins with version 4.7.4 on the master branch; 4.7.4 current in the package cloud staging repo.
Cherry Release: Version 4.4.5 (November 2020)
Bronze Release : version tag 4.0.5 (6 June 2020) -- Code is currently frozen; only bug fixes and documentation updates are being applied.
Remove unused SI95 status variable.
2020 February 24
Version 3.2.4 pushed to fix an MEID related bug causing a coredump (RIC-220).
2020 February 21
Version 3.2.3 pushed. This change ensures that RTS messages are attempted on a uni-directional channel first for performance reasons. MEID support in SI is now enabled.
2020 February 20
Version 3.2.2 was pushed into the repo. This change corrected a bug in the SI95 portion of the RMR code that affected multi-threaded user programmes which attempt to use more than one thread to receive messages.
2020 February 10:
The SI95 library support as a transport replacement for NNG has been in the build for a few weeks now. It should support all of the original capabilities provided by NNG. To make use, link with -lrmr_si and remove the library reference to nng. One caution: all applications communicating with RMR must use the same underlying transport (SI95 or NNG) as the two do NOT share the same protocol.
Current Version
Release B development (master branch) version tag 3.3.0 (4 Mar 2020)
Release A frozen: 1.11.1 (Amber branch) 6 November 2019
...
For a detailed description of API changes, and their related commits, please consult the CHANGES file at the top level of the RMR repo:https://gerrit.o-ran-sc.org/r/admin/repos/ric-plt/lib/rmrthe RMR repo or on the RMR read the docs page.
Changes to the API will be announced via this wiki page, so it is assumed that anybody interested in being notified about API changes will place a watch on this page.
...
The following pages hold information that should be useful to anybody modifying and/or testing RMR itself.
RMR Packages
Several frameworks (wrappers/bindings) are being developed which provide a more simplistic interface to the xAPP developer. Installation of the framework will likely require that the RMR runtime package be installed. RMR packages (debian and RPM) are currently published on the html site https://packagecloud.io.
The generic URL below can be used to obtain a list of available packages (current version listed at the top of this page).
https://packagecloud.io/app/o-ran-sc/staging/search?q=rmr&filter=all&filter=all&dist=
Links on these pages redirect to a generalised information HTML page; the actual wget command needed to pull the package is on the right side of these pages near the bottom.
As an example, the following can be added to a Docker file to install the RMR runtime package:
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
# Install RMr (runtime and dev) from debian package cached on packagecloud.io
ARG RMR_VER=3.3.0
RUN wget -nv --content-disposition https://packagecloud.io/o-ran-sc/staging/packages/debian/stretch/rmr_${RMR_VER}_amd64.deb/download.deb
RUN dpkg -i rmr_${RMR_VER}_amd64.deb |
Performance
The following pages discuss RMR and NNG performance.
Support Software
When the RMR runtime package is installed, there may be one or more support binaries which are included. These are installed (by default) into /usr/local/bin. The links below describe each.
Tutorials
The following are links to short tutorials covering some aspects of RMR usage
...