Upgrading to UNIFYConnect Sync Module v6

Overview

This document provides instructions on upgrading the plug-in of a UNIFYBroker/Plus v5.3 installation to a new version.

NOTE

Only UNIFYBroker/Plus v5.3 can be upgraded to UNIFYConnect Sync Module 6.

Upgrade Instructions

1. Install New ServiceInstall UNIFYConnect Sync Module v6 as per the installation guide, or upgrade an existing copy following the upgrade guide.If upgrading an existing copy, complete the upgrade but skip the "Verifying Installation" and "Cleanup" activities until the steps below are complete.
2. Migrate Configuration FilesCopy the existing UNIFYBroker/Plus XML configuration files in the current installation directory from Services\Extensibility\*.extensibility.config.xml into the Services\Extensibility folder in the new installation.
   • Delete any JSON configuration files related to UNIFYBroker/Plus in the new Services\Extensibility folder.UNIFYBroker Service v6 uses JSON format for the configuration files, but it also supports the format of XML.When you start the new service, it will automatically convert the XML files to JSON format, which will be used on subsequent service starts.
   • Once the service has started and upgrade completed successfully, you must remove existing XML configuration files from the Extensibility directory to avoid them trying to be converted again.
3. Verify the InstallationStart the UNIFYConnect v6 service and verify the installation by following the "Verifying Installation" section of Installing UNIFYConnect Sync Module