Chapter 1. Red Hat Software Collections 2.1
This chapter serves as an overview of the Red Hat Software Collections 2.1 content set. It provides a list of components and their descriptions, sums up changes in this version, documents relevant compatibility information, and lists known issues.
1.1. About Red Hat Software Collections
For certain applications, more recent versions of some software components are often needed in order to use their latest new features. Red Hat Software Collections is a Red Hat offering that provides a set of dynamic programming languages, database servers, and various related packages that are either more recent than their equivalent versions included in the base Red Hat Enterprise Linux system, or are available for this system for the first time. For a complete list of components that are distributed as part of Red Hat Software Collections and a brief summary of their features, see Section 1.2, “Main Features”.
Red Hat Software Collections does not replace the default system tools provided with Red Hat Enterprise Linux 6 or Red Hat Enterprise Linux 7. Instead, a parallel set of tools is installed in the
/opt/directory and can be optionally enabled per application by the user using the supplied
sclutility. The default versions of Perl or PostgreSQL, for example, remain those provided by the base Red Hat Enterprise Linux system.
All Red Hat Software Collections components are fully supported under Red Hat Enterprise Linux Subscription Level Agreements, are functionally complete, and are intended for production use. Important bug fix and security errata are issued to Red Hat Software Collections subscribers in a similar manner to Red Hat Enterprise Linux for at least three years from the release of each major version. A new major version of Red Hat Software Collections is released approximately every 18 months, and in each major release stream, each version of a selected component remains backward compatible. For detailed information about length of support for individual components, refer to the Red Hat Software Collections Product Life Cycle document.
1.2. Main Features
Red Hat Software Collections 2.1 provides recent stable versions of the tools listed in Table 1.1, “Red Hat Software Collections 2.1 Components”.
Table 1.1. Red Hat Software Collections 2.1 Components
|Red Hat Developer Toolset 4.0||devtoolset-4||Red Hat Developer Toolset is designed for developers working on the Red Hat Enterprise Linux platform. It provides current versions of the GNU Compiler Collection, GNU Debugger, Eclipse development platform, and other development, debugging, and performance monitoring tools. For a complete list of components, see the Red Hat Developer Toolset Components table in the Red Hat Developer Toolset User Guide.|
|Perl 5.20.1||rh-perl520||A release of Perl, a high-level programming language that is commonly used for system administration utilities and web programming. The rh-perl520 Software Collection provides additional utilities, scripts, and database connectors for MySQL and PostgreSQL. Also, it includes the DateTime Perl module and the mod_perl Apache httpd module, which is supported only with the httpd24 Software Collection.|
|PHP 5.4.40||php54||A release of PHP with PEAR 1.9.4 and a number of additional extensions. PHP 5.4 provides a number of language and interface improvements. The memcache and Zend OPcache extensions are also included.|
|PHP 5.5.21||php55||A release of PHP with PEAR 1.9.4 and enhanced language features including better exception handling, generators, and Zend OPcache. The memcache and mongodb extensions are also included.|
|PHP 5.6.5||rh-php56||A release of PHP with PEAR 1.9.5 and enhanced language features including constant expressions, variadic functions, arguments unpacking, and the interactive debugger. The memcache, mongo, and XDebug extensions are also included.|
|Python 2.7.8||python27||A release of Python 2.7 with a number of additional utilities. This Python version provides various new features and enhancements, including a new ordered dictionary type, faster I/O operations, and improved forward compatibility with Python 3. The python27 Software Collections contains the Python 2.7.8 interpreter, a set of extension libraries useful for programming web applications and mod_wsgi (only supported with the httpd24 Software Collection), MySQL and PostgreSQL database connectors, and numpy and scipy.|
|Python 3.4.2||rh-python34||A release of Python 3 with a number of additional utilities. This Software Collection gives developers on Red Hat Enterprise Linux access to Python 3 and allows them to benefit from various advantages and new features of this version. The rh-python34 Software Collection contains Python 3.4.2 interpreter, a set of extension libraries useful for programming web applications and mod_wsgi (only supported with the httpd24 Software Collection), PostgreSQL database connector, and numpy and scipy.|
|Ruby 2.2.2||rh-ruby22||A release of Ruby 2.2. This version provides substantial performance and reliability improvements, including incremental and symbol garbage collection and many others, while maintaining source level backward compatibility with Ruby 2.0.0 and Ruby 1.9.3.|
|Ruby on Rails 4.1.5||rh-ror41||A release of Ruby on Rails 4.1, a web application development framework written in the Ruby language. This version provides a number of new features including Spring application preloader, config/secrets.yml, Action Pack variants, and Action Mailer previews. This Software Collection is supported together with the rh-ruby22 Collection.|
|MariaDB 10.0.17||rh-mariadb100||A release of MariaDB, an alternative to MySQL for users of Red Hat Enterprise Linux. For all practical purposes, MySQL is binary compatible with MariaDB and can be replaced with it without any data conversions. This version adds the PAM authentication plugin to MariaDB.|
|MongoDB 2.6.9||rh-mongodb26||A release of MongoDB, a cross-platform document-oriented database system classified as a NoSQL database. This Software Collection includes the mongo-java-driver package.|
|MySQL 5.6.24||rh-mysql56||A release of MySQL, which provides a number of new features and enhancements, including improved performance.|
|PostgreSQL 9.4.1||rh-postgresql94||A release of PostgreSQL, which provides a number of enhancements, including improved scalability (bi-directonal replication, cascading replication), increased flexibility of native JSON support, and improved performance.|
|Node.js 0.10||nodejs010||A release of Node.js with npm 1.4.28 and support for the SPDY protocol version 3.1. This Software Collection gives users of Red Hat Enterprise Linux access to this programming platform.|
|rh-nginx 1.8.0||rh-nginx18||A release of nginx, a web and proxy server with a focus on high concurrency, performance and low memory usage. This version introduces a number of new features, including back-end SSL certificate verification, logging to syslog, thread pools support for offloading I/O requests, or hash load balancing method.|
|Apache httpd 2.4.12||httpd24||A release of the Apache HTTP Server (httpd), including a high performance event-based processing model, enhanced SSL module and FastCGI support. The mod_auth_kerb module is also included.|
|Varnish Cache 4.0.3||rh-varnish4||A release of Varnish Cache, a high-performance HTTP reverse proxy. Varnish Cache stores files or fragments of files in memory that are used to reduce the response time and network bandwidth consumption on future equivalent requests.|
|Thermostat 1.2.0||thermostat1||A release of Thermostat, a monitoring and instrumentation tool for the OpenJDK HotSpot JVM, with support for monitoring multiple JVM instances. This Software Collection depends on the rh-mongodb26 and rh-java-common components.|
|DevAssistant 0.9.3||devassist09||A release of DevAssistant, a tool designed to assist developers with creating and setting up basic projects in various programming languages, installing dependencies, setting up a development environment, and working with source control. DevAssistant supports the C, C++, Java, and Python programming languages but it is able to support working with any other language, framework, or tool due to its modular architecture.|
|Maven 3.0.5||maven30||A release of Maven, a software project management and comprehension tool used primarily for Java projects. Based on the concept of a project object model (POM), Maven can manage a project's build, reporting, and documentation from a central piece of information.|
|Passenger 4.0.50||rh-passenger40||A release of Phusion Passenger, a web and application server, designed to be fast, robust, and lightweight. It supports Ruby using the ruby193, ruby200, or rh-ruby22 Software Collections together with Ruby on Rails using the ror40 or rh-ror41 Collections. It can also be used with nginx 1.6 from the nginx16 Software Collection and with Apache httpd from the httpd24 Software Collection.|
|Common Java Packages 1.1||rh-java-common||This Software Collection provides common Java libraries and tools used by other collections. The rh-java-common Software Collection is required by the devtoolset-4, devtoolset-3, maven30, rh-mongodb26, and thermostat1 components and it is not supposed to be installed directly by users.|
Previously released Software Collections remain available in the same distribution channels. For example, the git19 Software Collection, which provides Git 1.9.4, has not been updated since Red Hat Software Collections 1.2 but still can be installed along with the Red Hat Software Collections 2.1 components or other previously released components.
All currently available Software Collections are listed in the Table 1.2, “All Available Software Collections”. For detailed information regarding components that have not been updated since Red Hat Software Collections 1, refer to the Red Hat Software Collections 1.2 Release Notes. See the Red Hat Software Collections Product Life Cycle document for information on the length of support for individual components.
Table 1.2. All Available Software Collections
|Components New in Red Hat Software Collections 2.1|
|Red Hat Developer Toolset 4.0||devtoolset-4|
|Varnish Cache 4.0.3||rh-varnish4|
|Components Updated in Red Hat Software Collections 2.1|
|Common Java Packages 1.1||rh-java-common|
|Components Not Updated since Red Hat Software Collections 2.0|
|Ruby on Rails 4.1.5||rh-ror41|
|Apache httpd 2.4.12||httpd24|
|Components Not Updated since Red Hat Software Collections 1|
|Ruby on Rails 4.0.2||ror40|
Note that Software Collections released in Red Hat Software Collections 2.0 and later include a
rh-prefix in their names.
1.3. Changes in Red Hat Software Collections 2.1
New Software Collections
Red Hat Software Collections 2.1 adds these new Software Collections:
- devtoolset-4 — see Section 1.3.2, “Changes in Red Hat Developer Toolset”
- rh-nginx18 — this Software Collection provides nginx 1.8.0, which introduces a number of new features, including back-end SSL certificate verification, logging to syslog, thread pools support for offloading I/O requests or hash load balancing method. For information about migration to the rh-nginx18 Collection, see Section 5.5, “Migrating to nginx 1.8”.
- rh-varnish4 — this Software Collection provides Varnish Cache 4.0.3, a high-performance HTTP reverse proxy. A reverse proxy is a proxy server that appears to clients as an ordinary server. Varnish Cache stores (caches) files or fragments of files in memory that are used to reduce the response time and network bandwidth consumption on future equivalent requests. For upstream Varnish Cache documentation, refer to https://www.varnish-cache.org/docs/4.0/.
Updated Software Collections
The following components have been updated in Red Hat Software Collections 2.1:
- maven30 — see Section 1.3.3, “Changes in Maven”
- rh-java-common — see Section 1.3.4, “Changes in the Common Java Packages”
- nodejs010 — see Section 1.3.5, “Changes in Node.js”
- v8314 — see Section 1.3.6, “Changes in V8”
Red Hat Software Collections Container Images
Container images based on Red Hat Software Collections 2.0 are now available. The available container images include applications, daemons, and databases. The images can be run on Red Hat Enterprise Linux 7 Server and Red Hat Enterprise Linux Atomic Host. For information about their usage, see the Knowledgebase article at https://access.redhat.com/articles/1752723.
A new source-to-image package is shipped with Red Hat Software Collections 2.1. Source-to-Image (S2I) is a tool for building reproducible container images. It produces ready-to-run images by injecting a user source into a container image and assembling a new container image. The new image incorporates the base image (the builder) and built source, and is ready to use with the
docker runcommand. S2I supports incremental builds, which re-use previously downloaded dependencies, previously built artifacts, and more.
Note that Source-to-Image is not a Software Collection, it is provided to be used with Red Hat Software Collections container images. For details, see https://access.redhat.com/articles/1752723.
1.3.2. Changes in Red Hat Developer Toolset
The following components have been upgraded in Red Hat Developer Toolset compared to the previous release of Red Hat Software Collections:
- Eclipse to version 4.5.0
- GCC to version 5.2.1
- binutils to version 2.25
- elfutils to version 0.163
- dwz to version 0.12
- GDB to version 7.10
- strace to version 4.10
- SystemTap to version 2.8
- OProfile to version 1.1.0
For detailed information on changes in Red Hat Developer Toolset 4.0, see Red Hat Developer Toolset User Guide.
1.3.3. Changes in Maven
The maven30 Software Collection has been updated with two bug fixes and the following enhancement:
- The Maven Central Repository is now by default accessed through the HTTPS protocol. This enhancement update improves security but can have negative impact on performance.
This update also adds three new packages:
- The maven30-xml-maven-plugin package, which enables users to perform several XML-related tasks.
- The maven30-codemodel and maven30-istack-commons packages, which are required by Red Hat Developer Toolset 4.0.
1.3.4. Changes in the Common Java Packages
The updated rh-java-common Software Collection provides several bug fixes and adds two new packages:
- The rh-java-common-apache-commons-jxpath package, which includes an interpreter for the XPath language.
- The rh-java-common-apache-commons-el package, which provides the JSP 2.0 Expression Language Interpreter from Apache.
Additionally, the rh-java-common-ecj package has been upgraded to upstream version 4.4.2, which enables users to compile Java 8 source code.
Note that the rh-java-common-tomcat-lib package is no longer included in the rh-java-common Software Collection due to impossibility of keeping it up-to-date with the latest security fixes.
1.3.5. Changes in Node.js
The nodejs010 Software Collection has been upgraded to upstream version 0.10.40, which provides a number of bug fixes over the version shipped in Red Hat Software Collections 2.0. For detailed changes, see the upstream release notes.
1.3.6. Changes in V8
The v8314 Software Collection has been updated to comply with the changes in nodejs010.
1.4. Compatibility Information
Red Hat Software Collections 2.1 is available for all supported releases of Red Hat Enterprise Linux 6 and Red Hat Enterprise Linux 7 on AMD64 and Intel 64 architectures.
1.5. Known Issues
- The rh-mysql56-mysql-server and rh-mariadb100-mariadb-server packages no longer provide the
testdatabase by default. Although this database is not created during initialization, the grant tables are prefilled with the same values as when
testwas created by default. As a consequence, upon a later creation of the
test_*databases, these databases have less restricted access rights than is default for new databases.Additionally, when running benchmarks, the
run-all-testsscript no longer works out of the box with example parameters. You need to create a test database before running the tests and specify the database name in the
--databaseparameter. If the parameter is not specified,
testis taken by default but you need to make sure the
- When using the
mod_proxy_fcgimodule with FastCGI Process Manager (PHP-FPM), httpd uses port
8000for the FastCGI protocol by default instead of the correct port
9000. To work around this problem, specify the correct port explicitly in configuration.
- When Passenger from the rh-passenger40 Software Collection is run as a module for httpd, the functionality is restricted by SELinux policy. To work around this problem, switch the passenger domain to permissive mode by running the following command as
semanage permissive -a passenger_tStandalone server and nginx integration are not affected by this issue.
- The mongodb24 Software Collection from Red Hat Software Collections 1.2 cannot be rebuilt with the rh-java-common and maven30 Software Collections shipped with Red Hat Software Collections 2.1. Additionally, the mongodb24-build and mongodb24-scldevel packages cannot be installed with Red Hat Software Collections 2.1 due to unsatisfied requires on the maven30-javapackages-tools and maven30-maven-local packages. When the mongodb24-scldevel package is installed, broken dependencies are reported and the
yum --skip-brokencommand skips too many packages. Users are advised to update to the rh-mongodb26 Software Collection.
- When the user tries to use the
mod_perlmodule from both the rh-perl520 and perl516 Software Collections, a conflict in the
/opt/rh/httpd24/root/usr/lib64/httpd/modules/mod_perl.sofile occurs. As a consequence, it is impossible to use
mod_perlfrom more than one Perl Software Collection.
- Shared libraries provided by the nodejs010 Software Collection, namely
libuv, are not properly prefixed with the Collection name. As a consequence, conflicts with the corresponding system libraries might occur.
- The rh-postgresql94 and postgresql92 packages for Red Hat Enterprise Linux 6 do not provide the
sepgsqlmodule as this feature requires installation of libselinux version 2.0.99, which is not available in Red Hat Enterprise Linux 6.
- When uninstalling the httpd24, mariadb55, rh-mariadb100, mongodb24, rh-mongodb26, mysql55, rh-mysql56, nodejs010, perl516, rh-perl520, php55, rh-php56, python27, python33, rh-python34, ruby193, ruby200, rh-ruby22, ror40, rh-ror41, thermostat1, or v8314 packages, the order of uninstalling can be relevant due to ownership of dependent packages. As a consequence, some directories and files might not be removed properly and might remain on the system.
- Red Hat Software Collections 2.1 contains the MySQL 5.6, MariaDB 10.0, PostgreSQL 9.4 and MongoDB 2.6 databases. The core Red Hat Enterprise Linux 6 provides earlier versions of the MySQL and PostgreSQL databases (client library and daemon). The core Red Hat Enterprise Linux 7 provides earlier versions of the MariaDB and PostgreSQL databases (client library and daemon). Client libraries are also used in database connectors for dynamic languages, libraries, and so on.The client library packaged in the Red Hat Software Collections database packages in the PostgreSQL component is not supposed to be used, as it is included only for purposes of server utilities and the daemon. Users are instead expected to use the system library and the database connectors provided with the core system.A protocol, which is used between the client library and the daemon, is stable across database versions, so, for example, using the PostgreSQL 9.2 client library with the PostgreSQL 9.4 daemon works as expected.The core Red Hat Enterprise Linux 6 and Red Hat Enterprise Linux 7 do not include the client library for MongoDB. In order to use this client library for your application, you should use the client library from Red Hat Software Collections and always use the
scl enable ...call every time you run an application linked against this MongoDB client library.
- MariaDB, MySQL, and MongoDB do not make use of the
/opt/provider/collection/rootprefix when creating log files. Note that log files are saved in the
/var/opt/provider/collection/log/directory, not in
- Compiling external applications against the Apache Portable Runtime (APR) and APR-util libraries from the httpd24 Software Collection is not supported. The LD_LIBRARY_PATH environment variable is not set in httpd24 because it is not required by any application in this Software Collection.
- In Red Hat Enterprise Linux 7, when the user tries to install the python27-python-debuginfo package, the
/usr/src/debug/Python-2.7.5/Modules/socketmodule.cfile conflicts with the corresponding file from the python-debuginfo package installed on the core system. Consequently, installation of the python27-python-debuginfo fails. To work around this problem, uninstall the python-debuginfo package and then install the python27-python-debuginfo package.
- When the user tries to rebuild the devassist09-PyYAML package on Red Hat Enterprise Linux 6, the build fails due to a soft dependency, if the Pyrex or Cython programming languages are detected. To work around this problem, make sure the pyrex or cython packages are not installed on your system.
- Using Software Collections on a read-only NFS has several limitations.
This is an expected behavior.
- Ruby gems cannot be installed while the rh-ruby22 Software Collection is on a read-only NFS. Consequently, for example, when the user tries to install the ab gem using the
gem install abcommand, the following error message is displayed:
ERROR: While executing gem ... (Errno::EROFS) Read-only file system @ dir_s_mkdir - /opt/rh/rh-ruby22/root/usr/local/share/gemsThe same problem occurs when the user tries to update or install gems from an external source by running the
- When installing Python packages on a read-only NFS using the Python Package Index (PyPI), running the
pipcommand fails with an error message similar to this:
Read-only file system: '/opt/rh/rh-python34/root/usr/lib/python3.4/site-packages/ipython-3.1.0.dist-info'
- Installing packages from PHP Extension and Application Repository (PEAR) on a read-only NFS using the
pearcommand fails with the error message:
Cannot install, php_dir for channel "pear.php.net" is not writeable by the current user
- Previously, it was sufficient to start the Thermostat storage and agent back ends by running the
thermostat servicecommand. With this update, it is necessary to first run the
thermostat-setupcommand and then configure the agent manually with credentials in the
agent.authfile. For details, refer to the Thermostat User Guide.
thermostat1-thermostat-tomcat startcommand, which starts the Thermostat web storage endpoint, can be used only on Red Hat Enterprise Linux 6 and Red Hat Enterprise Linux 7.0. On Red Hat Enterprise Linux 7.1 and later versions, use
service tomcat@thermostat startinstead.
- Language modules for Apache are supported only with the Red Hat Software Collections version of Apache httpd and not with the Red Hat Enterprise Linux system versions of httpd. For example, the
mod_wsgimodule from the rh-python34 Collection can be used only with the httpd24 Collection.
- all components
- Since Red Hat Software Collections 2.0, configuration files, variable data, and runtime data of individual Collections are stored in different directories than in previous versions of Red Hat Software Collections.
- Some utilities, for example, su, login, or screen, do not export environment settings in all cases, which can lead to unexpected results. It is therefore recommended to use sudo instead of su and set the
env_keepenvironment variable in the
/etc/sudoersfile. Alternatively, you can run commands in a reverse order; for example:
su -l postgres -c "scl enable rh-postgresql94 psql"instead of
scl enable rh-postgresql94 bash
su -l postgres -c psqlWhen using tools like screen or login, you can use the following command to preserve the environment settings:
- Note that Alternative PHP Cache (APC) in Red Hat Software Collections is provided only for user data cache. For opcode cache, Zend OPcache is provided.
- When the user tries to install more than one scldevel package from the python27, python33, and rh-python34 Software Collections, a transaction check error message is returned. This is an expected behavior because the user can install only one set of the macro files provided by the packages (
- When the user tries to install more than one scldevel package from the php54, php55, and rh-php56 Software Collections, a transaction check error message is returned. This is an expected behavior because the user can install only one set of the macro files provided by the packages (
- When the user tries to install more than one scldevel package from the ruby193, ruby200, and rh-ruby22 Software Collections, a transaction check error message is returned. This is an expected behavior because the user can install only one set of the macro files provided by the packages (
- When the user tries to install more than one scldevel package from the perl516 and rh-perl520 Software Collections, a transaction check error message is returned. This is an expected behavior because the user can install only one set of the macro files provided by the packages (
- When the user tries to install more than one scldevel package from the nginx16 and rh-nginx18 Software Collections, a transaction check error message is returned. This is an expected behavior because the user can install only one set of the macro files provided by the packages (
- When installing the nodejs010 Software Collection, nodejs010 installs GCC in the base Red Hat Enterprise Linux system as a dependency, unless the gcc packages are already installed.