Semaphore 5.2.0

Semaphore 5.2.0 is a major update to the software and an update to the Semaphore 5.0.5 release. At a high level, the new features of this release include the following:

• The use of environment definition to separate technical and model related publisher configuration and to enable the “hub-and-spoke” model for publishing to multiple environments.
• An improved workflow for the acceptance of changes from the Knowledge Review Tool into the knowledge models.
• The addition of a translation side panel to aid the creation of multiple language models.
• Improvements to the Document Analysis component to better view evidence in the context of knowledge models.
• The introduction of the “Rulenet Manager” to enable management of “Classification and Language Server” rulenets from with the Studio application.

Note: When defining CLS and SES instances in the Studio administration panel, it is now possible to define “Public” and “Internal” URLs. The “Public” URL is the URL of the service when accessed from outside the Semaphore environment, the “Internal” URL is the URL of the service as seen from the server running Studio. In many cases these two will have the same value (in which case only the Public value needs to be defined) but if the Studio server does not know the Public names of the other servers (or itself in the case of a one box install) then the Internal URL may need to be defined.

Important:

• When defining a SES instance, the URL should now be the full URL, including the trailing /ses if present. This is a change from 5.0.x because in some installations the /ses has been removed or replaced with some other value.

• The SES output is now V1.2 by default. See API versions for details. Generally this difference is not important, but it does allow the returning of more information about concepts where it doesn't fit into the original API definition - such as multivalued metadata items, and class information on related concepts.

Installation Prerequisites

Prior to installing or upgrading to this version of Semaphore please be sure to review the Third-party software requirements (Linux) or Third-party software requirements (Windows) information as well as the general Planning your Plan your Semaphore Installation (Linux) or Plan your Semaphore Installation (Windows) information for installation server requirements.

Product Notes

This version of Semaphore consists of the following components:

Platform Independent Components

Windows Components

Linux Applications

Integrations

(*) Unchanged from previous release.

(**) Unchanged from previous release but version number updated.

Studio (5.2.0)

New Functionality

• 2490 - User level permissioning of Environments
• 2491 - Remove service location reading from environment rather than publisher config
• 2665 - Model level permissions for environments
• 4938 - Ability to filter publisher configurations by environment
• 2623 - Ability to clone models
• 3432 - Ability to select metadata to display in visualizer
• 3844 - Improvement in acceptance workflow from KRT into KMM
• 5034 - KMM access permissions
• 5207 - Lexical side panel now displayed by default
• 5326 - Improvements to drag and drop from lexical side panel
• 5213/5227 - Performance improvements
• 5822 - Allow comment deletion
• 5864 - Different icons for different Studio components
• 5949 - Pre commit task checking.
• 6414 - File uploads now validated
• 6473 - Health checks to CS and SES only when service page is active
• 7306 - All models removed from installation
• 2873 - Better evidence highlighting in Document Analyser
• 5606 - Display of evidence in Document Analyser in the context of the model
• 5705 - More sorting options for DA output.
• 6319 - Creation of Rulenet Manager
• 6555 - Display of simple classification output in DA.

Issues Resolved

• 3133/3142/3533/3539 Backup improvements
• 4222 - Language filtering fixed.
• 4459 - Plugins now ignored during backup process
• 4509 - Performance improvements
• 5502 - Change notifications were being send before the transaction was committed.
• 6069 - SAYT fixed for non-alphanumeric character
• 6076 - Start up with corrupted workspace better handled
• 6252 - SPARQL endpoint parameters are now case insensitive for better integration
• 6538 - Publishing fixed for models with very many languages
• 6546 - Term IDs can now be URIs in visualizer
• 6749 - Addition of Translation side panel

Classification Server (5.2.0)

New Functionality

• 5364 - Remove non-functional classify.exe from distribution.
• 6253 - Improvement to security for administration functionality.

Semantic Enhancement Server (5.2.0)

New Functionality

• 6976 - Pagination within SES

Known Issues (Semaphore 5.2.0)

Installation of Studio (Semaphore 5.2.0)

• When installing to Windows you may get a warning about a failure to determine the version of Java in selected JAVA_HOME. Please ignore this message.
• If you do not have Java 11 installed, when you install Semaphore Studio you will be warned that Semaphore Studio requires “Java version 11 or later.” In fact it requires Java 11. Refer to Install third-party software in the Install Semaphore on Windows for details on how to install it.

Classification Server (5.2.0)

• Because of changes to how text is parsed prior to analysis, some inline style changes in PDFs (e.g. emphasised or italic text) may be treated as separate sentences or paragraphs. This could affect evidence finding where that evidence is now spread over multiple zones.
• Because of tokenization issues, Hebrew, Indonesian, Malay, Pashto and Vietnamese are temporarily being removed from the supported language set.
• We have updated our file type detection algorithm. This may change the determined file type for some documents which may affect how the document is parsed. If this is an issue, then remove the “external_parser” entry in the “classify_document” workflow in the file conf/config.xml to revert to the old style.

Stand-alone Linux Publisher (5.2.0)

Note: The following applies to the standalone publisher only, not the plugin.

• During the Linux installation you may see a spurious message about setting ACL permissions for the tomcat user. Please ignore these.

Knowledge Model Management (5.2.0)

When downloading configuration or backup files, it is possible that the default Windows zip extractor will report the downloaded file as invalid. This is, however, likely to be due to long file paths in the zip file not being handled correctly by that extractor. An alternative (such as 7-Zip) should be able to correct extract these files.

Semaphore for SharePoint 2013/2016 Integration (4.0 r54942)

The following are known issues with this version of Semaphore for SharePoint 2013/2016:

• Use of custom hierarchical relationship types for synchronization of models may result in incorrect model information in the term store (“has narrower/has broader” hierarchical relationship synchronization works correctly)
• DE2394 - Classification Server version 4.2.0 won't work when adding in CS URL. An error “Version's parameters must be greater than or equal to zero. Parameter name: revision.” is being shown.