org.glassfish.loadbalancer.admin.cli.delete-http-lb-ref.1 Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of load-balancer-admin Show documentation
The newest version!
delete-http-lb-ref(1)     asadmin Utility Subcommands    delete-http-lb-ref(1)

NAME
       delete-http-lb-ref - deletes the cluster or server instance from a load
       balancer

SYNOPSIS
           delete-http-lb-ref [--help] --config config_name | --lbname load_balancer_name
           [--force=false] target

DESCRIPTION
       Use the delete-http-lb-ref subcommand to remove a reference to a
       cluster or standalone server instance from a load balancer
       configuration or load balancer. So that you do not interrupt user
       requests, make sure the standalone server instance or all server
       instances in the cluster are disabled before you remove them from the
       load balancer configuration. If the force option is set to true, the
       references are deleted even if server instances or clusters are
       enabled.

           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.

       --config
           Specifies which load balancer configuration to delete cluster and
           server instance references from.

           Specify either a load balancer configuration or a load balancer.
           Specifying both results in an error.

       --lbname
           Specifies the load balancer to delete cluster and server instance
           references from.

           Specify either a load balancer configuration or a load balancer.
           Specifying both results in an error.

       --force
           If force is set to true, then the references are deleted even if
           there are currently enabled applications or instances. The default
           is false.

OPERANDS
       target
           Specifies which cluster or instance to remove from the load
           balancer. Valid values are:

           *   cluster_name- The name of a target cluster.

           *   instance_name- The name of a target server instance.

EXAMPLES
       Example 1, Deleting a Cluster Reference from a Load Balancer
       Configuration
           This example deletes the reference to cluster named cluster2 from a
           load balancer configuration named mycluster-http-lb-config.

               asadmin> delete-http-lb-ref --config mycluster-http-lb-config cluster2

               Command delete-http-lb-ref executed successfully.

EXIT STATUS
       0
           subcommand executed successfully

       1
           error in executing the subcommand

SEE ALSO
       create-http-lb-ref(1), disable-http-lb-server(1)

       asadmin(1M)

Jakarta EE 10                         25 Aug 2010            delete-http-lb-ref(1)