This is a cache of https://docs.openshift.com/enterprise/3.1/welcome/revhistory_full.html. It is a snapshot of the page at 2024-11-29T04:37:14.285+0000.
Full Revision History | About | OpenShift Enterprise 3.1
×

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

Thu Jun 29 2017

Table 1. Release Notes
Affected Topic Description of Change

OpenShift Enterprise 3.1 Release Notes

Added release notes for RHBA-2017:1665 - OpenShift Enterprise 3.1.1.11-3 Bug Fix Update.

Thu May 18 2017

Table 2. Release Notes
Affected Topic Description of Change

OpenShift Enterprise 3.1 Release Notes

Added release notes for RHBA-2017:1235 - OpenShift Enterprise 3.1.1.11-2 Bug Fix Update.

Tue Apr 25 2017

Table 3. Release Notes
Affected Topic Description of Change

OpenShift Enterprise 3.1 Release Notes

Added release notes for RHBA-2017:0989 - OpenShift Enterprise 3.1.1.11 Bug Fix Update.

Wed Feb 01 2017

Table 4. Installation and Configuration
Affected Topic Description of Change

Installing → Prerequisites

Added instructions for installing and using the atomic-openshift-excluder and atomic-openshift-docker-excluder scripts during cluster installations and upgrades.

Installing → Quick Installation

Installing → Advanced Installation

Upgrading → Manual Upgrades

Upgrading → Automated Upgrades

Mon Oct 24 2016

Table 5. Installation and Configuration
Affected Topic Description of Change

Installing → Prerequisites

Aded Note box to the Software Prerequisites section about subscription names.

Table 6. Cluster Administration
Affected Topic Description of Change

Configuring Service Accounts

Added a Service Accounts and Secrets heading.

Tue Oct 17 2016

Table 7. Installation and Configuration
Affected Topic Description of Change

Installing → Advanced Installation

Added more information to the openshift_master_portal_net parameter description in the Configuring Cluster Variables section.

Tue Oct 04 2016

Table 8. Installation and Configuration
Affected Topic Description of Change

Configuring Persistent Storage → Volume Security

Fixed formatting of the oc get project default -o yaml example output within the SCCs, Defaults, and Allowed Ranges section.

Table 9. Rest API Reference
Affected Topic Description of Change

Overview

Updated the oc whoami --token command to show the shorter flag of oc whoami --t.

Tue Sep 13 2016

Table 10. Installation and Configuration
Affected Topic Description of Change

Installing → Advanced Installation

Updated the Multiple Masters Using HAProxy Inventory File example with a line about enabling ntp on masters to ensure proper failover as part of HA configuration.

Table 11. Using Images
Affected Topic Description of Change

Other Images → Jenkins

Updated the Jenkins slave template URL within the Using the Jenkins Kubernetes Plug-in to Run Jobs section.

Database Images → MongoDB

Updated some of the language surrounding the Deployment Configuration Object Definition in the Example Template.

Tue Sep 06 2016

Table 12. Installation and Configuration
Affected Topic Description of Change

Working with HTTP Proxies

Added more information about the NO_PROXY variable.

Table 13. Developer Guide
Affected Topic Description of Change

Events

Added a comprehensive list of events.

Mon Aug 29 2016

Table 14. Installation and Configuration
Affected Topic Description of Change

Installing → Disconnected Install

Fixed the tag references of images to be more generic.

Tue Aug 23 2016

Table 15. Cluster Administration
Affected Topic Description of Change

Backup and Restore

New topic discussing back up (saving state to separate storage) and restore (recreating state from separate storage) at the cluster level.

Cluster Administration → Managing Nodes

Added details on how to change the node traffic interface.

Cluster Administration → Managing Security Context Constraints

Added information about required drop capabilities to the Creating New Security Context Constraints section.

Table 16. Installation and Configuration
Affected Topic Description of Change

Aggregating Container Logs

Removed oc set volume references, as oc volume is the correct command until OpenShift Enterprise 3.2.

Enabling Cluster Metrics

Added clarifying details to the Providing Your Own Certificates section.

Upgrading → Performing Manual Cluster Upgrades

Added manual upgrade steps to get the latest templates from openshift-ansible-roles.

Mon Aug 15 2016

Table 17. Installation and Configuration
Affected Topic Description of Change

Aggregating Container Logs

Added information on log locations within Kibana to the Deploying the EFK Stack section.

Mon Aug 08 2016

Table 18. Installation and Configuration
Affected Topic Description of Change

Installing → Prerequisites

Updated Important boxes in the System Requirements and Installing Docker sections with more specific details regarding Docker versions and yum update. (BZ#1341142)

Aggregating Container Logs

Added that NFS is a not suitable for Lucene storage, NFS is not supported, and how to use local storage.

Table 19. Developer Guide
Affected Topic Description of Change

Using Persistent Volumes

Added a spec.volumeName field to the Requesting Storage example.

Mon Aug 01 2016

Table 20. Installation and Configuration
Affected Topic Description of Change

Routing from Edge Load Balancers

Added a link connecting F5 router and Routing from Edge Load Balancers topics within the Establishing a Tunnel Using a Ramp Node section.

Working With HTTP Proxies

Added Using Maven Behind a Proxy section.

Table 21. Cluster Administration
Affected Topic Description of Change

Managing Projects

Clarified how to remove self-provisioning capabilities in the Disabling Self-provisioning section.

Table 22. Developer Guide
Affected Topic Description of Change

Integrating External Services

Corrected the endpoints example within the External MySQL Database section.

Wed Jul 27 2016

Table 23. Installation and Configuration
Affected Topic Description of Change

Installing → Prerequisites

Added TCP/UDP information to the xref:../install_config/install/prerequisites.adoc#prereq-network-access[Network Access} tables.

Installing → Disconnected Installation

Fixed command in Syncing Repositories section.

Configuring Persistent Storage

Added important box about changing fstype field in a persistent volume configuration in several files.

Table 24. Developer Guide
Affected Topic Description of Change

Builds

Added Build Resources section.

Application Health

Removed High-level Application Health Checks section.

Creating New Applications

Added the Useful Edits section with instructions on how to deploy an application to selected nodes.

Table 25. Using Images
Affected Topic Description of Change

Source-to-Image (S2I) → Python

Updated Python version numbers supported by OpenShift Enterprise.

Source-to-Image (S2I) → PHP

Updated PHP version numbers supported by OpenShift Enterprise.

Database Images → MySQL

Updated MySQL version numbers supported by OpenShift Enterprise.

Wed Jul 20 2016

Table 26. Architecture
Affected Topic Description of Change

Core Concepts → Pods and Services

Minor update for clarity in the Pods section.

Table 27. Installation and Configuration
Affected Topic Description of Change

Installing → Prerequisites

Added an Important box to the System Requirements section.

Corrected information in the Host Recommendations section.

Described which required ports are necessary for master self-communication.

Advanced LDAP Configuration

Aggregating Container Logs

Rewording and clarifications.

Expanded documentation on scaling up Elasticsearch instances.

Added a section on sending logs to an external source.

Enabling Cluster Metrics

Added a Template Parameters table to the Deployer Template Parameters section.

Table 28. Cluster Administration
Affected Topic Description of Change

High Availability

Added an Important box to the Configuring IP Failover section about using HA with AWS.

Troubleshooting OpenShift SDN

Added a TLS Handshake Timeout section.

Table 29. Developer Guide
Affected Topic Description of Change

Builds

Fixed build configuration example in the Other section.

Deployments

Clarified operational conditions around config-change and image-change triggers.

Managing Environment Variables

Added information about automatically added environment variables.

Secrets

Added clarifying details to the Restrictions section.

Port Forwarding

Updated outdated syntax instances of oc port-forward -p.

Table 30. Creating Images
Affected Topic Description of Change

Guidelines

Added a better UID permissions example for Support Arbitrary User IDs in the OpenShift-Specific Guidelines section.

Table 31. Using Images
Affected Topic Description of Change

Database Images → MySQL

Added MYSQL_SERVICE_HOST and MYSQL_SERVICE_PORT to the Environment Variables section.

Wed Jun 15 2016

Table 32. Architecture
Affected Topic Description of Change

Additional Concepts → Authentication

Removed the Impersonation section, which does not apply to OpenShift Enterprise 3.1.

Mon Jun 13 2016

Table 33. Installation and Configuration
Affected Topic Description of Change

Aggregating Container Logs

Specified the correct units for ES_INSTANCE_RAM and ES_OPS_INSTANCE_RAM.

Persistent Storage Examples → Mounting Volumes on Privileged Pods

Added Mounting Volumes on Privileged Pods file.

Deploying a Router

Added an Important box regarding default resource requests for router pods.

Deploying a Docker Registry

Updated the example of using an existing persistent volume claim (PVC) to a matching configuration for docker-registry PVC.

Table 34. CLI Reference
Affected Topic Description of Change

Developer CLI Operations

Replace instances of oc rsh <pod_ID> with oc rsh <pod> and fixed other formatting.

Table 35. Creating Images
Affected Topic Description of Change

Guidelines

Moved Docker and Project Atomic documentation links to a new External Guidelines subsection of General Docker Guidelines.

Table 36. Using Images
Affected Topic Description of Change

Other Images → Jenkins

Removed specific reference to Jenkins version and added a link to the LTS Changelog.

Red Hat JBoss Web Server xPaaS Images

Updated the binary deployment directory for tomcat STI image to be deployments, not deployment.

Fri Jun 10 2016

Table 37. Architecture
Affected Topic Description of Change

Infrastructure Components → Web Console

Added a Note introducing Cockpit to the Project Overviews section.

Core Concepts → Builds and Image Streams

Added Reproducibility to the list of S2I advantages in the Source-to-Image (S2I) Build section.

Additional Concepts → Authorization

Added a Note box indicating that Roles need to be assigned to administer the setup with an external user.

Table 38. Installation and Configuration
Affected Topic Description of Change

Installing → Advanced Installation

Replaced the openshift_docker_log_options Ansible variable with openshift_docker_options in the Configuring Host Variables section.

Updated openshift_router_selector to its new name of openshift_hosted_router_selector.

Installing → Deploying a Docker Registry

Fixed examples in the Securing the Registry section to use consistent --cert and --key values. Also, clarify the origin of the ca.crt file that must be installed per-node.

Configuring Authentication

Added a note on how to obtain the htpasswd utility.

Customizing the Web Console

Added that each time a user’s token to OpenShift Enterprise expires, the user is presented with a custom page. Also, added use cases for custom login pages.

Table 39. Cluster Administration
Affected Topic Description of Change

Configuring Service Accounts

Fixed callout numbering in the Managed Service Accounts example.

Overcommitting

Added instructions on how to make the resource-reserver pod start automatically.

Scheduler

Added a Modifying Scheduler Policy section.

Table 40. Developer Guide
Affected Topic Description of Change

Opening a Remote Shell to Containers

Added a new topic on opening a remote shell to containers.

Fri Jun 03 2016

Table 41. Installation and Configuration
Affected Topic Description of Change

Installing → Advanced Installation

Updated the location of the scaleup.yml playbook in the Adding Nodes to an Existing Cluster section.

Installing → Deploying a Docker Registry

Removed support information for upstream registry configuration not relevant to OpenShift Enterprise.

Mon May 30 2016

Table 42. Architecture
Affected Topic Description of Change

Additional Concepts → Authentication

Added the Impersonation section.

Table 43. Admin Guide
Affected Topic Description of Change

Overcommitting

Updated the Disabling Swap Memory section with options that can help users avoid having to swap and added a Warning box stating that disabling swap memory is not recommended.

Managing Security Context Constraints

Fixed command typos.

Table 44. Using Images
Affected Topic Description of Change

Other Images → Jenkins

Updated the example in the Using Jenkins as a Source-To-Image builder section to use https for GitHub access.

Table 45. Dev Guide
Affected Topic Description of Change

Templates

Fixed oc process example in the Parameters section.

Copying Files to or from a Container

Added use cases for the oc rsync command to the Overview.

Builds

Updated the examples in the Defining a BuildConfig, Git Repository Source Options, and Using a Proxy for Git Cloning sections to use https for GitHub access.

Table 46. Creating Images
Affected Topic Description of Change

S2I Requirements

Clarified details of onbuild behavior with S2I.

S2I Requirements

Added an External References section with links to an image creation tutorial and the S2I project repository.

Testing S2I Images

Updated the BuildConfig example to use https for GitHub access.

Table 47. Install Config
Affected Topic Description of Change

Installing → Advanced Installation

Updated the parameter name docker_log_options to openshift_docker_log_options in the Host Variables table.

Installing → Disconnected Installation

Fixed some outdated image names.

Installing → Prerequisites

Added an Important box to the Sizing Recommendations section advising that oversubscribing the physical resources on a node affects resource guarantees the Kubernetes scheduler makes during pod placement.

Installing → Deploying a Docker Registry

Added support information for upstream registry configuration.

Working with HTTP Proxies

Updated the example in the Configuring Default Templates for Proxies section to use https for GitHub access.

Persistent Storage Examples → Backing Docker Registry with GlusterFS Storage

New topic about how to attach a GlusterFS persistent volume to the Docker Registry.

Table 48. Cli Reference
Affected Topic Description of Change

Managing CLI Profiles

Updated the Verifying the Current Working Environment example to use https for GitHub access.

Get Started with the CLI

Updated the oc status example to use https for GitHub access.

Get Started with the CLI

Created 3 new videos about installing the CLI on Windows, Mac OS X, and Linux systems and updated written docs to include links to the videos, and image thumbnails to represent videos.

Tue May 10 2016

Table 49. Installation and Configuration
Affected Topic Description of Change

Upgrading → Manual Upgrades

Added the Upgrading the EFK Logging Stack section.

Configuring Persistent Storage → Persistent Storage Using GlusterFS

Updated for clarity throughout.

Enhanced the Volume Security section significantly.

Configuring Persistent Storage → Persistent Storage Using Ceph Rados Block Device (RBD)

Updated for clarity throughout.

Added the Creating the Ceph Secret and Volume Security section.

Persistent Storage Examples

New topic category that includes the following topics:

Enabling Cluster Metrics

Updated the port value for the re-encrypting port to 8444 for OpenShift Enterprise, which is different from the value for OpenShift Origin, which uses 8443.

Simplified steps in the Cleanup section.

Added extra warnings for Cassandra and its disk size in the Persistent Storage and Deployer Template Parameters sections.

Table 50. Cluster Administration
Affected Topic Description of Change

Managing Security Context Constraints

Added Note boxes advising against editing settings on the default SCCs other than priority, users, and groups.

Table 51. Developer Guide
Affected Topic Description of Change

Builds

Added a Note box stating that Gog supports the same webhook payload format as GitHub.

Included a missing step of adding the secret to the BuildConfig file and fixed the formatting of the nested list within the Other authentication section.

Table 52. Creating Images
Affected Topic Description of Change

Guidelines

Added recommendations for using templates and liveness and readiness probes.

Tue May 03 2016

Table 53. Architecture
Affected Topic Description of Change

Infrastructure Components → Web Console

Added a link to the OpenShift and Atomic Enterprise Platform Tested Integrations article in the Browser Requirements section.

Table 54. Using Images
Affected Topic Description of Change

Database Images → MySQL

Updated to use the current MySQL script names.

Table 55. Cluster Administration
Affected Topic Description of Change

Troubleshooting OpenShift SDN

Relocated the docker bridge to port 3 and other general enhancements for clarity.

Troubleshooting OpenShift SDN

Added a Debugging Virtual Networking section, which includes troubleshooting steps for when builds on a virtual network are failing. (BZ#1273327)

Table 56. Developer Guide
Affected Topic Description of Change

Application Tutorials → Quickstart Templates

New topic explaining quickstart templates and listing the current offerings.

Builds

Added the FROM Image section.

Wed Apr 27 2016

Table 57. Cluster Administration
Affected Topic Description of Change

Managing Users

New topic on how to add users, delete users, and view user and identity lists. (BZ#1326595)

Table 58. Architecture
Affected Topic Description of Change

Core Concepts → routes

Corrected footnote placement in the Secured routes section.

Core Concepts → Builds and Image Streams

Added information about maximum name lengths for objects.

Core Concepts → Projects and Users

Added information about maximum name lengths for objects.

Core Concepts → Pods and Services

Added information about maximum name lengths for objects.

Table 59. Installation and Configuration
Affected Topic Description of Change

Configuring Persistent Storage → Persistent Storage Using NFS

Updated the Export Settings section to note the no_wdelay NFS export option.

Installing → Deploying a Docker Registry

Updated the Known Issues section to note the no_wdelay NFS export option.

Working with HTTP Proxies

Added specific /etc/sysconfig files to the Configuring Hosts for Proxies section.

Added information explaining that OpenShift does not accept an asterisk as a wildcard attached to a domain suffix.

Mon Apr 18 2016

Table 60. Getting Started
Affected Topic Description of Change

Getting Started for Developers: Web Console

Added a Browser Requirements section, which points to the full browser requirements.

Table 61. Architecture
Affected Topic Description of Change

Infrastructure Components → Web Console

Added a Browser Requirements section, which outlines browser versions and operating systems that can be used to access the web console.

Table 62. Installation and Configuration
Affected Topic Description of Change

Installing → Advanced Installation

Fixed syntax of examples in the Configuring Custom Certificates section to be in proper INI format.

Added an Adding Nodes to an Existing Cluster section on using the scaleup.yml playbook. (BZ#1324571)

Added an Uninstalling Nodes section on using the uninstall.yml playbook for specific nodes.

Installing → Disconnected Installation

New topic on disconnected installations, detailing how to install OpenShift Enterprise in datacenters that do not have access to the Internet.

Table 63. Cluster Administration
Affected Topic Description of Change

Managing Nodes

Updated the Adding Nodes and Deleting Nodes sections for accuracy.

Table 64. Developer Guide
Affected Topic Description of Change

Authentication

Added a pointer to the browser requirements from the Web Console Authentication section.

Resource Quota

Added the Accounting for Quota in Deployment Configurations section.

Deployments

Updated the Deployment Resources section to clarify regarding quotas and deployment configurations.

Limits

Clarified some points.

Wed Apr 06 2016

Table 65. Installation and Configuration
Affected Topic Description of Change

Aggregating Container Logs

Removed references to non-existent roles in the Pre-deployment Configuration section. (BZ#1324571)

Mon Apr 04 2016

Table 66. Architecture
Affected Topic Description of Change

Additional Concepts → Authorization

Added deletecollection to the verb list within the Evaluating Authorization table.

Table 67. Installation and Configuration
Affected Topic Description of Change

Installing → Prerequisites

Updated the System Requirements and Installing Docker sections to take into account the release of Docker 1.9.

Added the Cloud Provider Considerations section and documented ports 2049, 5404, 5405, and 9000 in the Required Ports section.

Installing → Advanced Installation

Added information about region=infra to the Configuring Node Host Labels section and added openshift_router_selector and openshift_registry_selector to the Host Variables table.

Aggregating Container Logs

Updated significantly throughout to fix errors and recommended practices.

Enabling Cluster Metrics

Fixed typo of the destinationCACertificate parameter name.

Table 68. Cluster Administration
Affected Topic Description of Change

Managing Authorization Policies

Updated the oc describe clusterPolicy default output to include the new deletecollection verb and added a NOTE box with a pointer to the verb list in the Evaluating Authorization section.

Table 69. Developer Guide
Affected Topic Description of Change

Builds

Fixed webhook URL paths from osapi to oapi.

Pod Autoscaling

Updated to add clarity to autoscaling behavior.

Table 70. Using Images
Affected Topic Description of Change

Red Hat JBoss Fuse Integration Services

Added a KCS article link, changed the names of FIS application development workflows, and updated a command in the simple workflow example.

Tue Mar 29 2016

Table 71. Architecture
Affected Topic Description of Change

Additional Concepts → Persistent Storage

Updated the Overview section to provide a better introduction to the PV and PVC concepts.

Table 72. Installation and Configuration
Affected Topic Description of Change

Deploying a Docker Registry

Added an Important box about writing to the host directory in the Storage for the Registry section.

Configuring Persistent Storage → Persistent Storage Using NFS

Updated for clarity throughout.

Enhanced the Volume Security section significantly.

Added the Additional Configuration and Troubleshooting section.

Configuring Persistent Storage → Volume Security

Updated significantly for clarity throughout.

Table 73. Cluster Administration
Affected Topic Description of Change

Managing Projects

Fixed a configuration typo in Using Node Selectors.

Table 74. Using Images
Affected Topic Description of Change

Red Hat JBoss Fuse Integration Services

Updated path to image stream JSON file in the OpenShift Source-to-Image (S2I) Workflow section.

Tue Mar 22 2016

Table 75. Using Images
Affected Topic Description of Change

EAP xPaaS Image 7.0 Beta

Updated the EAP xPaaS image for 7.0 Beta release.

SSO xPaaS Image TP

New topic for the Red Hat SSO xPaaS Technology Preview image.

Mon Mar 21 2016

Table 76. Installation and Configuration
Affected Topic Description of Change

Installing

Fixed broken links.

Table 77. Cluster Administration
Affected Topic Description of Change

Authorization

Added the Authorization Policy diagram to the Overview section.

Table 78. Using Images
Affected Topic Description of Change

MySQL Image

Added a Troubleshooting section.

Thu Mar 17 2016

Table 79. Release Notes
Affected Topic Description of Change

OpenShift Enterprise 3.1 Release Notes

Changed a known issue to a fix regarding liveness and readiness probes.

Table 80. Architecture
Affected Topic Description of Change

Additional Concepts → Persistent Storage

In the Access Modes section, clarified how a PVC determines what PV to select.

Table 81. Installation and Configuration
Affected Topic Description of Change

Loading the Default Image Streams and Templates

Moved and updated the "First Steps" topic to become the Loading the Default Image Streams and Templates topic

Upgrading → Manual Upgrades

Changed a known issue to a fix regarding liveness and readiness probes.

Deploying a Docker Registry

Changed command to update the liveness probe to use oc patch instead of sed.

Enabling Cluster Metrics

Added the Using a Re-encrypting Route section.

Advanced Installation

Combined duplicate openshift_node_kubelet_args descriptions and moved all of the content to the Host Variables table.

Aggregating Container Logs

Fixed some errors and added some extra information.

Table 82. Cluster Administration
Affected Topic Description of Change

Pruning Resources

Corrected the default value for --keep-tag-revisions.

Managing Nodes

Added the Configuring Node Resources section.

Table 83. Developer Guide
Affected Topic Description of Change

Builds

Edits for clarity in the Binary Source section.

Builds

In the No Cache subsection of the Docker Strategy Options section, spelled noCache correctly in the example.

Mon Mar 7 2016

Table 84. Architecture
Affected Topic Description of Change

Additional Concepts → Persistent Storage

Updated the Access Modes content to address how access mode matching works and whether modes are enforced at runtime. (BZ#1304489)

Table 85. Installation and Configuration
Affected Topic Description of Change

Installing → Advanced Installation

Clarified in the Configuring Ansible section that the services and cluster networks also cannot overlap with networks to which the master and nodes need access, and not just networks to which the pods need access.

Modified the SDN-related Ansible cluster variables in the Configuring Ansible section to be more consistent with each other in general.

Installing → Deploying a Docker Registry

Mentioned default tag latest.

Clarified importance of the project name in the pull specification.

Added section Maintaining the Registry IP Address.

Upgrading

In the Automated Upgrades and Manual Upgrades sections, added guidance about verifying that custom configurations are added to the updated /etc/sysconfig/ paths after upgrading from OSE 3.0 to 3.1. (BZ#1284504)

Configuring the SDN

Added an Important box to the Configuring the Pod Network on Masters section noting that clusterNetworkCIDR can now be changed under certain conditions.

Configuring for AWS

Added the Applying Configuration Changes section. (BZ#1314085)

Persistent Storage → Persistent Storage Using NFS

Updated the "SELinux and NFS Export Settings" section to distinguish between NFSv3 and NFSv4 port requirements.

Aggregating Container Logs

Added a Note box to the Pre-deployment Configuration section recommending use of node selectors.

Fixed a service account name reference.

Enabling Cluster Metrics

Added a Note box about the cluster metrics template location.

Table 86. Cluster Administration
Affected Topic Description of Change

Managing Projects

Renamed topic from "Self-Provisioned Projects" and added the Using Node Selectors section.

Table 87. Developer Guide
Affected Topic Description of Change

Deployments

Added the Assigning Pods to Specific Nodes section.

Mon Feb 29 2016

Table 88. Architecture
Affected Topic Description of Change

Infrastructure Components → Kubernetes Infrastructure

Added a note to the High Availability Masters section indicating that moving from a single master cluster to multiple masters after installation is not supported.

Table 89. CLI Reference
Affected Topic Description of Change

Get Started with the CLI

Added steps on checking your PATH to the Installing the CLI subsections.

Table 90. Installation and Configuration
Affected Topic Description of Change

Upgrading

Converted the "Upgrading OpenShift" topic into its own Upgrading directory with separate topics for Performing Automated Cluster Upgrades and Performing Manual Cluster Upgrades.

Upgrading from Pacemaker to Native HA

New topic providing instructions on upgrading a multiple master cluster from Pacemaker to native HA.

Enabling Cluster Metrics

Removed the template in the "Creating the Deployer Template" section and fixed an incorrect file location.

Aggregating Container Logs

Added a step within the Pre-deployment Configuration section indicating that you must switch to your new project after creating it.

Prerequisites

Fixed the /etc/selinux/config file path in the SELinux section.

Advanced Installation

Added notes indicating that moving from a single master cluster to multiple masters after installation is not supported.

Mon Feb 22 2016

Table 91. Installation and Configuration
Affected Topic Description of Change

Configuring Custom Certificates

In the Configuring Custom Certificates section, replaced publicMasterURL with masterPublicURL.

Installing → Prerequisites

Added an SELinux section to include guidance that SELinux must be enabled, or the installer will fail.

Enabling Cluster Metrics

Added the Cleanup section with instructions on how to remove a metrics deployment.

Syncing Groups With LDAP

Updated the Running LDAP Sync section with better example command formatting.

Configuring Authentication

Updated the "Apache Authentication Using RequestHeaderIdentityProvider" example to use the /etc/origin/master/htpasswd file path.

Added a section for the Keystone identity provider.

Advanced Installation

Updated example inventory files to show the /etc/origin/master/htpasswd file path.

Clarified in the Verifying the Installation section to run the oc get nodes command on the master host.

Routing from Edge Load Balancers

Corrected the /run/openshift-sdn/config.env path in the Establishing a Tunnel Using a Ramp Node section.

Installing → Deploying a Docker Registry

Added the Advanced: Overriding the Registry Configuration section.

Table 92. Cluster Administration
Affected Topic Description of Change

Monitoring Routers

Corrected the HAProxy configuration file name.

Table 93. CLI Reference
Affected Topic Description of Change

Get Started with the CLI

Added a Prerequisites section and added subsections to the Installing the CLI section for Windows, Mac OS X, and Linux.

Table 94. Developer Guide
Affected Topic Description of Change

Creating New Applications

Updated the Language Detection section to show Python detection now looks for setup.py instead of config.py.

Deployments

Corrected syntax in the Creating a Deployment Configuration section example.

Managing Volumes

Corrected syntax in the secret volume example command.

Table 95. Using Images
Affected Topic Description of Change

Database Images

Updated the commands for creating new databases for MySQL, PostgreSQL, and MongoDB.

Mon Feb 15 2016

Table 96. Developer Guide
Affected Topic Description of Change

Integrating External Services

Corrected port numbers across the page and converted examples to YAML.

Builds

Updated the Starting a Build section to include the --env, --from-dir, --from-file, and --from-repo options for the oc start-build command.

Table 97. Architecture
Affected Topic Description of Change

Core Concepts → routes

Updated to clarify that destinationCaCertificate is required, but only for re-encryption.

Table 98. Installation and Configuration
Affected Topic Description of Change

Installing → Prerequisites

Added a new Managing Docker Container Logs section.

Updated to include guidance on how to check if Docker is running.

Installing → Advanced Installation

Listed docker_log_options as an host variable in the Configuring Ansible section.

Aggregating Container Logs

Added a Note box about json-file logging driver options.

Mon Feb 08 2016

Table 99. Installation and Configuration
Affected Topic Description of Change

Installing → Prerequisites

Updated the System Requirements section to clarify that instances can be running on a private IaaS, not just a public one.

Table 100. Developer Guide
Affected Topic Description of Change

Builds

Converted all object definitions and snippets from JSON to YAML, where appropriate.

Thu Feb 04 2016

Table 101. Release Notes
Affected Topic Description of Change

OpenShift Enterprise 3.1 Release Notes

Updated the OpenShift Enterprise 3.1.1 Enhancements section to more clearly identify the features that came out of Technology Preview.

Updated the OpenShift Enterprise 3.1.1 Technology Preview Features section to add a link to the new Dynamically Provisioning Persistent Volumes topic.

Table 102. Installation and Configuration
Affected Topic Description of Change

Installing → Deploying a Docker Registry

Updated the Securing the Registry section to account for the liveness probe that is now added to new registries by default starting in OpenShift Enterprise 3.1.1. (BZ#1302956)

Configuring for AWS

Fixed the default node configuration file path.

Corrected instructions on setting access key environment variables.

Configuring for GCE

Fixed the default node configuration file path.

Configuring Persistent Storage → Dynamically Provisioning Persistent Volumes

New topic on the experimental feature for allowing users to request dynamically provisioned persistent storage based on the configured cloud provider. Available in Technology Preview starting in OpenShift Enterprise 3.1.1.

Mon Feb 01 2016

Table 103. Architecture
Affected Topic Description of Change

Core Concepts → Builds and Image Streams

Added more information on how builds work behind the scenes.

Additional Concepts → Persistent Storage

Added an Important box about providing high-availability.

Table 104. CLI Reference
Affected Topic Description of Change

Administrator CLI Operations

New topic providing a reference for administrator CLI commands.

Developer CLI Operations

Changed the format for listing commands from tables to individual subsections per command.

Table 105. Using Images
Affected Topic Description of Change

Overview

Added details on which images are supported and their location.

Table 106. Installation and Configuration
Affected Topic Description of Change

Configuring for OpenStack

Changed <instance_ID> to <instance_name> in the Configuring Nodes section for readability.

Thu Jan 28 2016

OpenShift Enterprise 3.1.1 release.

Table 107. Release Notes
Affected Topic Description of Change

OpenShift Enterprise 3.1 Release Notes

Added the Asynchronous Errata Updates section and included release notes for OpenShift Enterprise 3.1.1, detailing the various enhancements, technology preview features, bug fixes, and known issues.

Table 108. Installation and Configuration
Affected Topic Description of Change

Installing → Prerequisites

Updated to include support for RHEL Atomic Host.

Installing → RPM vs Containerized

New topic discussing differences between RPM and containerized installations.

Installing → Quick Installation

Updated to include support for RHEL Atomic Host and containerized installations.

The former "Prerequisites" section in this topic has been renamed to Before You Begin and enhanced to differentiate from the actual Prerequisites topic.

Installing → Advanced Installation

Updated to include support for RHEL Atomic Host and containerized installations.

The former "Prerequisites" section in this topic has been renamed to Before You Begin and enhanced to differentiate from the actual Prerequisites topic.

Upgrading

Added the Upgrading to OpenShift Enterprise 3.1 Asynchronous Releases section and various enhancements to support the OpenShift Enterprise 3.1.1 release.

Syncing Groups With LDAP

Updated to promote the openshift ex sync-groups command to oadm groups sync and added the Running a Group Pruning Job section.

Table 109. Cluster Administration
Affected Topic Description of Change
Table 110. CLI Reference
Affected Topic Description of Change

CLI Operations

Added new options for the oc start-build command to the Build and Deployment CLI Operations section.

Table 111. Developer Guide
Affected Topic Description of Change

Builds

Added the Dockerfile Path section.

Added the Dockerfile Source section.

Added the Binary Source section.

Updated the Viewing Build Details section to note information included for Docker or Source strategy builds.

Pod Autoscaling

Updated to remove Technology Preview status starting in OpenShift Enterprise 3.1.1.

Tue Jan 26 2016

Table 112. Installation and Configuration
Affected Topic Description of Change

Enabling Cluster Metrics

Fixed the metrics-deployer.yaml file path.

Installing → Prerequisites

Added a Warning box about wildcards and DNS server entries in the /etc/resolv.conf file.

Configuring Persistent Storage → Persistent Storage Using Ceph Rados Block Device (RBD)

Fixed the ceph-common package name.

Configuring Persistent Storage → Persistent Storage Using NFS

Removed a contradictory Note box about NFS and SELinux.

Table 113. Using Images
Affected Topic Description of Change

xPaaS Middleware Images → Red Hat JBoss Fuse Integration Services

Fixed the KUBERNETES_MASTER value.

Mon Jan 19 2016

Table 114. Release Notes
Affected Topic Description of Change

Comparing OpenShift Enterprise 2 and OpenShift Enterprise 3

New topic discussing changes in architecture, concepts, and terminology between OpenShift Enterprise 2 and OpenShift Enterprise 3.

Table 115. Architecture
Affected Topic Description of Change

Additional Concepts → Authorization

Updated the list of default SCCs as of OpenShift Enterprise 3.1, and other improvements to the Security Context Constraints sections.

Core Concepts → Builds and Image Streams

Added a Note box clarifying how ImageStreamImage objects are created.

Table 116. Installation and Configuration
Affected Topic Description of Change

Installing → Advanced Installation

Added custom certificate parameters and added the Configuring Custom Certificates section.

Installing → Deploying a Docker Registry

Enhanced the Accessing the Registry Directly section, including organizing all user-related requirements under a User Prerequisites subsection. (BZ#1273412)

Downgrading OpenShift

New topic for downgrading from OpenShift Enterprise 3.1 to 3.0.

Configuring Custom Certificates

New topic for configuring custom certificates after initial installation.

Configuring Authentication

Added the mappingMethod parameter to all examples.

Configuring for OpenStack

Added references to nodeName in the Configuring Nodes section.

Fixed the default node configuration file path.

Aggregating Container Logs

Fixed the path to the logging-deployer.yaml file.

Enabling Cluster Metrics

Added information about Metrics Deployer certificates and the nothing=/dev/null option.

Added clarification about required host names for the Hawkular Metrics certificate.

Table 117. Cluster Administration
Affected Topic Description of Change

Managing Security Context Constraints

Added the Add an SCC to a User or Group section.

Table 118. CLI Reference
Affected Topic Description of Change

CLI Operations

Fixed a reference to the outdated OSC_EDITOR environment variable to instead refer to the current OC_EDITOR.

Table 119. Developer Guide
Affected Topic Description of Change

Builds

Grouped related sections under a new Git Repository Source Options section.

Added a Note box to clarify that pullSecret may be used with any of the build strategies.

Explained consistently the use for the serviceaccount/builder role.

Added the Using External Artifacts During a Build section.

Updated statement about builder images supporting the incremental flag.

Secrets

Added the metadata.name parameter in an example.

Thu Nov 19 2015

OpenShift Enterprise 3.1 release.