×

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

Wed Mar 07 2018

Table 1. Installation and Configuration
Affected Topic Description of Change

Aggregating Container Logs

Added to instructions to scale EFK pods when changes are made in the Understanding and Adjusting the Deployment section.

Tue Nov 21 2017

Table 3. Installation and Configuration
Affected Topic Description of Change

Installation and Configuration → Planning

Added a new section on installing a Single Master and Node on One System.

Fri Nov 03 2017

Table 4. Installation and Configuration
Affected Topic Description of Change

Configuring Global Build Defaults and Overrides

Added a note on limiting how long pods can run and a link to RunOnceDuration plugin.

Wed Oct 25 2017

Mon Oct 16 2017

Table 6. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster → Advanced Installation

Clarified required port for VIP and added note that HAProxy router is not for production environments in Multiple Masters Example.

Upgrading a Cluster → Performing Manual In-place Cluster Upgrades

Added a step in Preparing for a Manual Upgrade section to obtain the latest image stream.

Upgrading a Cluster → Performing Automated In-place Cluster Upgrades

Added a step in Preparing for an Automated Upgrade section to obtain the latest image stream.

Table 7. Developer Guide
Affected Topic Description of Change

Manging Images

Clarified wording around Image Streams and added new section on Adding Trusted Certificates for External Registries.

Wed Oct 11 2017

Table 8. Installation and Configuration
Affected Topic Description of Change

Aggregating Container Logs

Added the openshift_logging_es_number_of_replicas and openshift_logging_es_number_of_shards variables to the table in Specifying Logging Ansible Variables.

Installing a Cluster → Advanced Installation

Added the Configuring Registry Storage section.

Fri Sep 22 2017

Table 9. Installation and Configuration
Affected Topic Description of Change

Advanced Installation

Added a note that the default HAProxy load balancer is intended for non-production environments.

Configuring Authentication and User Agent

Added information on manually provisioning a user and identity when using the lookup mapping method for authenticating.

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

Removed the deprecated --credentials option from the Setting Up F5 Native Integration section.

Installing a Cluster → Disconnected Installation

Added a note to the Syncing Images section about the need for ose-recycler when using NFS.

Redeploying Certificates

Added a note to the Redeploying Certificates section about certificate expiration.

Mon Sep 18 2017

Table 10. Cluster Administration
Affected Topic Description of Change

Setting Limit Ranges

Added link to information on how CPU and memory are calculated.

Table 11. Developer Guide
Affected Topic Description of Change

Integrating External Services

Added context and use cases for the ExternalName parameter.

Managing Images

Noted that importPolicy.scheduled is disabled by default.

Table 12. Installation and Configuration
Affected Topic Description of Change

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

Added to the Prerequisites and Supportability section with supportability information.

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

Added an F5 support statement

Securing the Registry

Updated commands for registry installation.

Extended Registry Configuration

Updated commands for registry installation and added steps to use a ConfigMap not secrets to override registry defaults.

Accessing the Registry

Updated commands for registry installation.

Table 13. Getting Started
Affected Topic Description of Change

Administrators: Setting Up a Cluster

Changed the tag command to mark a new image as being desired for deployment.

Thu Sep 07 2017

Table 14. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.4 Release Notes

Added release notes for RHBA-2017:2670 - OpenShift Container Platform 3.4.1.44.17 Bug Fix Update.

Wed Sep 06 2017

Table 15. Developer Guide
Affected Topic Description of Change

Routes

Added a file path to the unsecured route CLI example in the Creating Routes section.

Table 16. Installation and Configuration
Affected Topic Description of Change

Using the Default HAProxy Router

Added information on needing separate DNS entries for routing shards to the Using Router Shards section.

Thu Aug 31 2017

Table 17. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.4 Release Notes

Added release notes for RHBA-2017:1828 - OpenShift Container Platform 3.4.1.44 Bug Fix Update.

Mon Aug 28 2017

Table 18. Architecture
Affected Topic Description of Change

Additional Concepts → OpenShift SDN

Corrected vxlan0 to vxlan_sys_4789 in the Design on Nodes section.

Table 19. Installation & Configuration
Affected Topic Description of Change

Aggregating Container Logs

Corrected the link to the logging yaml file example in the Specifying Logging Ansible Variables section.

Master and Node Configuration

Expanded openshift_master_audit_config details.

Installing a Cluster → Advanced Installation

Added openshift_master_audit_config details.

Table 20. Cluster Administration
Affected Topic Description of Change

Image Policy

Added note clarifying the need for the image prefix to set the default registry string in the Configuring the ImagePolicy Admission Plug-in section.

Pruning Objects

Added valid units of measurement for --keep-younger-than.

Troubleshooting OpenShift SDN

Changed the Further Help section to Finding Network Issues Using the Diagnostics Tool and added information about the Diagnostic Tool.

Troubleshooting OpenShift SDN

Corrected vxlan0 to vxlan_sys_4789 in the Debugging Local Networking section.

Fri Aug 25 2017

Table 21. Installation & Configuration
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.

Table 22. Developer Guide
Affected Topic Description of Change

Using Daemonsets

Removed Technology Preview notice.

Tue Aug 22 2017

Table 23. Architecture
Affected Topic Description of Change

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

Added information about the necessary F5 BIG-IP® versions to the F5 Native Integration section.

Tue Aug 15 2017

Table 24. 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 25. Cluster Administration
Affected Topic Description of Change

High Availability

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

Tue Aug 08 2017

Table 26. Installation and Configuration
Affected Topic Description of Change

Router → Using the Default HAProxy Router

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

Configuring the SDN

Added information about configuring Neutron to the Using Flannel section.

Fri Jul 28 2017

Table 27. Installation and Configuration
Affected Topic Description of Change

Redeploying Certificates

Added the Redeploying a New etcd CA section.

Thu Jul 27 2017

Table 28. 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 29. Architecture
Affected Topic Description of Change

Core Concepts → Routes

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

Table 30. 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 31. 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 ../install_config/install/advanced_install.htmlKnown Issues] to remove yum remove steps and instead link to Uninstalling OpenShift Container Platform.

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.

Tue Jul 18 2017

Table 32. 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 33. Developer Guide
Affected Topic Description of Change

Image Signatures

New topic about signing and verifying container image signatures.

Table 34. 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 35. CLI Reference
Affected Topic Description of Change

Administrator CLI Operations

Added more information about the openshift binary.

Table 36. 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 37. 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 38. Release Notes
Affected Topic Description of Change

Overview

Clarified that "client" referred to the oc client.

OpenShift Container Platform 3.4 Release Notes

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

Thu Jul 06 2017

Table 39. 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 40. Cluster Administration
Affected Topic Description of Change

Cluster Administration → Setting Quotas

Removed unsupported limits.storage parameter.

Table 41. Developer Guide
Affected Topic Description of Change

Downward API

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

Thu Jun 29 2017

Table 42. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.4 Release Notes

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

Thu Jun 22 2017

Table 43. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.4 Release Notes

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

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

Mon Jun 19 2017

Table 44. Developer Guide
Affected Topic Description of Change

Build Inputs

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

Table 45. Administrator Solutions
Affected Topic Description of Change

Certificate Management

New topic about certificate management procedures.

Wed Jun 14 2017

Table 46. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.4 Release Notes

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

Tue Jun 13 2017

Table 47. 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 48. Cluster Administration
Affected Topic Description of Change

Scheduler

Updated default scheduler policy in the Scheduler Policy section.

Table 49. Developer Guide
Affected Topic Description of Change

Managing Images

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

Wed May 31 2017

Table 50. 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 51. 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 52. Architecture
Affected Topic Description of Change

Core Concepts → Containers and Images

Added the Image Version Tag Policy section.

Table 53. Installation and Configuration
Affected Topic Description of Change

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 54. 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.

Thu May 18 2017

Table 55. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.4 Release Notes

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

Mon May 15 2017

Table 56. 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 57. 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.

Mon May 08 2017

Table 58. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster → Advanced Installation

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.

Added a Configuring Deployment Type section.

Tue May 02 2017

Table 59. Cluster Administration
Affected Topic Description of Change

Securing Builds by Strategy

Added that custom builds are disabled by default.

Table 60. Using Images
Affected Topic Description of Change

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

Added a support statement about Visual Studio 2017.

Table 61. 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.

Tue Apr 25 2017

Table 62. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.4 Release Notes

Added release notes for RHBA-2017:0989 - OpenShift Container Platform 3.4.1.16 Bug Fix Update and RHBA-2017:1129 - OpenShift Container Platform 3.4.1.18 Bug Fix Update.

Table 63. Installation and Configuration
Affected Topic Description of Change

Redeploying Certificates

Updated for new set of playbooks and options.

Wed Apr 12 2017

Table 64. Cluster Administration
Affected Topic Description of Change

Managing Security Context Constraints

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

Managing Nodes

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

Table 65. Using Images
Affected Topic Description of Change

MariaDB

Added MariaDB section.

Table 66. Architecture
Affected Topic Description of Change

Core Concepts → Routes

Updated router customization details.

Table 67. Installation and Configuration
Affected Topic Description of Change

Setting up a Router → Using the Default HAProxy Router

Added graphics to the Using Router Shards section.

Setting up a Router → Deploying a Customized HAProxy Router

Expanded details in the Rebuilding Your Router section.

Installing a Cluster → Prerequisites

Specified the UDP for port 4789.

Installing → Advanced Installation

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

Configuring for OpenStack

Added openshift_cloudprovider_openstack_domain_id and openshift_cloudprovider_openstack_domain_name to the list of configurable parameters.

Fri Apr 07 2017

Table 68. Installation and Configuration
Affected Topic Description of Change

Upgrading a Cluster → Automated In-place Upgrades

Removed workaround for atomic-openshift-docker-excluder package upgrades. (BZ#1430929)

Upgrading a Cluster → Manual In-place Upgrades

Upgrading a Cluster → Operating System Updates and Upgrades

Wed Apr 05 2017

Table 69. Using Images
Affected Topic Description of Change

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

Added .NET Core supported environment variables and added information about templates.

Tue Mar 14 2017

Affected Topic Description of Change

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

Updated supported version number.

Wed Jan 18 2017

OpenShift Container Platform 3.4 initial release.

Affected Topic Description of Change

Source-to-Image (S2I) → Customizing S2I Images

New topic about customizing the behavior of an S2I builder that includes default scripts.

Other Images → Jenkins

Added the Jenkins Standard Authentication section.

Mon Apr 03 2017

Table 70. Installation and Configuration
Affected Topic Description of Change

Advanced Installation

Added the debug_level parameter to the Configuring Cluster Variables section for setting the default verbosity of journald log messages.

Master and Node Configuration

Added a new section on configuring the verbosity of journald log messages.

Installing a Cluster → Advanced Installation

Added a Configuring Cluster Logging section.

Upgrading a Cluster → Performing Manual In-place Cluster Upgrades

Added a NOTE box about verifying the cluster health before upgrading.

Upgrading a Cluster → Performing Automated In-place Cluster Upgrades

Added a NOTE box about verifying the cluster health before upgrading.

Setting Up a Registry → Extended Registry Configuration

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.

Redeploying Certificates

Added Registry and Router Certificates section with instructions on redeploying these certificates manually.

Upgrading a Cluster → Blue-Green Deployments

Enhanced and re-organized entire topic for clarity.

Table 71. Developer Guide
Affected Topic Description of Change

Secrets

Added more details to the Service Serving Certificate Secrets section.

Quotas and Limit Ranges

Removed "m" as a valid suffix for memory in the Compute Resources section.

Mon Mar 27 2017

Table 72. Installation and Configuration
Affected Topic Description of Change

Downgrading OpenShift

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.

Table 73. Cluster Administration
Affected Topic Description of Change

Setting Limit Ranges

Added the missing -n demoproject option to the oc describe limits example and updated the command’s output.

Backup and Restore

Updated the backup and restore procedure.

Wed Mar 22 2017

Table 74. Installation and Configuration
Affected Topic Description of Change

Upgrading a Cluster → Automated In-place Upgrades

Added a workaround for atomic-openshift-docker-excluder package upgrades. (BZ#1430929)

Upgrading a Cluster → Manual In-place Upgrades

Upgrading a Cluster → Operating System Updates and Upgrades

Mon Mar 20 2017

Table 75. Architecture
Affected Topic Description of Change

Core Concepts → Routes

Added the Denying or Allowing Certain Domains in Routes section.

Additional Concepts → Flannel

Updated the topic with information on OpenStack installs, running Flannel in host-gw mode, and a diagram with route examples.

Table 76. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster → Prerequisites

Added Network Time Protocol (NTP) as a prerequisite.

Configuring Authentication and User Agent

Added information on using the htpasswd command to generate hashed passwords for HTPasswd authentication to the HTPasswd section.

Installing a Cluster → Installing on Containerized Hosts

Updated the Installing on Containerized Hosts topic to promote the information on installing on containerized hosts.

Installing a Cluster → Containerized Components

Added paragraph about the rhel7/etcd image with containerized installs.

Installing a Stand-alone Registry

Added openshift_master_default_subdomain to the openshift_master_default_subdomain file in the Advanced Installation for Stand-alone Registries section.

Configuring the SDN

Added information about the flannel_interface variable.

Table 77. Administrator Solutions
Affected Topic Description of Change

Master and Node Configuration

Added information on using the htpasswd command to generate hashed passwords for HTPasswd authentication to the Making Configuration Changes Using Ansible section.

Table 78. Cluster Administrator
Affected Topic Description of Change

Managing Nodes

Added the Setting Maximum Pods Per Node section.

Managing Authorization Policies

Updated the ClusterRole file in the Granting Users Daemonset Permissions section.

Table 79. Developer Guide
Affected Topic Description of Change

Routes

Added comment regarding not supporting password protected key files to the Creating Routes section.

Wed Mar 15 2017

Table 80. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.4 Release Notes

Added release notes for RHBA-2017:0512 - OpenShift Container Platform 3.4.1.10 Bug Fix Update.

Tue Mar 14 2017

Table 81. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster → Prerequisites

Renamed instances of openshift_node_set_node_ip to openshift_set_node_ip, the correct openshift-ansible variable name.

Installing a Cluster → Disconnected Installation

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.

Setting up the Registry → Known Issues

Added note recommending moving off NFS for production in the Image Push Errors with Scaled Registry Using Shared NFS Volume section.

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

Updated the example in the Deploying the F5 Router section to reflect host-network set to false.

Upgrading a Cluster → Performing Manual In-place Cluster Upgrades

Removed a repetitive step within the Updating the Default Image Streams and Templates section.

Upgrading a Cluster → Operating System Updates and Upgrades

Added the procedure for upgrading the operating system.

Configuring Persistent Storage → Persistent Storage Using GlusterFS

Added note about managing volumes using Heketi to the Dedicated Storage Gluster section.

Aggregating Container Logs

Removed the v from 3.4.1 in the Deploying the EFK Stack section.

Enabling Cluster Metrics

Added step to enable view permissions for Hawkular Metrics Deployer Service Account section.

Table 82. Cluster Administration
Affected Topic Description of Change

Managing Nodes

Renamed instances of openshift_node_set_node_ip to openshift_set_node_ip, the correct openshift-ansible variable name.

Restricting Application Capabilities Using Seccomp

Updated Seccomp references of runtime/default to be docker/default.

Table 83. Developer Guide
Affected Topic Description of Change

Secrets

Added an example YAML file of a secret that will create four files.

Table 84. Using Images
Affected Topic Description of Change

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

Updated supported version number.

Mon Mar 06 2017

Table 85. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.4 Release Notes

Added release notes for RHSA-2017:0448 - ansible and openshift-ansible Security and Bug Fix Update.

Table 86. Architecture
Affected Topic Description of Change

Core Concepts → Routes

Clarified that hostsubnet requires a specific annotation for multi-tenancy to work.

Table 87. Cluster Administration
Affected Topic Description of Change

Encrypting Hosts with IPsec

Re-added the Encrypting Hosts with IPsec topic and made it specific to the current version of libreswan.

Managing Pods

Added information and arranged the Controlling Egress Traffic section.

Table 88. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster → Advanced Installation

Updated Before You Begin section to raise minimal Ansible version to 2.2.0.

Provided guidance for preconfigured loadbalancers for OpenShift Container Platform with high availability.

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

Clarified that hostsubnet requires a specific annotation for multi-tenancy to work.

Redeploying Certificates

Added the Checking Certificate Expirations section.

Aggregating Container Logs

Added a Warning admonition recommending the use of the default value for use-journal and added a new Updating Fluentd’s Log Source After a Docker Log Driver Update section.

Fri Feb 24 2017

Table 89. Creating Images
Affected Topic Description of Change

Guidelines

Updated the commands in the Support Arbitrary User IDs section to enable root group access in the Dockerfile.

Wed Feb 22 2017

Table 90. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.4 Release Notes

Added release notes for RHBA-2017:0289 - OpenShift Container Platform 3.4.1.7 Bug Fix Update.

Table 91. Developer Guide
Affected Topic Description of Change

Builds

Thu Feb 16 2017

Table 92. Architecture
Affected Topic Description of Change

Infrastructure Components → Web Console

Removed the Technical Preview note from the JVM Console section.

Core Concepts → Routes

Edited out the ROUTE_LABELS environment variable to allighn with upstream.

Added descriptions for ROUTER_ALLOWED_DOMAINS and ROUTER_DENIED_DOMAINS in the Router Configuration Parameters table.

Table 93. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster→ Disconnected Installation

Added the cluster image to the Syncing Images section.

Setting up a Router → Using the Default HAProxy Router

Added the Filtering Routes to Specific Routers section.

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

Arranged the topic and added a Prerequisites 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 --hostnames flag.

Master and Node Configuration

Fixed the options for creating a configuration file in the Creating New Configuration Files section.

Configuring Persistent Storage → Volume Security

Added details about RunAsAny FSGroup and block device permissions.

Aggregating Container Logs

Fixed example in the Configuring Fluentd to Send Logs to an External Log Aggregator section.

Added a version variable and <tag> to code block example in Deploying the EFK Stack section to display the correct current version to use.

Table 94. Cluster Administration
Affected Topic Description of Change

Managing Pods

Added more information about disabling MAC filtering for the Egress router.

Aggregating Container Logs

Added a requirement that port 9300 be open for Elasticsearch to the Pre-deployment Configuration section.

High Availability

Added a step for deploying the ipfailover router to monitor postgresql listening to the Configuring a Highly-available Service section

Table 95. CLI Reference
Affected Topic Description of Change

Expose

Added additional information about the generator parameter in the Expose section.

Table 96. Developer Guide
Affected Topic Description of Change

Secrets

Corrected an example YAML file and added missing steps.

Using Persistent Volumes

Added a new Volume and Claim Pre-binding section

Service Serving Certificate Secrets

Added a note to the Service Serving Certificate Secrets section clarifying the use of the service DNS name.

Getting Traffic into the Cluster

Added more details about Ingress.

Thu Feb 09 2017

Table 97. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.4 Release Notes

Added release notes for RHBA-2017:0268 - OpenShift Container Platform 3.4.1.5 Bug Fix Update.

Added an etcd performance issue to Known Issues.

Table 98. Installation and Configuration
Affected Topic Description of Change

Upgrading a Cluster → Manual In-Place Upgrades

Added an Important admonition about an etcd performance issue.

Upgrading a Cluster → Automated In-Place Upgrades

Upgrading a Cluster → Blue-Green Deployments

Mon Feb 06 2017

Table 99. Architecture
Affected Topic Description of Change

Core Concepts → Routes

Added a new F5 Native Integration section.

Additional Concepts → OpenShift SDN

Updated OpenShift SDN information.

Table 100. Installation and Configuration
Affected Topic Description of Change

Upgrading a Cluster → Manual Upgrades

Updated file paths to the logging and metrics deployer templates to their new OpenShift Container Platform 3.4 locations.

Setting up the Registry → Deploying a Registry on Existing Clusters

Aggregating Container Logs

Enabling Cluster Metrics

Installing a Cluster → Host Preparation

Added steps on using yum-config-manager to the host registration steps.

Installing a Cluster → Advanced Installation

Added the Configuring a Registry Location section.

Setting up the Registry → Deploying a Registry on Existing Clusters

Added Important admonition about shutting down Cockpit to the Non-Production Use section.

Arranged the Securing the Registry Console section to include information on the certificate.

Setting up a Router → Using the Default HAProxy Router

Arranged the topic to create the Creating a Router section, and added a paragraph on router options on creation.

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

Added a new Setting Up F5 Native Integration section.

Configuring Nuage SDN

Added the Configuring Nuage SDN topic.

Persistent Storage Examples → Complete Example Using GlusterFS

Added a link to the Complete Example of Dynamic Provisioning Using GlusterFS.

Clarified that, if using a service, the endpoints name must match the service name.

Enabling Cluster Metrics

Updated Cluster Metrics sizing recommendations for the new version of OpenShift Container Platform.

Customizing the Web Console

Removed information about Pipelines being a feature in Technology Preview.

Table 101. Cluster Administration
Affected Topic Description of Change

Troubleshooting OpenShift SDN

Updated OpenShift SDN information.

Handling Out of Resource Errors

Added clarifying details around kubeletArguments in the Example Scenario section.

Table 102. Developer Guide
Affected Topic Description of Change

Service Serving Certificate Secrets

Removed Tech Preview note from the Service Serving Certificate Secrets section.

Tue Jan 31 2017

Table 103. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.4 Release Notes

Added release notes for RHBA-2017:0218 - OpenShift Container Platform 3.4.1.2 Bug Fix Update.

Mon Jan 30 2017

Table 104. Installation and Configuration
Affected Topic Description of Change

Setting up the Registry → Securing and Exposing the Registry

Removed references to the deprecated --api-version flag.

Configuring Custom Certificates

Clarified custom certificate configuration locations in the Configuring Custom Certificates section.

Table 105. Developer Guide
Affected Topic Description of Change

Builds → Build Strategy Options

Updated the example Dockerfile path to point to a file, not a directory.

Managing Environment Variables

Removed redundant information and CLI reference material; rearranged sections to match user process.

Wed Jan 25 2017

Table 106. Architecture
Affected Topic Description of Change

Core Concepts → Pods and Services

Updated Ingress CIDR references to the new default.

Table 107. Installation and Configuration
Affected Topic Description of Change

Working with HTTP Proxies

Added step to Proxying Docker Pull for finding the registry service IP.

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

Removed references to the deprecated --credentials option.

Installing a Cluster → Prerequisites

Added information about required ports for Aggregated Logging.

Configuring Global Build Defaults and Overrides

Added notes to explain additional values in the /etc/origin/master/master-config.yaml file in the Manually Setting Global Build Defaults section.

Aggregate Logging Sizing Guidelines

Updated scale testing guidelines.

Customizing the Web Console

Added information about setting extension properties.

Configuring Persistent Storage → Dynamic Provisioning and Creating Storage Classes

Added additional details to the glusterfs-storageclass.yaml file example in the GlusterFS Object Definition section.

Master and Node Configuration

Updated the Audit Configuration section description and added Audit Configuration Parameters.

Table 108. Cluster Administration
Affected Topic Description of Change

Monitoring Routers

Removed references to the deprecated --credentials option.

High Availability

Removed references to the deprecated --credentials option.

Pruning Objects

Added a NOTE box to the Pruning Images section explaining that pruning images with the --namespace flag does not remove images.

Configuring the Cluster to Use Unique External IPs

Added a CAUTION box indicating that external IPs assigned to services of type LoadBalancer will always be in the range of ingressIPNetworkCIDR and updated Ingress CIDR references to the new default.

Managing Pods

Added clarifying details around EgressNetworkPolicy, including that it only affects external traffic (not pod-to-pod traffic) and that you can only have a single EgressNetworkPolicy in a namespace; added additional details about rule ordering and that breaking the rules can result in all egress traffic from the namespace being dropped.

Table 109. CLI Reference
Affected Topic Description of Change

Administrator CLI Operations

Removed references to the deprecated --credentials option.

Developer CLI Operations

Removed reference to the deprecated oc env command.

Table 110. Developer Guide
Affected Topic Description of Change

Builds → Basic Build Operations

Updated a Note box in the Accessing Build Logs section advising that the build defaults for an administrator can be overridden for non-binary builds by passing --build-loglevel to oc start-build.

Tue Jan 24 2017

Table 111. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.4 Release Notes

Added release notes for RHBA-2017:0186 - OpenShift Container Platform 3.4.0.40 Bug Fix Update.

Added BZ#1415570 to Known Issues.

Wed Jan 18 2017

OpenShift Container Platform 3.4 initial release.

Table 112. Release Notes
Affected Topic Description of Change

OpenShift Container Platform 3.4 Release Notes

Added release notes for initial release.

Table 113. Architecture
Affected Topic Description of Change

Core Concepts → Containers and Images

New section about init containers.

Core Concepts → Builds and Image Streams

Added information on how the first time a project defines a build configuration using a Pipeline strategy, OpenShift Container Platform instantiates a Jenkins server to execute the pipeline.

Added new Image Stream Image and Image Stream Tag sections.

Added a link for more details on how the Jenkins server is deployed.

Core Concepts → Routes

Added descriptions of all route annotations.

Added two new parameters under Configuration Parameters in the HAProxy Template Router section.

Added a new Creating Routes Specifying a Wildcard Subdomain Policy section.

Additional Concepts → Authentication

Added new Service Accounts as OAuth Clients and OAuth Server Metadata sections.

Table 114. Installation and Configuration
Affected Topic Description of Change

Installing a Cluster → Prerequisites

Added sizing guidelines for etcd service nodes within the Minimum Hardware Requirements table.

Setting up the Registry → Securing and Exposing the Registry

Added a Note admonition about mounting secrets to service accounts.

Setting up the Registry → Extended Registry Configuration

Updated with new oc rollout commands.

Setting up a Router → Using the Default HAProxy Router

Added the ARP Cache Tuning for Large-scale Clusters section.

Added information about security caveats and ownership claims of host names and subdomains.

Added a new Using Wildcard Routes (for a Subdomain) section.

Adding Hosts to an Existing Cluster

Updated quick installer instructions to use the new scaleup command.

Configuring Authentication and User Agent

Clarified the difference between /api and /oapi in the User Agent section.

Configuring for Azure

New topic on how OpenShift Container Platform can be configured to access an Azure infrastructure, including using Azure disk as persistent storage] for application data.

Configuring Persistent Storage → Persistent Storage Using Azure Disk

New topic on how to provision your OpenShift Container Platform cluster with persistent storage using Azure.

Persistent Storage Examples → Complete Example of Dynamic Provisioning Using GlusterFS

New topic providing an end-to-end example of how to dynamically provision GlusterFS volumes.

Configuring Pipeline Execution

Added information about setting up an external Jenkins server.

Configuring Global Build Defaults and Overrides

Added examples for node selectors in build configurations.

Configuring Persistent Storage → Volume Security

Removed nfsnobody references.

Configuring Global Build Defaults and Overrides

Added image label example to build file examples.

Configuring Pipeline Execution

Noted that for jenkinsPipelineConfig, the autoProvisionEnabled value defaults to true if unspecified.

Aggregating Container Logs

Updated with new oc rollout commands.

Added clarification regarding ConfigMaps and output of oc new-app.

Customizing the Web Console

Added the Configuring Catalog Categories section.

Table 115. Cluster Administration
Affected Topic Description of Change

Managing Pods

Updated the EgressNetworkPolicy example in the Configuring Pod Access Limits section.

Added a new Setting Pod Disruption Budgets section, which allows the specification of safety constraints on pods during operations.

Setting Quotas

Added information for the requests.storage value and a storage-consumption.yaml example.

Setting Limit Ranges

Updated the PVC limit range within the Limit Range Object Definition example.

Added the PersistentVolumeClaim Limits section.

Pruning Objects

Added a new Image Pruning Problems section, which describes possible issues with image pruning and how to avoid them with more generic tag naming.

Handling Out of Resource Errors

Added information about disk-based eviction.

Table 116. Developer Guide
Affected Topic Description of Change

Projects

Added a new Bookmarking Page States section, which discusses that OpenShift Container Platform now bookmarks page states, which is helpful in saving label filters.

Application Tutorials → Setting Up a Nexus Mirror for Maven

New topic on setting up a containerized Nexus repository for Maven dependency caching.

Templates

Added details about template writing for the best user experience.

Added examples of a template object definition, template description metadata, template object labels, generating a parameter value, setting an explicit value as the default value, and a full template with parameter definitions and references,

Builds → Build Ouput

Added example for custom build image label.

Builds → Build Strategy Options

Added new sections on adding secrets to Source Strategy, Docker Strategy, and Custom Strategy build configurations from the web console.

Builds → Triggering Builds

Added a note box to the Generic Webhooks section explaining that OpenShift Container Platform permits builds to be triggered via the generic webhook even if an invalid request payload is presented.

Builds → Advanced Build Operations

Added the Assigning Builds to Specific Nodes section.

Managing Images

Added a new Tag Naming section reviewing recommended conventions and best practices when naming tags.

Added a new Writing Image Streams for S2I Builders section.

Deployments → Basic Deployment Operations

Updated with new oc rollout commands.

Added a new Adding Secrets to Deployment Configurations from the Web Console section.

Deployments → Kubernetes Deployments Support

New topic detailing Technology Preview support for the new Kubernetes-provided deployments object type.

Secrets

Added details about stringData for secrets.

Managing Images

Added information about the supports annotation on image streams.

Table 117. Using Images
Affected Topic Description of Change

Source-to-Image (S2I) → Customizing S2I Images

New topic about customizing the behavior of an S2I builder that includes default scripts.

Other Images → Jenkins

Added the Jenkins Standard Authentication section.