These instructions apply to the development vortex repo using the updated toolchain. The updated toolchain is considered to be any commit of master
pulled from July 2, 2023 onwards. The toolchain update in question can be viewed in this commit. Therefore, if you are unsure whether you are using the new toolchain or not, then you should check the ci
folder for the existence of the toolchain_prebuilt.sh
script. Furthermore, you should notice that the toolchain_install.sh
script has the legacy llvm()
split into llvm-vortex()
and llvm-pocl()
.
The toolchain binaries provided with Vortex are built on Ubuntu-based systems. To install Vortex on your own system, follow these instructions.
Volvo is a 64-core server provided by HPArch. You need valid credentials to access it. If you don't already have access, you can get in contact with your mentor to ask about setting your account up.
Setup on Volvo:
- Connect to Georgia Tech's VPN or ssh into another machine on campus
ssh volvo.cc.gatech.edu
- Clone Vortex to your home directory:
git clone --recursive https://github.com/vortexgpgpu/vortex.git
source /nethome/software/set_vortex_env.sh
to set up the necessary environment variables.make -s
in thevortex
root directory- Run a test program:
./ci/blackbox.sh --cores=2 --app=dogfood
Nio is a 20-core desktop server provided by HPArch. If you have access to Volvo, you also have access to Nio.
Setup on Nio:
- Connect to Georgia Tech's VPN or ssh into another machine on campus
ssh nio.cc.gatech.edu
- Clone Vortex to your home directory:
git clone --recursive https://github.com/vortexgpgpu/vortex.git
source /opt/set_vortex_env_dev.sh
to set up the necessary environment variables.make -s
in thevortex
root directory- Run a test program:
./ci/blackbox.sh --cores=2 --app=dogfood
Docker allows for isolated pre-built environments to be created, shared and used. The emulation mode required for ARM-based processors will incur a decrease in performance. Currently, the dockerfile is not included with the official vortex repository and is not actively maintained or supported.
- Clone repo recursively onto your local machine:
git clone --recursive https://github.com/vortexgpgpu/vortex.git
- Download the dockerfile from here and place it in the root of the repo.
- Build the Dockerfile into an image:
docker build --platform=linux/amd64 -t vortex -f dockerfile .
- Run a container based on the image:
docker run --rm -v ./:/root/vortex/ -it --name vtx-dev --privileged=true --platform=linux/amd64 vortex
- Install the toolchain
./ci/toolchain_install.sh --all
(once per container) make -s
invortex
root directory- Run a test program:
./ci/blackbox.sh --cores=2 --app=dogfood
You may exit from a container and resume a container you have exited or start a second terminal session docker exec -it <container-name> bash