Appendix A. Revision History

Revision History
Revision 2.2-11Wed Nov 23 2016Ashley Hardin
BZ 1394396: Updated Section 9.8.1, “Installing Web Cartridges” to add an Important box about a tomcat7 known issue.
Revision 2.2-10Thu Sep 08 2016Ashley Hardin
BZ 1212040, BZ 1354609, BZ 1294966: Bug Fixes
Revision 2.2-8Thurs Aug 20 2015Brice Fallon-Freeman
OpenShift Enterprise 2.2.7 release.
BZ 1197116: Updated Section 9.10.3, “Configuring Disk Quotas” with Important box.
BZ 1190885: Updated Section 7.7.2, “Configuring MCollective Client”.
BZ 1210052: Update Section 8.6.1, “Selecting an External Routing Solution” with link to LTM® documentation.
Revision 2.2-7Mon Jul 20 2015Alex Dellapenta
OpenShift Enterprise 2.2.6 release.
BZ 1200123: Added Section 8.7, “Integrating with External Single Sign-on (SSO) Providers”.
Revision 2.2-6Fri Apr 10 2015Brice Fallon-Freeman
OpenShift Enterprise 2.2.5 release.
BZ 1159978, BZ 1157855, BZ 1051228: Rearranged and updated Section 6.1, “Using the Installation Utility” with more information.
BZ 1180532: Updated Section 8.2.2, “Authenticating Using LDAP” with Important box.
BZ 1173720: Added missing step to Section 8.6.2, “Configuring the Sample Routing Plug-In”.
BZ 1208556: Updated Section 8.6.3, “Configuring a Routing Daemon or Listener” to note the ACTIVEMQ_HOST setting can take an array of hosts.
BZ 1124840: Updated Section 10.5, “Backing Up Node Host Files” with more detail.
BZ 1118927: Updated Section 14.1, “Creating Custom Application Templates” with information on modifying pom.xml for JBoss EAP or JBoss EWS application templates.
Revision 2.2-5Thu Feb 12 2015Alex Dellapenta
OpenShift Enterprise 2.2.4 release.
Updated Section 8.6, “Using an External Routing Layer for High-Availability Applications”, Section 8.6.1, “Selecting an External Routing Solution”, and Section 8.6.3, “Configuring a Routing Daemon or Listener” to add details on F5 BIG-IP LTM® integration.
Revision 2.2-3Wed Dec 10 2014Timothy Poitras
OpenShift Enterprise 2.2.2 release.
BZ 1150426: Updated Section 8.4.4.1, “Configuring a Network of ActiveMQ Brokers” and Section 8.4.4.2, “Verifying a Network of ActiveMQ Brokers Using the ActiveMQ Console” with information on disabling Jetty.
Added Section 9.11, “Enabling Network Isolation for Gears”.
BZ 1165606: Updated Section 8.6.2, “Configuring the Sample Routing Plug-In” and Section 8.6.3, “Configuring a Routing Daemon or Listener” with information on enabling SSL connections per ActiveMQ host.
BZ 1159182: Updated Section 8.6.3, “Configuring a Routing Daemon or Listener” and Section 8.6.4, “Enabling Support for High-Availability Applications” with information on setting HA_DNS_PREFIX parameters consistently.
Updated Section 13.1, “Downloading the Image” to note the downloads page for the OpenShift Enterprise 2.2 version images.
Updated Section 14.2, “Customizing the Management Console” for the addition of the PRODUCT_LOGO and PRODUCT_TITLE parameters.
Updated Chapter 15, Asynchronous Errata Updates with details on incompatible cartridge upgrades.
Revision 2.2-2Thu Nov 6 2014Alex Dellapenta
Updated Section 4.5, “Upgrading from OpenShift Enterprise 2.1 to OpenShift Enterprise 2.2” to clarify OSE_UPGRADE_MIGRATE_VHOST usage.
Fixed minor publication issue.
Revision 2.2-1Tue Nov 4 2014Alex Dellapenta
Updated Section 8.6, “Using an External Routing Layer for High-Availability Applications” and subsections regarding routing solutions supported by the sample routing daemon.
Updated Section 9.12, “Configuring Node Hosts for xPaaS Cartridges” per OpenShift Enterprise 2.1.8 release.
Revision 2.2-0Tue Nov 4 2014Alex Dellapenta
OpenShift Enterprise 2.2 release.
Added Section 4.5, “Upgrading from OpenShift Enterprise 2.1 to OpenShift Enterprise 2.2”.
Added Section 5.2.3, “IPv6 Tolerance”.
Replaced the "Dynamic DNS with Non-BIND Name Servers" section with the new Section 8.1, “Installing and Configuring DNS Plug-ins” and subsections.
Added Section 8.2.4, “Authenticating Using Mutual SSL”.
Added Section 8.2.5, “Integrating Active Directory Authentication with Identity Management”.
Added Section 8.5, “Installing and Configuring the Gear Placement Plug-in” and subsections.
Updated Section 8.6, “Using an External Routing Layer for High-Availability Applications” and all subsections to include information on the new sample routing daemon, and added Section 8.6.1, “Selecting an External Routing Solution”.
Updated Section 8.10.2, “Accessing the Administration Console” to remove the unsupported "Configuring Hosts with Collocated Broker and Node Components" procedure.
Added Section 8.10.3, “Configuring Authentication for the Administration Console”.
Added Section 14.3, “Configuring the Logout Destination”.
Revision 2.1-7Thu Oct 23 2014Brice Fallon-Freeman
Updated oo-admin-ctl-cartridge commands to use import-profile.
BZ 1001833: Added Section 5.1, “Default umask Setting”.
BZ 1006040: Edited Section 5.2.1, “Custom and External Firewalls” and added Section 5.2.2, “Manually Configuring an iptables Firewall”.
BZ 1145762: Removed mention of installing using https://install.openshift.com with the -e option from Section 6.1, “Using the Installation Utility”.
BZ 1118766: Updated Section 8.6, “Using an External Routing Layer for High-Availability Applications” and subsections with edits to wording and procedure order.
Added Section 9.12, “Configuring Node Hosts for xPaaS Cartridges” and updated Section 9.1, “Configuring Node Host Entitlements” and Section 9.8.1, “Installing Web Cartridges” for the new JBoss A-MQ, JBoss Fuse, and JBoss Fuse Builder cartridges.
BZ 1146706: Updated "SNI Proxy" to clarify that SNI proxy ports must be opened in the firewall.
Revision 2.1-6Thu Sep 11 2014Brice Fallon-Freeman
OpenShift Enterprise 2.1.6 release.
BZ 1135480: Updated Section 2.1, “Supported Operating Systems” with Important box.
BZ 1133958: Updated Section 7.7.2, “Configuring MCollective Client” and Section 9.7, “Installing and Configuring MCollective on Node Hosts” with ActiveMQ configuration changes.
BZ 1124579: Updated Section 9.9, “Configuring SSH Keys on the Node Host” and Section 8.4, “Configuring Redundancy” with information on having multiple brokers.
BZ 1133936: Updated Section 9.13.1, “Adding or Modifying Gear Profiles” to note new, additional example resource_limits.conf files.
BZ 1133628: Updated Section 15.1, “Applying Asynchronous Errata Updates” with information on applying multiple updates at once.
Revision 2.1-5Tue Aug 26 2014Timothy Poitras
OpenShift Enterprise 2.1.5 release.
Updated Section 2.1, “Supported Operating Systems” and Section 2.3, “Red Hat Subscription Requirements” to note the inclusion of Red Hat Enterprise Linux 6 with OpenShift Enterprise subscriptions.
Updated Section 6.1, “Using the Installation Utility”, Section 7.1.2, “Using Red Hat Network Classic on Broker Hosts”, and Section 9.1.2, “Using Red Hat Network Classic on Node Hosts” with details regarding migrating from RHN to RHSM.
Revision 2.1-4Thu Aug 7 2014Alex Dellapenta
BZ 1060871: Updated "HTTP Proxies" with a note.
BZ 1084617: Updated Section 10.1.2.1, “Changing the Front-end HTTP Configuration for Existing Deployments” with correct Apache plug-in information.
BZ 1119795: Fixed typo in Section 9.10.3, “Configuring Disk Quotas”.
BZ 1114162: Updated steps in Section 4.3, “Upgrading from OpenShift Enterprise 1.2 to OpenShift Enterprise 2.0” and Section 4.4, “Upgrading from OpenShift Enterprise 2.0 to OpenShift Enterprise 2.1”.
Revision 2.1-3Tue Jun 24 2014Alex Dellapenta
OpenShift Enterprise 2.1.2 release.
Updated various sections to highlight OpenShift Enterprise 2.1 features.
Updated Section 13.1, “Downloading the Image” to note the 2.1.1 version image and latest Red Hat Customer Portal site navigation.
BZ 1102430: Updated Section 8.6.2, “Configuring the Sample Routing Plug-In” to note the ACTIVEMQ_HOST setting can now take an array of hosts.
BZ 1102131: Updated note in Section 7.8.9, “Configuring OpenShift Enterprise Authentication” for clarification between different OpenShift Enterprise releases.
BZ 1108950: Updated the procedure in Section 9.9, “Configuring SSH Keys on the Node Host”.
BZ 1111452: Updated Section 9.10.3, “Configuring Disk Quotas” with an example /etc/fstab file entry.
Revision 2.1-2Mon Jun 9 2014Alex Dellapenta
Added Chapter 13, OpenShift Enterprise by Red Hat Offline Developer Virtual Machine Image.
Various enhancements to Section 6.2, “Using the Installation Scripts” and subsections.
BZ 1105155: Updated Section 6.1, “Using the Installation Utility” to show tar usage instead of zip, and added an Important admonition on using the none subscription type.
Revision 2.1-1Wed Jun 4 2014Alex Dellapenta
OpenShift Enterprise 2.1.1 release.
Restructured and added sections for new Chapter 6, Deployment Methods, including more detailed information and examples regarding the installation scripts.
Restructured sections for new Chapter 5, Host Preparation.
Added Warning admonitions to note that running a broker and node on the same host is not supported.
Updated Section 9.8.2, “Installing Add-on Cartridges” for addition of MongoDB cartridge.
Updated Section 7.6.2, “Configuring ActiveMQ” for changes to default Jetty configuration.
Updated Section 8.4.5, “Broker Web Application”.
BZ 1098544: Updated Section 6.2.7, “Performing Required Post-Deployment Tasks” with required post-deployment tasks.
BZ 1100859: Updated Section 8.9.1, “Installing the Management Console” and Section 8.2, “Configuring User Authentication for the Broker”.
BZ 1080163: Updated Section 8.6.4, “Enabling Support for High-Availability Applications” with a note.
BZ 1099672: Updated Section 7.8.8, “Configuring the Broker Plug-ins”.
Revision 2.1-0Fri May 16 2014Bilhar Aulakh
OpenShift Enterprise 2.1 release.
Added Section 4.4, “Upgrading from OpenShift Enterprise 2.0 to OpenShift Enterprise 2.1”.
Added Section 7.8.2, “Setting Ownership and Permissions for MCollective Client Configuration File”.
Added Section 8.11, “Clearing Broker and Management Console Application Cache”.
Added Section 9.8.3, “Installing Cartridge Dependency Metapackages”.
Added Chapter 14, Customizing OpenShift Enterprise and subsections.
Updated default DNS key algorithm in various sections from HMAC-MD5 to HMAC-SHA256.
Updated Section 6.2, “Using the Installation Scripts” and Section 6.1, “Using the Installation Utility” to include latest installation script and utility changes.
Updated Section 7.7.2, “Configuring MCollective Client” and Section 9.7, “Installing and Configuring MCollective on Node Hosts” to include heartbeat parameters in the sample file configuration.
Updated Section 8.6.4, “Enabling Support for High-Availability Applications” with additional configuration settings.
Updated Section 9.14, “Configuring Districts”.
BZ 1063859: Updated log file locations to /var/log/openshift/node/ruby193-mcollective.log
BZ 1081654: Updated Chapter 15, Asynchronous Errata Updates with archiving instructions.
BZ 1071375: Updated Section 7.1, “Configuring Broker Host Entitlements” and Section 9.1, “Configuring Node Host Entitlements” to remove deprecated subscription-manager commands.
BZ 963332: Updated Section 7.7.2, “Configuring MCollective Client” with modified logging options.
BZ 1079365: Updated Section 7.7.2, “Configuring MCollective Client” and Section 9.7, “Installing and Configuring MCollective on Node Hosts” for upgrade to MCollective 2.4.
BZ 1063439: Added Important box to Section 7.8.9, “Configuring OpenShift Enterprise Authentication”.
BZ 1066729: Updated sample configuration in Section 8.4.4.1, “Configuring a Network of ActiveMQ Brokers”.
BZ 1074826: Fixed command error in Section 9.9, “Configuring SSH Keys on the Node Host”.
Revision 2.0-4Fri Apr 11 2014Brice Fallon-Freeman
BZ 1076233: Fixed faulty images in Chapter 3.
Revision 2.0-3Mon Feb 10 2014Julie Wu
OpenShift Enterprise 2.0.3 release.
BZ 1063577: Edited command in Section 6.1, “Using the Installation Utility”.
BZ 1066025: Added info to Section 9.10.7, “Configuring the Port Proxy”.
BZ 1009869: Added Section 12.7, “Switching Between Multiple OpenShift Environments”.
BZ 1051799 and BZ 1078325: Edited Section 7.8.7, “Configuring the Broker Datastore”.
BZ 1057190: Updated Section 7.6.2, “Configuring ActiveMQ”.
BZ 1064417: Updated Section 9.10.2, “Configuring Cgroups”
Revision 2.0-2Tue Jan 28 2014Alex Dellapenta
OpenShift Enterprise 2.0.2 release.
BZ 929182: Updated Section 8.2.2, “Authenticating Using LDAP”.
BZ 1051960: Updated commands in Section 7.8.4, “Configuring the Required Services”, Section 7.8.6, “Configuring the Broker Domain”, Section 8.3.2, “MongoDB”, Section 9.10.8, “Configuring Node Settings”, Section 4.2, “Preparing for an Upgrade”, and Section 9.10.1, “Configuring PAM”.
BZ 1051804: Updated Section 8.9.1, “Installing the Management Console”.
Added Chapter 15, Asynchronous Errata Updates.
Updated Chapter 4, Upgrading from Previous Versions.
BZ 1049566: Updated Section 8.6.3, “Configuring a Routing Daemon or Listener”.
Revision 2.0-1Tue Jan 14 2014Bilhar Aulakh
OpenShift Enterprise 2.0.1 release.
BZ 1043394: Updated contents of listener.rb file.
BZ 1051960: Fixed various shell commands with problematic quoting.
BZ 1051946: Removed problematic less-than signs in some shell commands.
BZ 1042903: Removed MONGO_REPLICA_SETS from configuration file screen output.
BZ 1042887: Updated suggestions for redundant topologies in Section 8.4, “Configuring Redundancy” for clarification.
BZ 1043073: Updated Section 9.4, “Configuring Node Host Name Resolution” and Section 9.5, “Configuring the Node Host DHCP and Host Name”.
BZ 1042997: Updated URL to configuration template and added note for kickstart script.
BZ 1042999: Added note about kickstart script for procedures.
BZ 1041545 and BZ 1039744: Updated Section 6.1, “Using the Installation Utility”.
BZ 1044224: Fixed and Updated Section 10.4, “Idling and Overcommitment”.
BZ 1043678: Updated Section 9.15, “Importing Cartridges”.
BZ 1022195: Fixed Section 9.10.8, “Configuring Node Settings”.
BZ 1014294: Fixed Section 8.4.4.1, “Configuring a Network of ActiveMQ Brokers”.
Added Section 4.3, “Upgrading from OpenShift Enterprise 1.2 to OpenShift Enterprise 2.0”.
BZ 1040150: Fixed and updated Section 7.1, “Configuring Broker Host Entitlements”, Section 7.2, “Configuring Yum on Broker Hosts”, Section 9.1, “Configuring Node Host Entitlements”, and Section 9.2, “Configuring Yum on Node Hosts”.
BZ 1039746: Fixed Section 5.4, “Enabling Remote Administration”.
BZ 1040199: Fixed Section 7.4.1, “Configuring the DHCP Client on the Broker Host”.
BZ 1040179: Fixed Section 7.3.2, “Configuring BIND and DNS”.
Revision 2.0-0Tue Dec 10 2013Alex Dellapenta
OpenShift Enterprise 2.0 release.
BZ 1000595: Added "Security" section.
BZ 921793: Added "Network Access" section.
Added "Installation Utility" section.
Added "External Load Balancing" sections.
Added "Administration Console" sections.
Added "Front-end Server Plug-ins" sections.
BZ 991607: Added "Adding New Gear Profiles" section.
BZ 1030645: Updated installation script function names.
BZ 990327: Updated "BIND and DNS" section with correct DNS configuration file.
BZ 1006451: Updated "Installing Cartridges" section.
BZ 1017839: Updated "Storage and Backup for Fault Tolerance" section for node hosts.
BZ 998699: Typo fixes in "Creating an SSL Certificate" section.