Install Classification and Language Services

The Classification and Language Service is used to provide classification facilities for applications. The application analyses the submitted text and returns categories from a particular model (classification scheme) for which the document is appropriate. 

Important: For Semaphore 5.10.2, a new NLP processor was introduced that works by default when no language packs are installed. However, the results from this configuration are likely to produce different results from an installation using language packs. Therefore, to ensure consistent results when upgrading, continue using the same language packs as earlier installations. If you are starting a new project, installing Semaphore without language packs is sufficient in most scenarios.

Note: If you are not using language packs, you do not need to install Java or configure the SEMAPHORE_JVM_LIB parameter.

Install Language Packs

To install your language packs:

1. On your target server, run the installer for your Base language pack:

   Copy

   Semaphore-LanguagePack-Windows-Base-<version>.exe
   

   The installer program opens.

   Important: You must install the Base language pack before other language packs for which you are licenced.

2. Follow the prompts. Note that you will need to specify the location of a supported JVM (jvm.dll) to be used by Semaphore. See Installing third-party software for supported Java versions.

3. For each language you are licenced to use:

   a. Run the installer program for the language pack. For example:

   Copy

   Semaphore-LanguagePack-Windows-Base-<version>.exe
   

   b. Follow the prompts. Note that you will need to specify the location of a supported JVM (jvm.dll) to be used by Semaphore.

Install the licence key

Before you can use the Classification Server or Semantic Enhancement service, you must install the license key. First, copy the file to the following directory:

C:\\Program Files\\SmartLogic

Next, rename the licence key file rename the licence key file from:

<environment_name>-Env-Licence-<expiry_date>.txt

To:

licence

Install the Classification Server

The Classification Server processes requests sent by client applications (such as Semaphore for SharePoint solutions) and classifies the content of the request against a set of rules stored on the server. The resulting classification information is then returned to the requesting application.

To install the Classification Server:

1. On the target server, run the following installer program executable as an administrator:

   Copy

   Semaphore-<Version>-CLS-setup.exe
   

2. The License Agreement window appears. Make sure that you read and understand the license agreement. To continue with the installation, select the I accept the agreement; then, click Next.

3. In the Select Destination Location window, specify the location to install the Classification Server. Then click Next.

4. In the Select Components Window, select the components you want to install; then, click Next:

   • Service: Installs the components required to install the default, and other subsequent, Windows Services Classification Server instances.
   • Utilities: Includes several tools used to debug and test classification output including "parser" to determine the exact text output of an input file and "classify" providing command line bulk classification testing capability.

5. The Service Parameters window opens. Click Next to accept the default values for the Service Name and Service Name for display fields.

6. In the Select License Directory window, specify the following location to store the Semaphore licence key:

   Copy

   C:\\Program Files\\SmartLogic
   

   Important: When moving the licence key file to the specified location, you should rename the licence key file from <environment_name>-Env-Licence-<expiry_date>.txt to licence.

7. In the License window, choose one of the following; then, click Next.

   • Copy your licence key into the field.
   • Click Browse and navigate to your licence file.

8. The Select Start Menu Folder window appears. Provide the location in the Start Menu to add Semaphore shortcuts. Click Next.

9. In the Ready to Install window, confirm the installation details. If everything is correct, click Install to begin the installation.

10. After installation is complete, the Setup window will open. Choose one of the following:

    • To install and start the local service for the Semaphore Classification Server using the default configuration settings, click Finish.
    • To change the configuration before starting the service, uncheck the Start Classification Service box and click Finish.

Configure the Classification Server

Note: At installation time, if you are using language packs, the Classification Server attempts to locate the Java Virtual Machine (jvm.dll). If it is unable to do this, you may need to set the systemwide environment variable SEMAPHORE_JVM_LIB to the location of this file. For example:

```text
SEMAPHORE_JVM_LIB=C:\Program Files\Microsoft\jdk-21.0.2.13-hotspot\bin\server\jvm.dll
```

The Classification Server configuration file is named config.xml by default and found in the /<installation_directory>/CS/conf/ directory. Other configuration files may be used by specifying them via start-up parameters for Classification Server; however, we recommend using the typical name for easier maintenance.

For details of the settings in this file refer to Configure the Classification and Language Service (CLS).

Note: For any settings changes to take effect, you must restart the server for the Classification Service.