These are steps for running a jupyter notebook on S3DF via juptyerlab. These instructions assume a first time setup of connecting to s3df.
- Get a S3DF account
- Wait for approval
Ssh into s3df login node with port forwarding (5555 can be changed to any preferred port): note: make sure this ssh is from your local machine as we need to have port 5555 open on the connection all the way from your local machine to jupyter lab on s3df.
ssh -L 5555:localhost:5555 <SLAC UNIX USERNAME>@s3dflogin.slac.stanford.edu
if connecting from Windows' command line (cmd), specify the following:
ssh -m hmac-sha2-512 -L 5555:localhost:5555 <SLAC UNIX USERNAME>@s3dflogin.slac.stanford.edu
Connect to Iana :
ssh -L 5555:localhost:5555 iana
- Allocate compute via slurm and connect to it. *this step may be skipped if your notebook is not computationally intensive. *make sure your account is part of the FACET repo or use ad:beamphysics if you are a part of that repo (more info). You can change the parameter after
-n
to choose how many cores you want the notebook to have.srun --partition milano --account FACET -n 100 --time=01:00:00 --pty /bin/bash
Activate conda env: If conda is not installed see instructions here
conda activate <CONDA ENV>
** do only first time ** install jupyter lab if not installed:
conda install jupyterlab
- Run jupyter and click on the link localhost url to open in your browser:
jupyter lab --no-browser --port 5555
You can also use mamba instead of conda for a faster time creating environments. Mamba is used by first installing miniconda and then using the mamba command instead of the conda command.