Verifying successful migration (IBM® Knowledge Catalog)

Verify that the data and processes were successfully exported from InfoSphere Information Server and imported to Cloud Pak for Data.

Verification steps on the InfoSphere Information Server system

After the export is completed and shows a status: succeeded or status: failed message, you can review the summary of the export. An example of the status message:
{"status":"succeeded","startTime":1685530618701,"completionTime":1685530697649,"message":"The export of all entities successful.","percentageCompleted":100}
Copy the archive that contains the summary of export into the ${TOOLKIT_PATH} directory and extract the archive:
cp ${EXPORT_DATA_DIR}/${EXPORT_INSTANCE_NAME}/2*/legacy-migration/export_summary_20*.zip ${TOOLKIT_PATH}
The files contained in the archive are separated into different subfolders:
legacy-migration-summary/summary/
  • export-status.json
  • export-summary.json
  • export-validation-status.json
legacy-migration-summary/details/
  • ca-migration-plugin_export-details.csv
  • extended-data-sources_export-details.csv
  • glossary_export-details.csv
  • glossary_cad-export-details.csv
  • extension-mapping-documents_export-details.csv
  • imam_connections_export-details.csv
  • imam_importareas_export-details.csv
  • imam_data_assets_export-details.csv
  • imam_ldm_export-details.csv
  • imam_pdm_export-details.csv
  • data-quality_rule-definitions_export-details.csv
  • data-quality_rule-definitions_dq-details.csv
  • data-quality_projects_export-details.csv
  • data-quality_projects_dq-details.csv
  • An additional open-igc_<bundle name>_export-details.csv file for your each of your openIGC bundles

Verification steps on the Cloud Pak for Data system

After the import is completed and shows a status: succeeded or status: failed message, you can review the summary of the import. An example of the status message:
{"status":"succeeded","startTime":1785530618701,"completionTime":1785530697649,"message":"The import of all entities successful.","percentageCompleted":100}
To review the import summary, complete these steps:
  1. Download the archive file that contains the import summary:
    CPD_AUX_POD=`oc get pods -n ${NAMESPACE} -o custom-columns=POD:.metadata.name --no-headers | grep cpd-aux`
oc exec -it $CPD_AUX_POD -n ${NAMESPACE} -- bash -c "mkdir -p /tmp/${EXPORT_INSTANCE_NAME};cp /data/cpd/data/exports/wkc/${EXPORT_INSTANCE_NAME}/20*/legacy-migration/import_summary_20*.zip /tmp/${EXPORT_INSTANCE_NAME}/."
  2. Copy the archive to the current directory:
    oc cp ${NAMESPACE}/$CPD_AUX_POD:tmp/${EXPORT_INSTANCE_NAME}/. .
The archive contains the following files in addition to the export-related files:
  • import-failed-summary.json
  • import-status.json
  • import-validation-status.json
  • import-summary.json
Note: The import-summary.json file contains the summary of the imported assets. Currently, the glossary-related assets details are not present in the import-summary.json file.

If another import is run, the import-summary.json file will only contain details of the imported assets related to the latest import run.