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.

   For access to lineage feature with IBM Manta Data Lineage, business-term relationship search, and the relationship explorer in deployments with the Neo4j graph database, 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="{\"enableKnowledgeGraph\":True}"

   For access to the lineage feature with MANTA Automated Data Lineage or to the relationship explorer in deployments where MANTA Automated Data Lineage is installed, 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="{\"enableKnowledgeGraph\":True,\"useFDB\":True}"

   Important: This command enables the use of FoundationDB as the graph database, which does not support IBM Manta Data Lineage.

   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 the 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}"

   Gen AI based enrichment capabilities

   Enable all gen AI based capabilities in metadata enrichment for expanding asset and column names, generating asset and column descriptions, and term assignment. By default, models are started on CPU when you enable these capabilities. This is equivalent to the enableModelsOn:cpu setting, which means that the gen AI based capabilities are provided by smaller, quantized models on CPUs . No GPUs are required in this case.

   You can also choose to have the required models run on GPU (enableModelsOn:gpu), which increases performance and accuracy, or on a remote instance of watsonx.ai™ (enableModelsOn:remote).

   Important: With enableModelsOn:gpu, these capabilities require one GPU, and the NVIDIA GPU Operator and the Red Hat® OpenShift® AI Operator must be installed. Also, the inference foundation models (watsonx_ai_ifm) will automatically be installed.

   With enableModelsOn:remote, no models are started on the local cluster. You must set up a connection to a watsonx.ai instance on either a different IBM Software Hub cluster or to a cloud instance of watsonx.ai.

   For more information, see the table Enabling optional features.

   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,\"enableModelsOn\":cpu}"

   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:

   export INSTALL_OPTIONS="{<list of installation options>}"

   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}

For more information about the optional features, see Preparing to install IBM Knowledge Catalog.