====== 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: [[https://hpc.mif.vu.lt|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) Most Vilnius University users should use LITNET FEDI. External users usually use eduGAIN or credentials provided by the HPC administrators. ===== 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 Using SSH keys is more secure and convenient than password-based authentication. ===== 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: * [[en:hpc-new:connection|Connection]] ===== 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 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. ===== 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: * [[en:hpc-new:resources|Resource Allocations and Project Requests]] ===== 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 ''--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: * [[en:hpc-new:connection|Connect to HPC]] * [[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. All procedures and examples should be validated against the current HPC environment, software stack, and operational policies.