Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 1 | type=page |
| 2 | status=published |
| 3 | title=delete-http-lb-ref |
| 4 | next=delete-http-listener.html |
| 5 | prev=delete-http-lb-config.html |
| 6 | ~~~~~~ |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 7 | |
David Matějček | dbccabf | 2021-12-20 14:06:31 +0100 | [diff] [blame] | 8 | = delete-http-lb-ref |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 9 | |
| 10 | [[delete-http-lb-ref-1]][[GSRFM00081]][[delete-http-lb-ref]] |
| 11 | |
David Matějček | dbccabf | 2021-12-20 14:06:31 +0100 | [diff] [blame] | 12 | == delete-http-lb-ref |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 13 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 14 | Deletes the cluster or server instance from a load balancer |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 15 | |
| 16 | [[sthref723]] |
| 17 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 18 | === Synopsis |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 19 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 20 | [source] |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 21 | ---- |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 22 | asadmin [asadmin-options] delete-http-lb-ref [--help] |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 23 | --config config_name | --lbname load_balancer_name |
| 24 | [--force=false] target |
| 25 | ---- |
| 26 | |
| 27 | [[sthref724]] |
| 28 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 29 | === Description |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 30 | |
| 31 | Use the `delete-http-lb-ref` subcommand to remove a reference to a |
| 32 | cluster or standalone server instance from a load balancer configuration |
| 33 | or load balancer. So that you do not interrupt user requests, make sure |
| 34 | the standalone server instance or all server instances in the cluster |
| 35 | are disabled before you remove them from the load balancer |
| 36 | configuration. If the `force` option is set to true, the references are |
| 37 | deleted even if server instances or clusters are enabled. |
| 38 | |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 39 | [NOTE] |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 40 | ==== |
David Matějček | 6c58c14 | 2021-12-20 20:22:31 +0100 | [diff] [blame] | 41 | This subcommand is only applicable to {productName}. This |
| 42 | subcommand is not applicable to {productName}. |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 43 | ==== |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 44 | |
| 45 | [[sthref725]] |
| 46 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 47 | === Options |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 48 | |
| 49 | asadmin-options:: |
| 50 | Options for the `asadmin` utility. For information about these |
| 51 | options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page. |
| 52 | `--help`:: |
| 53 | `-?`:: |
| 54 | Displays the help text for the subcommand. |
| 55 | `--config`:: |
| 56 | Specifies which load balancer configuration to delete cluster and |
| 57 | server instance references from. + |
| 58 | Specify either a load balancer configuration or a load balancer. |
| 59 | Specifying both results in an error. |
| 60 | `--lbname`:: |
| 61 | Specifies the load balancer to delete cluster and server instance |
| 62 | references from. + |
| 63 | Specify either a load balancer configuration or a load balancer. |
| 64 | Specifying both results in an error. |
| 65 | `--force`:: |
| 66 | If `force` is set to true, then the references are deleted even if |
| 67 | there are currently enabled applications or instances. The default is |
| 68 | false. |
| 69 | |
| 70 | [[sthref726]] |
| 71 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 72 | === Operands |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 73 | |
| 74 | target:: |
| 75 | Specifies which cluster or instance to remove from the load balancer. |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 76 | Valid values are: |
| 77 | |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 78 | * cluster_name- The name of a target cluster. |
| 79 | * instance_name- The name of a target server instance. |
| 80 | |
| 81 | [[sthref727]] |
| 82 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 83 | === Examples |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 84 | |
| 85 | [[GSRFM550]][[sthref728]] |
| 86 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 87 | ==== Example 1 Deleting a Cluster Reference from a Load Balancer |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 88 | Configuration |
| 89 | |
| 90 | This example deletes the reference to cluster named `cluster2` from a |
| 91 | load balancer configuration named `mycluster-http-lb-config`. |
| 92 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 93 | [source] |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 94 | ---- |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 95 | asadmin> delete-http-lb-ref --config mycluster-http-lb-config cluster2 |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 96 | |
| 97 | Command delete-http-lb-ref executed successfully. |
| 98 | ---- |
| 99 | |
| 100 | [[sthref729]] |
| 101 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 102 | === Exit Status |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 103 | |
| 104 | 0:: |
| 105 | subcommand executed successfully |
| 106 | 1:: |
| 107 | error in executing the subcommand |
| 108 | |
| 109 | [[sthref730]] |
| 110 | |
David Matějček | 17fd461 | 2021-12-18 21:14:28 +0100 | [diff] [blame] | 111 | === See Also |
Vinay Vishal | 7c4c4fc | 2019-01-28 12:01:04 +0530 | [diff] [blame] | 112 | |
| 113 | link:asadmin.html#asadmin-1m[`asadmin`(1M)] |
| 114 | |
| 115 | link:create-http-lb-ref.html#create-http-lb-ref-1[`create-http-lb-ref`(1)], |
| 116 | link:disable-http-lb-server.html#disable-http-lb-server-1[`disable-http-lb-server`(1)] |
| 117 | |
| 118 | |