Configuring Jupyter Notebook Server
- Edit the config.conf file.
- In a text editor, open the file jupyter_installation_location/dist/scripts/unix/config.conf file for Linux or the jupyter_installation_location/dist/scripts/windows/config.conf for Microsoft Windows 10.
- Specify values, as required, for the parameters listed in the following table:
If you are securing Jupyter Notebook Server using SSL, enter the path to the directory that contains certificates for trusted SSL hosts.Tip: We recommend that the directory containing the certificates be located outside the jupyter_installation_location directory. As a result, the certificate files won't need to be moved after subsequent installations and the config.conf file can continue to point to the certificates.
If using SSL, enter the path, in Privacy Enhanced Mail (PEM) format, to the certificate file for the Jupyter Server.
If using SSL, enter the path, in Privacy Enhanced Mail (PEM) format, to the certificate private key file for the Jupyter Server.
If the location of your Docker images changes, update the path to the new location.
You should not need to edit the hostname value. It is resolved automatically if the hostname is set correctly. To check this, type hostname on a command line. The fully qualified name of the computer should be returned. If it is incorrect, you can edit the HOST_NAME value and add the fully qualified name.
For example, type the following:
The port number of the Jupyter Notebook hub.
COGNOS_HOST is an optional parameter that points the Jupyter server to the Cognos Analytics host. By default, the Jupyter server uses the Dispatcher URI for External Applications environment parameter from Cognos Configuration. However, if required, it can be overwritten here.
127.0.0.1cannot be used.
Specifies the maximum number of users that can be connected at one time. When set to 0 (the default value), no limit is enforced.
Specifies the memory limit for each user's container.
The value can either be an integer (bytes) or a string with a
When there is no value (the default), the user container is allocated the memory that it requires.
Specifies the idle time of each container, after which the cull service will remove them (default is 3600 seconds).Important: After you make any changes to the config.conf file, you must follow these steps:
- Run the dist/scripts/unix/build.sh for Linux or the dist/scripts/windows/build.bat for Windows script to apply your changes.
- Run the dist/scripts/unix/startup.sh for Linux or the dist/scripts/windows/startup.bat for Windows script to see your changes.
- Update Cognos Configuration as follows:
- Start Cognos Configuration.
- Click Environment and set the value for the
Dispatcher URI for External Applications property. Tip: If you set the COGNOS_HOST parameter in the config.conf file, you do not need to also set the Dispatcher URI for External Applications property in Cognos Configuration.