Windows upgrade

This topic describes how to upgrade an existing installation on Windows. We recommend using the latest version of Connect and its connectors, to benefit from the added capabilities and enhanced stability.

Important note before upgrading to 25.3

Starting with version 25.2, Connect exclusively supports only PostgreSQL as the database. Derby is officially deprecated. If you are currently using a version earlier than 25.2, you must first consult the official documentation to upgrade to version 25.2. For details, see Windows upgrade.

Database installation, upgrade, and management are the responsibility of the administrator.

Back to top

Upgrade process

This section lists the steps for performing an upgrade.

To perform the upgrade:

  1. Download the latest version of Connect Core from AppDelivery Marketplace.
  2. Download the latest version of the relevant connectors from AppDelivery Marketplace.
  3. Download all connector dependencies as specified in the connector Readme files. The Readme files are included in the download packages.
  4. Stop the Connect Web Server.
  5. Zip and backup the entire Connect folder as a safety measure.

  6. Launch and run the Connect installer of the new version.

  7. When complete, copy the relevant connectors with their dependencies into the AppData/Connectors folder.

  8. If you have modified utility scripts (for example the .bat or .sh files), merge the modifications into the newly installed utilities. The utilities are installed together with Connect.

    Caution: Do not copy over or merge older .jar files back into the new/upgraded install.

  9. If you have installed security certificates, copy the certificates from the backup and replace cacerts in <install path>/Connect/jre/lib.

  10. If you changed the running port or are using https/ssl, copy the server.xml file from the backup, and use it to replace server.xml in <install path>/Connect/WebServer/conf.

  11. Open the Services console and start the Connect Web Server service.

  12. We recommend running the Purge script on a regular basis. Use Windows Task Scheduler to set up a nightly run of the utility at a convenient time. For details, see Purge files on Windows as a nightly task.
  13. Log in, click the Info button, and select About. Verify that all builds and connectors match the latest version that you installed.
  14. Start up the connections, one connection at a time. Verify that each connection is running correctly before starting the next one.

Back to top

See also: