Desktop Client Module Upgrade

Last modified by ryanp on 2021/09/09 20:55

Overview

This document covers how to upgrade the optional Desktop Client Module, on an existing iSymphony server installation. If you have not yet installed the iSymphony server see Getting Started. If you have not yet installed the Desktop Client Module see Desktop Client Module Installation.

Upgrading to iSymphony Version 3.4.2 or later will include the desktop module by default. See Upgrading iSymphony and iSymphony 3.4.2 Upgrade Notes for information on upgrading iSymphony. Skip this document and proceed to Adding New Desktop Client Installers if v3.4.2+ is installed.

The Desktop Client Module requires an iSymphony Server version of 3.2.1 or higher.

The Desktop Client Module 2.0.0 requires an iSymphony Server version of 3.4.1 or higher.

1. Download The Latest Desktop Client Module

The desktop client module downloads can be found in the Downloads Archive. You will want to download the Desktop Client Module package on the server that is running the iSymphony server.

On this page:

The [toc] macro is a standalone macro and it cannot be used inline. Click on this message for details.
This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.

2. Uninstall The Old Desktop Client Module

The upgrade process for the Desktop Client Module is simply a matter of un-installing the old version and installing the new version.

Stop the iSymphony server. See Starting And Stopping The iSymphony Server.
Remove or move the following directory from the /opt/isymphony3/server/modules directory.
/opt/isymphony3/server/modules/desktop

3. Install The New Desktop Client Module

Install the new version of the module. See Desktop Client Module Installation.
Start the iSymphony server. See Starting And Stopping The iSymphony Server.
For adding new desktop installers see: Adding New Desktop Client Installers.

5. Upgrade The Desktop Client Installations

Restart all the Desktop Client installations, on the client machines, to initiate the upgrade. You should be prompted to upgrade when you launch the client.