Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

After opening a new notebook, you will be prompted to select a kernel

  • If you have never created a kernel to use, you will only see a list of default Jupyter kernels available on the cluster

  • You may check the box to start with the preferred kernel every time you open a notebook

Default Kernels on ARCC HPC Resources include:

  • Python Kernels

  • R Kernels

HPC-wide kernels are titled by packages installed and available when launched

Users can also create user-defined kernels from conda environments (Covered in a subsequent module. See Creating Jupyter Kernels from Conda Environments)

...

Running a Jupyter Notebook with Python 3 Kernel

If we select the default Python 3 (ipykernel), we are presented with the file explorer showing our home directory as it’s root location.

  • With root location set to our $HOME, we are unable to see our /project and /gscratch directories.

  • To expose these folders to the jupyter environment, create a symbolic link (aka shortcut) within our /home.

A screenshot of a computer

Description automatically generatedImage Added
  • Instructions for creating a symbolic link may be found here or expanded in the cell to the right

Expand
titleSteps to create a symbolic link
  1. Open an ssh connection to the HPC cluster with:
    ssh your_username@clustername.arcc.uwyo.edu
    or open a shell through OnDemand:

    Image Added
  2. In the shell/terminal interface, create a symbolic link to your project (replacing project_name with the name of your project) with:

[~] ln -s /project/project_name/ project

  1. In the shell/terminal interface, create a symbolic link to your gscratch (replacing username with the your username on the HPC) with:

[~] ln -s /gscratch/username/ gscratch

...

What Packages are Available in our Kernel?

In our notebook, we can provide a python command, to list available packages:

Image Added

Click on the package list image to the right to see output

Image Added

...