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 Transformer UI, 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.

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

After restarting Transformer, use your Transformer user account to log in.

Unregistering from Transformer

For a Transformer tarball installation, you can unregister Transformer from Control Hub using the Transformer UI.

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

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

  1. In Control Hub, stop all jobs running on the Transformer.
  2. Log in to the Transformer and click Administration > Disable Control Hub.
    The Disable Control Hub Confirmation dialog box appears.
  3. To disable Transformer from working with Control Hub, click Yes.
  4. Restart Transformer.

After restarting Transformer, use your Transformer user account to log in.

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.

After restarting Transformer, use your Transformer user account to log in.