Requirements

Technical specifications

The following are the minimum requirements for running all the Semaphore components on a single server:

• 2 x 2.4 GHz processors

• 8 GB RAM (plus 2 GB per CPU core)

• 40 Gb Hard Disk space free

• Microsoft Windows Server 2012 (64 Bit)

Please note:

• The specifications in this section are intended as guidelines only. The hardware requirements for a particular installation are dependent on a number of aspects of the solution being implemented, such as the size of the model and the size of the implementation. Requirements for a particular installation can be provided by Progress based on an analysis of the solution. Contact Progress for details.

• You must have the necessary permissions on the target machine to install the software (root permissions, for example).

Semaphore software pre-requisites

The required Semaphore files are available for download from the Progress Semaphore customer portal at Software Downloads. If you do not have access to this site or if one or more of these files are not available for you to download, create a New Support Ticket on the Progress Support Link Page.

Semaphore software installation files

The following files install Semaphore components. Unless otherwise directed, you should always install the latest versions of these components from the Progress Semaphore customer portal.

Additional required files

The following are additional files required for installing Semaphore:

Model Import File(s)

If you are planning on an initial model import then you will need information in a format supported by the import process of Knowledge Model Management (namely, RDF/XML or TTL)

Third-party software requirements

The following third-party software is required for installation of the Semaphore software.

Java JDK

Semaphore requires that a Java JDK has been installed. The following are Java JDK requirements by version.

Semaphore 5.6 and Semaphore 5.8

A Java JDK that is version 11 or higher is required. For these versions of Semaphore, the following are specifically supported:

• Amazon Corretto 11 x64 (64 bit) - Refer to https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/generic-linux-install.html for details.

• OpenJDK 11 x64 (64 bit) - Refer to https://openjdk.java.net/install/ for details (note that in Oracle Enterprise Linux (OEL)/CentOS, this is generally available as package java-11-openjdk within the standard "yum" repositories).

Semaphore 5.10

A Java JDK that is version 17 or higher is required. For this version of Semaphore, the following are specifically supported:

• Amazon Corretto 17 x64 (64 bit) - See https://docs.aws.amazon.com/corretto/latest/corretto-17-ug/generic-linux-install.html for details.

• OpenJDK 17 x64 (64 bit) - See https://openjdk.java.net/install/ for details.

Optional Software

The following optional software might also be required for your installation:

MarkLogic Server

By default, Knowledge Model Management uses Jena TDB to store model data. However, if you can also use Marklogic to store model data by doing the following:

• Install MarkLogic 8.0.4 (or later).

• Create a database created to store the model data.

• Configure the database settings collection lexicon and triple index set to true (Refer to Getting Started with Semantic Graphs in MarkLogic in Understand Semantic Graphs for details).

Notes:

• You must use digest authentication. Basic authentication is not supported.

• When defining a MarkLogic user for specific access to the triple store, the following roles have been shown to be sufficient for Knowledge Model Management: appuser, qconsole-user, rest-reader, rest-reader-internal, rest-writer, and rest-writer-internal. Additionally, the xdbc:eval-in permission is required, which is added either by assigning a role having this permission or creating a custom role with this permission then assigning this role to the user.

• If loading large models, it is necessary to increase the MarkLogic app-server default time limit. In a default Marklogic installation, you can find this setting by:

  1. Load the URL \<mlserver\>:8001 (logging in as necessary).

  2. Navigate on the left side tree to Configure>Groups>Default>App Servers [[HTTP]{.underline}].

  3. Then on the right side find the setting called default time limit and set to 3600 seconds (one hour).

  4. Click ok to save.

Next steps

Plan your Semaphore installation