The following sections aggregate the revision histories of each guide by publish date.

Fri Aug 18 2017

Table 1. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster → Advanced Installation

Added openshift_hosted_metrics_deployer_version and openshift_hosted_logging_deployer_version parameter usage. (BZ#1475880)

Installing a Cluster → Disconnected Installation

Corrected tag version for the metrics-deployer and logging-deployer images. (BZ#1475880)

Mon Aug 14 2017

Table 2. Installation and Configuration
Affected Topic Description of Change

Advanced Installation

Added information on configuring the default ports used by the master API and web console.

Table 3. Scaling and Performance Guide
Affected Topic Description of Change

Routing and Network Optimization

Added the Optimizing the MTU for Your Network section.

Table 4. Cluster Administration
Affected Topic Description of Change

Garbage Collection

Changed the image-gc-high-threshold default value to 85 from 90.

High Availability

Added verbiage clarifying the example outlined in the Configuring a Highly-available Service section.

Tue Aug 08 2017

Table 5. Installation and Configuration
Affected Topic Description of Change

Configuring the SDN

Added information about configuring Neutron to the Using Flannel section.

Router → Using the Default HAProxy Router

Added new section on how to manually redeploy the router certificates.

Fri Jul 28 2017

Table 6. Installation and Configuration
Affected Topic Description of Change

Redeploying Certificates

Added the Redeploying a New etcd CA section.

Thu Jul 27 2017

Table 7. CLI Reference
Affected Topic Description of Change

Administrator CLI Operations

Updated oadm commands to use oc adm instead.

Developer CLI Operations

Get Started with the CLI

Table 8. Architecture
Affected Topic Description of Change

Core Concepts → Routes

Added the Load-balancing Strategy section, as well as some minor rewordings.

Table 9. Cluster Administration
Affected Topic Description of Change

Setting Quotas

Updated the references to quota and limit ranges, as they are now listed on the Quota page.

Setting Limit Ranges

Updated the references to quota and limit ranges, as they are now listed on the Quota page.

Table 10. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster → Disconnected Installation

Added the openshift/hello-openshift dependency to the Syncing Repositories section.

Configuring Authentication and User Agent

Added a note about whitelisting users.

Installing a Cluster → Advanced Installation

Updated ]Known Issues to remove yum remove steps and instead link to Uninstalling OpenShift Container Platform.

Working with HTTP Proxies

Added note box about the limitations of the `no_proxy' variable acceptability.

Installing a Cluster → Advanced Installation

Added the Configuring the Firewall section.

Downgrading OpenShift

Updated the downgrading steps for clarity.

Tue Jul 18 2017

Table 11. Cluster Administration
Affected Topic Description of Change

Managing Security Context Constraints

Updated the Add an SCC to a User, Group, or Project section to add notes on granting SCC access and clarify project access.

Table 12. Developer Guide
Affected Topic Description of Change

Image Signatures

New topic about signing and verifying container image signatures.

Table 13. Architecture
Affected Topic Description of Change

Additional Concepts → Persistent Storage

Added details about the ReadWriteOnce access mode enforcement limitation and workaround instructions.

Web Console

Added the OSGi row to the JVM Console table in the JVM Console section.

Wed Jul 12 2017

Table 14. CLI Reference
Affected Topic Description of Change

Administrator CLI Operations

Added more information about the openshift binary.

Table 15. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster → Host Preparation

Replaced the deprecated openshift_master_portal_net variable with openshift_portal_net.

Installing a Cluster → Advanced Installation

Replaced the deprecated openshift_master_portal_net variable with openshift_portal_net.

Table 16. Developer Guide
Affected Topic Description of Change

Developer Guide → Integrating External Services

Added updatePeriodSeconds and intervalSeconds to the Consume a Service example with definitions.

Developer Guide → Deployment Stratecties

Added updatePeriodSeconds and intervalSeconds to the Rolling Deployment example with definitions.

Tue Jul 11 2017

Table 17. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.5 Release Notes

Added release notes for RHBA-2017:1640 - OpenShift Container Platform 3.5.5.31 Bug Fix Update.

Fri Jul 07 2017

Table 18. Release Notes
Affected Topic Description of Change

Overview

Clarified that "client" referred to the oc client.

OpenShift Container Platform 3.5 Release Notes

Added BZ#1466783 to Known Issues.

Table 19. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster → Advanced Installation

Added workaround for NO_PROXY issue. (BZ#1466783)

Installing a Cluster → Quick Installation

Upgrading a Cluster → Manual In-place Upgrades

Upgrading a Cluster → Automated In-place Upgrades

Thu Jul 06 2017

Table 20. Installation and Configuration
Affected Topic Description of Change

Enabling Controller-managed Attachment and Detachment

New topic on enabling controller-managed attachment and detachment.

Wed Jul 05 2017

Table 21. Cluster Administration
Affected Topic Description of Change

Cluster Administration → Setting Quotas

Removed unsupported limits.storage parameter.

Table 22. Developer Guide
Affected Topic Description of Change

Downward API

Updated annotation formatting in the Using the Volume Plug-in section.

Creating New Applications

Added Specifying Build Environment Variables section.

Table 23. Architecture
Affected Topic Description of Change

HAProxy Router Plug-in

Added the HAProxy Router Plug-in file, and made several updates to routes and networking sections throughout the documentation.

Thu Jun 29 2017

Table 24. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.5 Release Notes

Added release notes for RHBA-2017:1666 - atomic-openshift-utils Bug Fix and Enhancement Update.

Tue Jun 27 2017

Table 25. Installation and Configuration
Affected Topic Description of Change

Configuring for AWS

Updated the Example AWS Configuration with Ansible to include information on using IAM profiles.

Upgrading a Cluster → Blue-Green Deployments

Added an example new_nodes host group to the Creating and Labeling Green Nodes section.

Table 26. CLI Reference
Affected Topic Description of Change

Developer CLI Operations

Added information about the --generator option for the oc run command.

Table 27. Developer Guide
Affected Topic Description of Change

Authorization

Added the Authorization topic.

Thu Jun 22 2017

Table 28. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.5 Release Notes

Added release notes for RHBA-2017:1492 - OpenShift Container Platform 3.5.5.26 Bug Fix Update.

Added issued dates for all Asynchronous Errata Updates. (BZ#1463721)

Mon Jun 19 2017

Table 29. Developer Guide
Affected Topic Description of Change

Build Inputs

Added proxy warning for Jenkins in the Using a Proxy section.

Table 30. Administrator Solutions
Affected Topic Description of Change

Certificate Management

New topic about certificate management procedures.

Table 31. Scaling and Performance Guide
Affected Topic Description of Change

Routing and Network Optimization

Added the Optimizing IPSec section.

Wed Jun 14 2017

Table 32. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.5 Release Notes

Added release notes for RHBA-2017:1425 - OpenShift Container Platform 3.5.5.24 Bug Fix Update.

Tue Jun 13 2017

Table 33. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster → Advanced Installation

Added a step to verify that the etcd package is installed, if you installed multiple etcd hosts.

Table 34. Cluster Administration
Affected Topic Description of Change

Scheduler

Updated default scheduler policy in the Scheduler Policy section.

Table 35. Scaling and Performance Guide
Affected Topic Description of Change

Recommended Host Practices

Removed recommendation that the local etcd instance be listed first in master configuration.

Table 36. Developer Guide
Affected Topic Description of Change

Managing Images

Renamed section to Recommended Tagging Conventions and updated Image Tag Naming Conventions table.

Tue Jun 06 2017

Table 37. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster → Advanced Installation

Added Configuring Certificate Validity section and related variables to the Cluster Variables table.

Wed May 31 2017

Table 38. Installation and Configuration
Affected Topic Description of Change

Syncing Groups With LDAP

Added Nested Membership Sync Example.

Configuring Persistent Storage → Persistent Storage Using Azure File

New topic on provisioning a OpenShift Container Platform cluster with persistent storage using Azure File.

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.

Table 39. Using Images
Affected Topic Description of Change

Jenkins

Moved content to Jenkins Readme.md documentation and added links in the OpenShift Container Platform OAuth authentication section.

Thu May 25 2017

Table 40. Architecture
Affected Topic Description of Change

Core Concepts → Containers and Images

Added the Image Version Tag Policy section.

Table 41. Installation and Configuration
Affected Topic Description of Change

Upgrading a Cluster → Blue-Green Deployments

Added an animated graphic showing the blue-green deployment process.

Installing a Cluster → Advanced Installation

Fixed incorrect Ansible value to deployment_type.

Persistent Storage Examples → Complete Example Using Ceph RB

New Setting ceph-user-secret as Default for Projects section.

Configuring Authentication and User Agent

Noted that after making changes to an identity provider, you must restart the master service for the changes to take effect.

Configuring Persistent Storage → Persistent Storage Using Azure Disk

Added the Prerequisites section.

Configuring For Azure

Added the The Azure Configuration File section and some file example fixes.

Working with HTTP Proxies

Added the Using Maven Behind a Proxy section.

Table 42. Cluster Administration
Affected Topic Description of Change

Managing Security Context Constraints

Added a warning about pod creation on behalf of a user within the Grant Access to the Privileged SCC section.

Managing Networking

Added important box to the Using an Egress Router to Allow External Resources to Recognize Pod Traffic section.

Mon May 22 2017

Table 43. Container Security Guide
Affected Topic Description of Change

All topics

New guide providing a high-level walkthrough of the container security measures available in OpenShift Container Platform.

Thu May 18 2017

Table 44. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.5 Release Notes

Added release notes for RHBA-2017:1235 - OpenShift Container Platform 3.5.5.15 Bug Fix Update.

Mon May 15 2017

Table 45. Installation and Configuration
Affected Topic Description of Change

Upgrading a Cluster → Overview

Added clarification that nodes and masters are forward and backward compatible across one minor version.

Master and Node Configuration

Added information about openshift_master_audit_config to the Audit Configuration section.

Table 46. Cluster Administration
Affected Topic Description of Change

Garbage Collection

Updated the default value for the maximum-dead-containers setting in the Container Garbage Collection section.

Backup and Restore

Restored and updated steps for adding an etcd member.

High Availability

Removed numbering and added a title to Deploy IP Failover Pod in the Configuring a Highly-available Service section.

Table 47. Developer Guide
Affected Topic Description of Change

Environment Variables

Added Ignoring Source Files section.

Mon May 08 2017

Table 48. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster → Advanced Installation

Added a Configuring Deployment Type section.

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 region=infra label and to suggest configuring dedicated infrastructure nodes.

Tue May 02 2017

Table 49. Cluster Administration
Affected Topic Description of Change

Securing Builds by Strategy

Added that custom builds are disabled by default.

Table 50. Using Images
Affected Topic Description of Change

S2I (Source-to-Image) → .NET Core

Added a support statement about Visual Studio 2017.

Table 51. Architecture
Affected Topic Description of Change

Additional Concepts → F5 BIG-IP® Router Plug-in

Removed information about integration with HAProxy router.

Additional Concepts → F5 BIG-IP® Router Plug-in

F5 BIG-IP® Router Plug-in is now its own topic.

Table 52. Scaling Performance
Affected Topic Description of Change

Recommended Host Practices

Included a section on setting max pods per node.

Table 53. Installation and Configuration
Affected Topic Description of Change

Aggregating Container Logs

Noted that aggregated logging is only supported using the journald driver in Docker

Installing a Cluster → Advanced Installation

In the Configuring Cluster Metrics section, updated the openshift_metrics_install_metrics=true to be openshift_hosted_metrics_deploy.

Aggregating Container Logs

Added that the openshift_logging role labels nodes as part of the installation process.

Tue Apr 25 2017

Table 54. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.5 Release Notes

Added release notes for RHBA-2017:1129 - OpenShift Container Platform 3.5.5.8 Bug Fix and Enhancement Update.

Wed Apr 12 2017

OpenShift Container Platform 3.5 Initial Release

Table 55. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.5 Release Notes

Added release notes for initial release.

Added release notes for RHBA-2017:0903 - atomic-openshift-utils Bug Fix and Enhancement Update.

Table 56. Architecture
Affected Topic Description of Change

Infrastructure Components → Web Console

Added information about StatefulSet, currently a Technology Preview feature.

Core Concepts → Builds and Image Streams

Added link to OpenShift Image Streams and Templates library in the Image Streams section.

Core Concepts → Routes

Added more context to the Sticky Sessions section.

Added ROUTER_SLOWLORIS_HTTP_KEEPALIVE to the Router Configuration Parameters table.

New Disabling the Namespace Ownership Check section.

Added information on how to clear route status.

Added ROUTER_MAX_CONNECTIONS to the Router Configuration Parameters table.

Added ROUTER_CANONICAL_HOSTNAME to the list of route variables.

Added details about insecureEdgeTerminatePolicy in regard to reencrypt and passthrough routes.

Updated router customization details.

Additional Concepts → Persistent Storage

Added a Storage Class section.

Table 57. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster → Prerequisites

Specified the UDP for port 4789.

Installing a Cluster → Host Preparation

Added rhel-7-fast-datapath-rpms to the list of repositories to be enabled.

Installing a Cluster → Advanced Installation

In the Known Issues multiple masters discussion, included the docker-common package in the removal process, following a failed setup play.

Added information about deploying metrics using the ansible role openshift_metrics.

Setting up the Registry → Extended Registry Configuration

Added details about mirroring of blobs.

Setting up a Router → Using the Default HAProxy Router

Added graphics to the Using Router Shards section.

Added a new section about Setting the Maximum Number of Concurrent Connections.

Setting up a Router → Deploying a Customized HAProxy Router

Expanded details in the Rebuilding Your Router section.

Setting up a Router → Using the F5 Router Plug-in

Added the Finding the Hostname of the Router section

Specified that F5 virtual servers must be configured by users as a prerequisite.

Upgrading a Cluster → Performing Manual In-place Cluster Upgrades

Added rhel-7-fast-datapath-rpms to the list of repositories to be enabled.

Upgrading a Cluster → Automated In-place Cluster Upgrades

Added the Customizing Upgrades With Ansible Hooks section.

Added rhel-7-fast-datapath-rpms to the list of repositories to be enabled.

Redeploying Certificates

Updated for new set of playbooks and options.

Configuring Authentication and User Agent

Updated authentication proxy requirements in Request Header.

Added information about the ability include a list of one or more GitHub teams to which a user must have membership in order to authenticate.

Configuring Persistent Storage → Persistent Storage Using GlusterFS

Added Container Native Storage Recommendations.

Configuring Persistent Storage → Dynamic Provisioning and Creating Storage Classes

Added information about Trident from NetApp.

Persistent Storage Examples → Complete Example of Dynamic Provisioning Using Dedicated GlusterFS

New topic with a full dynamic provisioning example using a dedicated Gluster cluster.

Configuring Native Container Routing

Separated the Configuring Native Container Routing content from the Configuring Route Timeouts topic.

Configuring for OpenStack

Added openshift_cloudprovider_openstack_domain_id and openshift_cloudprovider_openstack_domain_name to the list of configurable parameters.

Configuring Global Build Defaults and Overrides

Added information to the Manually Setting Global Build Defaults example about adding default resources to BuildConfig.

Added and organized information on configuring global build overrides.

Aggregating Container Logs

Added content to reference Ansible Logging updates.

Aggregate Logging Sizing Guidelines

Added content to reference Ansible Logging updates.

Enabling Cluster Metrics

Added metrics recommendations for OpenShift Container Platform version 3.5.

Added more details to the Specifying Metrics Ansible Variables section.

Added content on deploying the agent to the default project in the Deploying the Hawkular OpenShift Agent section.

Added the Deploying the Hawkular OpenShift Agent section.

Added information about deploying metrics using the ansible role openshift_metrics.

Customizing the Web Console

Added a new section on enabling wildcard routes in the web console.

Updated the Changing Links to Documentation section to include information about customizing documentation links with a base URL.

Table 58. Administrator Solutions
Affected Topic Description of Change

Authentication

Added information about the ability include a list of one or more GitHub teams to which a user must have membership in order to authenticate.

Table 59. Cluster Administration
Affected Topic Description of Change

Managing Nodes

Fixed markup error in the examples in the Setting Maximum Pods Per Node section.

Managing Networking

Created the Managing Networking topic and added the Enabling Multicast and Enabling NetworkPolicy sections.

Managing Security Context Constraints

Added information about preserving labels and annotations, in addition to groups.

High Availability

In the Check and Notify Scripts section, added that the defaultMode for the mounted configMap files must allow execution.

In the Check and Notify Scripts section, added that when using the oadm ipfailover command, the user check script overrides the default.

Added new options to oadm ipfailover to configure the check and notify scripts and to control the period of time the check script runs.

Troubleshooting OpenShift SDN

Added that the ipf-debug.sh script can be used for debugging IP failover problems.

Table 60. Scaling and Performance Guide
Affected Topic Description of Change

All topics

New guide on recommended practices for building, scaling, and tuning OpenShift Container Platform clusters.

Table 61. CLI Reference
Affected Topic Description of Change

Developer CLI Operations

Added information about oc start-build --from-file and oc start build --from-dir.

Table 62. Developer Guide
Affected Topic Description of Change

Application Life Cycle Management → Creating New Applications

Added golang to the Languages Detected by new-app table.

Added information about --param-file and --env-file oc command arguments to the Template Parameters section.

Added information about the pipeline build strategy.

Noted that any BuildConfig objects created as part of oc new-app processing will not be updated with environment variables passed via the --e|--env argument.

Builds → Build Inputs

Clarified when URLs can be used with binary builds.

Added details about the build.openshift.io/source-secret-match-uri- annotation.

Added information about using URLs with oc start-build --from-file and oc start build --from-dir.

Templates

Added link to OpenShift Image Streams and Templates library in the Overview section.

Updated the NOTE box about updating template namespace behavior in the Object List section to reflect parameter support.

Added information about --param-file and working with a large number of parameters to the Parameters section.

Managing Images

Added new sections about the Insecure Tag Import Policy and Reference Policy.

Quotas and Limit Ranges

Added a new section on Opaque Integer Resources.

Secrets

Added information about expiration to the Service Serving Certificate Secrets section.

Cron Jobs

Changed instances of "Scheduled jobs" to "Cron jobs".

Create from URL

New topic on Create from URL, a function that allows you to construct a URL from an image stream, image tag, or template.

Table 63. Using Images
Affected Topic Description of Change

Database Images → MariaDB

New topic on the MariaDB database image.

Other Images → Jenkins

Clarified information about non-browser access to the OpenShift Container Platform OAuth Authentication section.