delete-instance

deletes a GlassFish Server instance

Synopsis

delete-instance [--help] instance-name 

Description

The delete-instance subcommand deletes a GlassFish Server instance. This subcommand requires the Distributed Component Object Model (DCOM) remote protocol or secure shell (SSH) 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.

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

The subcommand can delete any GlassFish Server instance, regardless of how the instance was created. For example, this subcommand can delete an instance that was created by using the create-local-instance(1) subcommand.

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.

Options

--help

-?

Displays the help text for the subcommand.

Operands

instance-name

The name of the instance to delete.

Examples

Example 1   Deleting a GlassFish Server Instance

This example deletes the GlassFish Server instance pmdsainst.

asadmin> delete-instance pmdsainst

Command delete-instance executed successfully.

Exit Status

0

command executed successfully

1

error in executing the command

See Also

create-instance(1), create-local-instance(1), delete-local-instance(1), setup-ssh(1), start-instance(1), start-local-instance(1), stop-instance(1), stop-local-instance(1), validate-dcom(1)

asadmin(1M)