Unregister Data Collector from Control Hub

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

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

Pipeline permissions, however, are not automatically reverted. To ensure that users can access pipelines, transfer pipeline permissions from the obsolete Control Hub users and groups back to Data Collector users and groups. Or, you can edit pipeline permissions individually.

You can unregister a Data Collector from the Data Collector UI, the Data Collector command line interface, or from Control Hub. For a Cloudera Manager installation, you must use both Control Hub and Cloudera Manager to unregister a Data Collector. For instructions on unregistering from Control Hub and Cloudera Manager, see the Control Hub online help.

Unregistering from Data Collector

You can unregister a Data Collector from Control Hub using the Data Collector UI.

  1. In Control Hub, stop all jobs started on the Data Collector.
  2. In Data Collector, click Administration > Disable SCH.
    The Disable SCH dialog box appears.
  3. To disable Data Collector from working with Control Hub, click Yes.
  4. Restart the Data Collector in one of the following ways:
    • If you started the Data Collector manually from the command line, click Restart Data Collector in the Disable SCH window.
    • If you started the Data Collector as a service, you must use the command line for restart. Click Cancel in the Disable SCH window, and then run the following command:
      service sdc restart
After restarting Data Collector, use your Data Collector user account to log in.

To ensure that users can access pipelines, transfer pipeline permissions from the obsolete Control Hub users and groups back to Data Collector users and groups. Or, you can edit pipeline permissions individually.

For more information about transferring permissions, see Transferring Permissions. For information about configuring individual pipeline permissions, see Sharing Pipelines.

Unregistering from the Command Line Interface

You can unregister a Data Collector from Control Hub using the Data Collector command line interface.

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

Use the command from the $SDC_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 Data Collector.

The default URL is http://localhost:18630.

-a <sdcAuthType>

or

--auth-type <sdcAuthType>
Required. Authentication type used by the Data Collector. Set to dpm.

If you omit this option, Data Collector uses the Form authentication type, which causes the disableDPM command to fail.

-D <dpmURL>

or

--dpmURL <dpmURL>

Required. Enter the appropriate URL:
  • For Control Hub cloud, use https://cloud.streamsets.com.
  • For Control Hub on-premises, use the 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, Data Collector 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 Data Collector with Control Hub:
bin/streamsets cli -U http://localhost:18630 -a dpm -D https://cloud.streamsets.com -u alison@MyOrg -p MyPassword system disableDPM

Restart the Data Collector to apply the changes.

After restarting Data Collector, use your Data Collector user account to log in.

To ensure that users can access pipelines, transfer pipeline permissions from the obsolete Control Hub users and groups back to Data Collector users and groups. Or, you can edit pipeline permissions individually.

For more information about transferring permissions, see Transferring Permissions. For information about configuring individual pipeline permissions, see Sharing Pipelines.