delete_component | Teradata DSA Commands - 17.20 - delete_component - BAR - Data Stream Architecture

Teradata® DSA User Guide

Data Stream Architecture
Release Number
November 2022
English (United States)
Last Update


The delete_component command deletes an existing component based on the information in the parameters.


dsc delete_component [parameters]


dsc delete_component -n system1 -t target_group -S

dsc delete_component -t target_group -r -n replication-tg-S3

dsc delete_component -t target_group -r -n replication-tg-S3 -d


n|name Name
The name of the BAR component. The name must be unique.
t|type Type
The type of BAR component. Enter one of the following:
  • system
  • media_server
  • nbu_server
  • dd_boost
  • disk_file_system
  • target_group
  • aws_app
  • azure_app
  • gcp_app
  • network_fabric
Example: target_group
Indicates the target group for deletion is a replication target group.
Deletes the replication target group and all save set files associated with it. Be very careful if you choose to use this parameter.
S|skip_prompt SkipPrompt
[Optional] Skips displaying a confirmation message before performing the command action.
u|user_authentication User
Required when security management is enabled. Supplies the command with the Viewpoint user, and triggers a password prompt for authentication.

Permissions required: Administrator role

Usage Notes

To use the delete_component command, you must specify the component name and type. You do not need to specify the component name for disk_file_system types.

You can delete a system, media server, NetBackup server, disk file system, DD Boost server, Amazon S3 storage account, Azure Blob storage account, Google Cloud Account or a target group, except under the following conditions:
  • System marked for repository backup
  • System in use by a job
  • Media server in use by a target group
  • NetBackup server in use by a target group
  • Target group in use by a job
  • Target group in use by a target group map
  • Target group in use for repository backups, unless it is a repository_replication target group
  • Policy used by a target group
Beginning with the DSA 16.10 release, nodes are autodiscovered and cannot be manually deleted.

XML File Example

This command does not support an XML file.