NEWS-5.2.0

OpenSAF 5.2.0 (released 2017-04-10)

This is a major release containing new enhancements. Before installing or
upgrading to OpenSAF 5.2, make sure your system meets the minimum version
requirements of the following system components:

• Linux kernel, version 2.6.37 or later. Recommended version is Linux 3.18 or
  later when using the TCP transport, and Linux 4.4.22 or later when using the
  TIPC transport. Linux versions older than the recommended ones contain bugs
  that are known to affect the proper function of OpenSAF. Use of Linux versions
  older than the recommended ones together with OpenSAF is strongly discouraged.
• GNU C Library (Glibc), version 2.11 or later
• GNU Compiler Collection (GCC), version 4.8.1 or later
• Libxml2, version 2.7 or later
• Libopenssl, version 0.9.8 or later (optional)
• Libsqlite3, version 3.6 or later (only needed when configuring with
  --enable-imm-pbe)
• OpenHPI, version 2.17.0 or later (only needed when configuring with
  --enable-ais-plm)
• Libvirt, version 0.9.7 or later (only needed when configuring with
  --enable-ais-plm)

When upgrading to OpenSAF 5.2.0 or later, be aware that SMF upgrade campaigns
can behave differently compared to earlier OpenSAF releases in case of component
failures. This is because Section 4.2.1.3 of SMF spec A.01.02 was implemented in
OpenSAF 5.2.0.

After upgrading to OpenSAF 5.2.0, please review the setting of
OSAF_CKPT_SHM_ALLOC_GUARANTEE in /etc/opensaf/ckptnd.conf. To avoid a
performance regression compared to OpenSAF 5.1.0, the default setting disables
the protection against situations when the POSIX shared memory is full. You must
change the setting of OSAF_CKPT_SHM_ALLOC_GUARANTEE if you wish to enable this
protection.

Important enhancements in this release

AMF enhancements

• Implement partial support for si-swap admin op for N+M model [#2259]
• Make saAmfCompCmdEnv attribute writable [#2255]
• Implement restrictions to auto-repair according to Section 3.11.1.4.2 in the
  spec. [#2144]
• Fix default value for saAmfSIPrefActiveAssignments [#1190]
• Add support for SA_AMF_CLUSTER_RESET recommended recovery [#2065]
• Roll back SI shutdown/​lock admin operation in case of node failover [#2133]
• Improvements to the SC absence feature [#1902]
• Support the saAmfSUAssignedSIs attribute [#905]
• Correcte the return code from saAmResponse_4(), saAmfComponentErrorClear_4()
  and saAmfComponentUnregister() in error cases [#251], [#245], [#171]

Build system enhancements

• Both the controller and the payload RPMs can now be installed on the same node
  at the same time [#2102]
• Use non-recursive make, and improve the default hardening options [#2084]
• Remove dependencies to internal OpenSAF libraries from the AIS libraries
  [#2375]

CLM enhancements

• Add a new CLM cluster reboot admin operation [#2053]

IMM ennhancements

• Support SC absence time-outs longer than 65535 seconds [#2130]
• Use CCB error string to report if an object is created in another CCB when
  calling CcbObjectCreate() [#2111]
• Print textual name of SAF error codes in the IMM command-line tools [#2123]
• Integrate the IMM service with CLM [#1640]

LOG enhancements

• Support logging to unix sockets using the RFC 5424 syslog protocol [#2258]
• Implement SaLogFilterSetCallbackT (Section 3.6.5 in spec.) [#2146]
• Implement rotation of .cfg files [#2239]

MDS enhancements

• Use a separate process for writing MDS log messages [#2015], [#2035], [#2241]
• Improvements to avoid dropped MDS messages [#2132]

OpenSAF start/stop enhancements

• Use a lock file to protect OpenSAF start and stop script from concurrent
  execution [#2244]
• Improve the detection of service failures during the OpenSAF start phase
  [#2204]
• Prevent remote fencing of nodes that are being stopped using the OpenSAF stop
  script [#2160]

PLM enhancements

• Add ability to scale out EEs dynamically [#2118]
• Log resource ids or entity paths when applicable for failed HPI calls [#2109]

Python enhancements

• Add a dispatch function to the clm utils [#2120]

SMF ennhancements

• Support detection of asynchronous failures of AMF entities (Section 4.2.1.3 of
  SMF spec A.01.02) [#2145]

Tracing enhancements

• Add thread id to trace log messages [#2370]

Links

• The complete list of enhancements in the 5.2.0 release can be found in this
  report
• The documentation for the OpenSAF 5.2.0 release can be downloaded here

You can also check the README of the respective OpenSAF service.