Command Central 10.1 | Command Central Developer Reference | Using the Command Line Interface | Configuration Commands | sagcc delete configuration data
 
sagcc delete configuration data
Deletes a configuration instance from a specified run-time component. For example, you might want to delete a previously created port on Integration Server.
Syntax
*Command Central syntax:
sagcc delete configuration data  node_alias componentid instanceid  [options]
*Platform Manager syntax:
sagcc delete configuration data  componentid instanceid  [options]
             
 options:               
[{--debug | -d}]               
[{--error | -r} file]               
[--force]               
[{--log | -l} file]               
[{--password | -p} password]               
[{--quiet | -q}]               
[{--server | -s} url]               
[{--username | -u} user_name]
Arguments and Options
Argument or Option
Description
node_alias
Command Central only.
Required. Specifies the alias name of the installation in which the run-time component is installed.
You can view a list of installations and their aliases using sagcc list landscape nodes.
componentid
Required. Specifies the ID of the run-time component from which you want to delete a configuration instance.
You can determine the IDs for run-time components using sagcc list inventory components.
instanceid
Required. Specifies the ID of the instance you want to delete.
You can determine the IDs for configuration instances using sagcc list configuration instances.
[options]
Optional. Refer to the command syntax for a list of the options the command supports. For a description of the options, see Common Options.
Usage Notes
*You cannot delete some configuration data. In general, if you can create the configuration data, you can also usually delete it. For example, you can add a new Integration Server port, and you can also delete an Integration Server port. However, you cannot create new ports on Broker Server, and you cannot delete Broker Server ports. The command returns an error if you attempt to perform an unsupported operation.
*You can use sagcc exec configuration validation delete to determine whether it is valid to delete the configuration instance.
Example When Executing on Command Central
To delete the configuration instance with ID “COMMON-PORTS-com.softwareag.sshd.pid.properties” from the run-time component with ID “OSGI-SPM”, which is installed in the installation with alias name “sag01” using the authorization of the user with user name “Administrator” and password “manage”:
sagcc delete configuration data sag01 OSGI-SPM COMMON-PORTS-              
com.softwareag.sshd.pid.properties --username Administrator            
--password manage
Because the {--server | -s} option is not specified, the command uses the default server. For more information, see server.
Example When Executing on Platform Manager
To delete the configuration instance with ID “COMMON-PORTS-com.softwareag.sshd.pid.properties” from the run-time component that has the ID “OSGI-SPM” and is managed by the Platform Manager with host name “rubicon2” and port “8092”, and execute the command with the authorization of the user with user name “Administrator” and password “manage”:
sagcc delete configuration data OSGI-SPM COMMON-PORTS-              
com.softwareag.sshd.pid.properties --server http://rubicon2:8092/spm            
--username Administrator --password manage