Lattice Practices

Create external accounts

Modified on: 04.10.23

A. Create account on Judoor, and join the "training2335" project

1. Visit https://judoor.fz-juelich.de/login and click on Register.
2. Follow the instruction to complete the registration. Make sure you register with the same email address you used to register to Lattice Practices. Notice that you will be asked to choose a password, while your username is created by the system and it will be sent to you be email once the registration process is terminated.
3. Go back to https://judoor.fz-juelich.de/login and login with your username and password. You will be automatically redirected to the "Your account" page. You will see your name and personal information.
4. Click on Join a project. The tab "Submit a request to participate in a project" opens up.
5. Under "Project id", type training2335 (without spaces). Under "Additional information", type Participant in Lattice Practices 2023.
6. Click on Join project. Your association to the project needs to be approved by one of the administrators, therefore it may take some time. You will get an automatic email confirmation when your request has been approved. Once your request is approved, you will see the project "training2335" listed on your "Your account" page.
7. [added on 04.10.23] In your "Your account" page, under "Systems", you will have "judac" and "jusuf". Click on sign the usage agreement next to each of them and follow the instructions.

B. Activate the Jupyter-JSC service

This step needs to be executed about half an hour after you have created your account of Judoor.

1. Visit https://jupyter-jsc.fz-juelich.de/hub/login and click on Login.
2. Login with your Judoor credentials. If the login is successful, you will get a popup which says: "Your authentication with remote service was successful...". If not, wait extra 30 minutes and try again. If the login is not successful again, contact the organizers.
3. Click on Register.
4. Accept the Terms and Conditions for the use of the system.

C. Create an ssh-key and upload it on Judoor

Note: an ssh key is a type of credential access, which we will use to log into the machines at Jülich Supercomputing Centre. If you do not know what it is, you can google it.

For Linux or MacOS

1. Open a terminal and type  
   mkdir -p ~/.ssh  
   ssh-keygen -a 100 -t ed25519 -f ~/.ssh/id_ed25519_juelich  
   You will need to choose a strong passphrase, which you need to remember. You will be asked the passphrase every time you use the key. The second command will create two files: the private key ~/.ssh/id_ed25519_juelich and the public key ~/.ssh/id_ed25519_juelich.pub. Never share your private key with anybody!
2. In the terminal, type  
   cat ~/.ssh/id_ed25519_juelich.pub  
   This will print the public key in the terminal. Copy the output of the 'cat' command.
3. Visit https://judoor.fz-juelich.de/login and login with your username and password. You will be automatically redirected to the "Your account" page.
4. Under "Systems", you will have "judac" and "jusuf". These are two different machines hosted at the Jülich Supercomputing Centre. Click on Manage SSH-keys next to "judac". You will be redirected to the page "SSH keys on judac".
5. Under the field "Your public key and options string" you will need to type the following string:  
   from="141.20.0.0/16" <public-key>  
   where you need to replace <public-key> with the output of the 'cat' command copied in 2.
6. Click on Start upload of SSH-Keys.
7. Once the upload is complete you will be redirected to the "Your account" page.
8. Under "Systems", click on Manage SSH-keys next to "jusuf". You will be redirected to the page "SSH keys on jusuf". Repeat steps 5 and 6.

For Windows

None of the local organizers uses Windows, and in general we are not be able to help you with issues related to Windows. We strongly recommend you install a Linux distribution on your laptop. Nevertheless, it is possible to use Windows at Lattice practices. You will need to install PuTTY and generate an ssh key with PuTTY. Instructions can be found here: https://apps.fz-juelich.de/jsc/hps/jusuf/cluster/access.html#putty. Once you create your ssh key, you should copy the public key and described in the previous link. Then:

1. Visit https://judoor.fz-juelich.de/login and login with your username and password. You will be automatically redirected to the "Your account" page.
2. Under "Systems", you will have "judac" and "jusuf". These are two different machines hosted at the Jülich Supercomputing Centre. Click on Manage SSH-keys next to "judac". You will be redirected to the page "SSH keys on judac".
3. Under the field "Your public key and options string" you will need to type the following string:  
   from="141.20.0.0/16" <public-key>  
   where you need to replace <public-key> with your public key copied before.
4. Click on Start upload of SSH-Keys.
5. Once the upload is complete you will be redirected to the "Your account" page.
6. Under "Systems", click on Manage SSH-keys next to "jusuf". You will be redirected to the page "SSH keys on jusuf". Repeat steps 3 and 4.