Jupyter Notebooks on S3DF

These are steps for running a jupyter notebook on S3DF via juptyerlab. These instructions assume a first time setup of connecting to s3df.

Use this method only for viewing and editing notebooks or running very non computationally intensive notebooks. The kind people running S3DF get unhappy when you run a multi core simulation on interactive compute. Instead see Running Notebooks on Batch Compute below.

1. Get a S3DF account
2. Wait for approval

3. 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

4. Connect to Iana :

    ssh -L 5555:localhost:5555 iana

5. Activate conda env: If conda is not installed see instructions here

   conda activate <CONDA ENV>

6. ** do only first time ** install jupyter lab if not installed: 

   conda install jupyterlab

7. Run jupyter and click on the link 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.