https://github.com/lextm/ancm-arm64
Installer patches for ASP.NET Core module on Windows 11 ARM64
https://github.com/lextm/ancm-arm64
arm64 asp-net-core aspnetcore dotnet dotnet-core dotnetcore iis iis-server windows windows-11 x64 x86 x86-64
Last synced: 9 months ago
JSON representation
Installer patches for ASP.NET Core module on Windows 11 ARM64
- Host: GitHub
- URL: https://github.com/lextm/ancm-arm64
- Owner: lextm
- License: mit
- Created: 2023-03-16T07:13:03.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-24T03:52:15.000Z (about 2 years ago)
- Last Synced: 2025-01-13T09:43:48.703Z (over 1 year ago)
- Topics: arm64, asp-net-core, aspnetcore, dotnet, dotnet-core, dotnetcore, iis, iis-server, windows, windows-11, x64, x86, x86-64
- Language: PowerShell
- Homepage:
- Size: 28.3 KB
- Stars: 8
- Watchers: 4
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ancm-arm64, installer patches for ASP.NET Core module on Windows 11 ARM64 and IIS.
## Background
The official installer for .NET 8.0/9.0 at this moment only properly installs ASP.NET Core module ARM64 bits on the machine, so that only pure ARM64 ASP.NET Core web apps can run on IIS. The application pool simply crashes when you try to host x86 or x64 web apps even if you enable emulation.
| .NET Version | Patch Required? | Notes |
|----------------------|--------------------------------------------|---------------------------------------------------------------------------------------------|
| .NET 10 Preview 2+ | ❌ No | Already patched by Microsoft; no action needed. |
| .NET 10 Preview 1 | ✅ Yes | This patch applies to Preview 1 only. |
| .NET 8.0 / 9.0 | ⚠️ Maybe | Microsoft might release patched installers later. Verify carefully if patch is needed. |
| .NET 7.0 | ✅ Yes | .NET 7.0 is end-of-life. |
| .NET 6.0 and below | ❌ No | .NET 6.0 and below are end-of-life and only runs in x64/x86 emulation on ARM64. |
BTW, [I also wrote about my investigation on this topic in details](https://halfblood.pro/successful-and-failed-attempt-my-first-pull-request-for-asp-net-core/) and hope you find the technical details useful when you study Windows ARM64.
## Preparation
Perform the following steps to prepare the environment on your development machine,
1. Download [the original 64 bit installer](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-7.0.4-windows-hosting-bundle-installer) from Microsoft.
1. Download [WiX Toolset](https://github.com/wixtoolset/wix3/releases/tag/wix3112rtm) if it isn't installed to `%ProgramFilesX86%\WiX Toolset v3.x\bin\`.
1. Extract all contents from original Microsoft installer using `dark.exe` with
``` bash
dark.exe dotnet-hosting-7.0.4-win.exe -x .\msi
```
At this stage, all useful bits can be found in `\msi\AttachedContainer` folder, such as `AspNetCoreModuleV2_*.msi`. This folder provides all files are later used for patching.
> Note that here we use .NET 7.0.4 as an example. The same approach should apply to other versions (including the latest .NET 10 Preview) till Microsoft officially ships the necessary changes in future releases.
## Apply the Patch
1. Execute the official installer to install ARM64 bits to IIS.
1. Clone this repo to your local disk.
1. Execute `patch.ps1 -msiFolder ` (this points to the `AttachedContainer` folder in earlier steps) as administrator so that it extracts the necessary files from those MSI packages and install to the desired places.
> Note that this install script also installs a few helper files compiled by me. They are ARM64X pure forwarders required for ARM64/x64 side by side execution. The source code and build script are in `src` folder.
## Restore to Default
1. Execute `restore.ps1` as administrator.
> You should restore to default before upgrading the hosting bundle to a newer version.