2.6.10 delete-instance

Synopsis

asadmin [asadmin-options] delete-instance [--help] instance-name

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The delete-instance subcommand deletes a server instance.

This subcommand requires the secure shell (SSH) protocol to be configured on the host where the domain administration server (DAS) is running and on the host that is represented by the node where the instance resides. However, if the instance to be deleted is configured on a config-type node, you do not need to specify SSH.

You may run this subcommand from any host that can contact the DAS.

The subcommand can delete any server instance, regardless of how the instance was created.

The instance that is being deleted must not be running. Otherwise, an error occurs.

The subcommand deletes an instance by performing the following actions:

• Removing the instance from the configuration of the domain administration server (DAS)

• Deleting the instance's files from file system

If the instance that is being deleted is the only instance that is using the node directory, that directory is also removed.

If a standalone instance is deleted, the instance's standalone configuration is also deleted. A standalone instance refers to a configuration that is named instance-name-config to which no other clusters or unclustered instances refer.

This subcommand is supported in remote mode only

Precondition

DAS has to be in a running state.

Arguments

--help | -?

Displays the help text for the subcommand.

instance-name

Specifies the name of the instance.

Type: String

The following values can be specified:

• Name of the instance

Default value: N/A

asadmin delete-instance pmdsainst

Exit Status

Exit Status	Explanation
0	command executed successfully.
1	error in executing the command.