diff --git a/docs/cvmfs/flagship-repositories.md b/docs/cvmfs/flagship-repositories.md index 283e289..7333382 100644 --- a/docs/cvmfs/flagship-repositories.md +++ b/docs/cvmfs/flagship-repositories.md @@ -1,5 +1,7 @@ # Flagship CernVM-FS repositories +Here we list a couple of flagship CernVM-FS repositories, all of which are **publicly available**. + ## LHC experiments CernVM-FS repositories are used to distribute the software required to analyse the data produced by the diff --git a/docs/cvmfs/index.md b/docs/cvmfs/index.md index 121e853..460091a 100644 --- a/docs/cvmfs/index.md +++ b/docs/cvmfs/index.md @@ -1,5 +1,9 @@ # Introduction to CernVM-FS +
+CernVM-FS logo
+
+ - [What is CernVM-FS?](what-is-cvmfs.md) - [Technical details](technical-details.md) - [Flagship repositories](flagship-repositories.md) diff --git a/docs/cvmfs/what-is-cvmfs.md b/docs/cvmfs/what-is-cvmfs.md index 6ffcbc9..ef13af8 100644 --- a/docs/cvmfs/what-is-cvmfs.md +++ b/docs/cvmfs/what-is-cvmfs.md @@ -1,5 +1,9 @@ # What is CernVM-FS? +
+CernVM-FS logo
+
+ [CernVM-FS](https://cernvm.cern.ch/fs/), the CernVM File System (also known as *CVMFS*), is a *file distribution service* that is particularly well suited to distribute *software installations* across a large number of systems world-wide in an efficient way. diff --git a/docs/eessi/index.md b/docs/eessi/index.md index 36892a1..84e539c 100644 --- a/docs/eessi/index.md +++ b/docs/eessi/index.md @@ -3,7 +3,7 @@ ## European Environment for Scientific Software Installations
-EESSI logo
+EESSI logo
* [What is EESSI?](what-is-eessi.md) @@ -11,3 +11,4 @@ * [Inspiration](inspiration.md) * [High-level design](high-level-design.md) * [Using EESSI](using-eessi.md) +* [Getting support](support.md) diff --git a/docs/img/logos/CernVM-FS_logo_with_name.png b/docs/img/logos/CernVM-FS_logo_with_name.png new file mode 100644 index 0000000..636bbe3 Binary files /dev/null and b/docs/img/logos/CernVM-FS_logo_with_name.png differ diff --git a/docs/index.md b/docs/index.md index 816943b..498f689 100644 --- a/docs/index.md +++ b/docs/index.md @@ -86,5 +86,6 @@ Undertaking (JU)](https://eurohpc-ju.europa.eu) and countries participating in t * [CernVM-FS website](https://cernvm.cern.ch/fs) * [CernVM-FS documentation](https://cvmfs.readthedocs.io) * [CernVM-FS @ GitHub](https://github.com/cvmfs) +* [CernVM-FS forum](https://cernvm-forum.cern.ch) * [Introduction to CernVM-FS by *Jakob Blomer (CERN)* (2021)](https://easybuild.io/eum21/#cvmfs-talk) * [Introductory tutorial on CernVM-FS (2021)](https://cvmfs-contrib.github.io/cvmfs-tutorial-2021) diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index 2d82838..337bf1e 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md @@ -48,8 +48,6 @@ Here are a couple of examples: ``` Failed to discover HTTP proxy servers (23 - proxy auto-discovery failed) ``` - We will outline some approaches that should help you to determine what could be wrong exactly. - * Other problems may be quite specific to the internals of CernVM-FS, rather than being configuration or networking issues. Examples include: @@ -142,6 +140,9 @@ Don't forget to reload the CernVM-FS configuration after you've made changes to sudo cvmfs_config reload ``` +Note that changes to specific configuration settings, in particular those related to FUSE, +will not be reloaded with this command, since they require remounting the repository. + #### Show configuration Verify the configuration via `cvmfs_config showconfig`: @@ -362,6 +363,12 @@ HTTP/1.1 404 Not Found ``` Maybe you forgot the '`.`' in `.cvmfspublished`? +!!! note + + A Stratum 1 server does not provide access to *all* possible CernVM-FS repositories. + + It has to be configured to serve particular repositories, as shown in [Private Stratum 1 replica server - Creating repository replica](access/stratum1.md#creating-repository-replica). + #### Network latency & bandwidth To check the network latency and bandwidth, you can use [`iperf3`]() and `tcptraceroute`](), @@ -505,7 +512,7 @@ CVMFS_DEBUGLOG=/tmp/cvmfs-debug.log ``` CernVM-FS will log more information to the specified debug log file after [reloading the CernVM-FS -configuration](#reloading). +configuration](#reloading) (supported since CernVM-FS 2.11.0). !!! warning "Debug logging is a bit like a firehose - use with care!" @@ -530,7 +537,7 @@ that CernVM-FS uses, which can accessed via the `attr` command (see also [the Ce documentation](https://cvmfs.readthedocs.io/en/stable/cpt-details.html#getxattr)). In particular the `logbuffer` attribute, which contains the last log messages for that particular -repository, which *can be accessed without special privileges* that are required to access log messages +repository, which **can be accessed without special privileges** that are required to access log messages emitted to `/var/log/*`. For example: