Unregister Transformer

You can unregister a Transformer from Control Hub when you no longer want to use that Transformer installation with Control Hub.

When you restart an unregistered Transformer, previously-configured Transformer user accounts become immediately available unless changed in the interim. Use your Transformer user account to log in.

The method you use to unregister Transformer depends on the Transformer installation type:

Tarball installation: You can unregister Transformer from the command line interface or from Control Hub.
RPM installation: You must unregister Transformer from Control Hub.

Unregistering from the Command Line Interface

For a Transformer tarball installation, you can unregister Transformer from Control Hub using the Transformer command line interface.

Note: For a Transformer RPM installation, you must use Control Hub to unregister Transformer.

When you unregister from the command line interface, Transformer deactivates the authentication token and modifies the configuration files for you.

Start Transformer, and then use the system disableDPM command to unregister the Transformer.

Use the command from the $TRANSFORMER_DIST directory as follows:

bin/streamsets cli \
(-U <sdcURL> | --url <sdcURL>) \
[(-a <sdcAuthType> | --auth-type <sdcAuthType>)] \
[(-D <dpmURL> | --dpmURL <dpmURL>)] \ 
[(-u <sdcUser> | --user <sdcUser>)] \
[(-p <sdcPassword> | --password <sdcPassword>)] \
system disableDPM

When using the system disableDPM command, the following basic options are required:


Basic Option	Description
-U <sdcURL> or --url <sdcURL>	Required. URL of the Transformer. The default URL is `http://localhost:19630`.
-a <sdcAuthType> or --auth-type <sdcAuthType>	Required. Authentication type used by the Transformer. Set to `dpm`. If you omit this option, Transformer uses the Form authentication type, which causes the disableDPM command to fail.
-D <dpmURL> or --dpmURL <dpmURL>	Required. URL to access Control Hub: For Control Hub cloud, set to `https://cloud.streamsets.com`. For Control Hub on-premises, set to the Control Hub URL provided by your system administrator. For example, `https://<hostname>:18631`.
-u <sdcUser> or --user <sdcUser>	Required. Enter your Control Hub user ID using the following format: `<ID>@<organization ID>` If you omit this option, Transformer uses the `admin` user account, which causes the disableDPM command to fail.
-p <sdcPassword> or --password <sdcPassword>	Required. Enter the password for your Control Hub user account.

For example, the following command unregisters a Transformer with Control Hub:

bin/streamsets cli -U http://localhost:19630 -a dpm -D https://cloud.streamsets.com -u alison@MyOrg -p MyPassword system disableDPM

Restart Transformer to apply the changes.