# Using MetaX C500 GPUs

Currently, OAsis HPC is connecting with one Kubernetes cluster (gcc500), which has one compute node and is equipped with 2 MetaX C500 GPUs. This guide walks through how to request and utilize MetaX C500 GPUs on the platform by examples.

Click on the Kubernetes tab to see the cluster's high-level information and the container images prepared for you.

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%; border-width: 0px; background-color: rgb(236, 240, 241); border-style: none;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><thead><tr><td style="border-width: 0px;">[![gcc500-overview1.png](https://doc.oasishpc.hk/uploads/images/gallery/2024-04/scaled-1680-/gcc500-overview1.png)](https://doc.oasishpc.hk/uploads/images/gallery/2024-04/gcc500-overview1.png)

One cluster named gcc500 is available to you, with two C500 GPUs.

</td><td style="border-width: 0px;">[![gcc500-overview2.png](https://doc.oasishpc.hk/uploads/images/gallery/2024-04/scaled-1680-/gcc500-overview2.png)](https://doc.oasishpc.hk/uploads/images/gallery/2024-04/gcc500-overview2.png)

Several containers are prepared in the cluster using MetaX MACA technology.

</td></tr></thead></table>

#### Creating a disk for persistent storage

Before requesting computing resources, we may create a disk to store our codes and data. Open the Disks tab, and make a disk as follows:

<table border="1" id="bkmrk-create-a-10gb-disk-n" style="border-collapse: collapse; width: 100%; border-width: 0px; background-color: rgb(236, 240, 241); border-style: none;"><thead><tr><td style="border-width: 0px; width: 100%;">[![gcc500-disk.png](https://doc.oasishpc.hk/uploads/images/gallery/2024-04/gcc500-disk.png)](https://doc.oasishpc.hk/uploads/images/gallery/2024-04/gcc500-disk.png)

Create a 10GB disk named mydata.

Storage class is the storage tier, which may incur a different monthly rate; please select default.

</td></tr></thead></table>


#### Interactive workspace

Platform support requesting a temporary interactive workspace. We can quickly launch a Jupyter Lab container with a workspace.

<table border="1" id="bkmrk-select-the-prepared-" style="border-collapse: collapse; width: 100%; border-width: 0px; background-color: rgb(236, 240, 241); border-style: none;"><tbody><tr><td style="border-width: 0px; width: 59.7531%;">[![gcc500-workspace.png](https://doc.oasishpc.hk/uploads/images/gallery/2024-04/gcc500-workspace.png)](https://doc.oasishpc.hk/uploads/images/gallery/2024-04/gcc500-workspace.png)

</td><td style="border-width: 0px; width: 40.2469%;">1. Select the prepared Jupyter container from the registry.
2. Request for one C500 GPU.
3. Enter the command to launch Jupyter Lab with a preset token, and set the working directory to our mounted disk.
4. Notify the system to expose the web service to the internet.
5. Mount the disk created in the last step.

</td></tr></tbody></table>

Now, we are ready to start the Jupyter Lab workspace and get access to it.

<table border="1" id="bkmrk-one-cluster-named-gc" style="border-collapse: collapse; width: 100%; border-width: 0px; background-color: rgb(236, 240, 241); border-style: none;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><thead><tr><td style="border-width: 0px;">[![gcc500-workspace2.png](https://doc.oasishpc.hk/uploads/images/gallery/2024-04/gcc500-workspace2.png)](https://doc.oasishpc.hk/uploads/images/gallery/2024-04/gcc500-workspace2.png)

Click the Play button to start the workspace. After a while, click the Jupyter Lab button to get access to it.

</td><td style="border-width: 0px;">[![gcc500-workspace3.png](https://doc.oasishpc.hk/uploads/images/gallery/2024-04/gcc500-workspace3.png)](https://doc.oasishpc.hk/uploads/images/gallery/2024-04/gcc500-workspace3.png)

Create a new notebook and verify that we can use Pytorch with the C500 GPU.

</td></tr></thead></table>


After you are done using the workspace, please remember to stop it by clicking the Stop button and release the GPU for other users.

#### Compile CUDA program

The container ships with MACA (MetaX Advanced Compute Architecture). A compiler is included to compile CUDA-compatible codes to run on MetaX GPUs. The following is an example of compiling and running a sample CUDA program inside our Jupyter workspace.

First, open the terminal in Jupyter Lab, enter bash, and input the following:

```bash
# go to our persistent storage
cd /disk

# install the required packages
apt update && apt install -y wget unzip build-essential

# download and unzip the CUDA samples
wget https://codeload.github.com/NVIDIA/cuda-samples/zip/refs/tags/v11.4 -O cuda-samples-11.4.zip
unzip cuda-samples-11.4.zip

# go into the matrixMul sample
cd /disk/cuda-samples-11.4/Samples/matrixMul

# compile and run it
export PATH=/opt/maca/tools/wcuda/bin:/opt/maca/ompi/bin:$PATH  # load path for: nvcc, mpicc
export CPATH=/opt/maca/tools/wcuda/include/:/opt/maca/ompi/include:$CPATH  # headers for cuda, mpi
nvcc -I ../../Common/ -lcuda matrixMul.cu -o matrixMul
./matrixMul
```

<table border="1" id="bkmrk-select-the-prepared--1" style="border-collapse: collapse; width: 100%; border-width: 0px; background-color: rgb(236, 240, 241); border-style: none;"><thead><tr><td style="border-width: 0px; width: 100%;">[![gcc500-cuda.png](https://doc.oasishpc.hk/uploads/images/gallery/2024-04/gcc500-cuda.png)](https://doc.oasishpc.hk/uploads/images/gallery/2024-04/gcc500-cuda.png)

Compile and run the matrixMul CUDA sample.

</td></tr></thead></table>