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.