Upgrade Transfer CFT

This section explains how to upgrade an existing Transfer CFT from versions 3.1.3, 3.2.x, 3.3.2 to Transfer CFT 3.6. It begins by detailing the prerequisites for a standalone (non multi-node) upgrade.

For details on upgrading a multi-node installation, see Upgrade a Transfer CFT multi-node installation.

About upgrades

As of Transfer CFT 3.4 there is no separate upgrade package, you use the installation package to perform an upgrade procedure as described in the sections below.

All passwords stored in the UCONF dictionary, or in the the Transfer CFT databases (for example, CFTPART, CFTPARM) are cyphered using the key generated at installation. If you are performing an upgrade, all passwords are cyphered using a hard-coded key. We recommend that you generate an encryption key.

Note See silent mode for detailed information on using the silent installation method.
Note When upgrading, the same type of user that did the initial installation must start the installer.

Before you start

Before beginning the upgrade procedure:

  • Download the Transfer CFT installation kit, available at support.axway.com.
  • Stop the Transfer CFT server and the Transfer CFT UI server, by entering:
    • cft stop
    • copstop -f

Windows Application Experience recommendation

You should enable the "Application Experience" service when using Transfer CFT. Otherwise you may encounter issues in accessing files when installing or upgrading the product.

Limitation

During an upgrade, if the CFTCOM file path is greater than 64 characters the COM file is not migrated, and you must migrate it manually.

Use Central Governance to upgrade Transfer CFT

You can perform Transfer CFT upgrades using Central Governance. However, from the Central Governance interface you cannot remove service packs or patches, and can only upgrade Transfer CFT as of Transfer CFT 3.1.3 with last service pack (to the latest version). You cannot perform a Transfer CFT migration via Central Governance.

Please refer to the Central Governance documentation for details.

Upgrade options

You can use the following installer options for Transfer CFT 3.4 when performing an upgrade:

--architecture <architecture>: Installation architecture (single or cluster mode).

  • Default: single
  • Allowed: single first_host additional_host

--runtimedir <runtimedir>: Shared Runtime Directory. On LEGACY upgrades, this is the shared data directory where the Axway Installer was installed.

  • Only used when architecture=additional_host

--installdir <installdir>: Directory where the Transfer CFT is installed/upgraded. On LEGACY upgrades, this is the directory where the Axway Installer was installed.

  • Not used when architecture=additional_host
  • Default:<Current Drive>:\axway\cft

--conf-file <conf-file>: File used to personalize installation of Transfer CFT

  • In this type of installation only 2 parameters are used:
    • - architecture and installdir (if architecture = single/first_host), or
    • - architecture and runtimedir (if architecture = additional_host)

You can set these using command line or the configuration file. The values passed in command line take precedence over the values in the configuration file.

Upgrade Transfer CFT 3.1.3, 3.2.x, or 3.3.2 to 3.6

Note Remember to update the product key between versions.

Step 1: Upgrade to the latest Transfer CFT 3.1.3, 3.2.x, or 3.3.2 Service Pack

Run the Axway Installer in update mode.

  1. Launch the Axway Installer:
  2. update32.exe or update64.exe

  3. Apply the Transfer_CFT_3.1.3_SP*****.zip

    Where ***** represents the SP level and the platform

    Example: Transfer_CFT_3.1.3_SP3_aix-power-64_BN8712000.zip

Note In this step you are working with a zip file (and not a jar as in earlier Installer versions). Do NOT unzip/uncompress the zip file.

Step 2: Upgrade to Transfer CFT 3.6

Caution   This operation removes the old Axway Installer and all its content, so no rollback is available. You should backup the content of your installation directory if you want to have the option of undoing this operation.
  1. Uncompress the Transfer CFT installation kit.
  2. From the Transfer CFT installation kit, enter:
  3. ./Transfer_CFT_3.4_Install_<OS>_<BN>.exe [<options>]
  4. Accept the license and the appropriate installation mode (e.g. single).
  5. When prompted for the installation directory, enter the path to the existing Transfer CFT installation directory.

Available options

The following available options are described in detail in Upgrade options:

  • --architecture <architecture>
  • --runtimedir <runtimedir> (only available when architecture = additional_hosts)
  • --installdir <installdir>
  • --conf-file <conf-file>
  • --help
  • --debuglevel
  • --mode

Post upgrade

After completing the upgrade procedure, your Transfer CFT 3.6, exec scripts are operational. However, you must rebuild your programs that use C and COBOL APIs and exits.

After performing an upgrade, all passwords are cyphered using a hard-coded key. We recommend that you generate an encryption key as described in Generate an encryption.

Checking the new version

To check the Transfer CFT version, as well as the license key and system information, enter the command:

CFTUTIL ABOUT

Related Links