configureHPC.py

This script automates initial access setup to the HPC cluster via WALDUR. It generates an SSH key if needed, uploads the public key to WALDUR, creates a desktop shortcut for SSH login, and mounts the user’s HPC home directory using SSHFS.

Requirements

Operating system

• Linux or macOS

Python

• Python 3.9 or newer

Python dependencies

Install required Python package:

pip install waldur-api-client

System dependencies

The script relies on SSH key generation, SSH connectivity checks, and mounting the HPC home directory using SSHFS.

Common

The following tools must be available in PATH:

• ssh
• ssh-keygen
• sshfs (optional)

Linux

Install sshfs using your distribution package manager:

# RHEL / CentOS / Alma / Rocky
yum install sshfs

# Debian / Ubuntu
apt-get install sshfs

macOS

Install FUSE and SSHFS using Homebrew:

brew install --cask macfuse
brew install gromgit/fuse/sshfs-mac

Note: On macOS, macFUSE requires approval in
System Settings → Privacy & Security after installation.

---

Prerequisites

Before running the script, ensure:

1. You have a Waldur account with access to a project that has an active HPC allocation.
2. You have a valid Waldur API token. You can obtain the token from the User Dashboard after logging in to Waldur.

How to run

Option 1: From Terminal

1. Clone the repository:

   git clone https://github.com/rtuhpc/configureHPC.git
   cd configureHPC

2. Ensure config.ini is configured correctly.

3. Run the script:

   python3 configure_HPC_v1.1.py

4. When prompted, paste your Waldur API token.

Option 2: Using the Desktop Shortcut (Linux)

A pre-configured .desktop file is included for Linux systems.

• Save it to your Desktop and make it executable:

  chmod +x ~/Desktop/Configure\ HPC.desktop

• Double-click to run the script in a terminal window.

---