blob: 1bbe4f993c2985c8b201293703c19bc79d68982e [file] [log] [blame]
type=page
status=published
title=disable-http-lb-server
next=disable-monitoring.html
prev=disable-http-lb-application.html
~~~~~~
= disable-http-lb-server
[[disable-http-lb-server-1]][[GSRFM00119]][[disable-http-lb-server]]
== disable-http-lb-server
Disables a sever or cluster managed by a load balancer
[[sthref1055]]
=== Synopsis
[source]
----
asadmin [asadmin-options] disable-http-lb-server [--help]
[--timeout 30]
target
----
[[sthref1056]]
=== 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 {productName}. This
subcommand is not applicable to {productName}.
====
[[sthref1057]]
=== Options
asadmin-options::
Options for the `asadmin` utility. For information about these
options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page.
`--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.
[[sthref1058]]
=== 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.
[[sthref1059]]
=== Examples
[[GSRFM593]][[sthref1060]]
==== Example 1   Disabling a Cluster for Load Balancing
This example disables load balancing for a cluster named `mycluster`.
[source]
----
asadmin> disable-http-lb-server mycluster
Command disable-http-lb-server executed successfully.
----
[[sthref1061]]
=== Exit Status
0::
subcommand executed successfully
1::
error in executing the subcommand
[[sthref1062]]
=== See Also
link:asadmin.html#asadmin-1m[`asadmin`(1M)]
link:create-http-lb-ref.html#create-http-lb-ref-1[`create-http-lb-ref`(1)],
link:enable-http-lb-server.html#enable-http-lb-server-1[`enable-http-lb-server`(1)]