-
Language:
English
-
Language:
English
2.0 Release Notes
Release Notes for OpenShift Enterprise
Red Hat OpenShift Documentation Team
Abstract
Chapter 1. Introduction to OpenShift Enterprise
1.1. Installing OpenShift Enterprise 2.0
1.2. Upgrading to OpenShift Enterprise 2.0
Chapter 2. New Features
2.1. What's New in OpenShift Enterprise 2.0
OpenShift Enterprise now supports the following new or updated cartridges:
- Node.js 0.10
- Python 2.7
- PostgreSQL 9.2
- Ruby 1.9 (now supported through the use of Software Collections)
Users can now set one or more custom environment variables for their applications. Set, view, and remove environment variables with the rhc env commands. See the OpenShift Enterprise User Guide for more information on using environment variables.
OpenShift Enterprise now features an optional Administration Console, providing administrators with a read-only view of their deployment data. Administrators can view gear profiles and resource management, and can receive suggestions on how to improve performance. See the OpenShift Enterprise Deployment Guide for the installation procedure, and the OpenShift Enterprise Administration Guide for usage instructions.
Users can now create multiple domains. See the OpenShift Enterprise User Guide for information on using domains, including creating and maintaining domains, and the OpenShift Enterprise Administration Guide for information on administering domains for users, such as configuring domain settings.
Users can now work collaboratively on applications within a domain. Add another user to your domain with view, edit, or administer access. See the OpenShift Enterprise User Guide for more information on members.
Users can now configure an application's deployment process. Use the rhc configure-app command to enable or disable automatic deployments, deploy from different Git branches, keep deployment metadata, and switch between Git and binary deployments. These new features also enable users to rollback an application to a previous deployment, or deploy using a binary snapshot. See the OpenShift Enterprise User Guide for more information on deployments.
OpenShift Enterprise 2.0 allows external load balancing by introducing pluggable web routing for high-availability instances. See the OpenShift Enterprise Deployment Guide for a more information on external load balancing.
2.2. Notable Technical Changes
OpenShift Enterprise 2.0 has new channels in both RHN Classic and Red Hat Subscription Management. See the OpenShift Enterprise Deployment Guide for an updated list of channel names and for more information on available repositories.
iptables Port Proxy Solution
OpenShift Enterprise now uses iptables instead of HAProxy as the port proxy solution. See the OpenShift Enterprise Deployment Guide for details on configuring the port proxy.
OpenShift Enterprise's MCollective infrastructure now utilizes the Software Collection Library (SCL). This includes the MCollective agent on node hosts and the MCollective client on broker hosts. MCollective packages and services now use a ruby193-mcollective prefix, which results in changes to relevant commands and file locations. See the OpenShift Enterprise Deployment Guide for more information on MCollective updates.
Previously, all deployed applications used a single front-end HTTP service. Now, administrators can configure their front-end server through a set of available plug-ins. See the OpenShift Enterprise Deployment Guide for more information on changing the front-end server plug-ins.
OpenShift Enterprise 2.0 introduces enhancements which minimize downtime for scaled applications during deployments and restarts. Scaled web cartridge restarts experience zero downtime. Application deployments experience minimized downtime when using a single HAProxy cartridge, and zero downtime when using multiple HAProxy cartridges.
Chapter 3. Known Issues
IPv6 is not supported for the 2.0 release, and OpenShift Enterprise has not been tested using IPv6. Some components that may be affected are listed in the bug report.
If you delete the Jenkins builder gear (from JBoss Developer Studio) and try to rebuild an application, the build fails because the build can not be found. This seems to be caused because Jenkins keeps a list of builders, and upon builder deletion (using REST calls), Jenkins does not get cleaned up.
Jenkins Server fails to build a re-created application that uses the same name as a previously deleted application. To workaround this issue, delete the Jenkins job before creating an application using the same name as a deleted application.
Chapter 4. Asynchronous Errata Updates
Note
The latest OpenShift Enterprise Deployment Guide provides general instructions on how to apply asynchronous errata updates within a minor release:
yum update command on a host installs packages for all pending updates at once. If you are applying multiple asynchronous errata updates at once, any additional update instructions for all releases being installed must be performed. However, the steps can be aggregated in this situation when commands would be unnecessarily repeated. When evaluating which additional steps must be performed for multiple pending asynchronous errata updates, consider the following general workflow:
- Run the
yum updatecommand on each host. - Restart relevant services.
- Clear the broker and console cache on the broker host, if relevant.
- Run the
oo-admin-upgradecommand on the broker host to upgrade existing gears, if relevant.
Example 4.1. Applying Multiple Asynchronous Errata Updates at Once
- After running the
yum updatecommand on each host, run the following on each node host:#
service ruby193-mcollective restart - Run the following on the broker host:
#
service openshift-broker restart#service openshift-console restart#oo-admin-broker-cache --console#oo-admin-upgrade archive#oo-admin-upgrade upgrade-node --version=2.0.7Note that theoo-admin-upgrade upgrade-nodecommand is only run once, using the version for the latest release being applied.
Table 4.1. Additional Update Instructions per Release
| Release | Advisory | Additional Instructions |
|---|---|---|
| 2.0.1 | RHBA-2014:0020 |
After running the
yum update command on each host and ensuring all packages have been updated, restart the ruby193-mcollective service on each node host:
#
|
| 2.0.2 | RHBA-2014:0102 |
After running the
yum update command and ensuring all packages have been updated, restart the ruby193-mcollective service on each node host:
#
On the broker host, restart the broker service and, if installed, the console service:
# |
| RHBA-2014:0117 |
After running the
yum update command and ensuring all packages have been updated, restart the broker service on the broker host:
#
| |
| 2.0.3 | RHBA-2014:0209 |
After running the
yum update command on each host and ensuring all packages have been updated, restart the ruby193-mcollective service on each node host:
#
On the broker host, upgrade all nodes using the following commands. Alternatively, to only upgrade a single node or gear, see the OpenShift Enterprise Deployment Guide for alternate
oo-admin-upgrade command usage and use 2.0.3 as the target --version.
# |
| RHBA-2014:0210 |
After running the
yum update command on each host and ensuring all packages have been updated, restart the ruby193-mcollective service on each node host:
#
On the broker host, upgrade all nodes using the following commands. Alternatively, to only upgrade a single node or gear, see the OpenShift Enterprise Deployment Guide for alternate
oo-admin-upgrade command usage and use 2.0.3 as the target --version.
# | |
| 2.0.4 | RHBA-2014:0309 |
After running the
yum update command on each host and ensuring all packages have been updated, restart the ruby193-mcollective service on each node host:
#
On the broker host, restart the broker service:
#
|
| 2.0.5 | RHBA-2014:0417 |
After running the
yum update command on each host and ensuring all packages have been updated, restart the ruby193-mcollective service on each node host:
#
|
| 2.0.6 | RHEA-2014:0599 |
After running the
yum update command on each host and ensuring all packages have been updated, restart the ruby193-mcollective service on each node host:
#
On the broker host, restart the broker service and, if installed, the console service:
#
Clear the broker cache and, if installed, the console cache:
#
On the broker host, archive previous upgrade data and upgrade all nodes using the following commands. Alternatively, to only upgrade a single node or gear, see the OpenShift Enterprise Deployment Guide for alternate
oo-admin-upgrade command usage and use 2.0.6 as the target --version.
# |
| 2.0.7 | RHBA-2014:1097 |
After running the
yum update command on each host and ensuring all packages have been updated, there are no additional update instructions for this release.
|
| 2.0.8 | RHBA-2015:0053 |
After running the
yum update command on each host and ensuring all packages have been updated, there are no additional update instructions for this release.
|
| 2.0.9 | RHBA-2015:1588 |
After running the
yum update command on each host and ensuring all packages have been updated, restart the ruby193-mcollective service on each node host:
#
Clear the broker cache and, if installed, the console cache:
#
|
| 2.0.10 | RHEA-2015:1587 |
After running the
yum update command on each host and ensuring all packages have been updated, there are no additional update instructions for this release.
|
Chapter 5. Product Support and Documentation
Product support is available at http://www.redhat.com/support.
Product documentation for OpenShift Enterprise is available at https://access.redhat.com/knowledge/docs/OpenShift_Enterprise/.
Appendix A. Revision History
| Revision History | |||||
|---|---|---|---|---|---|
| Revision 2.0-11 | Wed Aug 12 2015 | Alex Dellapenta | |||
| |||||
| Revision 2.0-10 | Tue Aug 11 2015 | Alex Dellapenta | |||
| |||||
| Revision 2.0-9 | Fri Sep 12 2014 | Alex Dellapenta | |||
| |||||
| Revision 2.0-8 | Fri Jun 6 2014 | Alex Dellapenta | |||
| |||||
| Revision 2.0-7 | Mon Apr 21 2014 | Alex Dellapenta | |||
| |||||
| Revision 2.0-6 | Fri Mar 28 2014 | Alex Dellapenta | |||
| |||||
| Revision 2.0-5 | Tue Mar 18 2014 | Alex Dellapenta | |||
| |||||
| Revision 2.0-4 | Tue Feb 25 2014 | Alex Dellapenta | |||
| |||||
| Revision 2.0-3 | Thu Jan 30 2014 | Alex Dellapenta | |||
| |||||
| Revision 2.0-2 | Tue Jan 28 2014 | Alex Dellapenta | |||
| |||||
| Revision 2.0-1 | Tue Jan 14 2014 | Brice Fallon-Freeman | |||
| |||||
| Revision 2.0-0 | Mon Dec 9 2013 | Bilhar Aulakh | |||
| |||||