Log in to the master console of the Access Manager, using the dcadmin user at https://hostname/auth/admin/master/console, where “hostname” is the hostname/IP of the VM where the platform is installed.

Go to Clients and click Create.

Set jupyterhub as the Client ID.

Set https://hostname/jupyter as the Root URL.

Click Save.

Click the jupyterhub client.

On the Settings tab, change the Access Type to confidential.

On the Installation tab, from the Format Option dropdown list, select Keycloak OIDC JSON.

Click Download or copy & paste the contents somewhere. You will use the secret later in the config.yaml file.

Connect to the VM where the platform is installed, and then connect to the Postgres container:

kubectl exec -it postgres-67fc4f87f8-vwvsf sh

Connect to the PostgreSQL server:

psql -U postgres

Execute the following SQL statements:

CREATE ROLE jupyter_user LOGIN PASSWORD 'jupyter_password';
ALTER USER jupyter_user WITH CREATEDB;
CREATE DATABASE jupyter_db;
GRANT ALL PRIVILEGES ON DATABASE jupyter_db TO jupyter_user;

Close the PostgreSQL connection, and then exit the container:

\q

exit

Use snap to install Helm:

sudo snap install helm –classic

Add the JupyterHub repository to Helm:

helm repo add jupyterhub https://jupyterhub.github.io/helm-chart/

helm repo update

Replace <RANDOM_HEX> with a randomly generated HEX string. You can run the following command in the terminal to generate the string:

openssl rand -hex 32

Replace <PLATFORM_ADDRESS> with the hostname/IP of the machine running the platform.

Replace <TENANT> with the tenant name from Access Manager, where you initially created the jupyterhub client.

Replace <CLIENT_SECRET> with the value of the secret from the jupyterhub client, initially created in Access Manager. The secret is included in the JSON file that you have downloaded.

Replace <DB_PASSWORD> with the password for the jupyter_user, created earlier in the PostgreSQL server.
In these instructions, we used jupyter_password.

Use Helm to install JupyterHub using the config.yaml file that you edited earlier:

helm upgrade --cleanup-on-fail --install jupyter jupyterhub/jupyterhub --namespace jupyter --create-namespace --version=0.10.3 --values config.yaml

Apply the ingress.yaml file to Kubernetes:

kubectl apply -f ingress.yaml

Access JupyterHub at https://hostname/jupyter, where “hostname” is the hostname/IP of the VM where the platform is installed.

Wait for the JupyterHub to start.

Uninstall jupyter:

helm uninstall jupyter -n jupyter

Remove the jupyter namespace in Kubernetes:

kubectl delete namespace jupyter