Upgrade the Semarchy xDI Designer
This article explains how to upgrade Semarchy xDI Designer from versions S20.x or 5.3.x to 5.3.y.
The following procedure describes the steps to upgrade from 20.x or 5.3.x to 5.3.y. For other upgrade scenarios, refer to this article. |
Pre-Upgrade Steps
This section describes the operations to perform before upgrading Semarchy xDI Designer.
Review the Release Notes
Release Notes provide the latest information about the Semarchy xDI release, including new features, bug fixes and breaking changes.
System Requirements
Review the system requirements for this release.
Semarchy xDI Designer 5.3 requires a JDK 11.0.2 or higher. If you are using an anterior version, migrate to Java 11.0.2 or above (review the supported Java versions in System Requirements). |
Close the Designer
Before upgrading, completely close the Designer environment:
-
Stop the local runtime.
-
Close all editors.
-
Exit Semarchy xDI Designer.
Backup your Installation
Perform a backup of your current installation of Semarchy xDI Designer:
-
Make a zip archive of the current Semarchy xDI Designer installation.
-
Make a zip archive of your workspace(s).
Upgrade the License Server
Semarchy xDI Designer 5.3 requires you to obtain its license from a license server 5.3 or higher.
If licenses in the current installation were obtained using a local license server 1.x, upgrade the License Server before upgrading Semarchy xDI Designer.
Upgrade Steps
Download and Install the New Version
To download and install the new version of Semarchy xDI Designer:
-
Download the new version of Semarchy xDI Designer from the Semarchy website.
-
Uncompress the archive in a temporary folder.
-
Move the archive’s content to the target installation folder:
-
Windows: Copy the content to your
Program Files
folder. -
Linux: Copy to your user folder.
-
macOS: Copy to your
Applications
folder.If you are prompted to replace, or keep a previous application having the same name, it is recommended to stop the process, rename the previous application, and move the new version to the Applications
folder again.
-
Copy Modules
Before the first startup, copy the Modules folder from the previous installation to the new one:
-
Under Windows/Linux: the default folder for Modules is
<Designer root folder>/runtime/modules
. -
Under macOS: the default folder for Modules is
<Designer root folder>/Contents/Eclipse/runtime/modules
.
Run the New Version
Perform the following operations for the first startup of the new version:
-
Start the new version of Semarchy xDI Designer (see instructions for Windows, Linux, macOS).
-
Select the workspace directory and click Launch.
-
Review and accept the License Terms, and then click Finish.
-
The Register License dialog opens.
-
If you are using a local license key:
-
Select the License Key File option.
-
Click the button next to the License Key File field to select the local key file.
-
-
If you are registering through an on-premises license server:
-
Select the Local License Server option.
-
Enter the License Server URL and the License Key.
-
-
If you are registering through the Semarchy License Server:
-
Select the Semarchy License Server Option.
-
Enter your License Key.
Refer to Manage the Designer License for more information on license modes.
-
-
-
Click Register.
-
On the Welcome Page, click Hide to show the design environment.
-
Launch the Rebuild Cache and Clean Projects operation from the Utilities menu.
Re-Install Components
Starting from 5.3.0, components in Semarchy xDI Designer are installed and updated using an update site.
To re-install components, follow the procedure described in Install Components and restart the Designer when you are prompted to.
When the Designer restarts, all Modules copied from the previous installation are automatically updated with the latest version included in the related component (if any). |
Post-Upgrade Steps
Generic Post-Upgrade Steps
Perform the following post-upgrade operations for all upgrade scenarios:
-
In the Modules Manager check that all modules have been migrated successfully.
-
Remove the old installation folder.
Post-Upgrade Steps - Upgrading from Versions Before 5.3.0
If you are upgrading from a version prior to 5.3.0:
-
Upgrade all workspaces: Run the designer in the command line with the
-clearPersistedState
option for each of your pre-5.3.0 workspaces. -
The User License is now holding the Components/Features permissions. If you notice any issue with Components/Features that are unexpectedly disabled and forbidden in your Designer, contact Semarchy.
A workspace that has been opened with a newer version of Semarchy xDI Designer shall not be re-opened with a previous version. |