The purpose of this article is to outline the step-by-step guide to installing IBM CA Jupyter Notebook Server for CA 11.1.2+. The steps will also include VNC installation and configuration to allow the software to be installed via the GUI and peforming a silent installation.

Environment
Ubuntu 16.04
Single Server
CA Jupyter

Installation via VNC*


1. SSH onto Ubuntu as root (or user with elevated privileges)

2. Run the command sudo apt-get update


3. Once complete then run this command sudo apt-get upgrade -y


4. Once completed install the Kubuntu-Desktop via the following executions:

sudo add-apt-repository ppa:kubuntu-ppa/backports

sudo apt-get install kubuntu-desktop


5. Once complete install VNC

6. Run vncserver and provide a password:


7. Run this command:

mv ~/.vnc/xstartup ~/.vnc/xstartup.bak

vim ~/.vnc/xstartup



8. Add the following lines to the xstartup file

#!/bin/bash
xrdb $HOME/.Xresources
startxfce4 &

9. Save and exit ctrl -wq!
10. Set the execute permission:

sudo chmod +x ~/.vnc/xstartup

11. Reboot the machine
12. SSH to Ubunutu shell and run the command vncserver


NB: The connect to the VNC instance will be <server>:1

13. Using VNC for Chrome connect:





14. At this point the desktop will appear


15. Navigate to the analytics installer and execute:





















16. Once complete install Docker
sudo apt-get install docker*

17. Once complete test using the command docker ps:

18. Now to install Jupyter Notebook Server navigate to the default /opt/ibm/cognos/jupyter/dist/scripts/unix:


19. Run the ./install.sh



20. Run docker ps and the jupyterhub and jupyter_viewer images should be visible:



21. To determine the ip address to connect Jupyterhub to CA 11.1.2 run docker <image> inspect  | grep IP

NB: By default the internal ip address is 172.17.0.3

The default port is 8000 and there are simple ways to validate this using:

docker inspect <containerID> | grep HOST



docker inspect <containerID> | grep Port



22. Now log into CA and navigate to Manage - Configuration - System - Environment



NB: Host name is the name of the server running Jupyter images. Both http://<machine>:8000 or http://<DNS>:8000 can be used i.e. in this case http://eggcup1.domain.com:8000 or http://eggcup1:8000. Alternatively, use Also, can use the internal ip address i.e. 172.17.0.3:8000 only when BOTH CA and Jupyter are on the SAME server.
Hence, Juypter Notebook server is therefore using the dispatcher URI for external applications from the Cognos Analytics configuration to reach the CA server

23. Now to confirm its configured correctly, the "Notebook" option should now appear. If so, as a test create a new notebook



Additional Information:
*VNC - Remote Software used in this article may not comply with company policies so alternative methods are applicable