Pre Upgrade Tasks

The minimum requirements for Data Collector can change with each version. Before you upgrade to a new Data Collector version, verify that the machine meets the latest minimum requirements as described in Installation Requirements.

If you use Data Collector with Control Hub On-premises, you must complete a prerequisite task before you upgrade to Data Collector version 4.0.x or later.

For details, see the StreamSets Support portal.

Starting with version 3.19.0, the full and core tarball installation methods are available only to users with an enterprise account.

If you have an enterprise account, you can download the full or core installation packages from the StreamSets Support portal. After you perform the upgrade, you can install or remove stage libraries as needed.

If you do not have an enterprise account, go to the StreamSets website to upgrade from a full or core installation.

Previous versions of Data Collector supported Java 8 in addition to Java 11 and Java 17. Starting with version 6.0, Data Collector supports only Java 11 and Java 17. For more information, see Java Versions and Available Features.

To migrate to Java 11 or 17, complete the following steps before upgrading to Data Collector 6.0 or later:

1. Shut down Data Collector.
2. Install Java 11 or 17 on the Data Collector machine.
3. Restart Data Collector and verify that it works as expected.
4. If any pipelines include the JavaScript Evaluator processor, open the pipelines and validate the scripts on the new Java version.