Updating the Semaphore licence

A Semaphore “environment” licence is issued based upon the terms of your contract with Progress and is required for Semaphore server components (Semaphore Studio, Semantic Enhancement Server and Classification Server). When (or if) the licence key have been given expires these products will no longer function and a new licence key will be required. Part of standard contract renewal includes the generation of this key by Progress at which time it will be sent to you.

To update the licence key copy the new key provided for the relevant environment into the appropriate location on the environment server (or servers). By default the location for the licence is “/opt/semaphore/licence” but this can be customized by setting the “SEMAPHORE_LICENCE_DIR” environment variable so check the value of this variable prior to installation.

Using the New Licence Key

Once a new licence key is installed you need to restart the Semantic Enhancement Server (“semaphore-ses”) and Classification Server (“semaphore-cs”) services so it picks up the new key. For Semantic Enhancement you can simply do “systemctl restart semaphore-ses”) but for Classification Server this should be done as follows:

1. Use “systemctl stop semaphore-cs”
2. Wait for a few minutes
3. Use “systemctl start semaphore-cs”

This is rather than simply “systemctl restart semaphore-cs” as the above steps gives all Classification Server threads time to stop before the restart.

After this, if you receive any licencing errors from Semaphore please create a Support ticket.

Updating licence on Semaphore Studio

Semaphore Studio does not pick up the licence installed on the server using the above mechanism, rather you need to update it within Semaphore Studio itself. To update the licence used in Semaphore Studio please see Initial Studio Configuration.