Getting Started with Beehive

Connecting to the Cluster

SSH keys are required to access the cluster. Password authentication is disabled.

ssh YOUR_USERNAME@cluster.ttic.edu

If you haven't set up your SSH key yet, see the SSH Keys guide.

Critical Usage Information

Head Node Usage

The head node (cluster.ttic.edu) should only be used for:

• Submitting jobs with sbatch
• Monitoring jobs with squeue and sacct
• Light file operations and code editing

Do not run compute-intensive or I/O-intensive tasks on the head node. Instead, request an interactive job on a compute node when you need to:

• Debug your code
• Perform data preprocessing
• Run interactive Python/Jupyter sessions
• Compile large projects

Interactive Jobs

To get an interactive shell on a compute node:

# Request an interactive CPU job
srun --pty -p cpu bash

# Request an interactive GPU job
srun --pty -p gpu -G1 bash

Best Practices

1. Never run heavy workloads on the head node - use interactive jobs instead
2. Use the development partitions for testing and debugging jobs (limited to 1 hour)
3. Specify GPU architectures when your code requires specific features
4. Request only the resources you need to improve scheduling efficiency
5. Utilize checkpointing in your code to recover from the 8-hour time limit on standard partitions
6. Monitor your job's memory usage to avoid out-of-memory errors
7. Use appropriate CUDA version for your applications