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:
- 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:
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:
- Open Dashboard
- Select Managed Projects
- Open the relevant project
- 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:
- User creates a Waldur account
- Project administrator adds the user to the project
- User gains access to shared resources
- 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
–accountparameter
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>
