Skip to content

Account#

You have to pass the MOOC at: and then request account at:

More information about services on HPC core website.

Here's your QuickStart Guide beautifully formatted in clean, professional Markdown, with clear structure, syntax highlighting, and user-friendly formatting:


๐Ÿš€ QuickStart Guide: Accessing Maestro Cluster at Pasteur Institute#

Note: Replace username with your actual login name throughout.


๐Ÿ”Œ Connect to Maestro#

๐Ÿ–ฅ๏ธ On Windows#

  • Install WSL (Windows Subsystem for Linux).
  • Choose Ubuntu as your Linux distribution.
  • Once installed, open the WSL terminal.
  • Your local drives will be accessible under /mnt.

๐Ÿ On macOS#

  • Open Terminal via Applications > Utilities.
  • Your personal files are located under /Users/username.

๐Ÿง On Linux#

  • Open a terminal (e.g., xterm, gnome-terminal, etc.).

๐Ÿ” SSH into Maestro#

Connect via SSH (from outside Pasteur, ensure you're connected to the VPN first):

ssh -Y username@maestro.pasteur.fr

โœ… The -Y flag enables X11 forwarding (useful for GUI apps).

After entering your password, youโ€™ll be logged in.


๐Ÿงช First-Time Check: Validate Your Account#

Run this command to confirm your account is active:

srun hostname

โœ… Expected output:

maestro-xxxx
(where xxxx is a four-digit number)

If this fails, contact the support team.


๐Ÿ“ฅ Transfer Files to Maestro#

โœ… Copy a Local Directory to Your Home Folder#

scp -r mydirectory username@maestro.pasteur.fr:

๐Ÿ“Œ This copies mydirectory to your home directory (~).

โš ๏ธ Note: Your $HOME has a 100 GB quota. Clean up old files regularly โ€” otherwise, jobs may fail due to lack of disk space.


๐Ÿ’พ Use $SCRATCH for Temporary Work#

For large datasets or temporary processing:

scp -r mydirectory username@maestro.pasteur.fr:/pasteur/appa/scratch/username/

โœ… No quota โ€” unlimited space
โ— But: Clean up after use!
โš ๏ธ Leaving large files in $SCRATCH impacts other users' work.


๐Ÿ“Š Monitor Your Jobs#

Add the following aliases to your ~/.bashrc file to streamline job monitoring:

# Add to ~/.bashrc
alias sq='squeue -u $USER'
alias sqr='squeue -u $USER -t RUNNING'
alias sqp='squeue -u $USER -t PENDING'
alias sql='squeue -u $USER -l'

๐Ÿ’ก Run source ~/.bashrc after editing to reload.

๐Ÿ“‹ Available Commands:#

Command Purpose
sq List all your jobs
sqr Show only running jobs
sqp Show only pending jobs
sql Show detailed job info (e.g., node, memory, time)

๐Ÿ“Œ These are essential for tracking job status and debugging.


โœ… Summary Checklist#

Task Command
Connect via WSL (Windows) Open WSL, use terminal
Connect via macOS Open Terminal
SSH to Maestro ssh -Y username@maestro.pasteur.fr
Test login srun hostname
Copy files to home scp -r mydir username@maestro.pasteur.fr:
Copy to scratch scp -r mydir username@maestro.pasteur.fr:/pasteur/appa/scratch/username/
Monitor jobs Use sq, sqr, sqp, sql

๐Ÿ“Œ Pro Tip: Always clean up your $HOME and $SCRATCH directories after job completion to help maintain system fairness and performance.


๐Ÿ“ž Need Help? Contact the Pasteur HPC support team for account issues, access, or troubleshooting.


โœ… You're now ready to run jobs, analyze data, and use Maestro efficiently!