Uploading custom abbreviation files for use in metadata enrichment

To extend the business vocabulary that is used in metadata enrichment, a data steward can create custom abbreviation files. To make such abbreviation files available for use in all projects, a cluster administrator must upload such files before they can be used.

Standard Premium You can extend the business vocabulary if IBM Knowledge Catalog Standard or IBM Knowledge Catalog Premium are installed and gen AI based enrichment capabilities are enabled.

Prerequisites

Required roles

A cluster administrator must complete this task.

Required input

A data steward must create one or more abbreviation files as described in Custom abbreviation files and provide them for upload.

Procedure

To upload abbreviation files:

  1. Log in to Red Hat OpenShift Container Platform as a user with sufficient permissions to complete the task.

    ${OC_LOGIN}

    Remember: OC_LOGIN is an alias for the oc login command.

  2. Get the names of the semantic-automation pods:

    oc get pods -n ${PROJECT_CPD_INST_OPERANDS} | grep semantic-automation

  3. Log in to one of the semantic-automation pods and create the directory for the abbreviation files. Replace semantic-automation-pod with one of the pod names that were returned in the previous step.

    oc rsh <semantic-automation-pod> mkdir /exchange/abbreviations
    Important: Do not change the directory name.

  4. Upload the abbreviation files one by one, where the first file to upload must be named abbreviations0.csv. All other files must be consecutively numbered and uploaded without skipping a number. Replace semantic-automation-pod with the name of the pod that you used in the previous step.

    oc cp abbrevation0.csv  <semantic-automation-pod>:exchange/abbreviations

  5. Restart all semantic automation pods by running the following command for each pod that was returned in step 2:

    oc delete <semantic-automation-pod>

To upload additional files or updated files later, follow the same steps.

Parent topic: Administering IBM Knowledge Catalog