Appendix - Common Questions

The following are some common questions people have regarding the Knowledge Model Management.

How can I publish my model to other Semaphore components (Classification & Language Service and/or Semantic Enhancement Service) from the command line

The easiest way to Publish a model from the command line is to use the kmm-client to fire off the publish event - see here.

It is possible to use the standalone publisher to publish using the SPARQL endpoint - please consult with a Semaphore engineer if you want to do this.

How can I determine my model “ID”?

The model ID can be found in the model URL. The model ID is deemed a ‘technical’ piece of information which is only relevant to a small audience like system admins or auditing. This information is apparent in the URL therefore this piece is removed to reduce the clutter in the UI.

This shows where in the URL you would find the model ID:

How can I improve start-up performance?

If Knowledge Model Management is taking a long time to start-up, check the logs to see what might be happening. If the logs indicate Knowledge Model Management is spending a lot of time doing the following type of operations:

...
[TopBraid Info] 2016-02-24T17:30:18+0000 - org.topbraid.core: Cached 4990000 triples.
[TopBraid Info] 2016-02-24T17:30:25+0000 - org.topbraid.core: Cached 5000000 triples.
[TopBraid Info] 2016-02-24T17:30:25+0000 - org.topbraid.core: Cached 5010000 triples.
[TopBraid Info] 2016-02-24T17:30:33+0000 - org.topbraid.core: Cached 5020000 triples.
...

Then you may want to consider changing the configuration value for the number of “workers” used to retrieve model information on start-up. This is the “smartlogic.topbraid.marklogic.findWorkersCount” setting which, by default, is set to 2. Note that it is recommended that “smartlogic.topbraid.marklogic.findWorkersCount” is never set to a value greater than half the number of CPUs available on the server (for example, if you have a 8 core machine then this should not be set to anything more than 4).

The “smartlogic.topbraid.marklogic.findWorkersCount” parameter is set in the “CATALINA_OPTS” value or the “Java Options”. For example, in “CATALINA_OPTS”:

CATALINA_OPTS=%CATALINA_OPTS% -Dsmartlogic.topbraid.marklogic.findWorkersCount=4

Or, for “Java Options” in Windows this can be set by adding the following to the configuration:

-Dsmartlogic.topbraid.marklogic.findWorkersCount=4

Once you have changed this value you will need to restart the Knowledge Model Management service.

What browser is required in order to use Knowledge Model Management?

Knowledge Model Management requires an HTML 5 compatible web browser such as the latest versions available of Edge, Firefox, or Google Chrome.

How can I perform a backup/import from the command line?

See export_import.

What metadata range types are supported?

When defining new types, their range can be: Boolean, date, integer, or string. Other types, including decimals, are not available for selection and not supported by Knowledge Model Management. If you import model with metadata types that use other range types they are shown in model and in structure page but you may not be able to edit them.

Can the “English” language be removed from a model?

No. The English language definition is mandatory at this time.

Is there a way to change the color of the bubbles in visualizer of Knowledge Review Tool?

Yes. Changing the color of concept classes in the model structure also reflects in the visualizer. This can be done as follows:

1. Open any model
2. Open ‘Master’ or ‘Task’
3. Open ‘Model structure’ from the menu
4. Select a concept class from the left hand side if one is defined
5. Class color will be available to select a color from a pallete, the color will be presented on the both KMM and KRT bubbles.

Can I configure KMM to not show the side panel widgets that require external access?

From Semaphore 5.8 yes. Edit the file

<KMM data>/workspace/com.smartlogic.workbench.ttl/config/semaphore-widgets-config.ttl

(typically in /opt/semaphore/kmm/data/workspace/com.smartlogic.workbench.ttl/config on linux or C:\ProgramData\Smartlogic\Studio\kmm\workspace\com.smartlogic.workbench.ttl\config on Windows)

Add lines as:

widget:LexicalResources semwidgets:isDisabled "true"^^xsd:boolean .
widget:Translation semwidgets:isDisabled "true"^^xsd:boolean .

to disable the two standard widgets that require external access.

Other widgets can be added here to be disabled.