.\" ha_peer.4: auto-generated, DO NOT EDIT
.\"
.\" Copyright 2009-2014. Quantum Corporation. All Rights Reserved.
.\" StorNext is either a trademark or registered trademark of
.\" Quantum Corporation in the US and/or other countries.
.\"
.\" Code start macro
.de Cs
.sp
.ft C
.in +0.3i
.nf
..
.\" Code end macro
.de Ce
.fi
.in -0.3i
.ft R
..
.TH HA_PEER 4 "December 2014" "Xsan File System"
.SH NAME
ha_peer \- Xsan HA Peer Server IP Address
.SH SYNOPSIS
.na
.nh
.HP
.B /Library/Preferences/Xsan/ha_peer
.ad
.hy
.SH DESCRIPTION
The Xsan File System
\fI/Library/Preferences/Xsan/ha_peer\fR file
provides the IP address of the peer server in an Xsan
High Availability (HA) cluster configuration to the
\fIsnhamgr_daemon\fR and \fIfsmpm\fR processes.
It must be configured on both servers.
The \fBha_peer\fR file may also be used to change the default IP port
(5189) used by the \fIsnhamgr_daemon\fR and \fIsnhamgr\fR processes.
.PP
The \fBha_peer\fR IP address allows the fsmpm processes to negotiate
the restarting of HA Timers to avoid unnecessary HA Reset incidents when
metadata writes are delayed by heavy disk activity, and to detect misconfigured
\fI/Library/Preferences/Xsan/ha_smith_interval\fR HA Timer override values.
For HA clusters with an \fIHaShared\fR file system,
the address also allows communication between the \fIsnhamgr_daemon\fR processes
running on the metadata controllers to collect operational status for the
\fIsnhamgr\fR command.
.SH SYNTAX
Any entry that does not begin with # is
assumed to be the peer IP address and optional port number.
The address should be in IPv4 or IPv6 numerical format.
The address and port entries are specified as follows:
.Cs
<address>
.Ce
or
.Cs
<address>:<port>
.Ce
.PP
For IPv6, enclose the address portion in square brackets if
also specifying a port.
.SH EXAMPLE
To set the peer address, the
\fBha_peer\fR file would contain the following line:
.Cs
192.168.10.1
.Ce
.PP
To set the peer address and port, the
\fBha_peer\fR file would contain the following line:
.Cs
192.168.10.1:8888
.Ce
.PP
To set an IPv6 address or address and port, the following lines
could be specified:
.Cs
fe80::250:56ff:fe9b:74b8
.Ce
.PP
or
.Cs
[fe80::250:56ff:fe9b:74b8]:4600
.Ce
.PP
.SH FILES
.I /Library/Preferences/Xsan/ha_peer
.SH "SEE ALSO"
.BR snhamgr (8),
.BR fsmpm (8),
\fIQuantum StorNext User's Guide\fR