From e2d83bb9975962bb09bc73e9e981f34a127e0392 Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Wed, 20 Nov 2024 11:42:13 -0800 Subject: [PATCH] Update status on Linux docs (#43671) * Update status on linux * Some other OS updates * Update rhel * Update fedora --- .../install/includes/linux-release-wait.md | 2 +- .../linux-ubuntu-register-backports.md | 13 ++++++ docs/core/install/linux-alpine.md | 37 ++++++++--------- docs/core/install/linux-debian.md | 31 ++------------ docs/core/install/linux-fedora.md | 10 ++--- docs/core/install/linux-opensuse.md | 13 +++++- docs/core/install/linux-rhel.md | 4 -- docs/core/install/linux-sles.md | 2 - docs/core/install/linux-snap-runtime.md | 4 +- docs/core/install/linux-snap-sdk.md | 4 +- docs/core/install/linux-ubuntu-install.md | 14 +++---- docs/core/install/macos.md | 41 +++++++------------ docs/core/install/windows.md | 4 -- 13 files changed, 76 insertions(+), 103 deletions(-) create mode 100644 docs/core/install/includes/linux-ubuntu-register-backports.md diff --git a/docs/core/install/includes/linux-release-wait.md b/docs/core/install/includes/linux-release-wait.md index 0dd515da05a3d..40846c4fbbddd 100644 --- a/docs/core/install/includes/linux-release-wait.md +++ b/docs/core/install/includes/linux-release-wait.md @@ -7,4 +7,4 @@ ms.custom: linux-related-content --- > [!IMPORTANT] -> .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. +> .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-register-backports.md b/docs/core/install/includes/linux-ubuntu-register-backports.md new file mode 100644 index 0000000000000..356360fb3ece0 --- /dev/null +++ b/docs/core/install/includes/linux-ubuntu-register-backports.md @@ -0,0 +1,13 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/20/2024 +ms.topic: include +ms.custom: linux-related-content +--- + +.NET is available in the Ubuntu .NET backports package repository. To add the repository, open a terminal and run the following command: + +```bash +sudo add-apt-repository ppa:dotnet/backports +``` diff --git a/docs/core/install/linux-alpine.md b/docs/core/install/linux-alpine.md index 547566e158971..8caef11b4a8aa 100644 --- a/docs/core/install/linux-alpine.md +++ b/docs/core/install/linux-alpine.md @@ -17,12 +17,6 @@ If you're using Docker, consider using [official .NET Docker images](../docker/i [!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)] -## Install .NET - -[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] - -[!INCLUDE [linux-apk-install-90](includes/linux-install-90-apk.md)] - ## Supported distributions The following table is a list of currently supported .NET releases and the versions of Alpine they're supported on. These versions remain supported until either the version of [.NET reaches end-of-support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) or the version of [Alpine reaches end-of-life](https://alpinelinux.org/releases/). @@ -32,13 +26,25 @@ The following table is a list of currently supported .NET releases and the versi | 3.20 | 9.0, 8.0 | 8.0, 6.0 | | 3.19 | 9.0, 8.0 | 7.0, 6.0 | | 3.18 | 8.0 | 7.0, 6.0 | -| 3.17 | 8.0 | 7.0, 6.0 | - -> [!IMPORTANT] -> Alpine 3.17 reaches end-of-life on November 22, 2024. [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] +## Install .NET + +# [.NET 9](#tab/dotnet9) + +Not supported on Alpine 3.18. + +[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] + +[!INCLUDE [linux-apk-install-90](includes/linux-install-90-apk.md)] + +# [.NET 8](#tab/dotnet8) + +[!INCLUDE [linux-apk-install-90](includes/linux-install-90-apk.md)] + +--- + ## Supported architectures The following table is a list of currently supported .NET releases and the architecture of Alpine they're supported on. These versions remain supported until either the version of [.NET reaches end-of-support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) or the architecture of [Alpine is supported#](https://alpinelinux.org/releases/). Note that only `x86_64`, `armv7`, `aarch64` is officially supported by Microsoft. Other architectures are supported by the distribution maintainers, and can be installed using the `apk` package manager. @@ -75,17 +81,6 @@ When you install with a package manager, these libraries are installed for you. - zlib - libgdiplus (if the .NET app requires the *System.Drawing.Common* assembly) -### 3.15 - 3.17 - -- icu-libs -- krb5-libs -- libgcc -- libintl -- libssl3 -- libstdc++ -- zlib -- libgdiplus (if the .NET app requires the *System.Drawing.Common* assembly) - Use the `apk add` command to install the dependencies. [!INCLUDE [linux-libgdiplus-general](includes/linux-libgdiplus-general.md)] diff --git a/docs/core/install/linux-debian.md b/docs/core/install/linux-debian.md index 9c28f09d1088b..c593bc84c5352 100644 --- a/docs/core/install/linux-debian.md +++ b/docs/core/install/linux-debian.md @@ -22,7 +22,6 @@ The following table is a list of currently supported .NET releases and the versi | Debian | .NET | |--------|---------| | 12 | 9, 8 | -| 11 | 8 | [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] @@ -36,8 +35,6 @@ The following table is a list of currently supported .NET releases and the versi ## Debian 12 -[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] - [!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)] ```bash @@ -46,35 +43,15 @@ sudo dpkg -i packages-microsoft-prod.deb rm packages-microsoft-prod.deb ``` -[!INCLUDE [linux-apt-install-90](includes/linux-install-90-apt.md)] - -## Debian 11 +# [.NET 9](#tab/dotnet9) -[!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)] +[!INCLUDE [linux-apt-install-90](includes/linux-install-90-apt.md)] -```bash -wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb -sudo dpkg -i packages-microsoft-prod.deb -rm packages-microsoft-prod.deb -``` +# [.NET 8](#tab/dotnet8) [!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] -## Debian 10 - -[!INCLUDE [linux-prep-intro-apt](includes/linux-prep-intro-apt.md)] - -```bash -wget https://packages.microsoft.com/config/debian/10/packages-microsoft-prod.deb -O packages-microsoft-prod.deb -sudo dpkg -i packages-microsoft-prod.deb -rm packages-microsoft-prod.deb -``` - -[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)] - -## How to install other versions - -[!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)] +--- ## Use APT to update .NET diff --git a/docs/core/install/linux-fedora.md b/docs/core/install/linux-fedora.md index 6d52e41e3134a..0655bb2082ea5 100644 --- a/docs/core/install/linux-fedora.md +++ b/docs/core/install/linux-fedora.md @@ -29,16 +29,16 @@ The following table is a list of currently supported .NET releases and the versi [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] -## Install .NET 9 +# [.NET 9](#tab/dotnet9) -[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] +[!INCLUDE [linux-dnf-install-90](includes/linux-install-90-dnf.md)] -[!INCLUDE [linux-dnf-install-80](includes/linux-install-90-dnf.md)] - -## Install .NET 8 +# [.NET 8](#tab/dotnet8) [!INCLUDE [linux-dnf-install-80](includes/linux-install-80-dnf.md)] +--- + ## Install preview versions [!INCLUDE [preview installs don't support package managers](./includes/linux-install-previews.md)] diff --git a/docs/core/install/linux-opensuse.md b/docs/core/install/linux-opensuse.md index aa1a98d3a4e04..1fd5ed71a0314 100644 --- a/docs/core/install/linux-opensuse.md +++ b/docs/core/install/linux-opensuse.md @@ -19,6 +19,11 @@ ms.custom: linux-related-content The following table is a list of currently supported .NET releases on openSUSE Leap 15. These versions remain supported until either the version of [.NET reaches end-of-support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) or the version of openSUSE Leap is no longer supported. +| openSUSE Leap | .NET | +|---------------|----------| +| 15.6 | 9.0, 8.0 | +| 15.5 | 9.0, 8.0 | + [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] ## Install preview versions @@ -41,10 +46,16 @@ sudo mv prod.repo /etc/zypp/repos.d/microsoft-prod.repo sudo chown root:root /etc/zypp/repos.d/microsoft-prod.repo ``` -[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] +# [.NET 9](#tab/dotnet9) [!INCLUDE [linux-zyp-install-90](includes/linux-install-90-zyp.md)] +# [.NET 8](#tab/dotnet8) + +[!INCLUDE [linux-zyp-install-80](includes/linux-install-80-zyp.md)] + +--- + ## How to install other versions [!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)] diff --git a/docs/core/install/linux-rhel.md b/docs/core/install/linux-rhel.md index c19cf156d5add..7dcd6351628d0 100644 --- a/docs/core/install/linux-rhel.md +++ b/docs/core/install/linux-rhel.md @@ -48,16 +48,12 @@ The following table is a list of currently supported .NET releases on both RHEL .NET is included in the [AppStream repositories](https://access.redhat.com/support/policy/updates/rhel-app-streams-life-cycle) for RHEL 9. -[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] - [!INCLUDE [linux-dnf-install-90](includes/linux-install-90-dnf.md)] ## RHEL 8 .NET is included in the [AppStream repositories](https://access.redhat.com/support/policy/updates/rhel-app-streams-life-cycle) for RHEL 8. -[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] - [!INCLUDE [linux-dnf-install-90](includes/linux-install-90-dnf.md)] ## CentOS Stream 9 diff --git a/docs/core/install/linux-sles.md b/docs/core/install/linux-sles.md index 7875b44499fd1..3fe874fd8d0eb 100644 --- a/docs/core/install/linux-sles.md +++ b/docs/core/install/linux-sles.md @@ -46,8 +46,6 @@ Currently, the SLES 15 Microsoft repository setup package installs the *microsof sudo ln -s /etc/yum.repos.d/microsoft-prod.repo /etc/zypp/repos.d/microsoft-prod.repo ``` -[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] - [!INCLUDE [linux-zyp-install-90](includes/linux-install-90-zyp.md)] ## How to install other versions diff --git a/docs/core/install/linux-snap-runtime.md b/docs/core/install/linux-snap-runtime.md index 8e28426eec2f2..8306677728360 100644 --- a/docs/core/install/linux-snap-runtime.md +++ b/docs/core/install/linux-snap-runtime.md @@ -39,14 +39,14 @@ The following steps install the .NET 9 runtime snap package: 01. Use `snap install` to install the .NET Runtime snap package. For example, the following command installs the .NET 8 runtime. ```bash - sudo snap install dotnet-runtime-90 + sudo snap install dotnet-runtime-80 ``` Each .NET Runtime is published as an individual snap package. The following table lists the packages: | .NET version | Snap package | .NET version supported by Microsoft | |---------------------------------------------------|---------------------|-----| -| 9 (STS) *Not yet available | `dotnet-runtime-90` | Yes | +| 9 (STS) | Not yet available | Yes | | [8 (LTS)](https://snapcraft.io/dotnet-runtime-80) | `dotnet-runtime-80` | Yes | | [7 (STS)](https://snapcraft.io/dotnet-runtime-70) | `dotnet-runtime-70` | No | | [6 (LTS)](https://snapcraft.io/dotnet-runtime-60) | `dotnet-runtime-60` | No | diff --git a/docs/core/install/linux-snap-sdk.md b/docs/core/install/linux-snap-sdk.md index 0e7ad3b4d4977..68b5d6cc9c985 100644 --- a/docs/core/install/linux-snap-sdk.md +++ b/docs/core/install/linux-snap-sdk.md @@ -50,7 +50,7 @@ Snap packages for the .NET SDK are all published under the same identifier: `dot ``` - The `--classic` parameter is required. - - Use the `--channel` parameter to specify which version to install. If this parameter is omitted, `latest/stable` is used. For example, `--channel 9.0/stable` installs .NET SDK 9.0. + - Use the `--channel` parameter to specify which version to install. If this parameter is omitted, `latest/stable` is used. For example, `--channel 8.0/stable` installs .NET SDK 8.0. The `dotnet` snap alias is automatically created and mapped to the snap package's `dotnet` command. @@ -58,7 +58,7 @@ The following table lists the package channels you can install: | .NET version | Snap package channel | |--------------|---------------------------------| -| 9 (STS) | `9.0/stable`
`latest/stable` | +| 9 (STS) | *Not yet available | | 8 (LTS) | `8.0/stable`
`lts/stable` | | 7 (STS) | `7.0/stable` (out of support) | | 6 (LTS) | `6.0/stable` (out of support) | diff --git a/docs/core/install/linux-ubuntu-install.md b/docs/core/install/linux-ubuntu-install.md index a07b4bd6c9c94..56ecfb47c3ab2 100644 --- a/docs/core/install/linux-ubuntu-install.md +++ b/docs/core/install/linux-ubuntu-install.md @@ -84,16 +84,16 @@ You can install a recent version of _libgdiplus_ by [adding the Mono repository The following versions of .NET are supported or available for Ubuntu 24.04: | Supported .NET versions | Available in
built-in Ubuntu feed | [Available in
backports
Ubuntu feed](linux-ubuntu.md#ubuntu-net-backports-package-repository) | [Available in
Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | -|-------------------------|--------------------------------------|----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------| -| 9.0, 8.0 | 8.0 | 7.0, 6.0 |None | +|-------------------------|--------------------------------------|-----------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------| +| 9.0, 8.0 | 8.0 | 9.0, 7.0, 6.0 |None | When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. # [.NET 9](#tab/dotnet9) -[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] +[!INCLUDE [linux-ubuntu-register-backports](includes/linux-ubuntu-register-backports.md)] -Not published by Microsoft. +[!INCLUDE [linux-apt-install-90](includes/linux-install-90-apt.md)] # [.NET 8](#tab/dotnet8) @@ -147,7 +147,7 @@ The following versions of .NET are supported or available for Ubuntu 22.04: | Supported .NET versions | Available in
built-in Ubuntu feed | [Available in
.NET backports
Ubuntu feed](linux-ubuntu.md#ubuntu-net-backports-package-repository) | [Available in
Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | |-------------------------|--------------------------------------|----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------| -| 9.0, 8.0 | 8.0, 7.0, 6.0 | None | 8.0, 7.0, 6.0, 3.1 | +| 9.0, 8.0 | 8.0, 7.0, 6.0 | 9.0 | 8.0, 7.0, 6.0, 3.1 | [!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] @@ -155,9 +155,9 @@ When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, # [.NET 9](#tab/dotnet9) -[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] +[!INCLUDE [linux-ubuntu-register-backports](includes/linux-ubuntu-register-backports.md)] -Not published by Microsoft. +[!INCLUDE [linux-apt-install-90](includes/linux-install-90-apt.md)] # [.NET 8](#tab/dotnet8) diff --git a/docs/core/install/macos.md b/docs/core/install/macos.md index 6f71a88ef9934..6d7e0f35a3563 100644 --- a/docs/core/install/macos.md +++ b/docs/core/install/macos.md @@ -245,6 +245,20 @@ For more information about how enforced-notarization affects .NET (and your .NET [!INCLUDE [verify-download-macos-linux](includes/verify-download-macos-linux.md)] +## Arm-based Macs + +The following sections describe things you should consider when installing .NET on an Arm-based Mac. + + + +### Path differences + +On an Arm-based Mac, all Arm64 versions of .NET are installed to the normal _/usr/local/share/dotnet/_ folder. However, when you install the **x64** version of .NET SDK, it's installed to the _/usr/local/share/dotnet/x64/dotnet/_ folder. + +### Path variables + +Environment variables that add .NET to system path, such as the `PATH` variable, might need to be changed if you have both the x64 and Arm64 versions of the .NET SDK installed. Additionally, some tools rely on the `DOTNET_ROOT` environment variable, which would also need to be updated to point to the appropriate .NET SDK installation folder. + ## Troubleshooting The following sections are available to help troubleshoot issues: @@ -283,33 +297,6 @@ Set the following two environment variables in your shell profile: export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools ``` -### Arm-based Macs - -The following sections describe things you should consider when installing .NET on an Arm-based Mac. - - - -#### .NET Versions - -The following table describes which versions of .NET are supported on an Arm-based Mac: - -| .NET Version | SDK | Runtime | -|--------------|-----|---------| -| 8 | Yes | Yes | -| 8 | Yes | Yes | -| 6 | Yes | Yes | -| 6 | Yes | Yes | - -The x64 and Arm64 versions of the .NET SDK exist independently from each other. If a new version is released, each install needs to be upgraded. - -#### Path differences - -On an Arm-based Mac, all Arm64 versions of .NET are installed to the normal _/usr/local/share/dotnet/_ folder. However, when you install the **x64** version of .NET SDK, it's installed to the _/usr/local/share/dotnet/x64/dotnet/_ folder. - -#### Path variables - -Environment variables that add .NET to system path, such as the `PATH` variable, might need to be changed if you have both the x64 and Arm64 versions of the .NET SDK installed. Additionally, some tools rely on the `DOTNET_ROOT` environment variable, which would also need to be updated to point to the appropriate .NET SDK installation folder. - ### System.Drawing.Common and libgdiplus .NET applications that use the `System.Drawing.Common` assembly require `libgdiplus` to be installed. diff --git a/docs/core/install/windows.md b/docs/core/install/windows.md index f6b2a914a2044..c277bd1ac44d1 100644 --- a/docs/core/install/windows.md +++ b/docs/core/install/windows.md @@ -116,10 +116,6 @@ The previous requirements are also required if you receive an error related to e .NET is supported on Arm-based Windows PCs. The following sections describe things you should consider when installing .NET. -### SDK differences - -The x86, x64, and Arm64 versions of the .NET SDK exist independently from each other. If a new version is released, each architecture install needs to be upgraded. - ### Path differences On an Arm-based Windows PC, all Arm64 versions of .NET are installed to the normal _C:\\Program Files\\dotnet\\_ folder. However, the **x64** version of the .NET SDK is installed to the _C:\\Program Files\\dotnet\\x64\\_ folder.