** NOTE: All users must run their codes using SLURM. Download Tutorial.pdf or Read the tutorial below. **

Log In

Go to the GPU Cluster homepage and login with your username and password.
Only the UNLV in-campus network is allowed to connect to the GPU Cluster. VPN required if off-campus.
If your account is for research purposes, your account will be sent to you via UNLV email.
If your account is for educational purposes, your account will be sent to your lecturer. Please ask.

Create Virtual Environment

Python virtual environment gives you the ability to isolate your python projects from the system. So, users can install and manage their own set of packages or create projects in different versions independently.

Install Miniconda

Before you create your virtual environment, you need to install Miniconda. Please follow these steps.

Step1: Open terminal in JupyterHub
Step2: Type wget https://repo.anaconda.com/miniconda/Miniconda3-py39_23.1.0-1-Linux-x86_64.sh
Step3: Type bash Miniconda3-py39_23.1.0-1-Linux-x86_64.sh
Step4: Type conda update conda

Create Virtual Environment

Now, you can create your own virtual environment. To create a virtual env, please follow the instructions.

Step1: Type conda create -n yourenv python=3.9.16 anaconda *** Note: yourenv will be your virtual environment name ***

Step2: Type conda env list to verify the new environment was installed

Step3: Close the terminal window and open a new terminal. Your prompt list which environment is activate. For now, it is (base) which is the default.

Step4: Type conda activate yourenv

Now, you can see the environment has changed. Make sure parenthesis with your virtual environment is in front of your account.

Step5: Install the packages you want to the virtual environment

Step6: Type python -m ipykernel install --user --name=yourenv

This command will create the kernel on your JupyterHub home. In case if the ipykernel is not available, install the ipykernel using this pip install command: pip install ipykernel

Open [File – New Launcher] in the menu. You can see the kernel with the name as your virtual environment. This might take some time. If it doesn’t appear after a few minutes, try opening a new window.

Step7: Go back to the terminal. Type conda deactivate to come out of the environment. The setting done above will remain as it is.

Cleaning-up

If your project is done or if you no longer require a virtual environment, please follow the step to delete your environment and kernel.

Step1: Type conda remove -n yourenv --all
Step2: Type jupyter kernelspec uninstall yourenv

Submit SLURM Job Script

SLURM is an open-source resource manager. It helps to organize and schedule the multiple jobs from multiple users. By submitting a job script via slurm, your job will be scheduled in order and efficiently.
To submit a job script, you need to have your own virtual environment, shell script for SLURM, and your python file for the project.