1
Fork 0
This repository has been archived on 2026-08-15. You can view files and clone it, but you cannot make any changes to it's state, such as pushing and creating new issues, pull requests or comments.
2026SEL3-project-Brittle_St.../scripts/hpc/train.pbs
Tibo De Peuter 7bcfa66685 feat(hpc): route caches to $VSC_SCRATCH, outputs to $VSC_DATA
- Install: redirect XDG_CACHE_HOME, UV_CACHE_DIR, MPLCONFIGDIR to
  $VSC_SCRATCH before any pip/module activity ($VSC_HOME is only ~3 GB)
- train.pbs:
  - Set same cache env vars at job start
  - Write run outputs and WandB cache to $VSC_SCRATCH during the run (fast I/O)
  - Copy results to $VSC_DATA/runs/<jobid>/ on completion for persistence
  - Redirect PBS stdout/stderr to $VSC_DATA/runs/<jobid>/job.{out,err}
  - Add cd $PBS_O_WORKDIR as first step (HPC best practice)
2026-04-04 18:39:45 +02:00

80 lines
3.3 KiB
Bash

#!/bin/bash
# scripts/hpc/train.pbs — Submit PPO training as a batch job with qsub.
#
# Usage (from project root after cloning into $VSC_HOME):
# qsub scripts/hpc/train.pbs
#
# To target a different GPU cluster (default: joltik):
# module swap cluster/accelgor && qsub scripts/hpc/train.pbs
#
# Available GPU clusters: joltik, accelgor, litleo
# Debug / interactive: doduo (CPU) or donphan (interactive GPU)
# ---------------------------------------------------------------------------
# PBS job directives
# ---------------------------------------------------------------------------
#PBS -N brittlestar-ppo
#PBS -l nodes=1:ppn=8:gpus=1
#PBS -l walltime=24:00:00
#PBS -l mem=32gb
# Logs are redirected inside the script to $VSC_DATA so they persist.
#PBS -o /dev/null
#PBS -e /dev/null
# ---------------------------------------------------------------------------
set -euo pipefail
# Always change to the directory from which qsub was called (best practice).
cd "$PBS_O_WORKDIR"
# ---------------------------------------------------------------------------
# Storage routing (see https://docs.hpc.ugent.be/Linux/running_jobs_with_input_output_data/)
#
# $VSC_HOME (~3 GB) — project source code only; no writes during jobs
# $VSC_DATA (~25 GB) — persistent run artefacts (models, final logs)
# $VSC_SCRATCH (large) — fast I/O during the job; caches; intermediate files
# ---------------------------------------------------------------------------
# Redirect Python / pip / uv caches away from $VSC_HOME to scratch (fast I/O).
export XDG_CACHE_HOME="$VSC_SCRATCH/.cache"
export UV_CACHE_DIR="$VSC_SCRATCH/.cache/uv"
export MPLCONFIGDIR="$VSC_SCRATCH/.config/matplotlib"
mkdir -p "$XDG_CACHE_HOME" "$UV_CACHE_DIR" "$MPLCONFIGDIR"
# Run outputs: write to $VSC_SCRATCH during the job (fast), then copy to
# $VSC_DATA at the end for long-term storage.
RUN_ID="brittlestar_${PBS_JOBID}"
SCRATCH_RUNDIR="$VSC_SCRATCH/runs/$RUN_ID"
DATA_RUNDIR="$VSC_DATA/runs/$RUN_ID"
mkdir -p "$SCRATCH_RUNDIR" "$DATA_RUNDIR"
# PBS stdout/stderr: redirect into the data directory for persistence.
exec 1> "$DATA_RUNDIR/job.out" 2> "$DATA_RUNDIR/job.err"
# ---------------------------------------------------------------------------
# Environment
# ---------------------------------------------------------------------------
module load vsc-venv
source vsc-venv --activate --modules env/hpc/modules.txt
# EGL is required for headless MuJoCo — both the physics sim loop and
# on-demand video rendering to disk. Without this, MuJoCo tries to open an
# X11 display and fails on compute nodes.
export MUJOCO_GL=egl
# Tell WandB to store its local run cache on scratch (fast, large).
export WANDB_DIR="$SCRATCH_RUNDIR"
# ---------------------------------------------------------------------------
# Run
# ---------------------------------------------------------------------------
python src/train.py \
--config configs/production_training.yaml \
--run_dir "$SCRATCH_RUNDIR"
# ---------------------------------------------------------------------------
# Stage out: copy results to persistent VSC_DATA storage.
# ---------------------------------------------------------------------------
echo "Copying results from scratch to \$VSC_DATA..."
cp -r "$SCRATCH_RUNDIR/." "$DATA_RUNDIR/"
echo "Done. Results at: $DATA_RUNDIR"