2.8.2 delete-application-ref
Removes the reference to an application.
Synopsis
asadmin [asadmin-options] delete-application-ref [--help] [--target target] [--cascade={true|false}] reference_name
Storage location
Application Server installation directory/javaee/glassfish/bin
Function
The delete-application-ref subcommand removes a reference from a cluster or a nonclustered server instance to an application. This effectively results in the application element being removed and no longer available on the targeted instance or the cluster. The target instance or instances making up the cluster need not be running or available for this subcommand to succeed. If one or more instances are not available, they will no longer load the application the next time they start. Removal of the reference does not result in removal of the application from the domain. The bits are removed only by the undeploy subcommand. 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.
- --target target
-
Specifies the target from which you are removing the application reference.
Type: String
The following values can be specified:
-
server
Specifies the default server instance as the target. The server is the name of the default server instance and is the default value.
-
cluster-name
Specifies a certain cluster as the target.
-
instance_name
Specifies a certain stand-alone server instance as the target.
Default value: server
-
- --cascade={false|true}
-
Indicates whether the resources dependent on the module should also be recursively deleted for a connector module.
Type: Boolean
The following values can be specified:
-
true
-
false
Default value: false
-
- reference_name
-
Specifies the name of the application or module that can be one of the following:
-
Java EE application module
-
Web module
-
EJB module
-
Connector module
-
Application client module
-
Lifecycle module
Type: String
The following values can be specified:
-
Name of the application or module
Default value: N/A
-
Examples
The following example removes a reference to the Web module MyWebApp from the nonclustered server instance NewServer.
asadmin delete-application-ref --target NewServer MyWebApp
Exit Status
Exit Status |
Explanation |
---|---|
0 |
command executed successfully. |
1 |
error in executing the command. |