...
The following are announcements related to RMR during the past 30 days; newest announcements first.
2019 September 26:
- NNG bug preventing reconnection of a session through docker-proxy (and maybe other proxies) was released. A patch level change to RMR was pushed which incorporates the NNG update during the RMR build process. (1.8.3) This version is backwards compatible with the version of NNG which was previously used (1.1.1), but the NNG library in the run-time environment must be upgraded to avoid the proxy related bug.
- RMR version 1.8.2 is a patch level change which fixed a bug in rmr_torcv_msg() that was causing the receive to block when the MT_CALL mode (multi-threaded call()) mode was enabled. 1.8.2 was updated on 25 September 2019.
- RMR version 1.8.1 is a patch level change which fixed a bug: missing constant possibly needed by wrapper scripts.
2019 September 19:
- Added three new message types; version now 1.8.0
2019 September 18:
- Version 1.7.0: Connection mode changed to be non-blocking by default. Set the environment variable RMR_CONN_ASYNC=0 if blocking is desired during connections. There is no affect on the API.
2019 September 3:
- Version 1.6.0: bug fix in rmr_rts_msg() which could cause the retry of a failed rts call to "reflect" the message back rather than sending it out. Added the ability to set the applications source ID via the environment variable RMR_SRC_ID (if not set the original behaviour of using the hostname, with out any domain components) is used.
2019 August 29:
- Changes to eliminate the possible edge condition where the status of a successful send when the routing table has multiple round-robin groups defined for a message type was added. When there are multiple round-robin groups, a successful status (RMR_OK) will be reported if the message was sent to any of the groups. Version bump to 1.5.0.
2019 August 26:
- Add message type constants to the RIC message type header file. Minor version bump to 1.4.0.
Current Version
2021 3 May
Version 4.7.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.
Release A frozen: 1.11.1 (Amber branch) 6 November 2019
Trial branch (r2-temp): 1.10.2 Fall 20191.8.3 September 25, 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.
...
- Frequently Asked Questions
- User's Guide
- Message Conventions
- Prebuilt Binary Packages
- Building From Source
- Using RMR
- RMR Route Tables (includes information on routing based on MEID)
- Subscription ID
- Manual (man) Pages
...
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