Chapter 33. Revision History: Installation and Configuration

Installation and Configuration Planning

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

Setting up the Registry Securing and Exposing the Registry

Added default registry to the example in the Manually Securing the Registry section.

Installing a Cluster Prerequisites

Added more information about port 1936 to the Required Ports section.

Installing a Cluster Prerequisites

Added that setting NM_CONTROLLED is required for DNS to work properly.

Installation Using the F5 Router Plug-in

Added a note that the F5 user needs Advanced Shell permission to use the F5 Router Plug-in.

Configuring Custom Certificates

Clarified that, for the master API or web console, wildcard names are accepted.

Installation and Configuration Planning

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

Setting up the Registry Securing and Exposing the Registry

Added default registry to the example in the Manually Securing the Registry section.

Installing a Cluster Prerequisites

Added more information about port 1936 to the Required Ports section.

Installing a Cluster Prerequisites

Added that setting NM_CONTROLLED is required for DNS to work properly.

Installation Using the F5 Router Plug-in

Added a note that the F5 user needs Advanced Shell permission to use the F5 Router Plug-in.

Installation and Configuration Planning

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

Setting up the Registry Securing and Exposing the Registry

Added default registry to the example in the Manually Securing the Registry section.

Installing a Cluster Prerequisites

Added more information about port 1936 to the Required Ports section.

Installation and Configuration Planning

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

Setting up the Registry Securing and Exposing the Registry

Added default registry to the example in the Manually Securing the Registry section.

Installing a Cluster Prerequisites

Added more information about port 1936 to the Required Ports section.

Installation and Configuration Planning

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

Setting up the Registry Securing and Exposing the Registry

Added default registry to the example in the Manually Securing the Registry section.

Installing a Cluster Prerequisites

Added more information about port 1936 to the Required Ports section.

Installation and Configuration Planning

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

Installation and Configuration Planning

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

Installing a Cluster Advanced Installation

Added the openshift_master_admission_plugin_config parameter to the Cluster Variables table.

Configuring Global Build Defaults and Overrides

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

Containerized Heketi for managing dedicated GlusterFS storage

Added an example with instructions to install Heketi on OpenShift and use to manage external GlusterFS storage

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.

Enabling Cluster Metrics

Added *_nodeselector variables to the table in the Specifying Metrics Ansible Variables section.

Installing a Cluster Advanced Installation

Added the Configuring Registry Storage section.

Setting up the Registry Extended Registry Configuration

Added note clarifying that the mirroring feature is different from the upstream feature in the Image Pullthrough section.

Enabling Cluster Metrics

Added link to upstream documentation in the Accessing Hawkular Metrics Directly section.

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.

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.

Aggregating Container Logs

Updated openshift-ansible playbook steps in the Troubleshooting Kibana section.

Advanced Installation

Clarified information about using a non-default registry and router in the Configuring a Registry Location section.

Using the Default HAProxy Router

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

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.

Configuring Azure Blob Storage for Integrated Docker Registry

Added an example for configuring Azure Blob Storage for OpenShift Integrated Docker Registry.

Setting up the Registry Deploying a Registry on Existing Clusters

Removed Technology Preview notice from the Deploying the Registry as a DaemonSet section.

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)

Advanced Installation

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

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.

Redeploying Certificates

Added the Redeploying a New etcd CA section.

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 Section 2.6.9, “Known Issues”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.

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.

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

Enabling Controller-managed Attachment and Detachment

New topic on enabling controller-managed attachment and detachment.

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.

Installing a Cluster Advanced Installation

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

Installing a Cluster Advanced Installation

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

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.

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.

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.

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.

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.

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.