Table of contents

Downloading the runtime configuration

Every custom image that you create must be based on one of the standard images included in IBM Watson Studio. You can get the name of the image that is used by a runtime from the configuration .json file for the runtime.

The following configuration files exist for the standard Jupyter notebook images included in Watson Studio:

JSON configuration file Image description
jupyter-py38-server.json Jupyter Notebook with Python 3.8
jupyter-py37-server.json Jupyter Notebook with Python 3.7
jupyter-py38gpu-server.json Jupyter Notebook with Python 3.8 with GPU support
jupyter-py37gpu-server.json Jupyter Notebook with Python 3.7 with GPU support
jupyter-lab-py38-server.json JupyterLab with Python 3.8
jupyter-lab-py37-server.json JupyterLab with Python 3.7
jupyter-lab-py38gpu-server.json JupyterLab with Python 3.8 with GPU support
jupyter-lab-py37gpu-server.json JupyterLab with Python 3.7 with GPU support
jupyter-r36-server.json Jupyter Notebook with R 3.6

For RStudio, use the following configuration file:

JSON configuration file Image description
rstudio-server.json RStudio with R 3.6

For SPSS Modeler, use the following configuration file:

JSON configuration file Image description
spss-modeler-server.json SPSS Modeler

Important:

  • All runtime configuration file names must end with -server.json, including the configuration files you customize, for example custom-runtime-def-1-server.json.
  • The JSON file contains an entry for the registry where the image is stored.

Download the JSON file by using the Cloud Pak for Data API:

  • List the file in a browser for you to copy and paste:

    Log in to Cloud Pak for Data as administrator and paste the following URL into the browser. Replace <CloudPakforData_URL> with the URL of your Cloud Pak for Data system and replace <runtime-config-server.json> with the name of the JSON file you need for your customization.

      <CloudPakforData_URL>/zen-data/v1/volumes/files/%2F_global_%2Fconfig%2F.runtime-definitions%2Fibm%2F<runtime-config-server.json>
    
  • Download the file by using cURL in a browser:

    1. Login to Cloud Pak for Data as administrator. Get the required platform access token by entering the following command that returns the bearer token in the accessToken field. Replace <CloudPakforData_URL> with the URL of your Cloud Pak for Data system.
        curl <CloudPakforData_URL>/v1/preauth/validateAuth -u <username>:<password>
      

      You can save the value directly by using something like:

        myToken=`curl -k <CloudPakforData_URL>/v1/preauth/validateAuth -u USER:PASSWORD | sed -n -e 's/^.*accessToken":"//p' | cut -d'"' -f1`
      

      Note the usage of -k because of certificate issues. -k disables certificate validation. You might not have to do this.

    2. Download the file. Replace <runtime-config-server.json> with the name of the JSON file you need for your customization. You can cut and paste the token using this:
        curl -X GET '<CloudPakforData_URL>/zen-data/v1/volumes/files/%2F_global_%2Fconfig%2F.runtime-definitions%2Fibm%2F<runtime-config-server.json>' --header 'Authorization: Bearer <platform-access-token>' 
      

      Or if you saved the myToken variable you can use something similar to:

        curl -X GET "<CloudPakforData_URL>/zen-data/v1/volumes/files/%2F_global_%2Fconfig%2F.runtime-definitions%2Fibm%2F<runtime-config-server.json>" --header "Authorization: Bearer ${myToken}" -k
      

      Note the use of the -k option again.