-
Notifications
You must be signed in to change notification settings - Fork 1
Add cvmfsexec and tidy up
#9
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
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
This file was deleted.
| Original file line number | Diff line number | Diff line change | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
@@ -12,9 +12,10 @@ of the EESSI repository. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ## Is EESSI accessible? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| EESSI can be accessed via [a native (CernVM-FS) installation](#native-installation), | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| or via [a container that includes CernVM-FS](#eessi-via-a-container). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| via [a container that includes CernVM-FS](#eessi-via-a-container), or via a dedicated user-space tool called | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| [`cvmfsexec`](#eessi-via-cvmfsexec). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Before you look into these options, check if EESSI is already accessible on your system. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Before you look into other options, check if EESSI is already accessible on your system. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Run the following command: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ``` { .bash .copy } | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
@@ -41,23 +42,20 @@ ls: /cvmfs/software.eessi.io: No such file or directory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ``` | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| No worries, you don't need to be a :mage: to get access to EESSI. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Continue reading about the [Native installation](#native-installation) of EESSI, | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| or accessing [EESSI via a container](#eessi-via-a-container). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Continue reading about the [Native installation](#native-installation) of EESSI, or | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| accessing EESSI via a [container](#eessi-via-a-container) or via [`cvmfsexec`](#eessi-via-cvmfsexec). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ## Native installation | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Setting up native access to EESSI, that is a system-wide deployment that does not require workarounds like | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| [using a container](#eessi-via-a-container), requires the installation and configuration of [CernVM-FS](https://cernvm.cern.ch/fs). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| This requires **admin privileges**, since you need to install CernVM-FS as an OS package. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| This requires **administrator privileges**, since you need to install CernVM-FS as an OS package. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| The following actions must be taken for a (basic) native installation of EESSI: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| * Installing CernVM-FS itself, ideally using the OS packages provided by the CernVM-FS project | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (although installing from source is also possible); | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| * Installing the EESSI configuration for CernVM-FS, which can be done by installing the ``cvmfs-config-eessi`` | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| package that we provide for the most popular Linux distributions | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| (more information available [here](https://github.com/EESSI/filesystem-layer/)); | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| * Creating a small client configuration file for CernVM-FS (``/etc/cvmfs/default.local``); | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| see also the [CernVM-FS documentation](https://cvmfs.readthedocs.io/en/stable/cpt-quickstart.html#create-default-local). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
@@ -180,6 +178,32 @@ In this environment, you should be able to access the EESSI `software.eessi.io` | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ls /cvmfs/software.eessi.io | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ``` | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ## EESSI via `cvmfsexec` | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| When you do not have administrator rights, nor access to `singularity`/`apptainer`, there is still another option that | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| may work for you: [`cvmfsexec`](https://github.com/cvmfs/cvmfsexec) allows you to mount cvmfs repositories | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| as an unprivileged user. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Whether this approach will work is very dependent on the specific system you have access to. If this approach is your | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| only option, the best way to check if it will work is to try it out and see if you run into problems. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| The first thing you need to do is clone the `cvmfsexec` repository, and enter the directory | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ``` { .bash .copy } | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| git clone https://github.com/cvmfs/cvmfsexec.git | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| cd cvmfsexec | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ``` | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Once inside this directory, `cvmfsexec` does still require an internet connection and some tools from your system that | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| may not be available by default (but are quite common): `curl`, `rpm2cpio`, and `cpio`. If those are available then the | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| see if the steps below work for you: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ``` { .bash .copy } | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| # First we gather the files that cvmfsexec requires (this will also tell you if your OS is supported) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ./makedist default | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| # Then we try to start cvmfsexec and see what happens | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ./cvmfsexec cvmfs-config.cern.ch software.eessi.io -- bash | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ``` | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Comment on lines
+197
to
+205
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| --- | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| To start using EESSI, see [Using EESSI](usage.md). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -109,7 +109,7 @@ We use custom architecture detection scripts | |||||
| to automatically select the best suited installations from the software stack for | ||||||
| a particular host, based on its system architecture. | ||||||
|
|
||||||
| The software layer is maintained through our [https://github.com/EESSI/software-layer](https://github.com/EESSI/software-layer) GitHub repository. | ||||||
| The software layer is maintained through our [https://github.com/EESSI/software-layer-scripts](https://github.com/EESSI/software-layer) and [https://github.com/EESSI/software-layer](https://github.com/EESSI/software-layer-scripts) GitHub repositories. | ||||||
|
|
||||||
| ## Current status | ||||||
|
|
||||||
|
|
@@ -135,4 +135,10 @@ and hence the [MultiXscale](https://www.multixscale.eu/) EuroHPC Centre-of-Excel | |||||
| project (2023-2026) that is a collaboration between EESSI and [CECAM](https://www.cecam.org/), with goals | ||||||
| that include making EESSI ready for production, and supporting community contributions. | ||||||
|
|
||||||
| In 2024, EESSI won the HPCwire Reader's Choice Award at SC24. | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Still missing a paragraph on the
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| EESSI is also a critical component of the | ||||||
| [EuroHPC Federation Platform (EFP)](https://my-eurohpc.eu/), underpinning the Federated Software Catalogue. The first | ||||||
| release of EFP took place in April 2026. | ||||||
|
|
||||||
| [*(back to overview page)*](index.md) | ||||||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.