Upgrade from Release 11.6

You can upgrade  from Release 11.6 to Service Packs (11.6.01 and 11.6.02), as follows:
xdtw1161
You can upgrade
CA XCOM Data Transport for Windows
from Release 11.6 to Service Packs (
11.6.01, 11.6.02, and 11.6.03
), as follows:
Review the Considerations
Consider the following information before you upgrade to Service Packs:
  • You can rollback the upgrade manually
    only
    . No automatic rollback exists.
  • XcomAPI and XcomQAPI are updated in this release. If you used XcomAPI and XcomQAPI from a previous release of
    CA XCOM Data Transport for Windows
    to build custom applications, you must perform the following tasks
    before
    you use them with Service Pack:
    • Recompile your applications with the Visual Studio 2013 compiler.
    • Link them with the new versions of xcomapitcp.lib/xcomapisna.lib from Service Pack.
  • You can upgrade 11.6 32-bit to 11.6.01 32-bit, but you cannot upgrade from 11.6 32-bit to 11.6.01/11.6.02/11.6.03 64-bit.
  •   Similarly, you can upgrade 11.6 64-bit to 11.6.01/11.6.02/11.6.03 64 bit, but you cannot upgrade from 11.6 64-bit to 11.6.01 32-bit.
    Service Pack 11.6.02 and above does not support 32-bit.
  • The
    CA XCOM Data Transport for Windows
    Service Pack installer acts as both a new and upgrade installer. If the Installer does not find any installed XCOM instance on your computer, the installer acts as a new installer. If the installer finds a Release 11.6 XCOM instance, the installer acts an upgrade installer.
  • You can upgrade in either GUI mode or silent mode:
    • To upgrade in GUI mode, follow the instructions on this page.
    • To upgrade in silent mode, follow the instructions on Install or Upgrade in Silent Mode.
Understand the Process
When you run the installation program to upgrade the product, it performs the following tasks:
  1. Performs pre-installation checks to verify the following criteria:
    • The user who invokes the installer has admin permissions.
    • No
      CA XCOM Data Transport for Windows
      processes are running.
    • The currently installed product version is a candidate for the upgrade process.
  2. Backs up the following information from the existing product environment:
    • XCOM_HOME directory
    • Registry Keys
  3. Installs the following entities:
    • CA XCOM Data Transport for Windows
      binary files and services
    • CAPKI and CA License software
  4. Restore the existing
    CA XCOM Data Transport for Windows
    user customized settings:
    • User customized configuration files, including configssl.cnf, history.inserts, log4j.properties, StandAloneGUIParameters.xml, xcom.cnf, xcom.glb, xcom.ses, xcom.tid, xcom.log, xcomlp, xcomntfy, and exit scripts
    • User customized configuration folders, including ssl, tmp, preferences, trace, and convtab
    • registry settings
  5. Copies the user specified JDBC driver jar files to the XCOM_HOME/lib directory
  6. Removes the existing CAPKI software.
  7. Performs configuration file migration where the key value pair are compared and merged in configuration files like xcom.glb, xcom.cnf and configssl.cnf.
  8. Migrates the history database schema from Release 11.6 to the appropriate Service Pack.
  9. Migrates the Transfer Queue records from Release 11.6 to the appropriate Service Pack.
  10. Performs post-installation tasks.
Perform the Pre-Upgrade Tasks
Before you upgrade, complete the following tasks:
  1. Coordinate with users for the best time to perform the upgrade.
  2. Verify that no active transfers are running.
  3. Stop all CA XCOM Data Transport applications.
  4. Stop the XCOM Scheduler service.
Upgrade
To upgrade from Release 11.6 to Service Pack 11.6.01, follow these steps:

  1. Right-click XCOM.exe and select Run as Administrator.
  2. Follow the directions on the installation panels, and click Next to proceed through the installation process. Click Cancel to exit at any time. Confirm or supply the following information at the prompts:
    1. License agreement
    2. Decision to upgrade
    3. Components to upgrade
    4. Backup directory
    5. If TRUST_DATABASE_TYPE= MySQL/DB2, enter the following Trusted database drivers:
      • For MySQL, the JDBC Driver Path for the MySQL connector jar files
      • For DB2, the JDBC Driver Path and JDBC Driver License for the DB2 JDBC connector jar files
      The installer copies the selected JDBC driver jars to %XCOM_HOME%\lib post installation.
  3. Verify the details on the Pre-Installation (pre-upgrade) Summary panel and click Install.
  4. Note whether any messages appear about failed upgrade tasks. You can research these messages later in the upgrade log files, which are described later on this page.
  5. When the upgrade is completed, click Done.
To upgrade from Release 11.6 to Service Pack 11.6.02, follow these steps:
  1. Right-click XCOM.exe and select Run as Administrator.
  2. Follow the directions on the installation panels, and click Next to proceed through the installation process. Click Cancel to exit at any time. Confirm or supply the following information at the prompts:
    1. License agreement
    2. Decision to upgrade
    3. Components to upgrade
    4. Backup directory
    5. If TRUST_DATABASE_TYPE= MySQL/DB2, consent for upgrading the trusted database drivers:
      • For MySQL, the JDBC Driver Path for the MySQL connector jar files
      • For DB2, the JDBC Driver Path and JDBC Driver License for the DB2 JDBC connector jar files
      The installer copies the selected JDBC driver jars to %XCOM_HOME%\lib post-installation.
    6. provide consent for upgrading History DB schema
  3. Verify the details on the Pre-Installation (pre-upgrade) Summary panel and click Install.
  4. Note whether any messages appear about failed upgrade tasks. You can research these messages later in the upgrade log files, which are described later on this page.
  5. When the upgrade is completed, click Done.
To upgrade from Release 11.6 to Service Pack 11.6.03, follow these steps:
  1.   Right-click XCOM.exe and select Run as Administrator.
  2.   Follow the directions on the installation panels, and click Next to proceed through the installation process. Click Cancel to exit at any time. Confirm or supply the following information at the prompts:
    1. License agreement
    2.   Choose Java Virtual Machine
    3.   Decision to upgrade
    4. Components to upgrade
    5. Backup directory
    6.   If TRUST_DATABASE_TYPE= MySQL/DB2, consent for upgrading the trusted database drivers:
      • For MySQL, the JDBC Driver Path for the MySQL connector jar files
      • For DB2, the JDBC Driver Path and JDBC Driver License for the DB2 JDBC connector jar files.
      The installer copies the selected JDBC driver jars to %XCOM_HOME%\lib post-installation.
    7.   Provide consent for upgrading History DB schema
  3.   Verify the details on the Pre-Installation (pre-upgrade) Summary panel and click Install.
  4.   Note whether any messages appear about failed upgrade tasks. You can research these messages later in the upgrade log files, which are described later on this page.
  5. When the upgrade is completed, click Done.
Perform the Post-Upgrade Tasks
The post-installation tasks are:
  1. (Optional) If you have not already done so, set the PATH variable to include the directory where
    CA XCOM Data Transport for Windows
    is installed.
  2. Before you use the product, start the XCOMD CA XCOM Scheduler service.
  3. If you have not already done so, create the CA XCOM batch interactive group for running jobs or scripts.
  4. (If applicable) If you used XcomAPI and XcomQAPI from a previous release of
    CA XCOM Data Transport for Windows
    to build custom applications, perform the following tasks
    before
    you use them with Service Pack:
    • Recompile your applications with the Visual Studio 2013 compiler.
    • Link them with the new versions of xcomapitcp.lib/xcomapisna.lib from Service Pack.
Review the Log Files
The upgrade log files are:
  • %temp%\xcominstaller.log – warnings, error messages, and exit codes that occurred during the installation.
  • %XCOM_HOME%\Uninstaller\Logs\*install*.log – the sequence of actions that the installer performed
  • %temp%\capki_install.log – CAPKI installation log file
  • %temp%\calic_debug_InstallShield.log – CA Licensing installation log file (
    only for service pack 11.6.01
    )
The Installer installs or upgrades CAPKI and CA License software. The CA License is used only with
CA XCOM Data Transport for Windows
11.6.01 64-bit.
 When upgrading from R11.6 to Service Pack 11.6.01:
  • If trusted database is not configured for release 11.6
    ,
    the following message or any message related to JDBC jar files can be ignored from the installation log (%temp%\xcominstaller.log):
    Specified JDBC Driver File <<JAR FILE PATH>> is not valid
  • If the history database is not configured for release 11.6, the following message or any message related to database upgrade can be ignored from the installation log (%temp%\xcominstaller.log):
    No Success return code on UpgradeDB action. Failed with return code:nn