disable-http-lb-application
|
This subcommand has been retained from Oracle GlassFish’s original integration with external load balancers, but it has no proper integration functionality in Payara Server. Hence, it is not intended to be used in any way. The documentation in this page may not be accurate. |
Disables an application managed by a load balancer.
Synopsis
asadmin [asadmin-options] disable-http-lb-application [--help]
[--timeout 30]
--name application_name targetDescription
The disable-http-lb-application subcommand disables an application for load balancing. The disabled application goes offline for load balancing with minimal impact to users. Disabling an application gives a finer granularity of control than disabling a server instance and is most useful when a cluster is hosting multiple independent applications.
Once the application is disabled and the changes have been applied to the load balancer, new requests for the application are not forwarded to the target. Existing sessions continue to access the application until the timeout is reached. This process is known as quiescing.
If an application is deployed across multiple clusters, use this subcommand to disable it in one cluster while leaving it enabled in others.
If an application is deployed to a single server instance, use this subcommand to disable it in that instance while leaving the instance itself enabled.
Options
- asadmin-options
-
Options for the
asadminutility. For information about these options, see theasadminhelp page. --help-?-
Displays the help text for the subcommand.
--timeout-
The timeout (in minutes) to wait before disabling the specified application. This time allows for the graceful shutdown (quiescing) of the specified application. The default value is 30 minutes. The minimum value is 1 minute.
--name-
The name of the application to be disabled.
Operands
- target
-
This operand specifies the server instance or cluster on which to disable the application. Valid values are:
-
cluster_name - The name of a target cluster.
-
instance_name - The name of a target server instance.
-
Examples
Example 1 Disabling an Application for Load Balancing
This example, disables an application for load balancing
asadmin> disable-http-lb-application --name webapps-simple mycluster
Command disable-http-lb-application executed successfully.