'\" t
.\"     Title: hb_standby
.\"    Author: Alan Robertson <alanr@unix.sh>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: November 26, 2009
.\"    Manual: General commands
.\"    Source: Heartbeat 3.0.6
.\"  Language: English
.\"
.TH "HB_STANDBY" "1" "November 26, 2009" "Heartbeat 3.0.6" "General commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
hb_standby \- issues a failover request to the cluster manager
.SH "SYNOPSIS"
.PP
\fBhb_standby\fR
[all|foreign|local|failback]
.SH "DESCRIPTION"
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBWarning\fR
.ps -1
.br
.PP
This command is deprecated\&. It is only suitable for legacy Heartbeat clusters without Pacemaker enabled\&. In Pacemaker\-enabled clusters, the
\fBcrm\fR(8)
shell supports switching individual nodes into standby mode, and replaces
\fBhb_standby\fR\&.
.sp .5v
.RE
.PP
\fB/usr/share/heartbeat/hb_standby\fR
issues a request to the cluster to move resources from the node where it is invoked, to the other node (if it is currently available)\&. The meaning of the options is relative\&. This manual assumes the following configuration to be present in
/etc/ha\&.d/haresources:
.sp
.if n \{\
.RS 4
.\}
.nf
alice drbddisk::r0 Filesystem::/dev/drbd0::/local/groups::ext3 10\&.0\&.0\&.1 smb
bob drbddisk::r1 Filesystem::/dev/drbd1::/local/ldap::ext3 10\&.0\&.0\&.2 ldap
.fi
.if n \{\
.RE
.\}
.SH "OPTIONS"
.PP
The following options are supported:
.PP
local
.RS 4
Migrates any resources that the local node
\fIis\fR
the preferred node for\&.
.sp
When invoked on
alice, Samba would be shut down, the IP address 10\&.0\&.0\&.1 would be released,
/local/groups
would be unmounted,
/dev/drbd0
would be placed into the secondary role and
bob
would take all these services over\&.
.sp
When run on
bob, OpenLDAP would shut down, 10\&.0\&.0\&.2 would be released,
/local/ldap
would be unmounted,
/dev/drbd1
would be placed into the Secondary role and
alice
would take over all these services\&.
.RE
.PP
foreign|failback
.RS 4
Migrates any resources that the local node
\fIis not\fR
the preferred node for\&.
.sp
When run on
alice, OpenLDAP would shut down, 10\&.0\&.0\&.2 would be released,
/local/ldap
would be unmounted,
/dev/drbd1
would be placed into the Secondary role and
bob
would take over all these services\&.
.sp
When invoked on
bob, Samba would be shut down, the IP address 10\&.0\&.0\&.1 would be released,
/local/groups
would be unmounted,
/dev/drbd0
would be placed into the secondary role and
alice
would take all these services over\&.
.RE
.PP
all
.RS 4
Migrates all resources to the other node\&.
.RE
.PP
Invoking
\fBhb_standby\fR
without any options is identical to
\fBhb_standby\fR\ \&all\&.
.SH "CAVEATS"
.PP
\fBhb_standby\fR
is only usable in R1\-style configurations (i\&.e\&., those configured using the
haresources
file)\&.
.SH "SEE ALSO"
.PP
\fBhb_takeover\fR(1),
\fBheartbeat\fR(8),
\fBcl_status\fR(1)
.SH "AUTHORS"
.PP
\fBAlan Robertson\fR <\&alanr@unix\&.sh\&>
.RS 4
hb_standby
.RE
.PP
\fBGuochun Shi\fR <\&gshi@ncsa\&.uiuc\&.edu\&>
.RS 4
man page
.RE
.PP
\fBFlorian Haas\fR <\&florian\&.haas@linbit\&.com\&>
.RS 4
man page
.RE