2.8.4 disable

Synopsis

asadmin [asadmin-options] disable [--help]
    [--target target] component_name

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The disable subcommand immediately disables the specified deployed component. If the component has not been deployed, an error message is returned.

This command communicates with servers to disable the components remotely.

The timeout can be set using the AS_ADMIN_READ_TIMEOUT parameter available in the asenv file.

This subcommand is supported in remote mode only.

Precondition

Domain Administration Server (DAS) is running.

Arguments

--help | -?

Displays the help text for the subcommand.

--target target

Specifies the target on which you are disabling the component.

Type: String

The following values can be specified:

• server

  Disables the component on the default server instance server and is the default value.

• domain_name

  Disables the component on the named domain.

• cluster_name

  Disables the component on every server instance in the cluster.

• instance_name

  Disables the component on a particular clustered or stand-alone server instance.

Default value: server

component_name

Specifies the name of the component to be disabled.

Type: String

The following values can be specified:

• Name of the component

Default value: N/A

asadmin disable --target instance1 sampleApp

Exit Status

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

Notes

Removing a component can release the instance from the memory. However, if the component is disabled (by running the disable command), the instance is not released. Note that when many components are disabled, memory in use increases and OutOfMemoryError may occur.