Chapter 31. Revision History: Installation and Configuration
31.1. Wed Mar 07 2018
| Affected Topic | Description of Change |
|---|---|
| Added to instructions to scale EFK pods when changes are made in the Understanding and Adjusting the Deployment section. |
31.2. Fri Aug 25 2017
| Affected Topic | Description of Change |
|---|---|
| Setting up the Registry → Deploying a Registry on Existing Clusters | Removed Technology Preview notice from the Deploying the Registry as a DaemonSet section. |
31.3. Tue Aug 08 2017
| Affected Topic | Description of Change |
|---|---|
| Added new section on how to manually redeploy the router certificates. | |
| Added information about configuring Neutron to the Using Flannel section. |
31.4. Fri Jul 28 2017
| Affected Topic | Description of Change |
|---|---|
| Added the Redeploying a New etcd CA section. |
31.5. Thu Jul 27 2017
| Affected Topic | Description of Change |
|---|---|
|
Added the | |
| Added a note about whitelisting users. | |
|
Updated Section 2.6.11, “Known Issues”Known Issues] to remove | |
| Setting up the Registry → Securing and Exposing the Registry | Added steps to the Securing the Registry section on configuring your cluster to trust the certificate at the OS level. |
31.6. Wed Jul 12 2017
| Affected Topic | Description of Change |
|---|---|
|
Replaced the deprecated | |
|
Replaced the deprecated |
31.7. Tue Jun 13 2017
| Affected Topic | Description of Change |
|---|---|
| Added a step to verify that the etcd package is installed, if you installed multiple etcd hosts. |
31.8. Wed May 31 2017
| Affected Topic | Description of Change |
|---|---|
| Installing a Cluster → Installing a Stand-alone Deployment of OpenShift Container Registry | Updated to use OpenShift Container Registry name and add clarification on the distinction between Atomic Registry. |
31.9. Thu May 25 2017
| Affected Topic | Description of Change |
|---|---|
| Noted that after making changes to an identity provider, you must restart the master service for the changes to take effect. |
31.10. Mon May 15 2017
| Affected Topic | Description of Change |
|---|---|
| Added clarification that nodes and masters are forward and backward compatible across one minor version. | |
|
Added information about |
31.11. Tue May 09 2017
| Affected Topic | Description of Change |
|---|---|
| Updated the Configuring Schedulability on Masters section to note that masters are automatically marked unschedulable by default by the installer. | |
|
Updated the Configuring Node Host Labels section to better describe the special | |
| Added a Configuring Deployment Type section. |
31.12. Tue Apr 25 2017
| Affected Topic | Description of Change |
|---|---|
| Updated for new set of playbooks and options. |
31.13. Wed Apr 12 2017
| Affected Topic | Description of Change |
|---|---|
| Added graphics to the Using Router Shards section. | |
| Expanded details in the Rebuilding Your Router section. | |
| Specified the UDP for port 4789. | |
| In the Known Issues multiple masters discussion, included the docker-common package in the removal process, following a failed setup play. | |
|
Added |
31.14. Mon Apr 03 2017
| Affected Topic | Description of Change |
|---|---|
|
Added the | |
| Added a new section on configuring the verbosity of journald log messages. | |
| Updated the list of supported registry storage drivers in the Storage section. | |
| Setting Up a Registry → Deploying a Registry on Existing Clusters | Added list of supported registry storage drivers to the Storage for the Registry section. |
| Added Registry and Router Certificates section with instructions on redeploying these certificates manually. |
31.15. Mon Mar 27 2017
| Affected Topic | Description of Change |
|---|---|
| Moved the procedure for restoring etcd to the Backup and Restore topic. | |
| Setting up a Router → Configuring the HAProxy Router to Use the PROXY Protocol | New topic on configuring the HAProxy router to use the PROXY protocol. |
31.16. Mon Mar 20 2017
| Affected Topic | Description of Change |
|---|---|
| Added Network Time Protocol (NTP) as a prerequisite. | |
|
Added information on using the | |
|
Added |
31.17. Tue Mar 14 2017
| Affected Topic | Description of Change |
|---|---|
|
Renamed instances of | |
| Added information about disconnected installation of the stand-alone registry. | |
| Setting up the Registry → Deploying a Registry on Existing Clusters | Added footnotes to the example file in the Use Amazon S3 as a Storage Back-end section. |
| Added note recommending moving off NFS for production in the Image Push Errors with Scaled Registry Using Shared NFS Volume section. | |
| Upgrading a Cluster → Performing Manual In-place Cluster Upgrades | Removed a repetitive step within the Updating the Default Image Streams and Templates section. |
| Added the procedure for upgrading the operating system. |
31.18. Tue Mar 07 2017
| Affected Topic | Description of Change |
|---|---|
| Updated Before You Begin section to raise minimal Ansible version to 2.2.0. | |
| Provided guidance for preconfigured load balancers for OpenShift Container Platform with high availability. | |
| Added the Checking Certificate Expirations section. |
31.19. Thu Feb 16 2017
| Affected Topic | Description of Change |
|---|---|
| Added the cluster image to the Syncing Images section. | |
| Setting up the Registry → Deploying a Registry on Existing Clusters | Added additional URL instructions to the Deploying the Registry Console section. |
| Setting up the Registry → Securing and Exposing the Registry |
Added a step for adding the public route host name in the |
| Added the Filtering Routes to Specific Routers section. | |
| Fixed the options for creating a configuration file in the Creating New Configuration Files section. | |
|
Added details about | |
| Fixed example in the Configuring Fluentd to Send Logs to an External Log Aggregator section. | |
|
Added a version variable and |
31.20. Mon Feb 06 2017
| Affected Topic | Description of Change |
|---|---|
| Arranged the topic to create the Creating a Router section, and added a paragraph on router options on creation. | |
| Persistent Storage Examples → Complete Example Using GlusterFS | Clarified that, if using a service, the endpoints name must match the service name. |
| Configuring Persistent Storage → Persistent Storage Using GlusterFS | Clarified that, if using a service, the endpoints name must match the service name. |
| Setting up the Registry → Deploying a Registry on Existing Clusters | Added Important box about shutting down Cockpit to the Non-Production Use section. |
|
Added steps on using | |
| Setting up the Registry → Deploying a Registry on Existing Clusters | Arranged the Securing the Registry Console section to include information on the certificate. |
| Added the Configuring a Registry Location section. | |
| Configuring Nuage SDN | Added the Configuring Nuage SDN file. |
31.21. Tue Jan 31 2017
| Affected Topic | Description of Change |
|---|---|
| Added instructions for installing and using the atomic-openshift-excluder and atomic-openshift-docker-excluder scripts during cluster installations and upgrades. | |
31.22. Mon Jan 30 2017
| Affected Topic | Description of Change |
|---|---|
| Setting up the Registry → Securing and Exposing the Registry |
Removed references to the deprecated |
| Clarified custom certificate configuration locations in the Configuring Custom Certificates section. |
31.23. Wed Jan 25 2017
| Affected Topic | Description of Change |
|---|---|
| Added step to Proxying Docker Pull for finding the registry service IP. | |
|
Removed references to the deprecated | |
| Added information about required ports for Aggregated Logging. | |
| Added notes to explain additional values in the /etc/origin/master/master-config.yaml file in the Manually Setting Global Build Defaults section. | |
| Added information about setting extension properties. |
31.24. Wed Jan 18 2017
| Affected Topic | Description of Change |
|---|---|
| Setting up the Registry → Securing and Exposing the Registry | Added note box about mounting secrets to service accounts. |
31.25. Mon Jan 16 2017
| Affected Topic | Description of Change |
|---|---|
|
Clarified the difference between | |
|
Added clarification regarding ConfigMaps and output of |
31.26. Mon Jan 09 2017
| Affected Topic | Description of Change |
|---|---|
| Added clarifying details about HTTP proxies. |
31.27. Tue Dec 20 2016
| Affected Topic | Description of Change |
|---|---|
| Removed section on configuring Maven with http proxies. | |
| Updated the path to the latest epel-release package. |
31.28. Tue Dec 13 2016
| Affected Topic | Description of Change |
|---|---|
| Configuring Persistent Storage → Persistent Storage Using GCE Persistent Disk | Added a new Multi-zone Configuration section. |
| Configuring Persistent Storage → Dynamically Provisioning Persistent Volumes | Added clarifying details about multi-zone persistent volume (PV) configuration. |
| Added Configuring Fluentd to Send Logs to an External Log Aggregator section. | |
| Added Note boxes explicitly stating that sending logs directly to an AWS Elasticsearch instance is not supported. | |
| Added F-5 Load Balancer and X-Forwarded-For Enabled to the Troubleshooting Kibana section. | |
| Added a new Customizing the About Page section. |
31.29. Mon Dec 05 2016
| Affected Topic | Description of Change |
|---|---|
| Removed Git access as a prerequisite because it is a requirement for development, but not for installing a cluster. | |
| Added a NOTE indicating that, as of OpenShift Container Platform 3.3, Fluentd no longer reads historical log files when using the JSON file log driver. | |
|
Added the | |
|
Added the | |
|
Removed references to filtering |
31.30. Mon Nov 21 2016
| Affected Topic | Description of Change |
|---|---|
| Clarified points around NFS storage. | |
| Setting up the Registry → Deploying a Registry on Existing Clusters | Removed inaccurate example showing how to attach an existing NFS volume to the registry. |
| Described the CloudFront middleware extension. |
31.31. Mon Nov 14 2016
| Affected Topic | Description of Change |
|---|---|
|
Updated the | |
| Added steps to verify the web console. |
31.32. Mon Nov 07 2016
| Affected Topic | Description of Change |
|---|---|
| New topic on the impacts of operating system updates and upgrades and possible solutions. | |
| Setting up the Registry → Securing and Exposing the Registry | Added clarification to the Exposing a Non-Secure Registry section. |
31.33. Tue Nov 01 2016
| Affected Topic | Description of Change |
|---|---|
| Updated the Sizing Considerations section for clarity. |
31.34. Thu Oct 27 2016
OpenShift Container Platform 3.3.1 release.
| Affected Topic | Description of Change |
|---|---|
| Upgrading a Cluster → Performing Automated In-place Cluster Upgrades | Minor updates for clarity, including converting some procedures into numbered steps for easier readability. |
31.35. Mon Oct 17 2016
| Affected Topic | Description of Change |
|---|---|
| Clarified Jenkins template names. | |
| Updated information in the Offerings by Subscription Type section on which images are provided by which subscription s. | |
|
Added more information to the |
31.36. Tue Oct 11 2016
| Affected Topic | Description of Change |
|---|---|
| Fixed error in Deploying the EFK Stack section. | |
| Added clarifying details to the Migrating Between SDN Plug-ins section about when to clean up SDN-specific artifacts. | |
| Configuring Persistent Storage → Persistent Storage Using Ceph Rados Block Device (RBD) | Updated the persistentVolumeReclaimPolicy setting to retain in the Persistent Volume Object Definition Using Ceph RBD example. |
|
Replaced |
31.37. Tue Oct 04 2016
| Affected Topic | Description of Change |
|---|---|
| Added clarifying details to the Migrating Between SDN Plug-ins section about when to clean up SDN-specific artifacts. | |
|
Added that | |
| Added troubleshooting guidance on Image Pruning Failures. | |
| Added information about disabling dnsmasq. | |
| Added example for a multi-master install with etcd on the same hosts. | |
| Configuring Persistent Storage → Persistent Storage Using Ceph Rados Block Device (RBD) | Updated the persistentVolumeReclaimPolicy setting to retain in the Persistent Volume Object Definition Using Ceph RBD example. |
| Persistent Storage Examples → Binding Persistent Volumes by Labels |
Updated the |
| Persistent Storage Examples → Complete Example Using GlusterFS | Updated the GlusterFS persistent storage example to use NGNIX instead of busybox. |
|
Fixed formatting of the | |
|
Removed |
31.38. Tue Sep 27 2016
OpenShift Container Platform 3.3 initial release.
| Affected Topic | Description of Change |
|---|---|
|
Added that | |
| Setting up the Registry → Securing and Exposing the Registry | Added two new sections on Exposing a Secure Registry and Exposing a Non-Secure Registry. |
| Added Configuring Navigation Menus section. | |
| Added troubleshooting guidance on Image Pruning Failures. | |
| Added a Audit Configuration section. | |
| Added information about disabling dnsmasq. | |
|
New topic reviewing how to back up and redeploy cluster certificates using the | |
| Added example for a multi-master install with etcd on the same hosts. | |
| Added capacity planning guidance for OpenShift Container Platform metrics. | |
| Updated scale recommendations. | |
| Updated the Multiple Masters Using HAProxy Inventory File example with guidance on applying updated node defaults. | |
| Updated version numbers for image streams across the Updating the Default Image Streams and Templates section. | |
| Persistent Storage Examples → Binding Persistent Volumes by Labels |
Updated the |
| Persistent Storage Examples → Complete Example Using GlusterFS | Updated the GlusterFS persistent storage example to use NGNIX instead of busybox. |
| Corrected instructions for enabling Jenkins auto-provision. | |
| Changed "Native Container Routing" topic to "Configuring Routing" and added information about Configuring Route Timeouts. | |
| Added clarifying details to the Warning box in the Persistent Elasticsearch Storage section regarding the NFS workaround. | |
| Added a new Update Your Configuration File section. | |
| Emphasized the new mandatory middleware configuration entries. | |
|
Extended the registry configuration file example within the Deploying Updated Configuration section to include the | |
| New topic providing an end-to-end example for binding persistent volume claims (PVCs) to persistent volumes (PVs) by defining labels in the PV and matching selectors in the PVC. | |
| New topic outlining how to bind persistent volumes claims (PVCs) to persistent volumes (PVs) via selector and label attributes. | |
| Added new topic. | |
| Added additional details to the Accessing Hawkular Metrics Directly section. | |
| Added a new Protecting Against DDoS Attacks section. | |
| New section. | |
| Added that the deserialization cache size can be reduced using a setting in master-config.yaml. | |
| Added information about configuration from configmaps, Fluentd, and Curator. | |
|
Edited references to | |
|
Fixed formatting of the | |
| Updated OAuth grant strategies information. | |
| Updated mandatory configuration options for the registry’s configuration file. | |
| Updated migration steps for SDN plug-ins. | |
| Added a Warning box about excluding roles from reconciliation. | |
| Added a new Metrics Deployer Validations section. | |
| Added recent image quota restrictions. |

Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.