Upgrading Connect

Version 22.0.8486


Upgrading Connect


CData is always making improvements to our products. It is always recommended that you run the latest version of CData Connect to maximize performance, stability and compatibility with online services. This page outlines the best ways to update CData Connect based on your configuration.

Upgrading the Embedded Application or Service

If you run CData Connect using the embedded application or as a service, follow these steps to upgrade:

  1. Stop the CData Connect application or service (see Starting the Server for more information).

  2. Download the latest version of CData Connect.

  3. Install the application.

    • For Windows, run the step file and install it to the existing directory.

    • For Linux, follow these steps to preserve your settings and drivers:

      1. Extract the archive to a temporary directory. To do this, you can use this terminal command: tar -zxvf CDataConnect.tar.gz -C Connect_temp/

      2. Copy Connect_temp/connect.jar to the base folder of your Connect installation directory and overwrite the existing file.

      3. Copy Connect_temp/webapp/connect.war to the webapp folder of your Connect installation directory and overwrite the existing file.

  4. Start the application or service.

Upgrading the Java Connectors

In addition to the Connect application, CData regularly makes improvements to the underlying connectors.

Updating to the Latest Official Version

CData releases updates to connectors on a quarterly basis. To upgrade to the latest official release of a specific connector:

  1. In the CData Connect admin console, open the Data Model page.

  2. Select the Connections tab, and then click Add More.

  3. Select the connector you wish to upgrade and click Download & Install.

  4. Restart the Connect service for the update to take effect.

Updating to a Custom Driver Version

Sometimes, CData makes improvements to connectors between official quarterly releases. If one of your connectors receives such an update, CData may provide you with custom version of the driver. To update a driver to a custom version, follow these steps:

  1. Download the driver file.

  2. Launch the CData Connect admin console and open the Data Model page.

  3. In the Available Sources section, click Add More.

  4. Select your data source in the list.

  5. Click the drop-down arrow next to Download & Install and select Browse.

  6. In the file upload dialogue, select the custom driver file and click Upload.

  7. When the upload finishes, restart the Connect service.