Install and Configure Jupyter Notebooks

Using Team Studio, you can integrate Jupyter Notebooks for Team Studio to run Python code.

Note: Changes between Python 2.x and Python 3.x can cause existing code to break. To use Python with Team Studio, install both Python 2.6 and Python 3.4 (or later) on the cluster. Alternatively, if you have only one version of Python, and you experience failures, install the other version of Python and try again.
Installation Preparation

For a non-Docker installation, before running the installer for Jupyter Notebooks for Team Studio, install the package bunzip2.

Jupyter Notebooks for Team Studio is installed using a shell script installer. You must install Jupyter Notebooks for Team Studio on a separate server from your Team Studio installation. The shell script installer requires the following information.
  • The location of the installation.

    The default path is /opt/notebooks.

  • The Spawner type.

    You can run Jupyter Notebooks for Team Studio in a Docker container on that server, or you can run uncontainerized as a local managed process. The default is Docker.

  • Whether the installation SSL-enabled. If so, provide the following.
    • SSL certificate path.
    • SSL key path.

    The default is No.

After the installer completes, review the output for warnings or errors, or for further instructions on configuration changes to the chorus.properties file, and for information on starting or stopping the service.

Port Configuration
By default, communication between the Team Studio server and the server where Jupyter Notebooks is installed occurs over port 8000. You can change this option in the file $CHORUS_HOME/shared/chorus.properties.
For Team Studio version 6.2 and later, configure Jupyter Notebooks to use the PySpark package. Make sure you have five random ports available to maintain full communication between the server where Jupyter Notebooks for Team Studio is installed and all cluster nodes.
Note: For Spark to work, you must make sure that full communication is open between the Team Studio server and all cluster nodes.
Python Packages
For Jupyter Notebooks for Team Studio to work correctly, certain Python packages must be installed by the user. For a list of packages that Jupyter Notebooks for Team Studio requires for integration, see Python Packages Required for Jupyter Notebooks in Team Studio.

For more information about Jupyter Notebooks, see jupyter.org.

Related concepts
Related tasks