From 2d2fa1206d93d3733b4cd2726732c3d18d71fbb8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jean-No=C3=ABl=20Grad?= Date: Wed, 28 Oct 2026 20:58:45 +0100 Subject: [PATCH 1/2] Fix CSS styling --- docs/getting_access/native_installation.md | 30 +++++++++++----------- docs/site_build/site_cvmfs.md | 1 - 2 files changed, 15 insertions(+), 16 deletions(-) diff --git a/docs/getting_access/native_installation.md b/docs/getting_access/native_installation.md index a7a051477a..dc7f4e30f9 100644 --- a/docs/getting_access/native_installation.md +++ b/docs/getting_access/native_installation.md @@ -75,23 +75,23 @@ The good news is that all of this only requires a handful commands :astonished: ``` !!! Warning - When using the default setting `CVMFS_CLIENT_PROFILE="single"`, `CVMFS_HTTP_PROXY` is set to `auto;DIRECT`. Ìn case you have setup with a private Stratum 1 with no proxy, this can lead to unintended requests to Web Proxy Auto Discovery (WPAD) infrastructure before falling back to direct connections. Removing the `auto` ensures direct connections without unnecessary WPAD requests. - ```bash - sudo bash -c "echo 'CVMFS_HTTP_PROXY=direct' >> /etc/cvmfs/default.local" + When using the default setting `CVMFS_CLIENT_PROFILE="single"`, `CVMFS_HTTP_PROXY` is set to `auto;DIRECT`. In case you have setup with a private Stratum 1 with no proxy, this can lead to unintended requests to Web Proxy Auto Discovery (WPAD) infrastructure before falling back to direct connections. Removing the `auto` ensures direct connections without unnecessary WPAD requests. + ``` { .bash .copy } + sudo bash -c "echo 'CVMFS_HTTP_PROXY=direct' >> /etc/cvmfs/default.local" ``` - Additionally, if you have a local proxy configured with: + Additionally, if you have a local proxy configured with: - ```bash - CVMFS_HTTP_PROXY=;DIRECT + ``` { .bash .copy } + CVMFS_HTTP_PROXY=";DIRECT" ``` - and the local proxy becomes unavailable, the client will not directly contact the Stratum 1. Instead, it will failover to CERN/FNAL fallback proxies as its set in CernVM-FS's general configuration: + and the local proxy becomes unavailable, the client will not directly contact the Stratum 1. Instead, it will failover to CERN/FNAL fallback proxies as its set in CernVM-FS's general configuration: - ```bash - CVMFS_FALLBACK_PROXY="http://cvmfsbproxy.cern.ch:3126;http://cvmfsbproxy.fnal.gov:3126 # Taken from /cvmfs/cvmfs- config.cern.ch/etc/cvmfs/common.conf - ``` - Be aware that in such cases, the `DIRECT` directive is silently ignored. + ``` { .bash .copy } + CVMFS_FALLBACK_PROXY="http://cvmfsbproxy.cern.ch:3126;http://cvmfsbproxy.fnal.gov:3126 # Taken from /cvmfs/cvmfs- config.cern.ch/etc/cvmfs/common.conf + ``` + Be aware that in such cases, the `DIRECT` directive is silently ignored. ## Installation for larger systems (e.g. clusters) { #native-install-on-clusters } @@ -124,14 +124,14 @@ More advanced use cases can be found in [the CernVM-FS documentation](https://cv If you have set up your own Stratum 1 mirror server that replicates the EESSI CernVM-FS repositories, you can instruct your CernVM-FS client(s) to use it by prepending your newly created Stratum 1 to the existing list of EESSI Stratum 1 servers by creating a local CVMFS configuration file for the EESSI domain: -```bash +``` { .bash .copy } echo 'CVMFS_SERVER_URL="http:///cvmfs/@fqrn@;$CVMFS_SERVER_URL"' | sudo tee -a /etc/cvmfs/domain.d/eessi.io.local ``` It is also strongly recommended to disable the GEO API when using a private Stratum 1, because you want your private Stratum 1 to be picked first anyway. In order to do this, add the following to `/etc/cvmfs/domain.d/eessi.io.local`: -```bash +``` { .bash .copy } CVMFS_USE_GEOAPI=no ``` @@ -145,13 +145,13 @@ CVMFS_USE_GEOAPI=no After you have made any changes to the CernVM-FS client configuration, you will have to apply them. If this is the first time you set up the client, you can simply run: -```bash +``` { .bash .copy } sudo cvmfs_config setup ``` If you already had configured the client before, you can reload the configuration for the EESSI repository (or, similarly, for any other repository) using: -```bash +``` { .bash .copy } sudo cvmfs_config reload -c software.eessi.io ``` diff --git a/docs/site_build/site_cvmfs.md b/docs/site_build/site_cvmfs.md index f048a3ca14..cfa91d9264 100644 --- a/docs/site_build/site_cvmfs.md +++ b/docs/site_build/site_cvmfs.md @@ -546,7 +546,6 @@ sudo apt-get update sudo apt-get install -y squid echo "Creating squid config" -``` { .bash .copy } sudo bash -c "cat > /etc/squid/squid.conf" < Date: Wed, 28 Oct 2026 21:00:52 +0100 Subject: [PATCH 2/2] Add autofs troubleshooting --- docs/getting_access/native_installation.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/getting_access/native_installation.md b/docs/getting_access/native_installation.md index dc7f4e30f9..2b66ec6be9 100644 --- a/docs/getting_access/native_installation.md +++ b/docs/getting_access/native_installation.md @@ -74,6 +74,14 @@ The good news is that all of this only requires a handful commands :astonished: sudo bash -c "echo 'CVMFS_CACHE_BASE=' >> /etc/cvmfs/default.local" ``` +!!! Note + If the EESSI CernVM-FS doesn't get mounted, restart the automounter: + ``` { .bash .copy } + sudo bash -c "echo '+dir:/etc/auto.master.d' >> /etc/auto.master" + sudo systemctl restart autofs + sudo cvmfs_config chksetup + ``` + !!! Warning When using the default setting `CVMFS_CLIENT_PROFILE="single"`, `CVMFS_HTTP_PROXY` is set to `auto;DIRECT`. In case you have setup with a private Stratum 1 with no proxy, this can lead to unintended requests to Web Proxy Auto Discovery (WPAD) infrastructure before falling back to direct connections. Removing the `auto` ensures direct connections without unnecessary WPAD requests. ``` { .bash .copy }