Troubleshooting an Upgrade

Use the following tips for help with upgrades:

After upgrading a Transformer that is registered with StreamSets Control Hub, Transformer fails to start with the following error about a component ID:

Failed registration for component ID '<unique ID>'

The upgraded Transformer is using a new component ID stored in the $TRANSFORMER_DATA/sdc.id file. An upgraded Transformer that is registered with Control Hub must use the same component ID as the previous version.

This error can occur if you configured the upgraded Transformer to use a different $TRANSFORMER_DATA directory. If this is the case, copy the sdc.id file used by the previous version of Transformer into the $TRANSFORMER_DATA directory for the upgraded version of Transformer. Then, restart Transformer.

After upgrading a Transformer that is registered with Control Hub, Transformer fails to start with the following error about the authentication token:

appAuthToken cannot be NULL or empty

The upgraded Transformer is using the new version of the $TRANSFORMER_CONF/application-token.txt file. The previous version of the file includes the authentication token that this Transformer instance requires to issue authenticated requests to Control Hub. As a result, an upgraded Transformer must use the previous version of the file.

This error can occur if you configured the upgraded Transformer to use a different $TRANSFORMER_CONF directory. If this is the case, copy the application-token.txt file used by the previous version of Transformer into the $TRANSFORMER_CONF directory for the upgraded version of Transformer. Then, restart Transformer.