Jupyter Notebook

Run the script interactively using a Jupyter Notebook. A Jupyter environment is available as part of the IBM Watson Studio Service, which can be installed on IBM Cloud Pak for Data.

Before you begin

Ensure the following is installed:

  • Watson Knowledge Catalog on IBM Cloud Pak for Data version 4.0 or higher
    Note: For Watson Knowledge Catalog on IBM Cloud Pak for Data version 4.0.3, please install the Knowledge Accelerators fixpack available at https://www.ibm.com/support/pages/node/6526592.
  • IBM Watson Studio on IBM Cloud Pak for Data version 4.0 or higher
  • Specific Python libraries installed
  • Ensure the PIP requirements are met for the Python 3 kernel being used. (See Jupyter documentation for help on installing PIP dependencies).

Procedure

Preparing the import procedure.

  1. Check if the IBM Watson Studio service is installed, by opening the Services catalog and checking whether the service is enabled.
  2. Locate the Knowledge Accelerators archive (.zip file) that is provided with the Knowledge Accelerators release.
  3. Log in to IBM Cloud Pak for Data as a user with Administrative Privilege.
    Login for Cloud Pak for Data
  4. From the menu, select Projects.
    Selecting Projects
  5. Click New Project
    Clicking New project button.
  6. Choose Analytics Project and click Next
    Selecting Analytics Project.
  7. Choose Create a project from file.
    Create a project from file window
  8. Browse to the Knowledge Accelerators archive file located in (2), enter a Project name and a Project Description and click Create.
    Create a project window

Executing the import procedure.

  1. Once the project has been created, select the Assets tab and expand the Notebooks section.
    Notebooks tab
  2. Click the ka-import Notebook to open it in your Jupyter environment.
  3. Click the Edit icon to edit the Notebook.
    Edit button
  4. Review the Prerequisites section and take any actions that are needed.
  5. Options to import the Knowledge Accelerator content.
    • To import the Knowledge Accelerator core vocabulary and all of the optional Industry Alignment Vocabulary content:
      • Go to Cell and Run All
    • To import the Knowledge Accelerator core vocabulary and one or more of the optional Industry Alignment Vocabulary content:
      • Go to Cell and Run Cells for the base and core-bpi content, and each required IAV cell separately.
  6. When prompted, enter your Watson Knowledge Catalog hostname, Username and Password. Press enter after entering each value.
    Logging in to Watson Knowledge Catalog.
    Note: You can find your Watson Knowledge Catalog hostname in your browser as part of your Project URL after https://. For example, in a Project URL https://cpd-wkc.apps.mywkc.cp.fyre.ibm.com the hostname is: cpd-wkc.apps.mywkc.cp.fyre.ibm.com
  7. When the import is completed, review the output of each cell.
  8. Download and save a backup copy of the log files as these files might be needed for importing further Industry Alignment Vocabularies.
    1. To find the logs, go to your Project view, click the Find and add data icon the upper-right side and click the Files tab.