fsnameservers(4) fsnameservers(4)
NAME
fsnameservers - Xsan File System Name Server List
SYNOPSIS
/Library/Preferences/Xsan/fsnameservers
DESCRIPTION
The Xsan File System fsnameservers file describes to the fsmpm(8) dae-
mon which machines are serving as File System Name Server coordina-
tor(s). The volume name coordinators are a critical component of the
Xsan File System Services (FSS). One of the principal functions of the
coordinator is to manage failover voting in a high availability config-
uration. Therefore it is crucial to choose highly reliable systems as
the coordinators. Redundancy is provided by listing multiple entries in
fsnameservers, one entry per line. The first host in the list is the
primary coordinator and any subsequent entries are backup coordinators.
It is recommended to list two systems to utilize this redundancy bene-
fit. Typically the systems chosen are also configured for the File Sys-
tem Manager (FSM) services as well. However, this is not required.
If fsnameservers does not exist then the system will operate as a
"local" filesystem requiring both client and server. It will not commu-
nicate with any other Xsan product on the network. This may be desired
when no SAN sharing is required.
The fsnameservers file is also used to specify the dedicated metadata
network(s) used for Xsan. That is, if an address in the fsnameservers
file is on IP network x, then IP network x will be used to carry Xsan
metadata traffic. Multiple, redundant metadata networks can be created
by using additional network interfaces on every system; each coordina-
tor is then specified in fsnameservers multiple times, once for each of
its metadata-network addresses.
It is extremely important that all copies of fsnameservers in a SAN
are identical. A stale configuration on a system not even in use can
cause election problems if fsmpm processes are running with mismatched
fsnameservers.
It is also crucial to ensure that complete network connectivity exists
between all systems running Xsan whether client or server. This is
important because all Xsan systems participate in failover voting so
any connectivity gaps will cause erroneous elections.
After you put the IP addresses of two reliable machines on your network
in your fsnameservers, copy fsnameservers to every machine running
Xsan. Always reboot or stop and restart Xsan after changing fsname-
servers.
SYNTAX
The format for the fsnameservers is simple. It contains the name of the
IP address or hostname to use as either a primary or a secondary coor-
dinator. The use of IP addresses is preferred to avoid problems associ-
ated with lookup system (eg., DNS or NIS) failures. The format of an
fsnameservers line is:
<IP address>
or
<HostName>
Where HostName is a host name or IP address of a host that can coordi-
nate queries and failover votes for the File System Services.
Lines that contain white space only or that contain the comment token
as the first non-white space character are ignored.
FILES
/Library/Preferences/Xsan/fsnameservers
SEE ALSO
cvfs(1), snfs_config(5), fsm(8), fsmpm(8), mount_acfs(1)
Xsan File System May 2006 fsnameservers(4)
Mac OS X 10.9.1 - Generated Fri Jan 10 16:55:33 CST 2014