Upgrading MCS

Step-by-step instructions for upgrading MyConnection Server on Windows and Linux.

Stop the MCS Service

Windows

In the list of Windows services locate Visualware MyConnection Server. Right click and choose Stop. This will stop the service.

Open the Run dialog, type services.msc, and click the OK button to launch the services admin panel.

Open the services admin panel
Open the services admin panel

Scroll down to find the Visualware MyConnection Server (#XXXXX) listing. Right click and choose Stop from the menu to stop the service.

Stop the MCS service
Stop the MCS service

Linux

Inside the MCS installation folder will be the stop_mcs.sh script. Run this to stop the service — this can take up to 10–15 seconds. Once stopped, move to the backup step.

From a Linux SSH prompt, browse to the installation directory for MCS. Now use the command below to stop the MCS service.

sh stop-mcs.sh
Browse to MCS directory and stop the service
Browse to MCS directory and stop the service

Backup

To backup, simply copy the current MCS installation directory to a safe location. This ensures that, should the upgrade not go as planned, the original install can be recovered.

Windows

Simply take a copy of the entire installation directory.

Linux

There are many ways to copy directories on Linux. rsync is one of the more robust options. The key flags are:

Flag Description
-a Enables recursive mode and preserves symbolic links, special and device files, modification times, group, owner, and permissions
-v Gives more detailed information about what rsync is doing. Omit this for silent operation.
--delete Deletes any files in the destination directory that are not present in the source directory
--ignore-existing Skips updating files that already exist in the destination and only overwrites files that are newer in the source

Tip: Using --delete and --ignore-existing together can make future backups quicker as it only copies files it needs to.

rsync command to backup MCS on Linux
rsync command to backup MCS on Linux

Install the Latest MCS

For both Windows and Linux you can simply install the latest MCS over the current installation folder.

Installing MCS on Windows

Installing MCS on Linux

The service will automatically start once the install completes.

Satellite Upgrades

Important: MCS 11.0a+ contains increased security protocols. This change requires that all NQC and Access Satellites be upgraded to the latest firmware. To request the latest Access Series firmware click here. For NQC Satellites the latest install kits are in the MCS install root directory.

Cache Reset

Since MCS is a web-based application, it relies on external components that may be cached by the browser. Upgrading MCS can include newer versions of these components, and if the browser uses cached versions, it may cause the page to malfunction. We recommend clearing the browser cache for the MCS admin portal after each upgrade.