Getting Started
This step-by-step guide will get you started to perform your first dummy computation. You will need an RWTH Account, an HPC Account and a recommended VPN Account.
- Learn about Linux in HPC
 - Get an RWTH Account with IDM:
- RWTH members already have an RWTH Account
 - Externals can also get access:
- Apply for a Computation project. You will eventually receive an RWTH Account
 - Get the role "Angehörige Organisationseinheit" from an organisational unit at RWTH Aachen University
 
 
 - Get an HPC Account with RegApp:
- Generate an HPC Account
 - Set HPC Account Password
 - Mandatory: Set 2FA
- Safely store a backup 2FA TAN Code list (not meant for daily login)
 - Setup a 2FA Token Generator used for daily login.
 
 - Recommended: Set an SSH KEY
 
 - Get a VPN Account:
 - Login to the HPC System:
- Connect to the RWTH Network
- Confirm if your institution can already reach the RWTH Network.
- Connect to your institutions VPN if necessary.
 - Type on a console  ping login23-1.hpc.itc.rwth-aachen.de 
- See if there was a Reply ...
 
 
 - Connect to the RWTH VPN if necessary. 
- Server: vpn.rwth-aachen.de
 - Tunnel: Full tunnel (all traffic via RWTH network) or split tunnel (only RWTH internal addresses are accessed via VPN)
 - VPN-Username: ab123456 as seen on your VPN Account
 - VPN-Password: XXXXXXX as chosen for your VPN Account
 
 
 - Confirm if your institution can already reach the RWTH Network.
 - Connect to any login node:
- Open a console or the SSH client:
- Type: ssh -l ab123456 login23-1.hpc.itc.rwth-aachen.de
 - SSH-Username: ab123456 as seen on your HPC Account
 - SSH-Password: XXXXXXX as chosen for your HPC Account
 
 - Or connect with a Graphical Interface using FastX to any X node:
- Download FastX3
 - Connect to login23-x-1.hpc.itc.rwth-aachen.de
 - Username: ab123456 as seen on your HPC Account
 - Password: XXXXXXX as chosen for your HPC Account
 
 
 - Open a console or the SSH client:
 
 - Connect to the RWTH Network
 - Start a short interactive test job:
- Open a terminal | command prompt if using FastX:
- Right click: Terminal Hier öffnen | Open Here
 
 - Start a 25 minute job with 2 cpus on the devel partition:
- Type: salloc -p devel -n 2 -t 25
 
 - Wait for the job to start. You will be redirected to a compute node
 - Type command hostname 
- See Output n23m0001.hpc.itc.rwth-aachen.de or similar
 
 - NOTE! We use ZSH instead of bash by default!
 - Use the module system to load pre-installed efficient software
 - Run a small test computation
 - Exit the node and relinquish the allocated job:
- Type: exit
 
 
 - Open a terminal | command prompt if using FastX:
 - Create batch jobs to run computations on the HPC system.
 
Please send us some feedback on how to improve this quick start Guide!

