Upgrading

When a new version of ContainDS Dashboards or related components is released, the upgrade process may depend on your JupyterHub configuration.

Please see any specific notes in the Changelog - for example, changes may be required to your jupyterhub_config.py file.

In general, you just need to remember to upgrade both your hub and user environments. If you only have one environment in your installation, you should run both the hub and user upgrade commands in your environment.

Especially in containerised environments (Docker or Kubernetes), existing singleuser servers may need to be deleted. They can be recreated by re-accessing the dashboard through the Dashboards page.

LocalProcessSpawner or SystemdSpawner

In the hub environment:

pip install --upgrade cdsdashboards==0.6.3
# or
conda install -c conda-forge cdsdashboards=0.6.3

Also upgrade in the user environment, with some extra dependencies:

pip install --upgrade cdsdashboards[user]==0.6.3
# or
conda install -c conda-forge cdsdashboards-singleuser=0.6.3

DockerSpawner

In the hub environment:

pip install --upgrade cdsdashboards==0.6.3
# or
conda install -c conda-forge cdsdashboards=0.6.3

Your singleuser image will also need to be upgraded.

For example, if using a pre-built image, in your jupyterhub_config.py:

c.DockerSpawner.image = 'ideonate/containds-allr-datascience:0.6.3'

If you are using your own image, please rebuild it, specifying the updated version numbers where appropriate.

The Littlest JupyterHub

Upgrade the cdsdashboards package in the hub environment:

sudo -E /opt/tljh/hub/bin/python3 -m pip install cdsdashboards==0.6.3

Also upgrade cdsdashboards in the user environment, including extra dependencies:

sudo -E /opt/tljh/user/bin/python3 -m pip install cdsdashboards[user]==0.6.3

Kubernetes (Z2JH)

In your config.yaml file, update to the latest tags of the images used - both hub and singleuser.

Here is an example snippet from a config.yaml:

hub:
  allowNamedServers: true
  image:
    name: ideonate/cdsdashboards-jupyter-k8s-hub
    tag: 1.2.0-0.6.3

...

singleuser:
  image:
    name: ideonate/containds-allr-datascience
    tag: 0.6.3

If you are using your own images, please rebuild them, specifying the updated version numbers where appropriate.

Troubleshooting

If you have any problems at all please contact us or open an issue on the GitHub repo. Be sure to describe your current configuration and any errors you are seeing.