Connect to the Tutorial Server

Live tutorial

Your credential card contains your username, password, and server.

Angle-bracket values need editing

Amber text inside angle brackets, such as <USERNAME> or <SERVER>, marks a value you must replace. The rest of the command remains unchanged.

macOS and Linux

Open Terminal and connect with:

ssh <USERNAME>@<SERVER>

Replace <USERNAME> and <SERVER> with the values printed on your card.

Windows

Open PowerShell or Windows Terminal to check whether SSH is already installed:

ssh -V

If that prints an OpenSSH version, you are ready to connect.

If ssh is not recognized, open PowerShell as Administrator and install the OpenSSH Client:

Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0

After installation, verify it:

ssh -V

If that prints an OpenSSH version, SSH is ready to use.

Connect with:

ssh <USERNAME>@<SERVER>

Replace <USERNAME> and <SERVER> with the values printed on your card.

The first connection may ask whether you want to trust the server. Enter:

yes

Then enter your password.

Your password will not appear on screen while you type. This is normal.

1. Check your account

After logging in, run:

whoami
hostname
pwd

whoami should show the username printed on your card, and your home directory should be:

/home/<USERNAME>

Now confirm that your tutorial workspace is writable:

printf 'access works\n' > ~/tutorial/access-test.txt
cat ~/tutorial/access-test.txt
rm ~/tutorial/access-test.txt

You should see:

access works

Your home directory and tutorial workspace belong to your account. Always use the username and server assigned to you.

2. Find the tutorial repository and examples

All tutorial instructions, scripts, and examples are already available in your workspace. Do not clone another copy of the repository on the live server.

cd ~/tutorial
ls

You should see the main repository files and directories:

README.md  docs  examples  mkdocs.yml  scripts

3. Activate the tutorial tools

The tutorial software is installed in a shared, read-only environment.

Activate it with:

source /opt/tutorial/activate.sh

Confirm that the environment is active:

python --version
echo "$CONDA_PREFIX"

CONDA_PREFIX should point somewhere under:

/opt/tutorial/

4. Check TaskVine and Floability

Run:

vine_worker --version
python -c "import ndcctools.taskvine; print('TaskVine: OK')"
python -c "import cloudpickle, matplotlib, numpy, onnxruntime, pandas; from PIL import Image; print('Scientific examples: OK')"
floability --help >/dev/null && echo "Floability: OK"
sciunit --version >/dev/null && echo "Sciunit: OK"

You should finish with:

TaskVine: OK
Scientific examples: OK
Floability: OK
Sciunit: OK

The RAG-Lite exercise uses a separate prepared environment for its application dependencies. You will activate that environment when the exercise begins.

You are ready

Your setup now has two separate areas:

/opt/tutorial/       shared tutorial software
~/tutorial/          your exercises and files

Later, Floability will create and cache backpack-specific software environments inside your own user space.

These environments are separate from the shared tutorial tools. Repeated runs of the same backpack may reuse your cached environment, but environments are not shared between participants.

Continue to TaskVine Quickstart.