Additional updates for ubuntu

adegeo · adegeo · commit 8241c5dccece · 2024-11-04T12:58:48.000-08:00
diff --git a/docs/core/install/includes/linux-release-wait.md b/docs/core/install/includes/linux-release-wait.md
@@ -1,10 +1,10 @@
 ---
 author: adegeo
 ms.author: adegeo
-ms.date: 11/14/2023
+ms.date: 11/04/2024
 ms.topic: include
 ms.custom: linux-related-content
 ---
 
 > [!IMPORTANT]
-> .NET 8 was released on November 14, 2023. It may take time for the packages to appear in the package manager feeds.
+> .NET 9 was released on November 12, 2024. It may take time for the packages to appear in the package manager feeds, or for your specific Linux distribution to include it.
diff --git a/docs/core/install/includes/linux-ubuntu-feed-sdk-note.md b/docs/core/install/includes/linux-ubuntu-feed-sdk-note.md
@@ -1,10 +1,10 @@
 ---
 author: adegeo
 ms.author: adegeo
-ms.date: 05/24/2023
+ms.date: 11/04/2024
 ms.topic: include
 ms.custom: linux-related-content
 ---
 
 > [!IMPORTANT]
-> .NET SDK versions offered by Canonical are always in the [.1xx feature band](../../versions/index.md#versioning-details). If you want to use a newer feature band release, use the [Microsoft feed to install the SDK](../linux-ubuntu.md#register-the-microsoft-package-repository). Make sure you review the information in the [.NET package mix ups on Linux](../linux-package-mixup.md?pivots=os-linux-ubuntu#whats-going-on) article to understand the implications of switching between repository feeds.
+> If you're using .NET 8 SDK and Ubuntu 22.04, understand that SDK versions offered by Canonical are always in the [.1xx feature band](../../versions/index.md#versioning-details). If you want to use a newer feature band release, use the [Microsoft feed to install the SDK](../linux-ubuntu.md#register-the-microsoft-package-repository). Make sure you review the information in the [.NET package mix ups on Linux](../linux-package-mixup.md?pivots=os-linux-ubuntu#whats-going-on) article to understand the implications of switching between repository feeds.
diff --git a/docs/core/install/includes/linux-ubuntu-package-feed-both.md b/docs/core/install/includes/linux-ubuntu-package-feed-both.md
@@ -1,9 +1,9 @@
 ---
 author: adegeo
 ms.author: adegeo
-ms.date: 03/18/2024
+ms.date: 11/04/2024
 ms.topic: include
 ms.custom: linux-related-content
 ---
 
-.NET is available in the Ubuntu package manager feeds, as well as the Microsoft package repository. However, you should only use one or the other to install .NET. If you want to use the Microsoft package repository, see [How to register the Microsoft package repository](../linux-ubuntu.md#register-the-microsoft-package-repository).
+.NET is available in the Ubuntu package manager feeds, as well as the Microsoft package repository. However, you should only use one or the other to install .NET. Microsoft recommends that you use the Ubuntu package manager feeds. If you want to use the Microsoft package repository, see [How to register the Microsoft package repository](../linux-ubuntu.md#register-the-microsoft-package-repository).
diff --git a/docs/core/install/linux-alpine.md b/docs/core/install/linux-alpine.md
@@ -19,7 +19,7 @@ If you're using Docker, consider using [official .NET Docker images](../docker/i
 
 ## Install .NET
 
-[!INCLUDE [linux-apk-install-60](includes/linux-install-80-apk.md)]
+[!INCLUDE [linux-apk-install-80](includes/linux-install-80-apk.md)]
 
 ## Supported distributions
 
diff --git a/docs/core/install/linux-package-mixup.md b/docs/core/install/linux-package-mixup.md
@@ -3,7 +3,7 @@ title: Troubleshoot .NET package mix ups on Linux
 description: Learn about how to troubleshoot strange .NET package errors on Linux. These errors may occur when you run the dotnet command.
 author: omajid
 ms.author: adegeo
-ms.date: 03/01/2023
+ms.date: 11/04/2024
 ms.custom: linux-related-content
 no-loc: ['usr','lib64','share','dotnet','libhostfxr.so', 'fxr', 'FrameworkList.xml', 'System.IO.FileNotFoundException']
 zone_pivot_groups: operating-systems-set-two
@@ -40,6 +40,9 @@ One symptom of these problems is that both the `/usr/lib64/dotnet` and `/usr/sha
 
 ## What's going on
 
+> [!IMPORTANT]
+> Starting with .NET 9 (currently in preview), Microsoft only publishes packages for supported Linux distributions that don't publish their own packages. For more information, see [Install .NET on Linux](linux.md#packages).
+
 These errors usually occur when two Linux package repositories provide .NET packages. While Microsoft provides a Linux package repository to source .NET packages, some Linux distributions also provide .NET packages. These distributions include:
 
 - Alpine Linux
diff --git a/docs/core/install/linux-ubuntu.md b/docs/core/install/linux-ubuntu.md
@@ -3,15 +3,15 @@ title: .NET and Ubuntu overview
 description: Learn about the ways you can install .NET on Ubuntu, either from the built-in package feed, the .NET backports repository, or the Microsoft repository.
 author: adegeo
 ms.author: adegeo
-ms.date: 05/14/2024
+ms.date: 11/04/2024
 ms.custom: updateeachrelease, linux-related-content
 ---
 
 # Overview of .NET on Ubuntu
 
 This article describes how to install .NET on Ubuntu. Starting with Ubuntu 22.04, most supported versions of .NET are available in the built-in Ubuntu feed. The Ubuntu .NET backports package repository contains the remaining supported .NET versions. For more information about available versions, see the [Supported distributions](#supported-distributions) section.
 
-Additionally, for Ubuntu 23.10 and previous versions, the Microsoft package repository contains every version of .NET that is currently, or was previously, supported.
+Canonical has taken over publishing .NET on Ubuntu. Starting with Ubuntu 22.04, Microsoft no longer distributes .NET for Ubuntu to the Microsoft package repository.
 
 > [!WARNING]
 > It's recommended that you choose between either Ubuntu or Microsoft feeds to source .NET packages. Don't mix .NET packages from multiple package repositories, as this leads to problems when apps try to resolve a specific version of .NET.
@@ -23,6 +23,12 @@ Additionally, for Ubuntu 23.10 and previous versions, the Microsoft package repo
 | [Package manager<br>(Microsoft feed)](#register-the-microsoft-package-repository) | <ul><li>Supported versions always available.</li><li>Patches are available right way.</li><li>Dependencies are included.</li><li>Easy removal.</li></ul> | <ul><li>Not available for Ubuntu 24.04+.</li><li>Requires registering the Microsoft package repository.</li><li>Preview releases aren't available.</li><li>Only supports x64 Ubuntu.</li></ul> |
 | [Script \ Manual extraction](linux-scripted-manual.md) | <ul><li>Control where .NET is installed.</li><li>Preview releases are available.</li></ul> | <ul><li>Manually install updates.</li><li>Manually install dependencies.</li><li>Manual removal.</li></ul> |
 
+## Considerations when upgrading Ubuntu
+
+Upgrading Ubuntu to 22.04 or later? Consider uninstalling .NET first.
+
+If you used a package manager to install .NET from the Microsoft package repository, you'll end up with a package mix-up problem after upgrading Ubuntu. Now that Canonical publishes .NET to the package feeds for Ubuntu 22.04 (and later versions), the package manager won't know about the previously installed .NET version. The packages can't be upgraded to the latest .NET. First, uninstall them, then reinstall them from the [Ubuntu package repository].
+
 ## Decide how to install .NET
 
 When your version of Ubuntu supports .NET through the built-in or .NET backports Ubuntu feed, support for those builds of .NET is provided by Canonical and the builds might be optimized for different workloads. Microsoft provides support for packages in the Microsoft package repository feed.
@@ -44,9 +50,8 @@ Use the following sections to determine how you should install .NET:
 
 Install .NET through the Ubuntu feed. For more information, see the following pages:
 
+- [Install .NET on Ubuntu 24.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2410).
 - [Install .NET on Ubuntu 24.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404).
-- [Install .NET on Ubuntu 23.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2310).
-- [Install .NET on Ubuntu 23.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2304).
 - [Install .NET on Ubuntu 22.04](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2204).
 
 [!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)]
@@ -58,8 +63,6 @@ If you're going to install the Microsoft repository to use other Microsoft packa
 Use the instructions on the version-specific Ubuntu page.
 
 - [20.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2004)
-- [18.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-1804)
-- [16.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-1604)
 
 Review the [Supported distributions](#supported-distributions) section for more information about what versions of .NET are supported for your version of Ubuntu. If you're installing a version that isn't supported, see [Register the Microsoft package repository](#register-the-microsoft-package-repository).
 
@@ -113,7 +116,7 @@ Starting with .NET 8 on Ubuntu 24.04, Canonical supports .NET for the IBM System
 
 Install .NET through the built-in Ubuntu feed. For more information, see the following page:
 
-- [Install .NET 8 on Ubuntu 24.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404&tabs=dotnet8).
+- [Install .NET 8 on Ubuntu 24.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2410&tabs=dotnet8).
 
 ## Supported distributions
 
@@ -125,11 +128,8 @@ The following table is a list of currently supported .NET releases and the versi
 |--------------------------------------------------------------------|-------------------------|--------------------------------------|--------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------|
 | [24.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2410)       | 9.0, 8.0                | 9.0, 8.0                             | None                                                                                                   | None                                                                         |
 | [24.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2404) | 9.0, 8.0, 6.0           | 8.0                                  | 9.0, 7.0, 6.0                                                                                          | None                                                                         |
-| [23.10](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2310)       | 8.0, 6.0                | 8.0, 7.0, 6.0                        | None                                                                                                   | 8.0, 7.0, 6.0                                                                |
 | [22.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2204) | 9.0, 8.0, 6.0           | 8.0, 7.0, 6.0                        | 9.0                                                                                                    | 8.0, 7.0, 6.0, 3.1                                                           |
 | [20.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-2004) | 8.0, 6.0                | None                                 | None                                                                                                   | 8.0, 7.0. 6.0, 5.0, 3.1, 2.1                                                 |
-| [18.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-1804) | 6.0                     | None                                 | None                                                                                                   | 7.0. 6.0, 5.0, 3.1, 2.2, 2.1                                                 |
-| [16.04 (LTS)](linux-ubuntu-install.md?pivots=os-linux-ubuntu-1604) | 6.0                     | None                                 | None                                                                                                   | 6.0, 5.0, 3.1, 3.0, 2.2, 2.1, 2.0                                            |
 
 > [!IMPORTANT]
 > .NET 9 is currently in preview.
@@ -184,6 +184,9 @@ sudo apt install software-properties-common
 
 ## Register the Microsoft package repository
 
+> [!IMPORTANT]
+> This only applies to Ubuntu versions prior to 24.04. Starting with Ubuntu 24.04, Microsoft no longer publishes packages to the Microsoft package repository. Use the  [supported distributions table](#supported-distributions) to determine the best way to install .NET.
+
 The Microsoft package repository contains all versions of .NET that were previously, or are currently, [supported with your version of Ubuntu](#supported-distributions). If your version of Ubuntu provides .NET packages, you'll need to deprioritize the Ubuntu packages and use the Microsoft repository. For instructions on how to deprioritize the packages, see [I need a version of .NET that isn't provided by my Linux distribution](linux-package-mixup.md?pivots=os-linux-ubuntu#i-need-a-version-of-net-that-isnt-provided-by-my-linux-distribution).
 
 > [!IMPORTANT]
@@ -223,7 +226,7 @@ sudo apt update
 
 ## Install .NET
 
-After you've [registered the Microsoft package repository](#register-the-microsoft-package-repository), or if the Ubuntu Feeds supports the .NET package for your Ubuntu version, you can install .NET through the package manager with the `sudo apt install <package-name>` command. Replace `<package-name>` with the name of the .NET package you want to install. For example, to install .NET SDK 8.0, use the command `sudo apt install dotnet-sdk-8.0`. The following table lists the currently supported .NET packages:
+Install .NET through the package manager with the `sudo apt install <package-name>` command. Replace `<package-name>` with the name of the .NET package you want to install. For example, to install .NET SDK 8.0, use the command `sudo apt install dotnet-sdk-8.0`. The following table lists the currently supported .NET packages (which [may vary by your Ubuntu version](#supported-distributions)):
 
 || Product      | Type    | Package                  |
 |---------|--------------|---------|--------------------------|
@@ -234,8 +237,6 @@ After you've [registered the Microsoft package repository](#register-the-microso
 | **6.0**    | .NET         | Runtime | `dotnet-runtime-6.0`     |
 | **6.0**    | .NET         | SDK     | `dotnet-sdk-6.0`         |
 
-If you want to install an unsupported version of .NET, check the [Supported distributions](#supported-distributions) section to see if that version of .NET is available. Then, substitute the **version** of .NET you want to install. For example, to install ASP.NET Core 8.0, use the package name `aspnetcore-runtime-8.0`.
-
 > [!TIP]
 > If you're not creating .NET apps, install the ASP.NET Core runtime as it includes the .NET runtime and also supports ASP.NET Core apps.
 
diff --git a/docs/core/install/linux.md b/docs/core/install/linux.md
@@ -4,7 +4,7 @@ description: Learn about how .NET is available on Linux. .NET can be installed t
 author: adegeo
 ms.author: adegeo
 ms.custom: updateeachrelease, linux-related-content
-ms.date: 12/15/2023
+ms.date: 11/04/2024
 ---
 
 # Install .NET on Linux
@@ -19,16 +19,21 @@ This article describes how .NET is available on various Linux distributions. .NE
 
 ## Packages
 
-.NET is available in [official package archives](https://github.com/dotnet/core/blob/main/linux.md) for various Linux distributions and [packages.microsoft.com](https://packages.microsoft.com/).
+Starting with .NET 9 (currently in preview), Microsoft only publishes packages for supported Linux distributions that don't publish their own packages. Packages are published in the Microsoft package repository at <https://packages.microsoft.com/>. This includes the following Linux distributions:
 
-- [Alpine](linux-alpine.md)
+- Azure Linux 3.0
 - [Debian](linux-debian.md)
-- [Fedora](linux-fedora.md)
-- [openSUSE](linux-opensuse.md)
+- [openSUSE Leap](linux-opensuse.md)
 - [SUSE Enterprise Linux](linux-sles.md)
-- [Ubuntu](linux-ubuntu.md)
 
-.NET is [supported by Microsoft](https://github.com/dotnet/core/blob/main/microsoft-support.md) when downloaded from a Microsoft source. Best effort support is offered from Microsoft when downloaded from elsewhere. You can open issues at [dotnet/core](https://github.com/dotnet/core) if you run into problems.
+The following Linux distributions officially support .NET, and publish their own .NET packages:
+
+- Azure Linux 2.0 (CBL-Mariner)
+- [Alpine](linux-alpine.md)
+- [CentOS Stream](linux-rhel.md#centos-stream-9)
+- [Fedora](linux-fedora.md)
+- [Red Hat Enterprise Linux (RHEL)](linux-rhel.md)
+- [Ubuntu](linux-ubuntu.md)
 
 ## Snap
 
