sys failover
sys failover(1) BIG-IP TMSH Manual sys failover(1)
NAME
failover - Configures failover for a BIG-IP(r) unit in a redundant
system configuration.
MODULE
sys
SYNTAX
Change the failover state within the sys module using the syntax in the
following section.
MODIFY
run failover
options:
device [string]
no-persist
offline
online
persist
standby
traffic-group [[string] | default | non-default | none]
DISPLAY
show failover
options:
cable
DESCRIPTION
Failover is the process where a standby unit in a redundant system
configuration takes over when a software or hardware failure is
detected on the active unit.
EXAMPLES
run failover standby
Causes the active unit or cluster to go into the standby state forcing
the other unit or cluster in the redundant system configuration to
become active.
run failover offline
Causes the active unit or cluster to go into the Forced Offline state.
run failover online
Changes the status of a unit or cluster from Forced Offline to either
Active or Standby, depending upon the status of the other unit or
cluster in a redundant system configuration.
show failover
Displays the failover state of the BIG-IP system (active, standby,
offline, forced_offline) and how long it has been in that state.
run failover standby device my_bigip
Specifies that the my_bigip device should become the active device for
all traffic groups currently active on this device.
run failover standby traffic-group traffic_grp01
Specifies that the traffic group named traffic_grp01 should fail over
to the Standby state. The traffic group will then become Active on
another device.
run sys failover offline no-persist
Changes the status of a unit to Forced Offline and indicates that the
change will not be persisted after a system restart.
run sys failover offline persist
Changes the status of a unit to Forced Offline and indicates that the
change will be persisted after a system restart.
OPTIONS
Use these options to control failover of the system:
device
Specifies the device that should next become the active device for
the specified traffic group or all traffic groups (if a traffic
group is not specified). This option may only be specified with
the standby option.
no-persist
Does not persist the change in status of a unit. The option is
valid only with the offline state.
offline
Changes the status of a unit or cluster to Forced Offline. If
persist or no-persist options are not specified, the default
action is to persist the offline status of the unit between system
restarts.
online
Changes the status of a unit or cluster from Forced Offline to
either Active or Standby, depending upon the status of the other
unit or cluster in a redundant system configuration.
persist
Persists the change in status of a unit. The option is valid only
with the offline state.
standby
Specifies that the active unit or cluster fails over to a Standby
state, causing the standby unit or cluster to become Active.
traffic-group
Specifies the traffic-group that should fail over to the Standby
state, the traffic-group will become Active on another device.
This option may only be specified with the standby option.
Use this option to display the failover cable status of the system:
cable
Displays the status that the failover daemon detects on the serial
cable from its failover peer. It also shows what the failover peer
detects on the serial cable. An active BIG-IP system will see a
zero from its failover peer. A standby BIG-IP system will see a
one from its failover peer.
SEE ALSO
run, tmsh
COPYRIGHT
No part of this program may be reproduced or transmitted in any form or
by any means, electronic or mechanical, including photocopying,
recording, or information storage and retrieval systems, for any
purpose other than the purchaser's personal use, without the express
written permission of F5 Networks, Inc.
F5 Networks and BIG-IP (c) Copyright 2009-2013, 2016. All rights
reserved.
BIG-IP 2017-03-13 sys failover(1)