Linux SSH Setup

Linux SSH Setup

Setup instructions for connecting to the EMPHATIC GPVMs from a native Linux (Debian/Ubuntu/AlmaLinux) machine. For WSL, follow these same steps inside your WSL terminal. For Mac, see Computing Access.

First-time setup

On your local machine:

# Install Kerberos client
sudo apt install krb5-user          # Debian/Ubuntu
# sudo dnf install krb5-workstation  # AlmaLinux/RHEL

# Install the Fermilab Kerberos config
sudo wget -O /etc/krb5.conf https://authentication.fnal.gov/krb5conf/

# Get a Kerberos ticket
kinit username@FNAL.GOV

SSH to the GPVM:

ssh -K -Y username@emphaticgpvm01.fnal.gov

On the GPVM — create your working directories and clone the repository:

mkdir -p /exp/emph/app/users/<username>/build
cd /exp/emph/app/users/<username>
git clone https://github.com/EMPHATICSoft/emphaticsoft

Enter the Apptainer container and build:

source emphaticsoft/setup/setup_emphatic.sh
sl7-emph

# Now inside Apptainer:
cd /exp/emph/app/users/<username>/build
source ../emphaticsoft/ups/setup_for_development -p
buildtool --generator=ninja

Returning to an existing setup

# Local machine:
kinit username@FNAL.GOV
ssh -K -Y username@emphaticgpvm01.fnal.gov

# On the GPVM:
source /exp/emph/app/users/<username>/emphaticsoft/setup/setup_emphatic.sh
sl7-emph

# Inside Apptainer — go to build dir and run ninja as usual:
cd /exp/emph/app/users/<username>/build
ninja