From fa68763d0e03047d20dc24568f9c4a537ed4e0b5 Mon Sep 17 00:00:00 2001 From: Lars Bilke <lars.bilke@ufz.de> Date: Tue, 16 Jan 2024 13:53:29 +0100 Subject: [PATCH] [web] How to enable long path support on Windows. --- .../docs/userguide/troubleshooting/faq.md | 13 ++++++ .../troubleshooting/general/index.md | 45 ------------------- 2 files changed, 13 insertions(+), 45 deletions(-) delete mode 100644 web/content/docs/userguide/troubleshooting/general/index.md diff --git a/web/content/docs/userguide/troubleshooting/faq.md b/web/content/docs/userguide/troubleshooting/faq.md index 1a170552c1b..35a0bc1afdd 100644 --- a/web/content/docs/userguide/troubleshooting/faq.md +++ b/web/content/docs/userguide/troubleshooting/faq.md @@ -5,6 +5,19 @@ author = "Lars Bilke and Feliks Kiszkurno" weight = 1 +++ +## Windows only: `ogs`` or any of its tools cannot open an existing file with a long path + +Windows has a [default path length limit of 260 characters](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation). Especially in workflows this limit can be exceeded easily. To enable long paths on Windows you need to alter the Windows registry which requires administrative user privileges: + +- Open a PowerShell command prompt as an Administrator +- Run the following script: + + ```powershell + New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force + ``` + +- You may have to restart the computer + ## `XSDError: Loaded schema file is invalid` error encountered when running DataExplorer You may encounter the following error (or similar) on opening `.gml`, `.cnd`, `std` or `.prj` files in the Data Explorer or file diff --git a/web/content/docs/userguide/troubleshooting/general/index.md b/web/content/docs/userguide/troubleshooting/general/index.md deleted file mode 100644 index 3bb491d71bf..00000000000 --- a/web/content/docs/userguide/troubleshooting/general/index.md +++ /dev/null @@ -1,45 +0,0 @@ -+++ -date = "2018-11-14T11:00:13+01:00" -title = "General" -author = "Lars Bilke" -weight = 2 -toc = true -+++ - -<!-- TODO: This part so far is only repetition. It could be deleted. --> - -## Data Explorer - -### `XSDError`: Loaded schema file is invalid - -You may encountering the following error (or similar) on opening `.gml`, `.cnd`, `std` or `.prj` files in the Data Explorer or -file conversion tools (e.g. `OGSFileConverter`): - -<i class="far fa-exclamation-triangle"></i> Error message: - -```bash -Error XSDError in http://www.opengeosys.org/images/xsd/OpenGeoSysCND.xsd, at line 1, column 1: Start tag expected. -Error XSDError in file:///../bc/well.cnd, at line 5, column 195: Loaded schema file is invalid. -XMLInterface::isValid() - XML File is invalid (in reference to schema ./OpenGeoSysCND.xsd). -Error XSDError in http://www.opengeosys.org/images/xsd/OpenGeoSysCND.xsd, at line 1, column 1: Start tag expected. -``` - -<i class="far fa-arrow-right"></i> Solution: - -Open the affected file (e.g. `well.cnd` in this case) in a text editor and remove the following parameter of the XML root -element (the first element in `< >`-brackets in the element, e.g. `<OpenGeoSysCND>`): - -```xml -xsi:noNamespaceSchemaLocation="http://www.opengeosys.org/images/xsd/OpenGeoSysXXX.xsd" -``` - -where `XXX` can be `CND`, `GLI`, `PRJ` or `STN` depending on the file type. - -Now the save the modified file and try to load it again. - -<!-- vale off --> - -<details> - <summary>Background info:</summary> - The XSD files may be downloaded from a web location. We changed the protocol of our web site to `https://` but due to some weird behaviour of the Qt XML validation code it tries to download the file (even if it is available locally) and does not respect the URL redirection to `https://` of the web server. Simply removing the part solves the problem. The XML is still validated! Newer OGS versions do not write that parameter into files anymore, see [!2198](https://github.com/ufz/ogs/pull/2198). -</details> -- GitLab