Upgrade the Semaphore software

To upgrade the installed software, do the following:

• If required, connect to the installation computer (e.g. using SSH) as an administrator.

• If unknown, determine what Semaphore components are installed. To get a complete list of installed components, you can execute the following:

  Copy

  rpm -qa | grep Semaphore
  

• Download the latest version of your Semaphore components from the Customer Portal (Progress Semaphore) in the Software Downloads area and copy onto target server

• Upgrade each installed Semaphore component using yum upgrade command. The syntax is as follows:

  Copy

  yum upgrade <installation_file>
  

A few notes about the yum upgrade process:

• The software components can be upgraded in any order.

• If upgrading your version of the software is not possible, you might need to manually remove and reinstall each specific component. This can be done using the following commands:

  1. yum remove to uninstall the component.

  2. yum install to reinstall the component.

  Refer to the Install the Semaphore Software Components section for detailed instructions.

  Important:

  • Uninstalling the Semaphore Ontology Server does not remove any local or embedded models that may have been created.

  • Uninstalling any applications does not remove the server licence key. When the software is reinstalled, the licence key will still be available, and you will not need to provide it again.

• If upgrading a Classification Server installation that was originally installed as version 4.0.42 or earlier (i.e., version 4.0.42 was upgraded without ever removing the product), the initd or systemd scripts might be removed during the upgrade process. To resolve this issue:

  1. Back up any modified configuration files.

  2. Remove the old version of the Classification Server.

  3. Install version 4.0.43 (or later).

  Once version 4.0.43 or later is installed, subsequent upgrades will retain the init.d and systemd scripts.

• When upgrading language packs to Semaphore 5.4.0, before executing a yum upgrade, you must remove the language packs and re-install. To upgrade:

  1. Remove all language packs by running:

     Copy

     yum remove Semaphore-LanguagePack-Base
     

     Note: Removing the Base language pack will automatically remove all other language packs, as it is required for every language pack.

  2. Ensure all language pack artifacts are completely removed by executing:

     Copy

     /bin/rm -rf /opt/semaphore/languages
     /bin/rm -rf /opt/semaphore/languages
     

  3. Reinstall the required language packs using the standard yum install command for each language pack.

Install Semaphore Studio

If upgrading from an earlier version of Semaphore Studio, simply perform the relevant yum update command, but if you are upgrading from an earlier version of Semaphore that did not have Studio (Semaphore 4 or earlier) it is more complex:

1. Stop the Tomcat instance: Use the following command to stop tomcat:

   Copy

   systemctl stop tomcat
   

2. Copy the contents of Semaphore Workbench Home: If you have not already, copy the contents of the directory specified by the SEMAPHORE_WORKBENCH_HOME environment variable. This variable is typically set <tomcat_installdir>/bin/setenv.sh file. If you have trouble finding it, a set of files can be found in the <tomcat_installdir>/webapps/<OE/KMM_app>/WEBINF/SWH directory.

3. Note any other variables used by your installation: Specifically, if you are using a MarkLogic backend, note the settings of the following variables:

   • SEMAPHORE_DEFAULT_BACKEND

   • SEMAPHORE_MARKLOGIC_CONFIG

   These will typically be set in the same location as SEMAPHORE_WORKBENCH_HOME.

4. Remove tomcat and all sub-folders: Removing tomcat will also wipe the OE/KMM installation. In addition, make sure you remove any /etc/init.d/ or /etc/systemd/ service files that may have been created for the tomcat service.

5. Place the backup of Semaphore Workbench Home: Copy the contents of the directory to a public folder. For example, /home/SemaphoreWorkbenchHome or /var/opt/semaphore/SemaphoreWorkbencHome.

6. Install the Semaphore Studio product: See Install Semaphore Studio for details.

7. Setup Semaphore Workbench Home correctly BEFORE starting the Semaphore Studio service: Do the following:

   • Execute the following:

     Copy

     chown -R semaphore:semaphore <semaphore_workbench_home>
     

     For example, chown -R semaphore:semaphore /home/SemaphoreWorkbenchHome

   • In the /etc/sysconfig/semaphore file, add an entry for the SEMAPHORE_WORKBENCH_HOME variable. For example, add the following line:

     Copy

     SEMAPHORE_WORKBENCH_HOME=/home/SemaphoreWorkbenchHome
     

   • In the /etc/sysconfig/semaphore directory, add any additional settings copied from the old installation. For example: SEMAPHORE_DEFAULT_BACKEND and SEMAPHORE_MARKLOGIC_CONFIG.

8. Start the Semaphore Studio services. Execute the following to start the services:

   Copy

   systemctl start semaphore
   

   The semaphore service controls all studio components including Knowledge Model Management and Document Analyzer.