delete-failover-group

Syntax

tadm delete-failover-group common_options --config=config_name [--force] --virtual-ip=VIP

Description

Use this command to delete a failover group. To change the VIP or any property of a failover group, you should delete the failover group and create it afresh.

When deleting a failover group, if the administration node process is running as non-root on the node where the instances are located and if at least one failover group is still available, then you must run start-failover on those nodes as a root user. This is to manually restart the failover. On the other hand, after deleting a failover group, if no other failover groups are available for the corresponding instances, then stop-failover must be executed to stop the failover. If you do not execute either start-failover or stop-failover, then the VIP associated with the deleted failover group will continue to be available.

Options

For information about common_options, run the help command.

--config|-c

Specify the configuration for which you want to delete a failover group.

--virtual-ip|-i

Specify the virtual IP address of the failover group that you want to delete.

force|-f

Specify this option to delete the failover group even if the nodes are offline.

Example

tadm delete-failover-group --config=soa --virtual-ip=10.228.12.250
tadm start-failover --user=admin 
--password-file=./admin.passwd --host=admin.example.com --port=8989 
--no-prompt --config=soa --instance-home=/home/otd
tadm stop-failover --user=admin 
--password-file=./admin.passwd --host=admin.example.com --port=8989 
--no-prompt --config=www.example.org --instance-home=/home/otd

Exit Codes

The following exit values are returned:

0: command executed successfully

>0: error in executing the command

For more information about exit codes and syntax notations, run the help command.

See Also

help, create-failover-group, list-failover-groups, set-failover-group-primary, get-failover-group-prop, start-failover, stop-failover