Powered by Zoomin Software. For more details please contactZoomin

Semaphore Fact Extraction Framework (FACTS) Administration

Table of Contents

Upgrading the your FACTS plugin

Save PDF
Save selected topicSave selected topic and subtopicsSave all topics
Share
Share to emailCopy topic URL
Print
  • Last Updated: May 13, 2026
  • 3 minute read
    • Semaphore
    • Documentation

If you have an older version of the FACTS plugin (older than 5.4, so 5.0 and older) and you are using Semaphore 5.4 onwards, you should be aware that FACTS’ templates’ underlying language, Velocity, has changed. For example, dashes are no longer allowed in variable names and will cause issues on publishing FACTS models - these were removed from the FACTS plugin from 5.4 onwards.

We recommend that you should always keep your plugins, including FACTS, and Semaphore application software versions in synch.

Upgrading your FACTS plugin is simple and requires these two steps:

  1. Upgrading the FACTS plugin
  2. Upgrading your FACTS models Publisher configuration and template files

Upgrading the plugin

Before upgrading the Fact Extraction Framework you will need to login to Knowledge Model Management with a user account assigned the “SemaphoreSuperAdministrators” role. Once logged in select the “Manage Plugins” option from the “tools” (wrench) menu near the top right of the screen.

The “Manage Plugins” screen will be shown.

Click the “Update” button next to the “com.smartlogic.workbench.facts” plugin then drag/upload the distribution file “Semaphore-FactsExtraction-<version>.jar” into the “Upload Plugin/Bundle” screen displayed:

Press the “Submit” button and after a short time, the plugin will be upgraded appropriately.

Upgrading the Publisher Configuration and Template Files

After upgrading the Fact Extraction Framework plugin, upgrade the configuration files following these steps:

  1. On the server Publisher is installed on, navigate to the location where the Publisher configs and templates are stored. In a default Publisher installation, these are found in …\SemaphoreWorkbenchHome\workspace\com.smartlogic.workbench.publisher\config
  2. For each FACTS model, you will need to delete the entire directory for that model. The directory has the same name as the model.
  3. Prior to deleting that directory, copy any files that you have customized. Typically, this may only include the variants.csv files and the location and port of the classification server as configured in the “VelocityConfigForFACTS-Include.xml” file. If you have modified any of the Publisher configuration files or the templates, you will need to merge those changes into the new versions of those files.
  4. Once the model config directory is deleted, in Knowledge Model Management, open the model, click “Edit Master” to get to the master graph, and click “Publish Model” (but do not “Publish” the model until step 5 is completed). This will re-create the model config directory with the upgraded configurations.
  5. Merge any custom changes back into the upgraded files, including the location and port of classification server in the “VelocityConfigForFACTS-Include.xml” file.
TitleResults for “How to create a CRG?”Also Available inAlert