wjhjgi/jaws-client repository overview

⁠JAWS client docker image

The JAWS command line interface (jaws) has a few areas that hinder the user experience:

• must source a file to activate an environment before running jaws
• activation command is dependent on which site you are on
• activating the environment can mess up your existing environment

This docker image is intended to be used on cori and perlmutter to overcome the above shortcommings and make JAWS easier to use.

⁠Usage

⁠Running directly

shifter --entrypoint --image wjhjgi/jaws-client:latest jaws -h

You must be on cori or perlmutter to use this image, as it requires the NERSC filesystems to be mounted.

⁠Auth token

Your JAWS token must be in a file named ~/jaws.conf.

⁠Adding a bash function to your .bashrc

Either a bash alias or bash function could be used to make it easier to execute jaws via shifter, but by using (and exporting) a bash function, the simplifed jaws command will also be availble within shell scripts.

Append to the end of your ~/.bashrc on NERSC:

jaws() {
  shifter --module=none --entrypoint --image=wjhjgi/jaws-client:latest jaws "$@"
}
export -f jaws