Migrate/upgrade XCOM for Windows to new XCOM version or new Windows server

Products

XCOM Data Transport XCOM Data Transport - Windows

Issue/Introduction

What are the best practices when migrating XCOM for Windows for these scenarios:

Migrating XCOM to new Windows server.
Migrating/upgrading XCOM on a Windows server.

Environment

Release: 11.6, 12.0
XCOM™ Data Transport® for Windows

Resolution

Migrating XCOM to new Windows server

As general advice, when moving XCOM to new a new machine rather than copying existing XCOM installation files from the old to the new machine XCOM must be installed on the new machine.
That is because an XCOM installation on Windows involves not just placing the files/libraries onto the filesystem but also creating registry settings and environment variables.
If it is also required to upgrade the XCOM version at the same time, then the advice would be to install the existing version of XCOM on the new server and then upgrade it using the steps in the next section.

Migrating/upgrading XCOM on a Windows server

XCOM for Windows 12.0 is the latest version so it is strongly advised to upgrade to that version and its latest patch level assuming the Windows version being used is supported for it. For details please see XCOM Distributed Platform Compatibilities and the Windows section.
Instructions for both 11.6 and 12.0 are provided below.

Release 11.6

The latest service pack for 11.6 is SP03. NOTE: SP03 is the only service pack that is currently supported.

XCOM Data Transport r11.6 SP03 64-bit for Windows Family Server can be downloaded from the XCOM Product Download page (type windows into the search box and then the link for "XCOM Data Transport for Windows Family Server WINDOWS NT" will become easily visible). The SP03 release is version r11.6.20035.
Only file DVD0000000002021.iso needs to be downloaded.
See the online documentation section Installing and Upgrading. As described, to access the installer EITHER unzip the file DVD0000000002021.iso OR use right mouse button on it and option Mount which will open a new drive showing the installer XCOM.exe.
From within that section, please note that for an XCOM upgrade on the same Windows server, automatic upgrades from 11.5 or 11.6 32-bit are not supported and for those versions a manual upgrade must be done. NOTE: Only an automatic upgrade will perform an existing installation backup during the upgrade process and a manual upgrade requires a manual backup of files beforehand.
After the install/upgrade, install the latest patch to avoid any known problems. XCOM patches are cumulative so only the latest patch needs to be installed. The patches are available on the XCOM Solution Download page (type windows into the search box and then the link for "XCOM Data Transport for Windows Family Server WINDOWS NT" will become easily visible).
In general, unless running an automatic upgrade on the same Windows server or the old and new Windows servers are running identical XCOM versions (patch level), the best practice advice for the migration of configuration settings is that the new version should not simply have its configuration files replaced with backed-up copies from the old server. Instead, the steps should be:
a. Review what is currently in the xcom.glb and xcom.cnf files on the old server and use those files as a guide to modify the new xcom.glb and xcom.cnf. The same advice applies to any other configuration files e.g. configssl.cnf.
b. If using XCOM pre-processing or post-processing scripts on the old server the versions of those equivalent scripts on the new server will need to be modified accordingly.
c. Review the online documentation to see what has changed: XCOM™ Data Transport® for Windows 11.6 Service Packs > Release Notes

Release 12.0

Assuming the Windows version supports XCOM for Windows 12.0

XCOM Data Transport for Windows 12.0 can be downloaded from the XCOM Product Download page (type windows into the search box and then the link for "XCOM Data Transport for Windows Family Server WINDOWS NT" will become easily visible). Only file XCOMWindows120.iso needs to be downloaded.
See the online documentation section Installing. As described, to access the installer EITHER unzip the file XCOMWindows120.iso OR use right mouse button on it and option Mount which will open a new drive showing the installer XCOM_12_0_23053.exe.
From sub-section Upgrade from a Previous Release, please note that for an XCOM upgrade on the same Windows server, automatic upgrades from 11.0, 11.5 or 11.6 SP00 are not supported and for those versions a manual upgrade must be done. NOTE: Only an automatic upgrade will perform an existing installation backup during the upgrade process and a manual upgrade requires a manual backup of files beforehand.
After the install/upgrade, install the latest patch to avoid any known problems. XCOM patches are cumulative so only the latest patch needs to be installed. The patches are available on the XCOM Solution Download page (type windows into the search box and then the link for "XCOM Data Transport for Windows Family Server WINDOWS NT" will become easily visible).
In general, unless running an automatic upgrade on the same Windows server or the old and new Windows servers are running identical XCOM versions (patch level), the best practice advice for the migration of configuration settings is that the new version should not simply have its configuration files replaced with backed-up copies from the old server. Instead, the steps should be:
a. Review what is currently in the xcom.glb and xcom.cnf files on the old server and use those files as a guide to modify the new xcom.glb and xcom.cnf. The same advice applies to any other configuration files e.g. configssl.cnf.
b. If using XCOM pre-processing or post-processing scripts on the old server the versions of those equivalent scripts on the new server will need to be modified accordingly.
c. Review the online documentation to see what has changed: XCOM™ Data Transport® for Windows 12.0 Release Notes > Release Notes

Additional Information

XCOM Data Transport main product page.