Release Notes and Known Issues

Red Hat OpenShift Local 2.14

Highlighted features and identified problems in Red Hat OpenShift Local 2.14

Fabrice Flore-Thebault

Red Hat Developer Group Documentation Team

Abstract

This document lists and briefly describes new and improved features of Red Hat OpenShift Local 2.14. It also contains information about potential problems you may encounter while using the software. Where possible, workarounds are described for identified issues.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message.

Part I. Release notes

This section documents the most important features and bug fixes in the Red Hat OpenShift Local 2.14 product.

Chapter 1. Component versions

Red Hat OpenShift Local 2.14 has the following versions of the main components:

Table 1.1. Red Hat OpenShift Local, Component versions

ComponentVersion

OpenShift Container Platform

4.12.1

OpenShift client binary (oc)

v4.12.1

Podman binary

4.3.1

Chapter 2. Minimum system requirements

Red Hat OpenShift Local has the following minimum hardware and operating system requirements.

2.1. Hardware requirements

Red Hat OpenShift Local is supported on AMD64, Intel 64, and Apple Silicon architectures. Red Hat OpenShift Local does not support nested virtualization.

Depending on the desired container runtime, Red Hat OpenShift Local requires the following system resources:

2.1.1. For OpenShift Container Platform

  • 4 physical CPU cores
  • 9 GB of free memory
  • 35 GB of storage space
Note

The OpenShift Container Platform cluster requires these minimum resources to run in the Red Hat OpenShift Local instance. Some workloads may require more resources. To assign more resources to the Red Hat OpenShift Local instance, see Configuring the instance.

2.1.2. For the Podman container runtime

  • 2 physical CPU cores
  • 2 GB of free memory
  • 35 GB of storage space

2.2. Operating system requirements

Red Hat OpenShift Local requires the following minimum version of a supported operating system:

2.2.1. Microsoft Windows

  • On Microsoft Windows, Red Hat OpenShift Local requires the Windows 10 Fall Creators Update (version 1709) or later. Red Hat OpenShift Local does not work on earlier versions of Microsoft Windows. Microsoft Windows 10 Home Edition is not supported.

2.2.2. macOS

  • On macOS, Red Hat OpenShift Local requires macOS 11 Big Sur or later. Red Hat OpenShift Local does not work on earlier versions of macOS.

2.2.3. Linux

  • Red Hat provides support for Red Hat OpenShift Local on the two latest minor releases of Red Hat Enterprise Linux and CentOS 8 or 9, and the two latest stable releases of Fedora.
  • When using Red Hat Enterprise Linux, the machine running Red Hat OpenShift Local must be registered with the Red Hat Customer Portal.
  • Ubuntu 18.04 LTS or later and Debian 10 or later are not supported and may require manual set up of the host machine.
  • See Required software packages to install the required packages for your Linux distribution.

Chapter 3. Changes and improvements

These are some notable changes introduced in Red Hat OpenShift Local 2.14.

3.1. Notable enhancements

  • Red Hat OpenShift Local brings a minimal, preconfigured OpenShift Container Platform 4 cluster or Podman container runtime to your local notebook or desktop computer for development and testing purposes. Red Hat OpenShift Local has a Red Hat Enterprise Linux virtual machine that supports native hypervisors for Linux, macOS, and Microsoft Windows 10.

    • Red Hat OpenShift Local is designed for local development and testing on an OpenShift 4 cluster or Podman container runtime. To run an OpenShift 3 cluster locally, see Red Hat Container Development Kit.

3.2. Technology Preview

Support for these features falls under the Technology Preview Features Support Scope.

  • Red Hat OpenShift Local 2.14 includes the ability to create a custom bundle based on the currently running cluster with the crc bundle generate command. This command, its parameters, and behavior might change in incompatible ways in future releases.

3.3. Notable changes

  • Red Hat OpenShift Local 2.14 provides OpenShift Container Platform 4.12.1 as the embedded OpenShift version.
  • Red Hat OpenShift Local 2.14 provides Podman 4.3.1.
  • The crc oc-env and crc podman-env commands work on PowerShell Core. See commit.
  • The crc podman-env --root output adds the missing --root to the printed instructions. See issue #3492.

Part II. Known issues

Issues that users of Red Hat OpenShift Local 2.14 might have, as well as possible workarounds for these issues.

Chapter 4. General issues

Issues affecting all supported platforms.

4.1. SSH key mismatch error

The crc cleanup command does not remove the Red Hat OpenShift Local instance SSH key from the user SSH known hosts.

Therefore, when attempting to access the Red Hat OpenShift Local instance with a command such as podman-remote, you might receive this error message:

Error: failed to connect: ssh: handshake failed: knownhosts: key mismatch

Workaround

  • Remove the leftover SSH key from the SSH know hosts:

    $ ssh-keygen -R $(crc ip)

Additional resources

4.2. Proxy settings are improperly applied to the Podman preset

Proxy settings configured by using the crc config set command are not used by the podman-remote binary embedded in Red Hat OpenShift Local when the Podman preset is in use.

4.3. Red Hat OpenShift Local disables metrics by default

To ensure Red Hat OpenShift Local can run on a typical notebook, Red Hat OpenShift Local disables some resource-heavy services, such as Prometheus and all the related monitoring, alerting, and telemetry functions. You can enable these features.

You cannot disable Monitoring after enabling these features.

Workaround

To disable monitoring again:

  1. Delete the virtual machine:

    $ crc delete
  2. Create a virtual machine:

    $ crc start

4.4. Enabling many Operators requires more memory than the default

The crc start command assigns 9 GiB of memory to the Red Hat OpenShift Local virtual machine by default. Enabling many Operators might increase memory requirements.

Workaround

4.5. Red Hat OpenShift Local does not work when the first nameserver is IPv6

DNS resolution to the Red Hat OpenShift Local virtual machine might fail if the first nameserver is IPv6.

Workaround

  • Specify an IPv4 nameserver when starting the Red Hat OpenShift Local virtual machine by using the -n flag:

    $ crc start -n 8.8.8.8

Chapter 5. Issues on macOS

This section describes Red Hat OpenShift Local issues that affect users on a macOS host.

5.1. Hibernation causes VM time to desynchronize

Time in the Red Hat OpenShift Local virtual machine can become desynchronized with the time on your host machine. This issue occurs if the Red Hat OpenShift Local virtual machine is running when the host machine enters hibernation.

Workaround

  1. Stop the Red Hat OpenShift Local virtual machine:

    $ crc stop
  2. Restart the Red Hat OpenShift Local virtual machine:

    $ crc start

Chapter 6. Issues on Microsoft Windows

This section describes Red Hat OpenShift Local issues that affect users on a Microsoft Windows host.

6.1. Completing the installation after installation with the Microsoft Standard Installer (MSI)

Procedure

  1. Install Red Hat OpenShift Local with the MSI installer
  2. Reboot your computer
  3. Run the command in Command Prompt or PowerShell:

    $ crc setup

6.2. The crc cleanup command might fail with a permission error

Running crc setup followed by crc cleanup without restarting your host computer between commands will cause crc cleanup to report the following error:

Post "http://unix/clean": open \\.\pipe\crc-admin-helper: Access is denied.

Workaround

  1. Reboot your computer
  2. Run the command:

    $ crc cleanup

6.3. Unexpected behavior when run outside %WINDRIVE%

The Hyper-V driver will fail when you start the crc binary from a network drive.

Workaround

  • Move the crc binary to a location on %WINDRIVE%.

    %WINDRIVE% is usually set to C:\.

6.4. Red Hat OpenShift Local expects FullLanguage support in PowerShell

Red Hat OpenShift Local supports the ConstrainedLanguage PowerShell mode with exceptions determined by your system administrator.

6.5. The crc oc-env command does not work with special characters in %PATH%

On Microsoft Windows, PowerShell and Command Prompt do not use the UTF-8 encoding. Therefore, running the crc oc-env command with special characters present in the %PATH% will not accurately encode UTF-8 characters.

Workaround

  • Move the crc binary to a location containing no special characters.

Additional resources

Legal Notice

Copyright © 2023 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.