...
The following are announcements related to RMR during the past 30 days; newest announcements first.
2019 Novermber 7:
- Release B development branch created (dev-b) in the o-ran repo. The version number point for release B is 1.12.0
- Master branch remains frozen at 1.11.0; eventually a branch for the Amber release will be cut allowing dev-b to merge back into master.
- The branch r2-temp was created at version 1.10.2; it contains RMR state for the November 2019 trial.
2019 October 22:
- RMR version 1.10.1 pushed to package cloud. Bug fixes which prevent a nil message buffer pointer from being returned to the caller in the event that epoll/select cannot be initialised when using a timeout based RMR send function. The bug was considered to have a very low probability of being triggered, and any function which tested for a nil pointer from any RMR send function would not have issues.
2019 October 7:
- RMR version 1.10.0 pushed to package cloud. The version reports on send counts (success/hard fail/soft fail), and attempts to reduce the number of retries reported to the user application.
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.
Current Version
Release B development: 1.12.0 7 November 2019
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 Release A frozen: 1.11.0 1 (masterAmber branch) 6 November (doc update)2019
Trial branch (r2-temp): 1.10.2 Fall 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