From 746864e7486110b0f22cf5817dd7bc406ae2cfa2 Mon Sep 17 00:00:00 2001 From: Kate Tungusova Date: Fri, 2 May 2025 15:47:48 +0100 Subject: [PATCH 1/6] [CF1] .NET troubleshooting update --- .../cloudflare-one/faq/troubleshooting.mdx | 21 ++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/src/content/docs/cloudflare-one/faq/troubleshooting.mdx b/src/content/docs/cloudflare-one/faq/troubleshooting.mdx index e506b77da80e076..dc2d575b5d48e74 100644 --- a/src/content/docs/cloudflare-one/faq/troubleshooting.mdx +++ b/src/content/docs/cloudflare-one/faq/troubleshooting.mdx @@ -340,4 +340,23 @@ To resolve this error, review the following options: When you put your Google Workspace behind Access, users will not be able to log in using Google or Google Workspace as an identity provider. -This configuration creates an authentication loop. Cloudflare Access tries to authenticate the user via Google, but Google itself treats Cloudflare as its identity provider and requires authentication from Cloudflare. Since each system depends on the other to complete login first, the user is caught in an infinite redirect cycle and can never successfully authenticate. \ No newline at end of file +This configuration creates an authentication loop. Cloudflare Access tries to authenticate the user via Google, but Google itself treats Cloudflare as its identity provider and requires authentication from Cloudflare. Since each system depends on the other to complete login first, the user is caught in an infinite redirect cycle and can never successfully authenticate. + +## When installing WARP on Windows, the Setup Wizard ends prematurely. + +This issue can occur if the system is missing the [required version](https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/warp/download-warp/#windows:~:text=NET%20Framework%20version-,4.7.2%20or%20later,-HD%20space) of the .NET Framework. + +Cloudflare WARP requires at least **.NET Framework Runtime 4.7.2**. Some older versions of Windows do not include this runtime by default, which causes the installer to fail with a `Setup Wizard ended prematurely` error. + +This problem typically only affects legacy versions of Windows (such as, Windows 10 Enterprise 1607 LTSB, which is bundled with .NET `4.6`.) More recent Windows versions include .NET `4.7.2` or later by default and do not encounter this error. + +To fix this: + +1. Download and install the [.NET Framework 4.7.2 Runtime](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net472) (make sure to install the **Runtime**, not the Developer Pack). +2. Re-run the WARP installer. + +If the problem continues, try running the [.NET Repair Tool](https://www.microsoft.com/en-ca/download/details.aspx?id=30135), or check which .NET versions are installed by running the following command in PowerShell: + +```powershell +Get-ChildItem -Path “HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP” -Recurse | ForEach-Object { $_.Name; Get-ItemProperty $_.PSPath; "" } +``` From 3039fe8d7c98dba6549a38e51845f3f517fac60c Mon Sep 17 00:00:00 2001 From: Kate Tungusova Date: Fri, 2 May 2025 16:41:03 +0100 Subject: [PATCH 2/6] edit --- .../docs/cloudflare-one/faq/troubleshooting.mdx | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/src/content/docs/cloudflare-one/faq/troubleshooting.mdx b/src/content/docs/cloudflare-one/faq/troubleshooting.mdx index dc2d575b5d48e74..219752830ee559b 100644 --- a/src/content/docs/cloudflare-one/faq/troubleshooting.mdx +++ b/src/content/docs/cloudflare-one/faq/troubleshooting.mdx @@ -344,11 +344,11 @@ This configuration creates an authentication loop. Cloudflare Access tries to au ## When installing WARP on Windows, the Setup Wizard ends prematurely. -This issue can occur if the system is missing the [required version](https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/warp/download-warp/#windows:~:text=NET%20Framework%20version-,4.7.2%20or%20later,-HD%20space) of the .NET Framework. +This error can occur for several reasons, including missing dependencies, like the appropriate .NET Framework version or other Dynamic Link Libraries (DLLs) such as `netstandard2.0`, required during installation. -Cloudflare WARP requires at least **.NET Framework Runtime 4.7.2**. Some older versions of Windows do not include this runtime by default, which causes the installer to fail with a `Setup Wizard ended prematurely` error. +One common cause is a missing or outdated version of the [.NET Framework Runtime](https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/warp/download-warp/#windows:~:text=NET%20Framework%20version-,4.7.2%20or%20later,-HD%20space). Cloudflare WARP requires a .NET Framework version of `4.7.2` or later. -This problem typically only affects legacy versions of Windows (such as, Windows 10 Enterprise 1607 LTSB, which is bundled with .NET `4.6`.) More recent Windows versions include .NET `4.7.2` or later by default and do not encounter this error. +Some legacy Windows systems (such as Windows 10 Enterprise 1607 LTSB, which is bundled with .NET `4.6`) do not include this runtime by default and may fail during installation with a `Setup Wizard ended prematurely` error. More recent Windows versions include .NET `4.7.2` or later by default and do not encounter this error. To fix this: @@ -358,5 +358,11 @@ To fix this: If the problem continues, try running the [.NET Repair Tool](https://www.microsoft.com/en-ca/download/details.aspx?id=30135), or check which .NET versions are installed by running the following command in PowerShell: ```powershell -Get-ChildItem -Path “HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP” -Recurse | ForEach-Object { $_.Name; Get-ItemProperty $_.PSPath; "" } +Get-ChildItem -Path “HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP” -Recurse | ForEach-Object { $_.Name; Get-ItemProperty $_.PSPath; "" } +``` + +If the issue still as not resolved, run: + +```powershell +msiexec /i /L*V ``` From 1b71ac8947f29007fe801c95fe207d485d6a594e Mon Sep 17 00:00:00 2001 From: Kate Tungusova Date: Wed, 7 May 2025 18:07:50 +0100 Subject: [PATCH 3/6] order update --- .../warp/troubleshooting/common-issues.mdx | 4 ++++ .../docs/cloudflare-one/faq/troubleshooting.mdx | 14 ++++++++------ 2 files changed, 12 insertions(+), 6 deletions(-) diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/common-issues.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/common-issues.mdx index 0c83e943aa98a50..426b21a9af78cb3 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/common-issues.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/common-issues.mdx @@ -188,3 +188,7 @@ Some applications require traffic to flow either all inside or all outside of th 1. Determine the IP addresses and/or domains required for your application to function. Common Internet search terms include ` split tunnel list`, ` allow list`, or ` firewall ips`. 2. In [Zero Trust](https://one.dash.cloudflare.com/), go to your [Split Tunnel settings](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels/). 3. Depending on the application, either include or exclude all of the necessary IPs and/or domains. For Microsoft applications, we provide a [one-click action](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings/#directly-route-microsoft-365-traffic) to exclude all Microsoft 365 IPs. + +## Troubleshooting + +- [Troubleshooting](/cloudflare-one/faq/#troubleshooting) - Review Troubleshooting for other WARP-related troubleshooting errors and solutions. diff --git a/src/content/docs/cloudflare-one/faq/troubleshooting.mdx b/src/content/docs/cloudflare-one/faq/troubleshooting.mdx index 219752830ee559b..5bf056f7e317c51 100644 --- a/src/content/docs/cloudflare-one/faq/troubleshooting.mdx +++ b/src/content/docs/cloudflare-one/faq/troubleshooting.mdx @@ -346,6 +346,14 @@ This configuration creates an authentication loop. Cloudflare Access tries to au This error can occur for several reasons, including missing dependencies, like the appropriate .NET Framework version or other Dynamic Link Libraries (DLLs) such as `netstandard2.0`, required during installation. +To investigate, run the following command to generate installation logs: + +```powershell +msiexec /i /L*V +``` + +Check the logs to verify if there are any missing DLLs (for example, `netstandard2.0`), which may point to a missing or outdated version of the .NET Framework. + One common cause is a missing or outdated version of the [.NET Framework Runtime](https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/warp/download-warp/#windows:~:text=NET%20Framework%20version-,4.7.2%20or%20later,-HD%20space). Cloudflare WARP requires a .NET Framework version of `4.7.2` or later. Some legacy Windows systems (such as Windows 10 Enterprise 1607 LTSB, which is bundled with .NET `4.6`) do not include this runtime by default and may fail during installation with a `Setup Wizard ended prematurely` error. More recent Windows versions include .NET `4.7.2` or later by default and do not encounter this error. @@ -360,9 +368,3 @@ If the problem continues, try running the [.NET Repair Tool](https://www.microso ```powershell Get-ChildItem -Path “HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP” -Recurse | ForEach-Object { $_.Name; Get-ItemProperty $_.PSPath; "" } ``` - -If the issue still as not resolved, run: - -```powershell -msiexec /i /L*V -``` From 575baecfbd43ad8bea52450fab58bddf992d8a04 Mon Sep 17 00:00:00 2001 From: Kate Tungusova Date: Wed, 7 May 2025 18:33:57 +0100 Subject: [PATCH 4/6] final --- .../warp/troubleshooting/known-limitations.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/known-limitations.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/known-limitations.mdx index a5ea1cbf5a3bfba..f867290c1a20fae 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/known-limitations.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/known-limitations.mdx @@ -105,3 +105,7 @@ The MTU value should be set to the MTU of your host's default interface minus 80 ## Windows 10 in Microsoft 365 Cloud PC is not supported Use of the WARP client in a Microsoft 365 Windows 10 Cloud PC is not supported. To work around this limitation, use Windows 11. + +## Troubleshooting + +- [Troubleshooting](/cloudflare-one/faq/#troubleshooting) - Review Troubleshooting for other WARP-related troubleshooting errors and solutions. From c40bcf9346de910dea3cc3b6d8d519e0bc1a945f Mon Sep 17 00:00:00 2001 From: Kate Tungusova <70746074+deadlypants1973@users.noreply.github.com> Date: Thu, 8 May 2025 13:11:19 +0100 Subject: [PATCH 5/6] Apply suggestions from code review pcx suggestions Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> --- .../warp/troubleshooting/known-limitations.mdx | 2 +- src/content/docs/cloudflare-one/faq/troubleshooting.mdx | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/known-limitations.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/known-limitations.mdx index f867290c1a20fae..4a292e8af1a1c7f 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/known-limitations.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/known-limitations.mdx @@ -108,4 +108,4 @@ Use of the WARP client in a Microsoft 365 Windows 10 Cloud PC is not supported. ## Troubleshooting -- [Troubleshooting](/cloudflare-one/faq/#troubleshooting) - Review Troubleshooting for other WARP-related troubleshooting errors and solutions. +- [Troubleshooting](/cloudflare-one/faq/troubleshooting/) - Review Troubleshooting for other WARP-related troubleshooting errors and solutions. diff --git a/src/content/docs/cloudflare-one/faq/troubleshooting.mdx b/src/content/docs/cloudflare-one/faq/troubleshooting.mdx index 5bf056f7e317c51..6bef3c0b7d8ce28 100644 --- a/src/content/docs/cloudflare-one/faq/troubleshooting.mdx +++ b/src/content/docs/cloudflare-one/faq/troubleshooting.mdx @@ -354,7 +354,7 @@ msiexec /i /L*V Check the logs to verify if there are any missing DLLs (for example, `netstandard2.0`), which may point to a missing or outdated version of the .NET Framework. -One common cause is a missing or outdated version of the [.NET Framework Runtime](https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/warp/download-warp/#windows:~:text=NET%20Framework%20version-,4.7.2%20or%20later,-HD%20space). Cloudflare WARP requires a .NET Framework version of `4.7.2` or later. +One common cause is a missing or outdated version of the [.NET Framework Runtime](/cloudflare-one/connections/connect-devices/warp/download-warp/#windows:~:text=NET%20Framework%20version-,4.7.2%20or%20later,-HD%20space). Cloudflare WARP requires a .NET Framework version of `4.7.2` or later. Some legacy Windows systems (such as Windows 10 Enterprise 1607 LTSB, which is bundled with .NET `4.6`) do not include this runtime by default and may fail during installation with a `Setup Wizard ended prematurely` error. More recent Windows versions include .NET `4.7.2` or later by default and do not encounter this error. @@ -366,5 +366,5 @@ To fix this: If the problem continues, try running the [.NET Repair Tool](https://www.microsoft.com/en-ca/download/details.aspx?id=30135), or check which .NET versions are installed by running the following command in PowerShell: ```powershell -Get-ChildItem -Path “HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP” -Recurse | ForEach-Object { $_.Name; Get-ItemProperty $_.PSPath; "" } +Get-ChildItem -Path "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP" -Recurse | ForEach-Object { $_.Name; Get-ItemProperty $_.PSPath; "" } ``` From 515cb4c1558bf5336efe383e5f1a437c5eadde39 Mon Sep 17 00:00:00 2001 From: Kate Tungusova <70746074+deadlypants1973@users.noreply.github.com> Date: Thu, 8 May 2025 13:11:30 +0100 Subject: [PATCH 6/6] Update src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/common-issues.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> --- .../connect-devices/warp/troubleshooting/common-issues.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/common-issues.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/common-issues.mdx index 426b21a9af78cb3..732c89439f20342 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/common-issues.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/common-issues.mdx @@ -191,4 +191,4 @@ Some applications require traffic to flow either all inside or all outside of th ## Troubleshooting -- [Troubleshooting](/cloudflare-one/faq/#troubleshooting) - Review Troubleshooting for other WARP-related troubleshooting errors and solutions. +- [Troubleshooting](/cloudflare-one/faq/troubleshooting/) - Review Troubleshooting for other WARP-related troubleshooting errors and solutions.