====== Waldur User Guide ====== HPC Documentation: [[en:hpc-new:start|Home]] • [[en:hpc-new:registration|Registration]] • [[en:hpc-new:connection|Connection]] • [[en:hpc-new:getting_started|First Successful Job]] • [[en:hpc-new:lustre|Shared File System (Lustre)]] • [[en:hpc-new:slurm|Batch Job Execution (SLURM)]] • [[en:hpc-new:resources|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: [[https://hpc.mif.vu.lt|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) {{:en:hpc-new:images:waldur-login.png?800|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'' {{:en:hpc-new:images:waldur-profile.png?800|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'' {{:en:hpc-new:images:waldur-hpc-account.png?800|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'' {{:en:hpc-new:images:waldur-ssh-keys.png?800|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'' {{:en:hpc-new:images:waldur-workspaces.png?800|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'' {{:en:hpc-new:images:waldur-resources.png?800|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'' {{:en:hpc-new:images:waldur-login-with.png?800|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: [[en:hpc-new:connection|Connection]] ===== Find Your SLURM Allocation ===== To find the allocation account required for job submission: Navigation: ''Dashboard → Managed Projects → Resources → HPC Resource'' Locate: ''Submit with'' {{:en:hpc-new:images:waldur-submit-with.png?800|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'' {{:en:hpc-new:images:waldur-allocation-limits.png?800|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: [[en:hpc-new:resources|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: [[en:hpc-new:connection|Connection]] [[en:hpc-new:getting_started|First Successful Job]] [[en:hpc-new:slurm|Batch Job Execution (SLURM)]] [[en:hpc-new:resources|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.