This article was originally published on August 21, 2019
Technical Alert
ALERT FOCUS
All versions of EDB Failover Manager (EFM). The update has been tested with versions 3.2 through 3.5, and is included EFM 3.6 and later.
RECOMMENDED ACTIONS
Status: Moderate
Recommended: This update fixes a slow memory leak in a 3rd party library used by EFM. Over a period of months with the current memory settings, EFM agents will run out of memory and fail. This does not affect running databases, but disables failover protection until the affected agents are restarted. It is recommended to apply this change when convenient.
WHAT IS IN THIS ALERT
This technical alert is notifying you of an available update to existing EFM installations to fix a memory leak.
This software update contains the following fixes:
The JGroups library version 4.0.19 that contains a fix for the memory leak issue.
IS THIS ALERT FOR ME?
This alert is for customers using:
This update can be obtained by downloading a 3rd party library .jar file to replace the existing one in an EFM installation. Because this version affects clusters running with IPv6 (see below), it is not an automatic update to EFM.
-Djava.net.preferIPv6Addresses=true
For example, if you had this previously:
# Extra information that will be passed to the JVM when starting the agent.
jvm.options=-Xmx128m
It should be changed to:
# Extra information that will be passed to the JVM when starting the agent.
jvm.options=-Xmx128m -Djava.net.preferIPv6Addresses=true
This property change will not be needed for EFM v3.6 and later. It is only needed for the specific version of JGroups that contains the memory fix and works with EFM 3.5 and older.
ALERT FOCUS
All versions of EDB Failover Manager (EFM). The update has been tested with versions 3.2 through 3.5, and is included EFM 3.6 and later.
RECOMMENDED ACTIONS
Status: Moderate
Recommended: This update fixes a slow memory leak in a 3rd party library used by EFM. Over a period of months with the current memory settings, EFM agents will run out of memory and fail. This does not affect running databases, but disables failover protection until the affected agents are restarted. It is recommended to apply this change when convenient.
WHAT IS IN THIS ALERT
This technical alert is notifying you of an available update to existing EFM installations to fix a memory leak.
This software update contains the following fixes:
The JGroups library version 4.0.19 that contains a fix for the memory leak issue.
IS THIS ALERT FOR ME?
This alert is for customers using:
- EDB Failover Manager versions 3.2 through 3.5.
This update can be obtained by downloading a 3rd party library .jar file to replace the existing one in an EFM installation. Because this version affects clusters running with IPv6 (see below), it is not an automatic update to EFM.
- Stop the EFM agents to be updated. This should be all of the agents in a cluster; EFM should not be run with different versions of the code on different agents in the same cluster.
- In the /usr/edb/efm-[version]/lib directory, rename the file jgroups-[version].Final.jar. For instance:
# cd /usr/edb/efm-3.2/lib
# mv jgroups-4.0.8.Final.jar jgroups-4.0.8.Final.jar_original
- Download the following file. This version has been tested with previous EFM installations: https://repo1.maven.org/maven2/org/jgroups/jgroups/4.0.19.Final/jgroups-4.0.19.Final.jar
- Save this file in /usr/edb/efm-[version]/lib with the same name as the file that was renamed in step 2. This allows it to be used by EFM without any changes to the EFM code.
- Start the EFM agents.
-Djava.net.preferIPv6Addresses=true
For example, if you had this previously:
# Extra information that will be passed to the JVM when starting the agent.
jvm.options=-Xmx128m
It should be changed to:
# Extra information that will be passed to the JVM when starting the agent.
jvm.options=-Xmx128m -Djava.net.preferIPv6Addresses=true
This property change will not be needed for EFM v3.6 and later. It is only needed for the specific version of JGroups that contains the memory fix and works with EFM 3.5 and older.