Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

small tweaks + better logo for CernVM-FS #43

Merged
merged 8 commits into from
Dec 4, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/cvmfs/flagship-repositories.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 4 additions & 0 deletions docs/cvmfs/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Introduction to CernVM-FS

<div align="center">
<img src="../img/logos/CernVM-FS_logo_with_name.png" alt="CernVM-FS logo" width="50%"/></br>
</div>

- [What is CernVM-FS?](what-is-cvmfs.md)
- [Technical details](technical-details.md)
- [Flagship repositories](flagship-repositories.md)
4 changes: 4 additions & 0 deletions docs/cvmfs/what-is-cvmfs.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# What is CernVM-FS?

<div align="center">
<img src="../../img/logos/CernVM-FS_logo_with_name.png" alt="CernVM-FS logo" width="50%"/></br>
</div>

[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.
Expand Down
3 changes: 2 additions & 1 deletion docs/eessi/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,12 @@
## European Environment for Scientific Software Installations

<div align="center">
<img src="../../img/logos/EESSI_logo_horizontal.png" alt="EESSI logo" width="50%"/></br>
<img src="../img/logos/EESSI_logo_horizontal.png" alt="EESSI logo" width="50%"/></br>
</div>

* [What is EESSI?](what-is-eessi.md)
* [Motivation & Goals](motivation-goals.md)
* [Inspiration](inspiration.md)
* [High-level design](high-level-design.md)
* [Using EESSI](using-eessi.md)
* [Getting support](support.md)
Binary file added docs/img/logos/CernVM-FS_logo_with_name.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
15 changes: 11 additions & 4 deletions docs/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -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`:
Expand Down Expand Up @@ -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`](),
Expand Down Expand Up @@ -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!"

Expand All @@ -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:
Expand Down
Loading