anchor.diff:  
   The following features are in Technology Preview:
   
  -- Binary builds, and the `*Dockerfile*` source type for builds.
  +* Binary builds, and the Dockerfile source type for builds.
  +* Pod autoscaling, using the *HorizontalPodAutoscaler* object. OpenShift compares pod CPU usage as a percentage of requested CPU, and scales according to up to an indicated threshold.
  +* Support for OpenShift Enterprise running on Atomic Host.
  +* Containerized installations, meaning all OpenShift Enterprise components running in containers.
  +
  +== Known Issues
  +
  +* When pushing to an internal registry when multiple registries share the same NFS volume, there is a chance the push will fail. link:../install_config/install/docker_registry.html#known-issues[A workaround] has been suggested.
  +* When creating a build, in the event where there are not enough resources (possibly due to quota), the build will be pending indefinitely. As a workaround, free up resources, cancel the build, then start a new build.
  
positive.code: 
  Built on Red Hat Enterprise Linux and Google Kubernetes, OpenShift Enterprise
  provides a secure and scalable multi-tenant operating system for today’s
  enterprise-class applications while providing integrated application runtimes
  and libraries. OpenShift Enterprise brings the OpenShift PaaS platform to
  customer data centers, enabling organizations to implement a private PaaS that
  meets security, privacy, compliance, and governance requirements.
  
negative.code: ====
  
  .For Administrators:
  Service, package, file name, and directories name changes renamed::
  
  [cols="4,6",options="header"]
  |===
  |Previous Name
  |New Name
  
  |*openshift-master*
  |*atomic-openshift-master*
  
  |*openshift-node*
  |*atomic-openshift-node*
  
  |*_/etc/openshift/_*
  |*_/etc/origin/_*
  
  |*_/var/lib/openshift/_*
  |*_/var/lib/origin/_*
  
  |*_/etc/sysconfig/openshift-master_*
  |*_/etc/sysconfig/atomic-openshift-master_*
  
  |*_/etc/sysconfig/openshift-node_*
  |*_/etc/sysconfig/atomic-openshift-node_*
  |===
  
  Docker version update required::
  Docker version 1.8.2 is required. This contains the fix to let the
  *_/etc/groups_* file use supplementary groups.
  
  LDAP Synchronization::
  OpenShift now allows you to sync LDAP records with OpenShift, so that you can
  manage groups easily.
  
  F5 Availability::
  You can now configure an F5 load-balancer for use with your OpenShift
  environment.
  
  More Persistent Storage Options::
  Several persistent storage options are now available, such as Red Hat's
  GlusterFS and Ceph RBD, AWS, and Google Compute Engine. Also, NFS storage is
  now supplemented by iSCSI- and Fibre Channel-based volumes.
  
  More Middleware Options::
  Several middleware services are now available, such as JBoss DataGrid, and
  JBoss BRMS, as well as a supported JBoss Developer Studio and Eclipse plug-in.
  
  Job Controller Now Available::
  The job object type is now available, meaning that finite jobs can now be
  executed on the cluster.
  
  Installation Utility Updates::
  Multiple enhancements have been made to the Ansible-based installation
  utility. The utility can now:
  * Perform container-based installations. (Technology Preview)
  * Install active-active, highly-available clusters.
  * Uninstall existing OpenShift clusters.
  
  Custom CA Certificates::
  You can now specify your own CA certificate during the install, so that
  application developers do not have to specify the OpenShift-generated CA to
  obtain secure connections.
  
  DNS Service Name Change::
  The DNS name for service SRV discovery has changed. Services without search paths resulted in long load times to resolve DNS. The change reduces load times.
  
  New Parameter Preventing Memory Overload::
  Excessive amounts of events being stored in etcd can lead to excessive memory
  growth. You can now set the `*event-ttl*` parameter in the master
  configuration file to a lower value (for example, `*15m*`) to prevent memory
  growth.
  
  New Parameter for Port Destination::
  You can now specify the port to send routes to. Any services that are
  pointing to multiple ports should have the `*spec.port.targetPort*` parameter
  on the pod set to the desired port.
  
  New Remote Access Command::
  The `oc rsync` command is now available, which can copy local directories into
  a remote pod.
  
  Project Binding Command::
  Isolated projects can now be bound together using `oadm pod-network
  join-project`.
  
  Host Configuration Validation Commands::
  New commands exist to validate master and node configuration files: `openshift
  ex validate master-config` and `openshift ex validate node-config`, respectively.
  
  New Tag Deletion Command::
  You can now delete tags from an image stream using the `oc tag <tag_name> -d`
  command.
  
  .For Developers:
  `*v1beta3*` no Longer Supported::
  Using `*v1beta3*` in configuration files is no longer supported:
  * The `*etcdStorageConfig.kubernetesStorageVersion*` and
  `*etcdStorageConfig.openShiftStorageVersion*` values in the master
  configuration file must be `*v1*`.
  * You may also need to change the `*apiLevels*` field and remove `*v1beta3*`.
  * `*v1beta3*` is no longer supported as an endpoint. `*/api/v1beta3*` and
  `*/osapi/v1beta3*` are now disabled.
  
  Web Console Enhancements::
  Multiple web console enhancements:
  * Extended resource information is now available on the web console.
  * The ability to trigger a deployment and rollback from the console has been
  added.
  * Logs for builds and pods are now displayed on the web console in real time.
  * When enabled, the web console will now display pod metrics.
  * You can now connect to a container using a remote shell connection when in
  the *Builds* tab.
  
  Aggregating Logging With the EFK Stack::
  Elasticsearch, Fluentd, and Kibana (together, known as the EFK stack) are now available for logging consumption.
  
  Heapster Now Available::
  The Heapster interface and metric datamodel can now be used with OpenShift.
  
  Jenkins is Now Available::
  * A Jenkins image is now available for deployment on OpenShift.
  * Integration between Jenkins masters and Jenkins slaves running on OpenShift
  has improved.
  
  `oc build-logs` is Now Deprecated::
  The `oc build-logs <build_name>` command is now deprecated and replaced by `oc
  logs build/<build_name>`.
  
  `*spec.rollingParams.updatePercent*` Field is Replaced::
  The `*spec.rollingParams.updatePercent*` field in deployment configurations
  has been replaced with `*maxUnavailable*` and `*maxSurge*`.
  
  Images now Editable::
  Images can be edited to set fields such as `*labels*` or `*annotations*`.
  
  [[ose-31-bug-fixes]]
  
  == Bug Fixes
  
  https://bugzilla.redhat.com/show_bug.cgi?id=1264836[BZ 1264836]:: Previously,
  the upgrade script used an incorrect image to upgrade the HAProxy router. The
  script now uses the right image.
  https://bugzilla.redhat.com/show_bug.cgi?id=1264765[BZ 1264765]:: Previously, an
  upgrade would fail when a defined image stream or template did not exist. Now,
  the installation utility skips the incorrectly defined image stream or
  template and continues with the upgrade.
  https://bugzilla.redhat.com/show_bug.cgi?id=1274134[BZ 1274134]:: When using
  the `oc new-app` command with the `--insecure-registry` option, it would not
  set if the Docker daemon was not running. This issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1273975[BZ 1273975]:: Using the `oc
  edit` command on Windows machines displayed errors with wrapping and file
  changes. These issues have been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1268891[BZ 1268891]:: Previously,
  creating pods from the same image in the same service and deployment were not
  grouped into another service. Now, pods created with the same image run in the
  same service and deployment, grouped together.
  https://bugzilla.redhat.com/show_bug.cgi?id=1267559[BZ 1267559]:: Previously,
  using the `oc export` command could produce an error, and the export would
  fail. This issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1266981[BZ 1266981]:: The recycler
  would previously fail if hidden files or directories would be present. This
  issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1268484[BZ 1268484]:: Previously,
  when viewing a build to completion on the web console after deleting and
  recreating the same build, no build spinner would show. This issue has been
  fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1269070[BZ 1269070]:: You can now
  use custom self-signed certificates for the web console for specific host
  names.
  https://bugzilla.redhat.com/show_bug.cgi?id=1264764[BZ 1264764]:: Previously,
  the installation utility did not have an option to configure the deployment
  type. Now, you can run the `--deployment-type` option with the installation
  utility to select a type, otherwise the type set in the installation utility
  will be set.
  https://bugzilla.redhat.com/show_bug.cgi?id=1273843[BZ 1273843]:: There was an
  issue with the `pip` command not being available in the newest OpenShift
  release. This issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1274601[BZ 1274601]:: Previously,
  using the `oc exec` command was only available to be used on privileged
  containers. Now, users with permissions to create pods can use the `oc exec`
  command to SSH into privileged containers.
  https://bugzilla.redhat.com/show_bug.cgi?id=1267670[BZ 1267670]:: There was an
  issue with using the `iptables` command with the `-w` option to make the
  `iptables` command wait to acquire the *xtables* lock, causing some SDN
  initializations to fail. This issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1272201[BZ 1272201]:: When installing a clustered etcd and defining variables for IP and etcd
  interfaces when using two network interfaces, the certificate would be populated
  with only the first network, instead of whichever network was desired. The issue
  has now been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1269256[BZ 1269256]:: Using the `GET` `*fieldSelector*` would return a 500 BadRequest error. This issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1268000[BZ 1268000]:: Previously, creating an application from a image stream could result in two builds being initiated. This was caused by the wrong image stream tag being used by the build process. The issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1267231[BZ 1267231]:: The *ose-ha-proxy* router image was missing the `X-Forwarded` headers, causing the Jenkins application to redirect to HTTP instead of HTTPS. The issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1276548[BZ 1276548]:: Previously, an error was present where the HAProxy router did not expose statistics, even if the port was specified. The issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1275388[BZ 1275388]:: Previously, some node hosts would not talk to the SDN due to routing table differences. A `*lbr0*` entry was causing traffic to be routed incorrectly. The issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1265187[BZ 1265187]:: When persistent volume claims (PVC) were created from a template, sometimes the same volume would be mounted to multiple PVCs. At the same time, the volume would show that only one PVC was being used. The issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1279308[BZ 1279308]:: Previously, using a etcd storage location other than the default, as defined in the master configuration file, would result in an upgrade fail at the "generate etcd backup" stage. This issue has now been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1276599[BZ 1276599]:: Basic authentication passwords can now contain colons.
  https://bugzilla.redhat.com/show_bug.cgi?id=1279744[BZ 1279744]:: Previously, giving `*EmptyDir*` volumes a different default permission setting and group ownership could affect deploying the *postgresql-92-rhel7* image. The issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1276395[BZ 1276395]:: Previously, an error could occur when trying to perform an HA install using Ansible, due to a problem with SRC files. The issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1267733[BZ 1267733]:: When installing a etcd cluster with hosts with different network interfaces, the install would fail. The issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1274239[BZ 1274239]:: Previously, when changing the default project region from *infra* to *primary*, old route and registry pods are stuck in the terminating stage and could not be deleted, meaning that new route and registry pods could not be deployed. The issue has been fixed.
  https://bugzilla.redhat.com/show_bug.cgi?id=1278648[BZ 1278648]:: If, when upgrading to OpenShift Enterprise 3.1, the OpenShift Enterprise repository was not set, a Python error would occur. This issue has been fixed.
  
  [[ose-31-technology-preview]]
  
  