Enabling optional features after installation or upgrade for IBM Knowledge Catalog

During the initial install or during the upgrade of any of the IBM Knowledge Catalog editions, you can enable a number of optional features. However, if you decide not to enable these optional features at that time, you can still do so after the initial install or after the upgrade.

To enable additional features, follow these instructions.

1. Specify your IBM Knowledge Catalog edition.
   Set the IKC_TYPE environment variable to the edition of IBM Knowledge Catalog for which you want to enable the features:

   IBM Knowledge Catalog

   export IKC_TYPE=wkc

   IBM Knowledge Catalog Premium

   export IKC_TYPE=ikc_premium

   IBM Knowledge Catalog Standard

   export IKC_TYPE=ikc_standard

2. Enable optional features:

   Knowledge graph

   Enable knowledge graph to gain access to the lineage feature, business-term relationship search, and the relationship explorer.

   This option can be enabled for all editions by running this patch command:

   cpd-cli manage update-cr \
   --component=${IKC_TYPE} \
   --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --patch="{\"enableKnowledgeGraph\":True}"

   After you enable the knowledge graph, you must synchronize governance artifacts. Use the following API for updating the categories, business terms, data classes, reference data sets, etc. in the knowledge graph. Replace $HOST by the host name and port number used in the IBM Cloud Pak for Data UI. You must have the manage_glossary permission to complete this task. This permission is available in Administrator platform role.

   1. Follow the steps in Generating an API authorization token to generate an API key.
   2. Start the synchronization:

      curl -k -X POST "https://$HOST/v3/glossary_terms/admin/resync?artifact_type=<artifact_type>&sync_destinations=KNOWLEDGE_GRAPH" --header "Content-Type: application/json" --header "Accept: application/json" --header "Authorization: ZenApiKey ${TOKEN}" -d '{}'

      • The allowed values for artifact_type parameter are category, glossary_term, classification, data_class, reference_data, policy, rule.
      • Start with category, then continue with glossary_term, classification, data_class, reference_data, policy, and rule.
        Note: category_ids are glossary category IDs for governance artifacts. Choosing specific category_ids will set that group of governance artifacts to be used. If no category_ids are set, then all categories will be synchronized.

   Data quality

   Enable data quality features for working with data quality definitions and data quality rules in projects. For information about data quality definitions and rules, see Managing data quality.

   Important: Enabling this option will install DataStage with IBM Knowledge Catalog. To ensure a smooth installation of this feature, see Installing DataStage.

   If you did not purchase a DataStage license, use of the DataStage Enterprise service installed with IBM Knowledge Catalog is limited to creating, managing, and running data quality rules.

   Examples of accepted usage:

   • Preprocessing of data to enable running data quality rules
   • Transformation of data to remediate data quality issues

   This option can be enabled for IBM Knowledge Catalog and IBM Knowledge Catalog Premium by running this patch command:

   cpd-cli manage update-cr \
   --component=${IKC_TYPE} \
   --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --patch="{\"enableDataQuality\":True}"

   Semantic capabilities

   Enable semantic capabilities in metadata enrichment for expanding asset and column names, generating asset and column descriptions, and semantic term assignment.

   Important: These capabilities require one GPU, and the NVIDIA GPU Operator and the Red Hat® OpenShift® AI Operator must be installed. Enabling this option will install inference foundation models (watsonx_ai_ifm).

   This option can be enabled for IBM Knowledge Catalog Premium and IBM Knowledge Catalog Standard by running this patch command:

   cpd-cli manage update-cr \
   --component=${IKC_TYPE} \
   --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --patch="{\"enableSemanticAutomation\":True}"

   Enable all optional features for an IBM Knowledge Catalog edition

   You can enable all optional features for an IBM Knowledge Catalog edition.

   Set the INSTALL_OPTIONS environment variable to the available options for your IBM Knowledge Catalog edition:

   IBM Knowledge Catalog

   export INSTALL_OPTIONS="{\"enableKnowledgeGraph\":True,\"enableDataQuality\":True}"

   IBM Knowledge Catalog Premium

   export INSTALL_OPTIONS="{\"enableKnowledgeGraph\":True,\"enableDataQuality\":True},\"enableSemanticAutomation\":True}"

   IBM Knowledge Catalog Standard

   export INSTALL_OPTIONS="{\"enableKnowledgeGraph\":True,\"enableSemanticAutomation\":True}"

   To enable all available options at the same time, run this patch command:

   cpd-cli manage update-cr \
   --component=${IKC_TYPE} \
   --cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --patch=${INSTALL_OPTIONS}