IT wiki

VU MIF STSC

User Tools

Site Tools


en:hpc-new:waldur

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:

  • A user from another Vilnius University faculty or institute
  • A member of a research project
  • An external collaborator
  • A user with additional CPU or GPU allocations

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

What Can I Do in Waldur?

Waldur allows you to:

  • Create and manage your HPC account
  • Manage SSH login keys
  • View assigned HPC resources
  • Check allocation limits
  • View resource usage
  • Join project workspaces
  • Access project-specific HPC allocations

Logging In

Open:

VU MIF HPC Portal

Sign in using one of the supported authentication methods:

  • LITNET FEDI
  • eduGAIN
  • Local username and password (only for users who cannot use LITNET FEDI or eduGAIN)

<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:

  • Manage

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:

  • HPC User Account

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:

  • SSH
  • SCP
  • SFTP
  • WinSCP
  • Visual Studio Code Remote SSH

Configure SSH Keys

SSH keys are required for HPC access.

Open:

  • SSH Keys

Upload your public SSH key.

Example public key:

ssh-ed25519 AAAAC3NzaC1...

You may upload multiple SSH keys if needed.

Examples:

  • Work computer
  • Personal workstation
  • Laptop

<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:

  • Select Workspace

Typical workspaces include:

  • MIF users
  • VU users
  • Research projects
  • Collaborative projects

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

Understanding Projects

A project is a collection of users and allocated resources.

Examples:

  • Research groups
  • Scientific collaborations
  • Grant-funded projects
  • Shared laboratory environments

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:

  • CPU allocations
  • GPU allocations
  • Active resources
  • Available services

Finding Your HPC Login Information

Open the HPC resource assigned to your project.

Locate:

  • Login with

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

Typically you will see:

  • HPC username
  • Login instructions
  • Authentication requirements

You should use:

  • The user account created through FreeIPA
  • The SSH key uploaded to Waldur

For connection instructions see:

Finding Your SLURM Allocation

Open the HPC resource assigned to your project.

Locate:

  • Submit with

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:

  • Backend ID

Depending on your project configuration, you may see:

  • CPU limits
  • GPU limits
  • Resource quotas
  • Allocation information

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:

  • Dashboard
  • Managed Projects
  • Project Resources
  • Submit with

The SLURM allocation account typically begins with:

alloc_

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

Verify that:

  • You have been added to the project
  • The allocation exists
  • The allocation name is correct
  • You are using the correct –account parameter

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:

  • Dashboard
  • Managed Projects
  • Resources

Common Problems

No Available Resources Visible

Verify that:

  • You have selected the correct workspace
  • You are a member of the project
  • The project has active allocations

SSH Login Does Not Work

Verify that:

  • Your HPC account has been created
  • Your SSH public key has been uploaded
  • You are using the correct private key

Invalid SLURM Account

Check the allocation name shown under:

  • Submit with

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>

en/hpc-new/waldur.txt · Last modified: by eduardas

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki