Chapter 36. Revision History: Installation and Configuration

Advanced Installation

Updated recommended storage for logging and metrics to use dynamic provisioning the Configuring Metrics Storage and Configuring Logging Storage sections.

Aggregating Container Logs

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

Installation and Configuration

Added information in multiple locations to use oc adm ca commands from the first master only.

Performing Manual In-place Cluster Upgrades

Added information to use oc adm ca commands from the first master only.

Getting Started

Added information to use oc adm ca commands from the first master only to the Configure OpenShift Container Platform and Install OpenShift Container Platform.

Performing Manual In-place Cluster Upgrades

Added new step to Upgrading Master Components for configuring dnsmsq.

Aggregating Container Logs

Added the Expose Elasticsearch as a Route section, and updated related variables in the Specifying Logging Ansible Variables section.

Installation and Configuration Prerequisites

Added note to make sure the lastest version of Glusterfs is installed.

Setting up the Registry Extended Registry Configuration

Added more content to the Image Pullthrough section.

Installation and Configuration Planning

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

Configuring the SDN

Fixed command error in the Migrating from ovs-multitenant to ovs-networkpolicy section.

Setting up the Registry Securing and Exposing the Registry

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

Configuring Global Build Defaults and Overrides

Changed the units from m to Mi in the Example Build Defaults Configuration.

Installing a Cluster Prerequisites

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

Installing a Cluster Disconnected Installation

Updated the example in the Editing the Image Stream Definitions section.

Installing a Cluster Prerequisites

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

Using the Default HAProxy Router

Modified some information in the Router Environment Variables section.

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.

Installing a Cluster Advanced Installation

Added information on using a Cockpit registry console image other than the default.

Configuring Custom Certificates

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

Installation and Configuration Prerequisites

Added note to make sure the lastest version of Glusterfs is installed.

Setting up the Registry Extended Registry Configuration

Added more content to the Image Pullthrough section.

Installation and Configuration Planning

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

Configuring the SDN

Fixed command error in the Migrating from ovs-multitenant to ovs-networkpolicy section.

Setting up the Registry Securing and Exposing the Registry

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

Configuring Global Build Defaults and Overrides

Changed the units from m to Mi in the Example Build Defaults Configuration.

Installing a Cluster Prerequisites

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

Installing a Cluster Disconnected Installation

Updated the example in the Editing the Image Stream Definitions section.

Installing a Cluster Prerequisites

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

Using the Default HAProxy Router

Modified some information in the Router Environment Variables section.

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 Prerequisites

Added note to make sure the lastest version of Glusterfs is installed.

Setting up the Registry Extended Registry Configuration

Added more content to the Image Pullthrough section.

Installation and Configuration Planning

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

Configuring the SDN

Fixed command error in the Migrating from ovs-multitenant to ovs-networkpolicy section.

Setting up the Registry Securing and Exposing the Registry

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

Configuring Global Build Defaults and Overrides

Changed the units from m to Mi in the Example Build Defaults Configuration.

Installing a Cluster Prerequisites

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

Installing a Cluster Disconnected Installation

Updated the example in the Editing the Image Stream Definitions section.

Installation and Configuration Prerequisites

Added note to make sure the lastest version of Glusterfs is installed.

Setting up the Registry Extended Registry Configuration

Added more content to the Image Pullthrough section.

Installation and Configuration Planning

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

Configuring the SDN

Fixed command error in the Migrating from ovs-multitenant to ovs-networkpolicy section.

Setting up the Registry Securing and Exposing the Registry

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

Configuring Global Build Defaults and Overrides

Changed the units from m to Mi in the Example Build Defaults Configuration.

Installing a Cluster Prerequisites

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

Installation and Configuration Prerequisites

Added note to make sure the lastest version of Glusterfs is installed.

Setting up the Registry Extended Registry Configuration

Added more content to the Image Pullthrough section.

Installation and Configuration Planning

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

Configuring the SDN

Fixed command error in the Migrating from ovs-multitenant to ovs-networkpolicy section.

Setting up the Registry Securing and Exposing the Registry

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

Configuring Global Build Defaults and Overrides

Changed the units from m to Mi in the Example Build Defaults Configuration.

Installing a Cluster Prerequisites

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

Installation and Configuration Prerequisites

Added note to make sure the lastest version of Glusterfs is installed.

Setting up the Registry Extended Registry Configuration

Added more content to the Image Pullthrough section.

Installation and Configuration Planning

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

Configuring the SDN

Fixed command error in the Migrating from ovs-multitenant to ovs-networkpolicy section.

Installation and Configuration Prerequisites

Added note to make sure the lastest version of Glusterfs is installed.

Setting up the Registry Extended Registry Configuration

Added more content to the Image Pullthrough section.

Installation and Configuration Planning

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

Installation and Configuration Prerequisites

Added note to make sure the lastest version of Glusterfs is installed.

Setting up the Registry Extended Registry Configuration

Added more content to the Image Pullthrough section.

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

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.

Syncing Groups With LDAP

Noted that all attribute data coming from the LDAP server must be in the format of a UTF-8 encoded string.

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.

Setting up the Registry Securing and Exposing the Registry

Updated procedures including the caveat that the registry is secured and exposed by default during initial cluster installations. (BZ#1481798)

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.

Installation and Configuration Prerequisites

Removed information on disabling DNSMSQ from the DNS section. DNSMSQ must be enabled starting in version 3.6.

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.

Upgrading a Cluster Performing Automated In-place Cluster Upgrades

Added a note to the Upgrading to the Latest OpenShift Container Platform 3.6 Release section about the 'deployment_type' name change.

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.

Upgrading Migrating etcd Data: v2 to v3

New topic on migrating etcd data from v2 to v3.

Disconnected Installation

Updated the list of required and optional images to download.

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.

Upgrading a Cluster Known Issues

New topic cataloging workarounds to known cluster upgrade issues.

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 Prerequisites

Added the Using OverlayFS section.

Advanced Installation

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

Installing a Cluster Prerequisites

Added disk requirements other than /var/.

Installing a Cluster Host Preparation

Added the Enabling Image Signature Support section.

Updated the Installing Base Packages section to add alternative instructions for preparing for the containerized installer.

Installing a Cluster Advanced Installation

Added subsections to the Running the Advanced Installation section: Running the RPM-based Installer for the existing procedure and a new Running the Containerized Installer procedure.

Added Enabling the Service Catalog, Configuring the Ansible Service Broker, Configuring the Template Service Broker, and Deploying the Template Service Broker sections.

Added Configuring Cluster Pre-install Checks section.

Added openshift_template_service_broker_namespaces to the Cluster Variables table.

The deployment_type parameter is now openshift_deployment_type.

Installing a Cluster Installing a Stand-alone OpenShift Container Registry

The deployment_type parameter is now openshift_deployment_type.

Setting Up the Registry Accessing the Registry

Added the Accessing Registry Metrics section.

Setting Up the Registry Extended Registry Configuration

Added the OpenShift section.

Setting up a Router Using the Default HAProxy Router

Updated the default values for ARP cache size on nodes in the ARP Cache Tuning for Large-scale Clusters section.

Added the TLS Cipher Suites section and various changes about ciphers.

Added a new HAProxy Strict SNI section.

Setting up a Router Using the F5 Router Plug-in

Added prerequisite information to the F5 Router Partition Paths section.

Upgrading a Cluster Performing Automated In-place Cluster Upgrades

The deployment_type parameter is now openshift_deployment_type.

Configuring for VMWare vSphere

Added the Configuring for VMWare vSphere topic.

Configuring Persistent Storage Persistent Storage Using VMWare vSphere Volume

Added the Persistent Storage Using VMWare vSphere Volume topic.

Configuring Persistent Storage Volume Security

Removed the volume type svirt_sandbox_file_t from the SELinux Options section.

Configuring Persistent Storage Persistent Storage Using iSCSI

Added information about multipath portals and Challenge Handshake Authentication Protocol (CHAP) configuration.

Aggregating Container Logs

Added content to reference the use of Kibana certificates.

Added Exported Fields section.

Added Kibana Visualize section.

Configuring Persistent Storage Persistent Storage Using FlexVolume Plug-ins

New topic about using FlexVolume plug-ins.

Configuring Persistent Storage Dynamic Provisioning and Creating Storage Classes

Added Changing the Default StorageClass section.

Configuring Persistent Storage iSCSI Multipathing

Added a new topic for multipath support for iSCSI volume plugin.

Customizing the Web Console

Added a new Application Launcher section.

Added a new Extension Option for External Logging Solutions section.

Deploying External Persistent Volume Provisioners

Added new topic for external provisioners.