Setting up Jupyter on COLA Servers

  1. Setup a Password for Jupyter

jupyter notebook --generate-config
jupyter notebook password

  1. Issue the following command so that your environment will appear in Jupyter

python -m ipykernel install --user --name aoes --display-name "Python (aoes)"

  1. Log in to colaX.gmu.edu, where X refers to a COLA Server

ssh -Y -l <YOURUSERNAME>@colaX.gmu.edu

  1. Go to the Pangeo-at-AOES directory:

cd Pangeo-at-AOES

  1. Start up the Jupyter server with the following command:

jupyter lab --no-browser --ip=`hostname` --port=8878

  1. In a separate terminal, log in to colaX again with the following command:

ssh -N -L 8878:colaX.gmu.edu:8878 <YOURUSERNAME>@colaX.gmu.edu

Note

You must use the same COLA server in this step as you did in step 3. If you do not, then you get an invalid credentials error when you attempt to login to Jupyter.

  1. Open your browser and go to http://localhost:8878. It will ask you to enter the password you created in step 1.

  2. Your Jupyter server should appear in your local browser.

  3. In the upper right corner, you will see your current environemnt is Python (aoes). If it only says Python, click on Python and a menu will appear. Select Python (aoes)

Troubleshooting

Note

Traceback (most recent call last): File “/homes/sknapp4/.conda/envs/aoes/lib/python3.6/site-packages/traitlets/traitlets.py”, line 528, in get value = obj._trait_values[self.name] KeyError: ‘allow_remote_access’

Try launching Jupyter with the following command

jupyter lab –no-browser –ip=’0.0.0.0’ –port=8878

Note

If you get an Invalid Credentials error, check the messages on the screen where you launched `jupyter lab ` Sometimes port 8878 is in use and it will find a different port. The error messages will tell you which port you should use.

These errors messages look like:

jupyter lab –no-browser –ip=`hostname` –port=8878 [I 14:12:20.887 LabApp] The port 8878 is already in use, trying another port.