Configure the Classification Server

The Classification Server (CS) 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.

The Classification Server configuration file is typically named config.xml and found in the <install_dir>\Classification Server\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 the initial installation, the configuration file configures the Classification Server to:

• Listen on TCP/IP port 5058 for classification requests. You can see this in the port property in the bean object with id=CS.

• Listen on TCP/IP port 5059 for administration requests. You can see this in the port property in the bean object with id=CS_admin.

• Load all rulebases found in the <install_dir>\rulebases directory. You can see this in the rulebasdir property in the bean object with id=acquisition.

If you wish to alter any of these settings:

1. If already started, stop the Semaphore <version> - Classification Server - r<revision> Windows service.

2. Open the configuration file (e.g. <install_dir\conf\config.xml) in Notepad (or any other text editor).

3. Edit the settings of the file as appropriate.

4. Save the changes to the configuration file.

5. Start the Semaphore <version> - Classification Server - r<revision> Windows service.

To manually install different or new rulebases (instead using the Classification Server publish mechanism):

1. If already started, stop the Semaphore <version> - Classification Server - r<revision> Windows service.

2. Copy the rulebase files (typically one or more files ending in .pak) into the <rulebase_dir> directory (set in the configuration file in property rulebasedir, which is typically <install_dir>\rulebases).

3. Start the Semaphore <version> - Classification Server - r<revision> Windows service.

Detailed configuration information can be found in the Configure the Classification and Language Service (CLS).

Manually add a Classification Server instance

The installed config.xml file is used to configure the default Windows service created by through installation. If required, additional instances can be created by using the installed ClassificationService.exe from a command line.

To create a Classification Server instance:

1. From a Command Prompt window (Powershell is not supported), navigate to the directory:

   Copy

   <install_dir>\Classification Server\bin
   

2. Execute the following command:

   Copy

   ClassificationService -i <domainame\username> <password> <working_directory> <config file> [name]
   

   For example:

   Copy

   "C:\Program Files\Smartlogic\Classification Server\bin\ClassificationService\" -i .\LocalSystem "" "" ..\conf\test_config.xml "Semaphore Test Classification"
   

   Note: For a default setup, you can specify the value.\LocalSystem "" in lieu of the <domain>\<username> and <password> values.

3. Copy the config.xml you generated (for example, test_config.xml) and save it as a new configuration file.

4. Validate that your service has been created by examining the information in the Services applet in the Control Panel.

Important: If more than one Classification Server instance will run at the same time, the port parameter must be unique; otherwise, the Classification Server will fail to start if the port specified in its configuration file is in use.