Skip to content

Latest commit

 

History

History
83 lines (59 loc) · 2.84 KB

REMOTE_ACCESS.md

File metadata and controls

83 lines (59 loc) · 2.84 KB

Vortex Tutorial - Remote Option

We suggest that you use a remote server hosted by the CRNCH Rogues Gallery. This option will be available until the end of the conference

Register for access

Please use the form to submit your Github ID to reserve a slot to use for the duration of the tutorial.

Login

Login to rg-hub.crnch.gatech.edu/jupyter using your Github account.

| Note: Participants do not need a password to log in. They have to agree / authorize to join the "gt-crnch-rg" GitHub team to get access, and their GitHub username and password is used for authentication.

Then, click "Start My Server".

Once there, open the terminal application and follow below steps

$ whoami
crunchjupyter

$ pwd
/tmp

Vortex Simulation

Get the code

Everything you create (clones, builds, edits) must live in a directory on the server, not inside the container: the container's own writable space is only 64 MB.

$	git clone --branch v3.0 --recursive --depth 1 https://github.com/vortexgpgpu/vortex.git
$	git clone --depth 1 https://github.com/vortexgpgpu/vortex_tutorials.git      
$	mkdir work

Start Apptainer

The command

  • uses the pre-built apptainer image and
  • mounts your Vortex clone, the tutorial repository, a work directory and the shared toolchain onto the apptainer
$   apptainer shell --cleanenv --writable-tmpfs \
    --bind ./vortex:/home/vortex \
    --bind ./vortex_tutorials:/home/vortex_tutorials \
    --bind ./work:/home/work \
    --bind /netscratch/tutorials/micro-tutorial-2026/vortex-tools-v3.0:/home/tools \
    /netscratch/tutorials/micro-tutorial-2026/vortex_micro26.sif

Build Vortex inside Apptainer

Apptainer> export TUTORIAL=/home/vortex_tutorials
Apptainer> cd /home/vortex
Apptainer> mkdir build32 && cd build32
Apptainer> ../configure --xlen=32 --tooldir=$TOOLDIR
Apptainer> make -s -j4

Apptainer> echo $TOOLDIR
/home/tools

Apptainer> ls $TOOLDIR
chipstar  gem5  libc32  libc64  libcrt32  libcrt64  llvm-vortex  mesa-vortex  pocl  riscv32-gnu-toolchain  riscv64-gnu-toolchain  sta  sv2v  verilator  yosys

$TOOLDIR is already set to the toolchain mount (/home/tools). The toolchain is installed and the system packages are in the image, so the ./ci/toolchain_install.sh and ./ci/install_dependencies.sh steps of the exercise setup are not needed. Use -j; without it the build takes much longer.

Quick demo running vecadd OpenCL kernel on 2 cores

SIMX
Apptainer> ./ci/blackbox.sh --cores=2 --app=vecadd --driver=simx

RTLSIM
Apptainer> ./ci/blackbox.sh --cores=2 --app=vecadd --driver=rtlsim

XRTSIM
Apptainer> ./ci/blackbox.sh --cores=2 --app=vecadd --driver=xrt

The exercises

Follow the exercises in the tutorial repository