IBM Support

Known Issues with Automatic Term Assignment

Troubleshooting


Problem

Running automatic term assignment as part of discovery or column analysis does not provide expected results or analysis fails with a message indicating an issue with term assignment.

Symptom

Discovery of column analysis failed with an error description or log file entry that indicates that something went wrong during the term assignment phase.

Cause

Known limitation or error in term assignment configuration.

Environment

Information Server 11.7.0.0

Diagnosing The Problem

  1. Check the error message on the data set in the Information Analyzer Thin Client and/or examine the Application Server log files.

Resolving The Problem

Upgrade to Information Server 11.7.0.1 to fix any of the below items except 2.

For 11.7.0.0 there might be a workaround depending on the observed behavior and error message:

  1. When running discovery with term assignment on more than 30,000 assets term assignment may fail due to an internal size limitation. In this case we recommend to break down the discovery task into smaller subtasks with less than 30,000 assets each.
  2. There is no way to enable the detection of term assignment candidates but prevent the creation of term assignments. Removing the assignment threshold sets it to the default of 0.8. To minimize the number of assignments that are created set the assignmentTreshold to 1.0.
  3. The linguistic matching service has a fixed candidateThreshold of 0.4 that is independent of the candidate threshold set on the ODF configuration. There is currently no way to change this.
  4. An entry categoryScope = "" in the ODF configuration causes analysis to fail. To disable the category scope feature remove this entry from the ODF configuration.
    Example:

    Wrong (causes failure):
    {
     "capabilities": {
       "com.ibm.iis.odf.capabilities.TermAssignment": {
         "softLimit": 0,
         "hardLimit": 100,
         "candidateThreshold": 0.4,
         "assignmentThreshold": 0.8,
         
    "categoryScope": ""
       }
     },

    "services"...
    }

    Correct:
    {
     "capabilities": {
       "com.ibm.iis.odf.capabilities.TermAssignment": {
         "softLimit": 0,
         "hardLimit": 100,
         "candidateThreshold": 0.4,
         "assignmentThreshold": 0.8
       }
     },

    "services"...
    }

[{"Product":{"code":"SSZJPZ","label":"IBM InfoSphere Information Server"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"InfoSphere Unified Governance","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"11.7.0.0","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
21 June 2018

UID

swg22011706