Chapter 12. RHBA-2014:1183 - OpenShift Enterprise 2.1.6 Bug Fix and Enhancement Update

Broker

BZ#1138334

As administrators become increasingly likely to install different sets of cartridges using different gear profiles, for example to set aside profiles for JBoss EAP and future xPaaS cartridges, the process to import cartridge manifests becomes more complex. To accommodate this scenario, this enhancement adds the import-profile subcommand to the oo-admin-ctl-cartridge command on the broker host, which finds a representative node from one, several, or all profiles and imports the latest cartridge manifests from all representative nodes.

Copy to Clipboard Toggle word wrap

BZ#1122271

Previously, sparse files were not preserved when gears moved between nodes, which caused unnecessary disk usage. This bug fix adds the proper flags to related rsync operations which help prevent the issue going forward. After applying this fix, a cartridge migration is required and the MCollective service must be restarted. See https://access.redhat.com/solutions/1179673 for steps to fix existing gears previously using sparse files that have exceeded their quota as a result of this issue.

Copy to Clipboard Toggle word wrap

BZ#1132295

The oo-admin-upgrade, oo-admin-usage, and oo-admin-ctl-domain tools did not normalize user name parameters that were passed in, and the tools could fail to find the intended user name that was normalized in MongoDB. This bug fix updates the tools to now correctly normalize user names before searching for them.

Copy to Clipboard Toggle word wrap

BZ#1131317

Previously, it was possible to define a login normalization that was not idempotent, meaning that when run twice on a given login, the second normalization returned a different value than the first. In certain situations, a normalized login might be re-normalized to no longer match the original normalization, causing the intended user not to be found. Creating an authorization token during the 'rhc setup' process is one such case. To ensure that this does not happen, this bug fix updates the normalization process to repeat until it no longer changes the login, effectively forcing it to be idempotent. As a result, there should no longer be edge cases with a non-idempotent normalization, and 'rhc setup' process runs successfully even under these conditions.

Copy to Clipboard Toggle word wrap

BZ#1065048

The MCollective client configuration settings used a default timeout value which caused the broker to wait for a prolonged period of time when attempting to connect to ActiveMQ. When ActiveMQ was unreachable, the broker waited and eventually failed as if the requests had timed out without displaying helpful error messages. This bug fix updates the client configuration to set a reasonable default timeout value, and broker requests now time out faster and helpful error messages are displayed when ActiveMQ is unreachable. This configuration change is made only in the installation utility and scripts; see the OpenShift Enterprise 2.1 Release Notes for instructions on applying this fix to existing installations.

Copy to Clipboard Toggle word wrap

Cartridge

BZ#1130362

A race condition in the Python cartridge's start method caused the pid file to be written incorrectly in certain situations. This could lead to problems when stopping applications. This bug fix updates the Python cartridge to address the race condition, and the issue no longer occurs as a result. After applying this fix, a cartridge migration is required.

Copy to Clipboard Toggle word wrap

Command Line Interface

BZ#1124094

The oo-admin-upgrade tool previously only upgraded existing gears that included cartridges provided by Red Hat; specifically, only cartridges that defined "redhat" as the vendor in its manifest were affected. This bug fix updates the tool to also support upgrading gears that include any cartridge that exists in a node's cartridge repository, including custom cartridges and those provided by other vendors.

Copy to Clipboard Toggle word wrap

Node

BZ#1112446

Previously, the oo-accept-node tool incorrectly performed mod_rewrite configuration checks on nodes which were configured to use the apache-vhost front-end plug-in. These checks were unnecessary because the apache-mod-rewrite and apache-vhost plug-ins are mutually exclusive. This bug fix updates the tool to only perform the mod_rewrite checks when the apache-mod-rewrite plug-in is in use.

Copy to Clipboard Toggle word wrap

BZ#1127714

Due to a bug in the Watchman code, the Watchman Throttler plug-in had a memory leak which caused the Watchman service to consume too much memory and time out when attempting a restart. This bug fix updates the plug-in to resolve the memory leak, and these issues no longer occur as a result. After applying this fix, the openshift-watchman service must be restarted.

Copy to Clipboard Toggle word wrap

BZ#1135062

The MongoDB cartridge did not properly include the PATH and LD_LIBRARY_PATH entries provided by Red Hat Software Collections (SCL) in the cartridge environment, and did not publish the appropriate PATH elements for scaled cartridges. This caused the appropriate PATH and LD_LIBRARY_PATH entries for the mongo support binaries provided by SCL, such as mongoimport, to not be set, and were therefore not available to gear action hooks. This bug fix updates the MongoDB cartridge to include the appropriate PATH and LD_LIBRARY_PATH entries for non-scaled cartridges. It also provides a new connection hook that publishes OPENSHIFT_MONGODB_LD_LIBRARY_PATH_ELEMENT and OPENSHIFT_MONGODB_PATH_ELEMENT, included by scaled cartridges in the primary cartridge's PATH and LD_LIBRARY_PATH environment variable. As a result, the correct mongo binaries are now available from the command line and gear action hooks for scaled and non-scaled applications. See https://access.redhat.com/articles/1179613 for instructions on applying this fix to existing gears.

Copy to Clipboard Toggle word wrap

BZ#1133936

Previous releases of OpenShift Enterprise shipped a single example /etc/openshift/resource_limits.conf configuration file on nodes for a gear profile called "small". This enhancement adds additional configuration files based on other example gear profiles and host types. For example, files for "medium" and "large" example profiles are included, as well as an "xpaas" profile for use on nodes hosting xPaaS cartridges in future OpenShift Enterprise releases. The contents in the example configuration files have also been rearranged to make it easier for administrators to find commonly customized settings.

Specifying a profile of "small", "medium", "large", or "xpaas" when installing a node using the installation scripts now causes the corresponding example configuration file to be deployed. Custom profiles can be used in this way as well, as long as a corresponding configuration file is present during installation.

Copy to Clipboard Toggle word wrap

BZ#1131031

If a node failed and all that was left was the gear storage, metadata such as /etc/passwd entries, gear cgroup configurations, and limits.d files previously had to be recreated manually. This enhancement adds the new oo-admin-regenerate-metadata tool which can now perform these actions automatically.

Copy to Clipboard Toggle word wrap

BZ#1136983

The default /etc/openshift/node.conf file on node hosts contained gear UID and port settings that are no longer used as described and did not contain the actual settings for those purposes. This made it confusing when trying to change the port range, starting gear UID, or ports per gear. This bug fix updates this default file for new installations to remove the unused options. It also adds notes for options that should not be changed that must remain for historical purposes, and introduces accurate settings (PORTS_PER_USER and PORT_BEGIN) with helpful comments regarding restrictions on changing them. This file on existing installations is unaffected.

Copy to Clipboard Toggle word wrap

BZ#1104072

The shell function wrapper for the mongo binary improperly quoted command line arguments. The command name and the first argument were passed to the scl environment wrapper as a single token with the remaining arguments unquoted, causing the scl wrapper to look for a non-existent path prefix file, for example '/etc/scl/prefixes/mongo -u'. This bug fix updates the mongo function in the rhcsh environment script, and the entire command passed to the scl environment wrapper is now properly quoted.

Copy to Clipboard Toggle word wrap