Schemus Synchronization Tool – Mandatory Upgrade

book

Article ID: 171384

calendar_today

Updated On:

Products

Email Security.cloud Web Security.cloud

Issue/Introduction

Urgent: Upgrading Schemus from version 1.39/1.47 to 1.50

As per Symantec commitment to provide best-in-class encryption to our customers, support for Transport Layer Security (TLS) version 1.0 will be discontinued as of September 1st 2018. As such, Schemus Synchronization Tool, which extracts user information (email address, user, and group) from your LDAP directory service and provides user identity data to your Email Security.cloud and Web Security.cloud Security services must be upgraded to the latest 1.50 version.

Environment

  • Email Security.cloud
  • Web Security.cloud

Resolution

Required Action

We urge customers to upgrade to the latest Schemus 1.50 version

Checking current version: Open Schemus>Help>About Schemus>Schemus Synchronizer Version

Important notes before upgrading

  1. If upgrading a 64-bit Windows application to a 32-bit application, the 64-bit version will not be uninstalled. We recommend uninstalling the 64-bit version first if reinstalling or upgrading to a 32-bit version.
  2. Windows scheduled tasks will need to be recreated if installing for a different architecture (64/32 bit). 
  3. The bundled java certificate store will be replaced. Any custom certificates (e.g. for SSL communication to the directory) will be lost.
  4. Download version with JRE. If you download a version without JRE you may need to enable Java versions above 1.0 in the Java applet.

Upgrading Schemus

  1. Make a backup of the existing Schemus folder which can be found here:

Windows XP & Server 2003:
C:\Documents and Settings\ AllUsers\ApplicationData\Schemus

Windows 7, 8, Vista & Server 2008, 2012:
C:\programdata\Schemus

Linux:

      $HOME/.schemus/configurations/

      or

      ~/.schemus/configurations/

*You may need to enable the view of hidden files and folders in Windows

  1. Ensure that all other applications running on the computer are closed before you start the installation process.
  2. Download the latest version of Schemus from https://clients.messagelabs.com > Tools > Downloads
  3. Start the installer
  4. For Windows systems, click the executable file that you downloaded from the portal

For customers already on Schemus version 1.5 and still experiencing the SSL Handshake fatal alert, download and install schemus with JRE from the Client net Downloads menu.

For Linux systems, open a terminal, ensure that the execute permission is set on the installer file, and run it. For example

$ chmod +x Schemus_linux_jre.sh

$ ./Schemus_linux_jre.sh

  1. In the Welcome dialog, click Next
  2. In the License Agreement dialog box, read and acknowledge the agreement, and click Next
  3. In the Select Destination Directory dialog box, choose the directory in which to install the tool; for example C:ProgramFiles Schemus . Click Next

This step is skipped if the installation is an upgrade from a previous version of the tool

  1. In the Select Start Menu Folder dialog box, choose where you want to launch the Synchronization Tool from; the Start menu for Windows, and Symlinks for Linux. Click Next
  2. In the Select Configuration Directory dialog box, select a destination for the configuration settings and then click Next

Configuration settings determine the types of synchronization that you can to perform email, users, and groups. If you upgrade to a later version of the Synchronization Tool, you can keep your existing settings or create new ones.

If you want multiple users to run the tool, select a shared directory

  1. In the Office 365 modules dialog box, select the Office 365 source modules that you want to use. Note that you can only select these sources if your system satisfies the requirements.
  2. In the Information dialog box, read the release information and then click Next
  3. Click Finish to exit the setup wizard

*Once the upgrade is completed it is advised to perform a "Refresh" before proceeding with update.

Synchronization Scheduler

If you have scheduled synchronization task, verify the settings are still correct or follow the steps below to create a new synchronization schedule. Windows scheduled tasks will need to be re-created if installing for a different architecture (64/32 bit).

To remove a synchronization schedule

  1. Open Schemus
  2. Click on Configuration > Schedule
  3. Click Clear

The calendar icon is grayed to show that the synchronization is no longer scheduled.

To schedule a synchronization:

  1. Click Schedule to set a time for the synchronization profile to run
  2. Specify a time in Run at
  3. Specify a recurring time in then run every
  4. Choose the days to run from on the drop-down list
  5. Click Day of Month or Day of Week and make your selections. If you select both Days of Month and Day of Week, the Synchronization Tool runs as follows:

Every month on the chosen date, and Every week on the chosen day.

Click Schedule to save the changes.

 

More Information