Access Jumax

The following procedure explains how to join the optima project and remotely connect to the Jumax system deployed by Maxeler at Jülich Supercomputing Centre.

1. Register on https://judoor.fz-juelich.de/register with your email address

2. A Confirmation email gives you the link to the account registration

3. Once the account is created, you can log into it on this page: https://judoor.fz-juelich.de/login using the username that is given to you in a second email

4. Enroll to the OPTIMA project by clicking on the following link: https://judoor.fz-juelich.de/projects/join/optima

5. Wait for the administrator to accept your demand

6. Now the project should appear on your account page. In the Systems section you should see jumax now.

7. Click on Manage SSH-keys

8. Open a new terminal and enter the following command: ssh-keygen -a 100 -t ed25519 -f ~/.ssh/id_ed25519

   This will generate a secure key. When keygen asks for a passphrase, you should enter one to improve security. The generated private key is in the ~/.ssh/id_ed25519 file. The generated public key is in the ~/.ssh/id_ed25519.epub file.

9. Back to your web browser, in the Your public key and options string field (1) of the page you opened at step 7, write the following:

   from="your_ip_adress,*.zam.kfa-juelich.de,jumax" ssh-ed25519 AAAAC3N...

   Replace your_ip_address by yours shown in the blue field (2). Also edit the end of the line so that it contains your own public key. Finally validate your choice with the Start upload of SSH-Keys button.

10. The upload of the key can take up to 15 minutes. It is possible that you can’t connect to jumax directly even if you see the key on your account. For further information on the use and necessity of SSH keys, go to : https://apps.fz-juelich.de/jsc/hps/juwels/access.html#key-upload-key-restriction

11. Now open your ~/.ssh/ folder. There may be a config text file. If yes open it, if not create it as an empty text file. Add the following lines to the file:

    Host jumax
        HostName jumax.zam.kfa-juelich.de
        User user1
        IdentityFile ~/.ssh/id_ed25519
        IdentitiesOnly yes
    Host jumax-cpu jumaxbuild1 jumaxbuild2
        HostName %h
        User user1
        ProxyCommand ssh -q -W %h:%p jumax
    ForwardX11 yes

    Replace user1 by your username.

12. Open a terminal and connect to jumax by executing the following command ssh jumaxbuild1 or ssh jumaxbuild2 or ssh jumax-cpu. Jumax build 1 and 2 are used to compile software applications and build DFE applications, while Jumax CPU should be used to run DFE apps on the FPGAs.

To install Webots, head to: compile Webots on Jumax