Jetstream Atmosphere EZ tools

Instances launched using the Atmosphere web user interface are by default installed with the EZ command line tools, designed to streamline some common tasks and functions.

There are a number of different ez commands, including:

  • ez → a help menu listing available tools
  • ezj → run jupyter-notebook with python detection (Recommend m1.medium or larger)
  • ezjh → run jupyterhub (currently requires CyVerse CAS credentials) (Recommend m1.medium or larger)
  • ezd → install docker (Only supported on Ubuntu 14+ and CentOS 7)
  • ezs → install singularity (Only supported on Ubuntu 14+ and CentOS 6+)
  • unban → list blocked IP addresses or remove blocks for IP addresses trying to access the instance 
  • myip → set environment variables $JETSTREAM_PUBLIC_IP and $CYVERSE_PUBLIC_IP to the public IP Address and display the same to the screen 

eza help menu listing available tools

Options to pass to 'ez':

update -> perform a full update of the ez facility

<TOP>

ezj: Launching Jupyter Notebook within an instance (detailed description)

Options to pass to 'ezj':


-q : do not attempt to install, just launch jupyter!

-R : install the R kernel (-r also works)

-2 : force python 2 kernel (not compatible with -3 option)

-3 : force python 3 kernel (not compatible with -2 option)

-u : force update of anaconda (default is no update)

-p : takes a directory as an option; install in a different location other than default (/home)

NOTE: if you set this, you must pass it again for future calls

*** You do not need to run ezj more than once. You can start/restart a notebook with the commands: "ezj -q"  or "jupyter-notebook" .


<TOP>

ezjhrun jupyterhub with CyVerse CAS integration

Options to pass to 'ezjh':

none

NOTE: Only run if you have CyVerse access and are familiar with CAS

The installation may take up to 10 minutes to complete

*** You do not need to run ezjh more than once. You can start/restart a hub with the command:  jupyterhub .

<TOP>

ezdinstall docker

Options to pass to 'ezd':

-p : enable portainer on port 9000


<TOP>

ezsinstall singularity

Options to pass to 'ezs':

none


<TOP>

unbanlist blocked IP addresses or remove blocks for IP addresses trying to access the instance 

usage: unban [-l] [-i ip-address] [-a]

-l : print all currently banned ips
-i : unban a single ip address
-a : unban all ip addresses

Note: use only one of -l, -i, or -a at a time


<TOP>

myipset environment variables $JETSTREAM_PUBLIC_IP and $CYVERSE_PUBLIC_IP to the public IP Address and display the same to the screen