Update IBG 3: JSC Supercomputer HowTo authored by Johannes Keller's avatar Johannes Keller
......@@ -2,13 +2,17 @@ Welcome to the IBG-3 specific introduction for getting started with the JSC supe
This document is intended to complement the general documentation of JURECA and JUWELS by providing specific guidance tailored for IBG-3 users, helping you navigate common pitfalls and optimize your computing experience.
> [!NOTE] Strong Recommendation
> Work through HPC basics of the "Introduction to Supercomputing at JSC" under https://zhukov1.pages.jsc.fz-juelich.de/intro2sc-handson/2025_11/
Feel free to correct/adapt this document!
**Disclaimer:** Parts of this documentation have been re-written by ChatGPT asking for clarity and conciseness.
# Joining a compute time project
The following steps should help you get started with the JSC supercomputer efficiently.
The following steps should help you get started with the JSC supercomputer
efficiently.
1. Create a JuDoor Account:
- Visit JuDoor (https://judoor.fz-juelich.de/login).
......@@ -17,6 +21,7 @@ The following steps should help you get started with the JSC supercomputer effic
- Afterwards, you will receive an e-mail from dispatch@jsc.de with a personalized link.
- Click on the link, fill in the form with your data and submit the form.
- With this, the creation of your JSC account is completed. Now, you can log in to your JuDoor account with your username and password.
2. Join a Project:
- On JuDoor, click “Join a project.”
- Specify the project id. Examples:
......@@ -26,19 +31,26 @@ The following steps should help you get started with the JSC supercomputer effic
- For JUWELS-data-project, use “jibg36.”
- Provide some additional information meant for the PI/PA that will grant you access.
- The PI/PA will be automatically informed about your join request and can add you to the different systems available in the project. Once you are approved to join the project compute time, you should be able to see the project id under `Projects`.
3. Generate an SSH Key:
- Simplified instructions for SSH Key Generation: https://gitlab.jsc.fz-juelich.de/sdlts/general-organisation/jsc-supercomputer-wiki-for-ibg-3/-/wikis/SSH-Keys-at-JSC-Supercomputers
- General instructions in the JURECA manual (https://apps.fz-juelich.de/jsc/hps/jureca/access.html) to generate an SSH key.
4. Add SSH Key to JuDoor:
- Instructions: https://gitlab.jsc.fz-juelich.de/sdlts/general-organisation/jsc-supercomputer-wiki-for-ibg-3/-/wikis/SSH-Keys-at-JSC-Supercomputers#uploading-the-public-key-pair-to-judoor
- Use IP-Adresses of the form `x.y.0.0/16` (IPv4) or `x:y:z::/48` (IPv6) in the "from" clause, where the numbers "x", "y" and, for IPv6, "z" can be copied from the users's ip-adress displayed in the top of the JuDoor SSH-key-upload-page. Background: The later numbers of an ip-adress vary between logins. The suffix `0.0/16` (IPv4) or `::/48` (IPv6) ensures that the from-clause stays valid for these variations.
- Use IP-Adresses of the form `x.y.0.0/16` (IPv4) or `x:y:z::/48` (IPv6) in the "from" clause, where the numbers "x", "y" and, for IPv6, "z" can be copied from the users's ip-adress displayed in the top
of the JuDoor SSH-key-upload-page. Background: The later numbers of an
ip-adress vary between logins. The suffix `0.0/16` (IPv4) or `::/48` (IPv6) ensures that the from-clause stays valid for these variations.
5. Logging in to supercomputer:
- Detailed Instructions: https://gitlab.jsc.fz-juelich.de/sdlts/general-organisation/jsc-supercomputer-wiki-for-ibg-3/-/wikis/Logging-in-to-JSC-Supercomputers
- on JURECA, enforce IPv4: https://gitlab.jsc.fz-juelich.de/sdlts/general-organisation/jsc-supercomputer-wiki-for-ibg-3/-/wikis/Logging-in-to-JSC-Supercomputers#jureca-note-on-ipv6-connectivity
- Official manual, JURECA: https://apps.fz-juelich.de/jsc/hps/jureca/access.html#logging-in-to-system-name
- Official manual, JUWELS: https://apps.fz-juelich.de/jsc/hps/juwels/access.html#logging-in-to-system-name
6. Contact for Assistance:
- If you encounter login issues or have questions about using the system, feel free to contact for assistance.
- If you encounter login issues or have questions about using the
system, feel free to contact for assistance.
- Johannes: jo.keller@fz-juelich.de
- JSC general support contacts: https://www.fz-juelich.de/en/ias/jsc/services/user-support
......@@ -74,11 +86,13 @@ https://gitlab.jsc.fz-juelich.de/sdlts/general-organisation/jsc-supercomputer-wi
## Useful links
- Introduction to Supercomputing at JSC: [https://zhukov1.pages.jsc.fz-juelich.de/intro2sc-handson/2025_11/](https://zhukov1.pages.jsc.fz-juelich.de/intro2sc-handson/2025_11/ "https://zhukov1.pages.jsc.fz-juelich.de/intro2sc-handson/2025_11/")
* NOTE: This course is provided twice a year at JSC. Check the [JSC training website](https://www.fz-juelich.de/en/jsc/education/training-courses) for the newest edition.
- JSC HPC support corner: [https://www.fz-juelich.de/en/jsc/services/user-support/jsc-hpc-support-corner](https://www.fz-juelich.de/en/jsc/services/user-support/jsc-hpc-support-corner "https://www.fz-juelich.de/en/jsc/services/user-support/jsc-hpc-support-corner")
- Training courses in JSC: https://www.fz-juelich.de/en/jsc/education/training-courses
- Introduction to Supercomputing at JSC:
- https://zhukov1.pages.jsc.fz-juelich.de/intro2sc-handson/2025_11/
- https://www.fz-juelich.de/en/ias/jsc/education/training-courses/training-materials/course-material-sc-introduction-may-23
- JURECA documentation: https://apps.fz-juelich.de/jsc/hps/jureca/index.html
- JUWELS documentation: https://apps.fz-juelich.de/jsc/hps/juwels/index.html
- available file systems: https://apps.fz-juelich.de/jsc/hps/juwels/environment.html#available-file-systems
- JSC User Support: https://www.fz-juelich.de/en/ias/jsc/services/user-support
- JSC HPC Support Corner: https://www.fz-juelich.de/en/jsc/services/user-support/jsc-hpc-support-corner
- JuDoor: https://judoor.fz-juelich.de/login
\ No newline at end of file