| disable-http-lb-server(1) asadmin Utility Subcommands disable-http-lb-server(1) |
| |
| NAME |
| disable-http-lb-server - disables a sever or cluster managed by a load |
| balancer |
| |
| SYNOPSIS |
| disable-http-lb-server [--help] [--timeout 30] |
| target |
| |
| DESCRIPTION |
| The disable-http-lb-server subcommand disables a standalone server or |
| cluster of servers for load balancing. The disabled server instance or |
| cluster goes offline for load balancing with a minimum impact to users. |
| |
| Once the target has been disabled and the changes have been applied to |
| the load balancer, the load balancer stops assigning new requests to |
| the target. Session requests with sessions created before disabling the |
| target continue to be assigned to that target until the timeout is |
| reached. This process is known as quiescing. |
| |
| Changes are applied the load balancer automatically. You can also |
| manually export the configuration using export-http-lb-config and copy |
| it to the load balancer. |
| |
| Note |
| +----------------------------------------+ |
| | This subcommand is only | |
| | applicable to Oracle | |
| | GlassFish Server. This | |
| | subcommand is not applicable | |
| | to GlassFish Server Open | |
| | Source Edition. | |
| +----------------------------------------+ |
| |
| OPTIONS |
| --help, -? |
| Displays the help text for the subcommand. |
| |
| --timeout |
| The timeout (in minutes) to wait before disabling the specified |
| target. This time allows for the graceful shutdown (quiescing) of |
| the specified target. The default value is 30 minutes. The minimum |
| value is 1 minute. |
| |
| OPERANDS |
| target |
| This operand specifies which server instances and clusters to |
| disable. Valid values are: |
| |
| * cluster_name- The name of a target cluster. |
| |
| * instance_name- The name of a target server instance. |
| |
| EXAMPLES |
| Example 1, Disabling a Cluster for Load Balancing |
| This example disables load balancing for a cluster named mycluster. |
| |
| asadmin> disable-http-lb-server mycluster |
| |
| Command disable-http-lb-server executed successfully. |
| |
| EXIT STATUS |
| 0 |
| subcommand executed successfully |
| |
| 1 |
| error in executing the subcommand |
| |
| SEE ALSO |
| create-http-lb-ref(1), enable-http-lb-server(1) |
| |
| asadmin(1M) |
| |
| Java EE 8 09 Aug 2017 disable-http-lb-server(1) |