openshift-docs/microshift_release_notes/microshift-4-19-release-notes.adoc

:_mod-docs-content-type: ASSEMBLY
[id="microshift-4-19-release-notes"]
= {product-title} {product-version} release notes
include::_attributes/attributes-microshift.adoc[]
:context: release-notes

toc::[]

{product-title-first} provides developers and IT organizations with small-form-factor and edge computing delivered as an application that customers can deploy on top of their managed {op-system-base-full} devices at the edge. Built on {OCP} and Kubernetes, {microshift-short} provides an efficient way to operate single-node clusters in low-resource edge environments.

{microshift-short} is designed to make control plane restarts economical and be lifecycle-managed as a single unit by the operating system. Updates, roll-backs, and configuration changes consist of simply staging another version in parallel and then - without relying on a network - flipping to and from that version and restarting.

[id="microshift-4-19-about-this-release_{context}"]
== About this release
Version {product-version} of {microshift-short} includes new features and enhancements. Update to the latest version of {microshift-short} to receive all of the latest features, bug fixes, and security updates. {microshift-short} is derived from {OCP} {ocp-version} and uses the CRI-O container runtime. New features, changes, and known issues that pertain to {microshift-short} are included in this topic.

You can deploy {microshift-short} clusters to on-premise, cloud, disconnected, and offline environments.

{microshift-short} {product-version} is supported on {op-system-base-full} 9.6.

For lifecycle information, see the link:https://access.redhat.com/product-life-cycles?product=Red%20Hat%20build%20of%20Microshift,Red%20Hat%20Device%20Edge[{product-title} Life Cycle Policy].

[id="microshift-4-19-new-features-and-enhancements_{context}"]
== New features and enhancements

This release adds improvements related to the following components and concepts.

//L3 major categories with features in each as L4s
//[id="microshift-4-19-rhel_{context}"]
//=== {op-system-base-full}
//Image mode for RHEL here if GA; otherwise leave in TP

//4.19 is not an EUS release
[id="microshift-4-19-updating_{context}"]
=== Updating
Updates for both single-version minor releases and patch releases are supported. See xref:../microshift_updating/microshift-update-options.adoc#microshift-update-options[Update options with {product-title} and {op-system-bundle}] for details.

//TODO add new features and enhancements as needed, follow doc TOC titles as L3s, then add L4 headings for each feature

[id="microshift-4-19-configuring_{context}"]
=== Configuring

//[id="microshift-4-19-ingress-controller-two-config_{context}"]
//==== Control ingress for your use case with additional parameters
//add phase 2 ingress control parameters announcement here

[id="microshift-4-19-tls-config_{context}"]
==== {microshift-short} control plane enhanced with TLS
With this release, configurable transport layer security (TLS) protocols on internal control plane components are enabled to help prevent known insecure protocols, ciphers, or algorithms from accessing the applications you run on {microshift-short}. You use either the TLS 1.2 or TLS 1.3 with {microshift-short}. For more information, see xref:../microshift_configuring/microshift_auth_security/microshift-tls-config.adoc#microshift-tls-config[Configuring TLS security profiles].

//[id="microshift-4-19-running-apps_{context}"]
//=== Running applications

[id="microshift-4-19-greenboot-updated_{context}"]
==== Check application health with the {microshift-short} healthcheck command

With this release, you can use the `microshift healthcheck` command with various options to run a basic health check on your applications. For more information, see xref:../microshift_running_apps/microshift-greenboot-workload-health-checks.adoc#microshift-greenboot-workload-health-checks[Greenboot workload health checks].

[id="microshift-4-19-support_{context}"]
=== Support

[id="microshift-4-19-telemetry_{context}"]
==== Telemetry now available
With this release, {microshift-short} adds the Telemeter API. Lightweight attributes can be sent from a connected cluster to Red{nbsp}Hat to monitor the health of the cluster. To opt-out of Telemetry, see xref:../microshift_support/microshift-remote-cluster-monitoring.adoc#microshift-remote-cluster-monitoring[Remote health monitoring with a connected cluster].

//[id="microshift-4-19-doc-enhancements_{context}"]
//=== Documentation enhancements

//[id="microshift-4-19-storage-docs-update_{context}"]
//==== Updated content in the storage section

[id="microshift-4-19-notable-technical-changes_{context}"]
== Notable technical changes

[id="microshift-4-19-multus-standard-install_{context}"]
=== Multus CNI manifests included in the {microshift-short} RPM

With this release, the {microshift-short} RPM includes the {microshift-short} multiple networking plug-in. To deploy the Multus container network interface (CNI), you can either set the value in the {microshift-short} configuration file, or install the `microshift-multus` RPM, which contains a configuration snippet. For more information, see xref:../microshift_networking/microshift_multiple_networks/microshift-cni-multus.adoc#microshift-cni-multus[About using multiple networks].

[id="microshift-4-19-tech-preview_{context}"]
== Technology Preview features

Some features in this release are currently in Technology Preview. These experimental features are not intended for production use. Note the following scope of support on the Red{nbsp}Hat Customer Portal for these features:

link:https://access.redhat.com/support/offerings/techpreview[Technology Preview Features Support Scope]

[id="microshift-4-19-ai_{context}"]
=== Red{nbsp}Hat OpenShift AI with {microshift-short}

[id="microshift-4-19-example-ra-feature_{context}"]
==== Serve your trained models on edge deployments

With this release, a streamlined version of Red{nbsp}Hat OpenShift AI (RHOAI) can be used to serve artificial intelligence or machine learning (AI/ML) models on {microshift-short}. Develop and train your AI models in the data center or cloud, then deploy them to the edge where these models can make decisions without a human user. For more information, see xref:../microshift_ai/microshift-rhoai.adoc#microshift-rhoai[Using Red{nbsp}Hat OpenShift AI with {microshift-short}].

//TODO Gateway API might TP with this 4.19; there is no current epic. Discuss with PM as the release approaches.

//TODO verify the status of image mode; might GA with this release
//[id="microshift-4-19-rhel-image-mode_{context}"]
//=== {op-system-base-full} image mode Technology Preview feature
//* You can install {microshift-short} using a `bootc` container image. Image mode for {op-system-base} is a Technology Preview deployment method that uses a container-native approach to build, deploy and manage the operating system as a bootc container image.

//See xref:../microshift_install_bootc/microshift-install-rhel-image-mode.adoc#microshift-install-rhel-image-mode[Using image mode for RHEL with {microshift-short}] for more information.

[id="microshift-4-19-deprecated-and-removed-features_{context}"]
== Deprecated and removed features

Some features available in previous releases have been deprecated or removed. Deprecated functionality is still included in and continues to be supported, but will be removed in a future release. Deprecated features and functionality are not recommended for new deployments.

[id="microshift-4-19-app-greenboot-script-deprecated_{context}"]
=== Greenboot application health check script functions deprecated

The following functions related to checking workload health in the `/usr/share/microshift/functions/greenboot.sh` script are deprecated:

* `wait_for`
* `namespace_images_downloaded`
* `namespace_deployment_ready`
* `namespace_daemonset_ready`
* `namespace_pods_ready`
* `namespace_pods_not_restarting`
* `print_failure_logs`
* `log_failure_cmd`
* `log_script_exit`
* `lvmsDriverShouldExist`
* `csiComponentShouldBeDeploy`

//NOTE: Do NOT repeat bug fixes already noted in previous version z-streams
[id="microshift-4-19-bug-fixes_{context}"]
== Bug fixes

//[discrete]
//[id="microshift-4-19-installation-bug-fixes"]
//=== Installation

[id="microshift-4-19-additional-release-notes_{context}"]
== Additional release notes
Release notes for related components and products are available in the following documentation:

[NOTE]
====
The following release notes are for downstream Red{nbsp}Hat products only; upstream or community release notes for related products are not included.
====

//TODO check the latest gitops release version
[id="microshift-4-19-additional-release-notes-gitops_{context}"]
=== GitOps release notes
See link:https://docs.redhat.com/en/documentation/red_hat_openshift_gitops/1.15/html/release_notes/index[Red{nbsp}Hat OpenShift GitOps 1.15: Highlights of what is new and what has changed with this OpenShift GitOps release] for more information. You can also go to the Red{nbsp}Hat package download page and search for "gitops" if you just need the latest package, link:https://access.redhat.com/downloads/content/package-browser[Red{nbsp}Hat packages].

[id="microshift-4-19-additional-release-notes-ocp_{context}"]
=== {OCP} release notes
See the https://docs.openshift.com/container-platform/4.19/release_notes/ocp-4-19-release-notes.html[{OCP} Release Notes] for information about the Operator Lifecycle Manager and other components. Not all of the changes to {OCP} apply to {microshift-short}. See the specific {microshift-short} implementation of an Operator or function for more information.

[id="microshift-4-19-additional-release-notes-rhel_{context}"]
=== {op-system-base-full} release notes
See the link:https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/9.6_release_notes/index[Release Notes for Red{nbsp}Hat Enterprise Linux 9.6] for more information about {op-system-base}.
//Use the latest compatible RHEL, expected to be 9.6

[id="microshift-4-19-additional-release-notes-rhoai_{context}"]
=== {rhoai} release notes
See the link:https://docs.redhat.com/en/documentation/red_hat_openshift_ai_self-managed/latest-1/html/release_notes/index[Release notes] for more information about {rhoai}.
//TODO rhoai has a faster release cadence than OCP; get `latest` tag working

[id="microshift-4-19-asynchronous-errata-updates_{context}"]
== Asynchronous errata updates

Security, bug fix, and enhancement updates for {microshift-short} {product-version} are released as asynchronous errata through the Red{nbsp}Hat Network. All {microshift-short} {product-version} errata are https://access.redhat.com/downloads/content/290/[available on the Red{nbsp}Hat Customer Portal]. For more information about asynchronous errata, read the https://access.redhat.com/product-life-cycles?product=Red%20Hat%20build%20of%20Microshift,Red%20Hat%20Device%20Edge[{microshift-short} Life Cycle].

Red{nbsp}Hat Customer Portal users can enable errata notifications in the account settings for Red{nbsp}Hat Subscription Management (RHSM). When errata notifications are enabled, you are notified through email whenever new errata relevant to your registered systems are released.

[NOTE]
====
Red{nbsp}Hat Customer Portal user accounts must have systems registered and consuming {microshift-short} entitlements for {microshift-short} errata notification emails to generate.
====

This section is updated over time to provide notes on enhancements and bug fixes for future asynchronous errata releases of {microshift-short} {product-version}. Versioned asynchronous releases, for example with the form {microshift-short} {product-version}.z, are detailed in the following subsections.

[id="microshift-4-19-0-dp_{context}"]
=== RHEA-2025:1234 - {microshift-short} 4.19.0 bug fix and security update advisory

Issued: XX Month 2025

{product-title} release 4.19.0 is now available. Bug fixes and enhancements are listed in the link:https://access.redhat.com/errata/RHEA-2025:1234[RHEA-2025:1234] advisory. Release notes for bug fixes and enhancements are provided in this documentation. The images that are included in the update are provided by the {OCP} link:https://access.redhat.com/errata/RHSA-2025:1234[RHSA-2025:1234] advisory.

See the latest images included with {microshift-short} by xref:../microshift_updating/microshift-list-update-contents.adoc#microshift-get-rpm-release-info_microshift-list-update-contents[listing the contents of the {microshift-short} RPM release package].