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 Control Hub

When you unregister Transformer from Control Hub, Control Hub deactivates the authentication token. Then, you modify Transformer configuration files to remove the token from the Transformer and to disable communication with Control Hub.

In Control Hub, stop all jobs running on the Transformer.
Log in to the Transformer, and shut it down.
In Control Hub, click Execute > Transformers in the Navigation panel.
Hover over the Transformer that you shut down, and then click the Delete icon.
In the confirmation dialog box, click Delete and Unregister.
On the machine where the Transformer is installed, open the $TRANSFORMER_CONF/application-token.txt file, and remove the authentication token from the file.
Open the $TRANSFORMER_CONF/dpm.properties file for the Transformer, and set the dpm.enabled property to false.

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.