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

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

book

Article ID: 206782

calendar_today

Updated On:

Products

XCOM Data Transport XCOM Data Transport - Windows

Issue/Introduction

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

  • Moving from one XCOM version to another on the same Windows server.

  • Moving XCOM from one Windows server to another.

Environment

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

Resolution

Table of Contents


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.


Installing/upgrading XCOM

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.

  1. 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.

  2. See the online documentation section Installing and Upgrading. 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.

  3. 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).

  4. 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

  1. 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). 

  2. See the online documentation section Installing. 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.

  3. 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).

  4. 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.

Powered by Wolken Software