Use the following
tips for help with upgrades:
- After upgrading a Data Collector that is registered with StreamSets Control Hub, the Data Collector fails to start with the following error about a component ID:
-
Failed registration for component ID '<unique ID>'
- The upgraded Data Collector is using a new component ID stored in the
$SDC_DATA/sdc.id
file. An upgraded Data Collector that is registered with Control Hub must use the same component ID as the previous version.
- Verify that the
$SDC_DATA directory that the upgraded Data Collector is using includes the previous sdc.id file. Then, restart
Data Collector.
- After upgrading a Data Collector that is registered with Control Hub, the Data Collector fails to start with the following error about the authentication token:
-
appAuthToken cannot be NULL or empty
- The upgraded Data Collector is using the new version of the
$SDC_CONF/application-token.txt file. The previous version
of the file includes the authentication token that this Data Collector instance requires to issue authenticated requests to Control Hub. As a result, an upgraded Data Collector must use the previous version of the file.
- Verify that the
$SDC_CONF directory that the upgraded Data Collector is using includes the previous application-token.txt file.
Then, restart Data Collector.