Upgrade Transfer CFT

This section explains how to upgrade an existing Transfer CFT from versions 2.6 through 3.2.4 to Transfer CFT 3.3.2. 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

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.

Transfer CFT 3.1.3 introduced the CUP, Composite Upgrade Package, feature. This functionality enables you to upgrade both the installer and the product simultaneously.

Note See also silent mode for details on using the silent installation method.

Before you start

Before beginning the upgrade procedure, you should:

  • Stop the Transfer CFT server and the Transfer CFT UI server, by entering:
    • cft stop
    • copstop -f

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 Transfer CFT 2.6.4 to 3.3.2

Preconditions: Minimum versions for this procedure

This upgrade requires that your current installation is at least at the version levels listed below. Read the Before you start prior to beginning this procedure.

  • Transfer CFT version: 2.6.4_SP7
  • Axway Installer version: 4.3.1_SP2
  • Embedded JRE version: 1.5.0_15
Note Update the product key between versions (after completing the upgrade).

Step 1: Upgrade to Axway Installer 4.4.0 SP8 or the latest SP

Run the Axway Installer in update mode.

  1. Start the Axway Synchrony Installer in update mode, shown here in the default installation directory:

    Unix/Linux: ***Axway/Synchrony/setupUNIX.sh update

  2. Apply the Synchrony_Installer_4.4.0_UP7-from-4.3.1_win-x86-64_BN16272.jar.
  3. Start the Axway Synchrony Installer in update mode.

    Unix/Linux: ***Axway/Synchrony/setupUNIX.sh update

  4. Apply the Synchrony_Installer_4.4.0_SP8_allOS_BN25804.jar.

Step 2: Upgrade to JRE 160

Use the Axway JREUpdateTool to upgrade to JRE 1.6. This Axway tool is available on the Axway Support site.

  1. Unzip the JREUpdateTool_4.4.0_Utility_*****_BN1205240348.zip.

    Where ***** represents the platform

    Example: JREUpdateTool_4.4.0_Utility_win-x86-64_BN1205240348.zip

  2. Upgrade to Java 1.6 using the appropriate command:

    Unix/Linux: <JRETOOLS_DIRECTORY>/updatejre.sh /home/user/Axway/Synchrony/

Step 3: Upgrade to Axway Installer 4.5.0 SP4 or the latest SP

Run the Axway Installer in update mode.

  1. Start the Axway Synchrony Installer in updated mode:

    setupUNIX.sh update

  2. Apply the Synchrony_Installer_4.5.0_UP1-from-4.4.0-4.4.1_allOS_BN1204251050.jar.
  3. Start the Axway Installer.
  4. Note The program commands change in this step!

    update.sh

  5. Apply the Axway_Installer_4.5.0_SP4_allOS_BN22715.jar.

Step 4: Upgrade to JRE 160 update 37 using the JREUpdateTool

Use the Axway JREUpdateTool to update the JRE.

  1. Unzip the JREUpdateTool_4.5.0_Utility_*****_BN1211090726.zip

    Where ***** represents the platform

    Example: JREUpdateTool_4.5.0_Utility_win-x86-64_BN1211090726.zip

  2. Upgrade to Java 1.6 using the appropriate command:

    <JRETOOLS_DIRECTORY>/updatejre.sh /home/user/Axway/Synchrony/

Step 5: Upgrade to Axway Installer 4.8.0

Run the Axway Installer in update mode.

  1. Start the Axway Installer.

    update.sh

  2. Apply the Axway_Installer_4.8.0_UP2-from-4.5.x-4.6.1-4.7.0_*****_multiOS_BN2.jar.

    Where ***** represents the platform

    Example: Axway_Installer_4.8.0_UP2-from-4.5.x-4.6.1-4.7.0_win-x86_multiOS_BN2.jar

Step 6: Upgrade to Transfer CFT 3.1.3

Run the Axway Installer in update mode.

  1. Start the Axway Installer.
  2. update.sh

  3. Apply the Transfer_CFT_3.1.3_UP1-from-2.6.2-2.6.3-2.6.4-2.7.0-2.7.1-3.0.1-3.1.2_*****_BN8294000.jar

    Where ***** represents the platform

    Example: Transfer_CFT_3.1.3_UP1-from-2.6.2-2.6.3-2.6.4-2.7.0-2.7.1-3.0.1-3.1.2_win-x86-64_BN8294000.jar

Step 7: Upgrade to the latest Transfer CFT 3.1.3 Service Pack

Use the Axway Installer in update mode.

  1. Start the Axway Installer:

    update.sh

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

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

    For example, Transfer_CFT_3.1.3_SP3_aix-power-64_BN8712000.zip

  3. Note In this step you are working with a zip file (not a jar file as in earlier Installer versions). Do NOT unzip/uncompress the zip file.
  4. If necessary, add the Transfer CFT 3.x license key in the conf/cft.key file.

Step 8: Upgrade to the Transfer CFT 3.3.2 Upgrade Pack

Use the Axway Installer in update mode.

  1. Start the Axway Installer using one of the two installation modes:

    Silent mode: update.sh -i <zip_file>

    Interactive mode: update.sh

  2. Apply the Transfer_CFT_3.x.y_UP****-from-3.1.3_*****_BN*****.zip.

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

    For example, Transfer_CFT_3.3.2_UP1-from-3.1.3_aix-power-32_BN9815000.zip

  3. Note In this step you are working with a zip file (not a jar file as in earlier Installer versions). Do NOT unzip/uncompress the zip file.
  4. If necessary, add the Transfer CFT 3.x license key in the conf/cft.key file.

Step 9: Update Transfer CFT 3.3.2 to the latest Service Pack

Upgrade Transfer CFT 2.7.1 to 3.3.2

Preconditions: Minimum versions for this procedure

This procedure requires that your current installation be at least at the levels listed below.

  • Transfer CFT version 2.7.1_SP10
  • Axway Installer version 4.4.0_SP8 or 4.4.1_SP3
  • Embedded JRE version: 160
Note Remember to update the product key between versions (after completing the upgrade).

Step 1: Upgrade to JRE 160

Use the Axway JREUpdateTool to perform the JRE update.

  1. Unzip the JREUpdateTool_4.4.0_Utility_*****_BN1205240348.zip

    Where ***** represents the platform

    For example, JREUpdateTool_4.4.0_Utility_win-x86-64_BN1205240348.zip

  2. Use the following command to upgrade to Java 1.6:

    <JRETOOLS_DIRECTORY>chmod 755 *.sh/updatejre.sh /home/user/Axway/Synchrony

Step 2: Upgrade to the Axway Installer 4.5.0_SP4 or the latest SP

Run the Axway installer in update mode.

  1. Start the Axway Synchrony Installer, shown here in the default installation directory:

    ***Axway/Synchrony/setupUNIX.sh update

  2. Apply the Synchrony_Installer_4.5.0_UP1-from-4.4.0-4.4.1_allOS_BN1204251050.jar.
  3. Start the Axway Synchrony Installer.
  4. Note The program commands change in this step!

      Unix/Linux: update.sh

  5. Apply the Axway_Installer_4.5.0_SP4_allOS_BN22715.jar.

Step 3: Upgrade to JRE 160 update 37

Use the Axway JREUpdateTool to update the JRE level.

  1. Unzip the JREUpdateTool_4.5.0_Utility_*****_BN1211090726.zip
  2. Where ***** represents the platform

    For example, JREUpdateTool_4.5.0_Utility_win-x86-64_BN1211090726.zip

  3. Upgrade to Java 1.6 using the appropriate command:

    <JRETOOLS_DIRECTORY>/updatejre.sh /home/user/Axway/Synchrony/

Step 4: Upgrade to Axway Installer 4.8.0

Run the Axway Installer in update mode.

  1. Start the Axway Installer:

    update.sh

  2. Apply the Axway_Installer_4.8.0_UP**-from-4.5.x-4.6.1-4.7.0_*****_multiOS_BN2.jar

    Where ** is the UP version and ***** represents the platform

    For example, Axway_Installer_4.8.0_UP2-from-4.5.x-4.6.1-4.7.0_win-x86_multiOS_BN2.jar

Step 5: Upgrade to Transfer CFT 3.1.3

Run the Axway Installer in update mode.

  1. Start the Axway Installer:

    update.sh

  2. Apply the Transfer_CFT_3.1.3_UP**-from-2.6.2-2.6.3-2.6.4-2.7.0-2.7.1-3.0.1-3.1.2_*****_BN8294000.jar

    Where ** is the UP version and ***** represents the platform.

    For example, Transfer_CFT_3.1.3_UP2-from-2.6.2-2.6.3-2.6.4-2.7.0-2.7.1-3.0.1-3.1.2_win-x86-64_BN8294000.jar

Step 6: Upgrade to the latest Transfer CFT 3.1.3 Service Pack

  1. Start the Axway Installer:

    update.sh

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

  3. Note In this step you are now working with a zip file (it was a jar file in previous Installer versions). Do NOT unzip/uncompress the zip file.
  4. If necessary, add the Transfer CFT 3.x license key in the conf/cft.key file.

Step 7: Upgrade to Transfer CFT 3.3.2 Upgrade Pack

Use the Axway Installer in update mode.

  1. Start the Axway Installer:

    update.sh

  2. Apply the Transfer_CFT_3.x.y_UP****-from-3.1.3_*****_BN*****.zip.

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

    For example, Transfer_CFT_3.3.2_UP1-from-3.1.3_aix-power-32_BN9815000.zip

  3. Note In this step you are working with a zip file (not a jar file as in earlier Installer versions). Do NOT unzip/uncompress the zip file.
  4. If necessary, add the Transfer CFT 3.x license key in the conf/cft.key file.

Step 8: Update Transfer CFT 3.3.2 to the latest Service Pack

Upgrade Transfer CFT 3.0.1 to 3.3.2

Preconditions: Minimum versions for this procedure

This procedure requires that your current installation is at least at the levels listed below.

  • Transfer CFT 3.0.1_SP9
  • Installer 4.5.0_SP4
  • Embedded JRE version: JRE 160
Note Remember to update the product key between versions.

Step 1: Upgrade to Axway Installer 4.8.0

Use the Axway Installer in update mode:

  1. Start the Axway Installer:
  2. update.sh

  3. Apply Axway_Installer_4.8.0_UP2-from-4.5.x-4.6.1-4.7.0_*****_multiOS_BN2.jar

    Where ***** represents the platform

    For example, Axway_Installer_4.8.0_UP2-from-4.5.x-4.6.1-4.7.0_win-x86_multiOS_BN2.jar

Step 2: Upgrade to Transfer CFT 3.1.3

Run the Axway Installer in update mode.

  1. Start the Axway Installer:
  2. update.sh

  3. Apply the Transfer_CFT_3.1.3_UP**-from-2.6.2-2.6.3-2.6.4-2.7.0-2.7.1-3.0.1-3.1.2_*****_BN8294000.jar

    Where ** is the UP version and ***** represents the platform.

    Example: Transfer_CFT_3.1.3_UP2-from-2.6.2-2.6.3-2.6.4-2.7.0-2.7.1-3.0.1-3.1.2_win-x86-64_BN8294000.jar

Step 3: Upgrade to the latest Transfer CFT 3.1.3 Service Pack

Run the Axway Installer in update mode.

  1. Start the Axway Installer:

    update.sh

  2. 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 (not a jar file as in earlier Installer versions). Do NOT unzip/uncompress the zip file.

Step 4: Upgrade to Transfer CFT 3.3.2 Upgrade Pack

Use the Axway Installer in update mode.

  1. Start the Axway Installer:

    update.sh

  2. Apply the Transfer_CFT_3.y.z_UP****-from-3.1.3_*****_BN*****.zip.

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

    For example, Transfer_CFT_3.3.2_UP1-from-3.1.3_aix-power-32_BN9815000.zip

  3. Note In this step you are working with a zip file (not a jar file as in earlier Installer versions). Do NOT unzip/uncompress the zip file.
  4. If necessary, add the Transfer CFT 3.x license key in the conf/cft.key file.

Step 5: Update Transfer CFT 3.3.2 to the latest Service Pack

Upgrade Transfer CFT 3.1.x to 3.3.2

Preconditions: Minimum versions for this procedure

The current installation must be at least at the levels listed below.

  • Transfer CFT version is 3.1.3
Note Remember to update the product key between versions.

Step 1: Upgrade to the latest Transfer CFT 3.1.3 Service Pack

Run the Axway Installer in update mode.

  1. Launch the Axway Installer
  2. update.sh

  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 (not a jar as in earlier Installer versions). Do NOT unzip/uncompress the zip file.

Step 2: Upgrade to Transfer CFT 3.3.2 Upgrade Pack

Use the Axway Installer in update mode.

  1. Start the Axway Installer:

    update.sh

  2. Note In this step you are working with a zip file (not a jar file as in earlier Installer versions). Do NOT unzip/uncompress the zip file.
  3. If necessary, add the Transfer CFT 3.x license key in the conf/cft.key file.
  4. Apply the Transfer_CFT_3.y.z_UP****-from-3.1.3_*****_BN*****.zip.

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

    For example, Transfer_CFT_3.3.2_UP1-from-3.1.3_aix-power-32_BN9815000.zip

Step 3: Update Transfer CFT 3.3.2 to the latest Service Pack

Upgrade Transfer CFT 3.2.x to 3.3.2

Upgrade to Transfer CFT 3.3.2

Use the Axway Installer in update mode.

  1. Start the Axway Installer:

    update.sh

  2. Apply the Transfer_CFT_3.y.z_UP****-from-3.1.3_*****_BN*****.zip.

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

    For example, Transfer_CFT_3.3.2_UP1-from-3.1.3-3.2.2_aix-power-32_BN10690000.zip

  3. If necessary, add the Transfer CFT 3.x license key in the conf/cft.key file.
  4. Update Transfer CFT 3.3.2 to the latest Service Pack.

Post upgrade

After completing the upgrade procedure, your Transfer CFT 3.3.2, 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.

Check 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