Table of Contents

Waldur User Guide

Waldur is the self-service portal used to manage HPC projects, resource allocations, user access, and usage accounting.

If you are a VU MIF user working within the default allocation, you may never need to use Waldur.

However, if you are:

then Waldur will be your primary portal for managing HPC resources.

What Can I Do in Waldur?

Waldur allows you to:

Logging In

Open:

VU MIF HPC Portal

Sign in using one of the supported authentication methods:

<note tip> Most Vilnius University users should use LITNET FEDI.

External users usually use eduGAIN or credentials provided by the HPC administrators. </note>

Complete Your Profile

After logging in, open:

Review and update your profile information as needed.

Keeping your information current helps administrators provide support and manage project memberships.

Create an HPC Account

Before using cluster resources, you must create your HPC user account.

Navigate to:

Create the HPC user record.

The account information will be synchronized to the HPC authentication system (FreeIPA).

After the account is created, you can use it to connect to:

Configure SSH Keys

SSH keys are required for HPC access.

Open:

Upload your public SSH key.

Example public key:

ssh-ed25519 AAAAC3NzaC1...

You may upload multiple SSH keys if needed.

Examples:

<note tip> Using SSH keys is more secure and convenient than password-based authentication. </note>

Select Your Workspace

Waldur uses workspaces to organize users, projects, and resources.

Open:

Typical workspaces include:

Select the workspace that contains the project you wish to use.

Understanding Projects

A project is a collection of users and allocated resources.

Examples:

Projects allow multiple users to share CPU and GPU resources under a common allocation.

Viewing Your Resources

To see the resources available to your project:

  1. Open Dashboard
  2. Select Managed Projects
  3. Open the relevant project
  4. Select Resources

You can view:

Finding Your HPC Login Information

Open the HPC resource assigned to your project.

Locate:

This section contains the information required to connect to the cluster.

Typically you will see:

You should use:

For connection instructions see:

Finding Your SLURM Allocation

Open the HPC resource assigned to your project.

Locate:

This section contains information required when submitting SLURM jobs.

The most important value is the SLURM allocation account:

alloc_YYYY_PROJECTNAME

or

alloc_XXXX_PROJECT

Your allocation name may differ.

Using a Project Allocation

When submitting jobs, specify the project allocation:

#!/bin/bash
#SBATCH --account=alloc_xxxx_project
#SBATCH --partition=main
#SBATCH --cpus-per-task=4
#SBATCH --time=01:00:00
 
python3 script.py

<note important> Most VU MIF users working under the default allocation do not need to specify the –account parameter.

Only users assigned to project resources should use the allocation account provided by Waldur. </note>

Viewing Allocation Limits

Open the HPC resource assigned to your project.

The allocation limits are displayed under:

Depending on your project configuration, you may see:

For details about quotas and resource usage see:

Inviting Collaborators

Project administrators can invite additional users to a project.

Typical workflow:

  1. User creates a Waldur account
  2. Project administrator adds the user to the project
  3. User gains access to shared resources
  4. User can submit jobs using the project allocation

Frequently Asked Questions

Do all HPC users need Waldur?

No.

Most VU MIF users can use the default HPC allocation without interacting with Waldur.

Waldur is primarily used for project-based resource management.

Where can I find my SLURM account?

Open:

The SLURM allocation account typically begins with:

alloc_

Why can't I submit a job using my allocation?

Verify that:

Can I use multiple SSH keys?

Yes.

Multiple SSH keys can be uploaded and managed through the SSH Keys section.

Where can I see my available resources?

Open:

Common Problems

No Available Resources Visible

Verify that:

SSH Login Does Not Work

Verify that:

Invalid SLURM Account

Check the allocation name shown under:

The allocation used in SLURM must exactly match the account shown in Waldur.

Next Steps

Once your account and allocations are configured:


<note> This guide was prepared and updated by the VU MIF HPC team with the assistance of Microsoft Copilot. All procedures and examples should be validated against the current HPC environment, software stack, and operational policies. </note>