Table of Contents

Waldur User Guide

HPC Documentation:

Home • Registration • Connection • First Successful Job • Shared File System (Lustre) • Batch Job Execution (SLURM) • Resource Allocations and Project Requests

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, project members and users with additional resource allocations will use Waldur to manage their HPC access.

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 account (provided only when federated login is unavailable)

Waldur login page

Figure 1. Waldur login page. Most Vilnius University users should authenticate using LITNET FEDI.

Most Vilnius University users should use LITNET FEDI.

External users usually use eduGAIN or credentials provided by the HPC administrators.

Complete Your Profile

After your first login, review your profile information.

Navigation:

Manage

Profile management

Figure 2. Review and update your profile information.

Keeping your information up to date helps administrators provide support and manage project memberships.

Create an HPC Account

Before using HPC resources, create your HPC user account.

Navigation:

Dashboard → Select Workspace → HPC User Account

Create HPC user account

Figure 3. Creating an HPC account in Waldur. Account information is synchronized automatically to the HPC authentication system (FreeIPA).

After the account has been created, it can be used for:

SSH SCP SFTP WinSCP Visual Studio Code Remote SSH

Configure SSH Keys

SSH keys are required for HPC access.

Navigation:

Manage → SSH Keys → Add SSH Key

SSH key management

Figure 4. Upload and manage SSH public keys used to access the HPC cluster.

Paste your public key, for example:

ssh-ed25519 AAAAC3NzaC1…

You may upload multiple SSH keys, for example:

Work computer Laptop Personal workstation Using SSH keys is more secure and convenient than password-based authentication.

Select a Workspace

A user may belong to multiple organizations or projects.

Navigation:

Select Workspace

Workspace selection

Figure 5. Workspace selection. Choose the organization or project whose resources you want to access.

Typical workspaces include:

MIF users VU users Research projects Collaborative projects

Understanding Projects

A project is a collection of users and allocated resources.

Projects are commonly used for:

Research groups Scientific collaborations Grant-funded projects Shared laboratory environments

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

View Available Resources

To view project resources:

Navigation:

Dashboard → Managed Projects → Project → Resources

Project resources

Figure 6. Project resources page showing available HPC services and resource allocations.

This page displays information about:

CPU allocations GPU allocations Available services Resource limits

Find Your HPC Login Information

To view the credentials required for connecting to the HPC cluster:

Navigation:

Dashboard → Managed Projects → Resources → HPC Resource

Locate:

Login with

HPC login information

Figure 7. The “Login with” section contains the information required to access the HPC cluster.

This section typically contains:

HPC username Login instructions Authentication information

You should use:

The HPC user account created in Waldur The SSH key uploaded in the SSH Keys section

For connection instructions see:

Connection

Find Your SLURM Allocation

To find the allocation account required for job submission:

Navigation:

Dashboard → Managed Projects → Resources → HPC Resource

Locate:

Submit with

SLURM allocation account information

Figure 8. The “Submit with” section contains the SLURM allocation account that must be used when submitting jobs under a project allocation.

Look for an allocation name similar to:

alloc_2026_MY_PROJECT

Use this allocation in your SLURM job scripts:

#SBATCH –account=alloc_2026_MY_PROJECT Look for an allocation name beginning with: alloc_

You will need this value when submitting SLURM jobs under a project allocation.

Most VU MIF users do not need to specify the –account parameter because they use the default allocation.

Only users assigned to project resources should use the allocation account provided by Waldur.

View Allocation Limits

To see project quotas and allocation limits:

Navigation:

Dashboard → Managed Projects → Resources → HPC Resource

Locate:

Backend ID

Allocation limits and quotas

Figure 9. Allocation limits and usage information. This section shows the resources assigned to the project.

Depending on the project configuration, you may see:

CPU allocations GPU allocations Resource quotas Usage information

For details about quotas and resource usage see:

Resource Allocations and Project Requests

Inviting Collaborators

Project administrators can add additional users to a project.

Typical workflow:

A user creates a Waldur account. The user uploads SSH keys. A project administrator adds the user to the project. The user gains access to project resources. The 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?

Navigation:

Dashboard → Managed Projects → Resources → HPC Resource → Submit with

The allocation account typically begins with:

alloc_

Why can't I submit jobs using my allocation?

Verify that:

You are a member of the project. The allocation exists. The allocation name is correct. You specified the correct –account parameter.

Can I upload multiple SSH keys?

Yes.

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

Where can I see how many resources are available?

Navigation:

Dashboard → Managed Projects → Resources

Common Problems

No Resources Are Visible

Verify that:

You selected the correct workspace. You are a member of the correct 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 shown in:

Dashboard → Managed Projects → Resources → HPC Resource → Submit with

The value used in SLURM must exactly match the allocation displayed by Waldur.

Next Steps

Once your account and allocations are configured:

Connection First Successful Job Batch Job Execution (SLURM) Resource Allocations and Project Requests This guide was prepared and updated by the VU MIF HPC team with the assistance of Microsoft Copilot. Screenshots may change as the Waldur interface evolves. Always refer to the current portal interface if menu names differ.