blob: 5678bf5f8a58c115166a9f12eb4afa29f14f4f5d [file] [log] [blame]
type=page
status=published
title=delete-cluster
next=delete-config.html
prev=delete-auth-realm.html
~~~~~~
= delete-cluster
[[delete-cluster-1]][[GSRFM00068]][[delete-cluster]]
== delete-cluster
Deletes a {productName} cluster
[[sthref609]]
=== Synopsis
[source]
----
asadmin [asadmin-options] delete-cluster [--help]
[--autohadboverride={true|false}] [--node-agent=node-agent--name]
cluster-name
----
[[sthref610]]
=== Description
The `delete-cluster` subcommand deletes a {productName} cluster.
A cluster can be deleted only if the cluster contains no {productName}
instances. If a cluster that you are deleting contains any instances,
stop and delete the instances before deleting the cluster.
If the cluster's named configuration was created automatically for the
cluster and no other clusters or unclustered instances refer to the
configuration, the configuration is deleted when the cluster is deleted.
A configuration that is created automatically for a cluster is named
cluster-name`-config`, where cluster-name is the name of the cluster.
This command is supported in remote mode only.
[[sthref611]]
=== Options
asadmin-options::
Options for the `asadmin` utility. For information about these
options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page.
`--help`::
`-?`::
Displays the help text for the subcommand.
`--autohadboverride`::
Do not specify this option. This option is retained for compatibility
with earlier releases. If you specify this option, a syntax error does
not occur. Instead, the subcommand runs successfully and displays a
warning message that the option is ignored.
`--nodeagent`::
Do not specify this option. This option is retained for compatibility
with earlier releases. If you specify this option, a syntax error does
not occur. Instead, the subcommand runs successfully and displays a
warning message that the option is ignored.
[[sthref612]]
=== Operands
cluster-name::
The name of the cluster to delete.
[[sthref613]]
=== Examples
[[GSRFM535]][[sthref614]]
==== Example 1   Deleting a {productName} Cluster
This example deletes the {productName} cluster `adccluster`.
[source]
----
asadmin> delete-cluster adccluster
Command delete-cluster executed successfully.
----
[[sthref615]]
=== Exit Status
0::
command executed successfully
1::
error in executing the command
[[sthref616]]
=== See Also
link:asadmin.html#asadmin-1m[`asadmin`(1M)]
link:create-cluster.html#create-cluster-1[`create-cluster`(1)],
link:delete-instance.html#delete-instance-1[`delete-instance`(1)],
link:delete-local-instance.html#delete-local-instance-1[`delete-local-instance`(1)],
link:list-clusters.html#list-clusters-1[`list-clusters`(1)],
link:start-cluster.html#start-cluster-1[`start-cluster`(1)],
link:stop-instance.html#stop-instance-1[`stop-instance`(1)],
link:stop-local-instance.html#stop-local-instance-1[`stop-local-instance`(1)],
link:stop-cluster.html#stop-cluster-1[`stop-cluster`(1)]