
# Streaming Optimised Scientific Software: an Introduction to [EESSI](https://www.eessi.io/docs/)
### [Friday 4 October 2024 (09:00-11:00 CEST)](https://time.is/compare/0900_4_Oct_2024_in_CEST)
:::danger
**Please fill out the feedback form:**
https://events.vsc.ac.at/event/141/surveys/140
:::
### Instructors
- Alan O’Cais (he/him; CECAM/University of Barcelona, Spain; [@ocaisa](https://github.com/ocaisa); `alan.ocais@cecam.org`)
- Thomas Röblitz (University of Bergen, Norway; [@trz42](https://github.com/trz42); `Thomas.Roblitz@uib.no`)
- Davide Grassano (CECAM/École Polytechnique Fédérale de Lausanne, Switzerland; [@crivella](https://github.com/Crivella); `davide.grassano@epfl.ch`)
- Kenneth Hoste (Ghent University, Belgium, [@boegel](https://github.com/boegel), `kenneth.hoste@ugent.be`)
- Simeon Harrison (VSC Research Center - TU Wien, Austria, `simeon.harrison@tuwien.ac.at`)
- Pavel Tomšič (Faculty for Mechanical engineering, University of Ljubljana, Slovenia,`pavel.tomsic@fs.uni-lj.si` )
---
## General information
This HackMD: https://hackmd.io/@multixscale/VSC
(to edit use https://hackmd.io/@multixscale/VSC/edit?both)
VSC page for this event: https://events.vsc.ac.at/e/EESSI-2024-10
### For the tutorial
- Access the VSC system
- You have been provided with a username and password for the event to access the VSC services. Note them down as **you will need them**.
- Access via ssh
- Shell access: `ssh -t <username>@vmos.vsc.ac.at l55`
- You will be connected to the specfic login node `l55` so you will need to enter your password twice, and you may also be required to enter an OTP
- EESSI demo GitHub repo: https://github.com/EESSI/eessi-demo
`git clone https://github.com/EESSI/eessi-demo.git`
- EESSI workflow demo GitHub repo: https://github.com/EESSI/eessi-nextflow-example
- `git clone https://github.com/EESSI/eessi-nextflow-example.git`
- Enter repository: `cd eessi-nextflow-example`
- Setup direnv: `eval "$(direnv hook bash)"`
- Allow direnv in dir: `direnv allow`
- Run the workflow: `./hello_plus_version.nf`
- I believe this step had to be done before running direnv
```bash
srun --time 150 --ntasks 1 --cpus-per-task 8 --mem=20G --partition=zen3_0512 --hint=nomultithread --qos=zen3_0512 --reservation=eessi_training --pty /bin/bash
```
### Additional info
- **[Tutorial slides](https://docs.google.com/presentation/d/1SU5ujgz0JBKM0lLack8HyEcDcjQF6STyNTZ9n85n1MA/edit?usp=sharing)**
- [EESSI documentation](https://www.eessi.io/docs/)
- Initialising the EESSI environment
```bash
source /cvmfs/software.eessi.io/versions/2023.06/init/lmod/bash
```
### Communicating with us
It's preferred to use Slack so that you can also join the EESSI community (and have quick access to all those using and contributing to EESSI!):
* To join the EESSI Slack: https://join.slack.com/t/eessi-hpc/shared_invite/zt-1wqy0t8g6-PZJTg3Hjjm5Fm3XEOkzECg .
* For posting questions or comments related to the tutorial during the presentations, we strongly prefer you to join the `#eessi-tutorial` channel in the EESSI Slack (direct link: https://eessi-hpc.slack.com/archives/C068ACS7XK8 )
* During the hands-on sessions you will be placed in break-out rooms which are _not_ recorded. This is a good opportunity to talk directly to the tutorial helpers to raise specific issues. Issues that might be of general interest will be re-raised in the main room by the helper.
### Feedback
- [Workshop feedback form](https://events.vsc.ac.at/event/141/surveys/140)
### Accessing EESSI repositories
* **production** EESSI repository:
```bash
unset MODULEPATH
source /cvmfs/software.eessi.io/versions/2023.06/init/bash
```
or
```bash
unset MODULEPATH
source /cvmfs/software.eessi.io/versions/2023.06/init/lmod/bash
```
---
### Code of conduct
During this tutorial, we strive to follow the [Contributor Covenant Code of Conduct](https://www.contributor-covenant.org/version/2/1/code_of_conduct/)
to foster an inclusive and welcoming environment for everyone.
[](https://www.contributor-covenant.org/version/2/1/code_of_conduct/)
In short:
- Use welcoming and inclusive language
- Be respectful of different viewpoints and experiences
- Gracefully accept constructive criticism
- Focus on what is best for the community
- Show courtesy and respect towards other community members
---
:::danger
You can ask questions about the workshop content at the bottom of this page though we prefer if you use the dedicated Slack channel. We use the videoconferencing chat only for reporting videoconferencing problems and such.
:::
---
:::warning
EESSI has been nominated for the **HPCwire Readers’ Choice Awards 2024**,
in the "Best HPC Programming Tool or Technology" category.
**You can help us win the award by joining the vote!**
Click here to vote: [hpcwire.com/2024-hpcwire-readers-choice-awards-voting-is-open](https://www.hpcwire.com/2024-hpcwire-readers-choice-awards-voting-is-open)
More info: [eessi.io/docs/blog/2024/09/20/hpcwire-readers-choice-awards-2024](https://www.eessi.io/docs/blog/2024/09/20/hpcwire-readers-choice-awards-2024)
:::
---
## Questions, answers, discussion and information
:::info
Remember to use the editable of this document at https://hackmd.io/@multixscale/VSC/edit?both
:::
* Ask a question like this
* ...and someone will answer like this!
*
*