.\" fsmlist.4: auto-generated, DO NOT EDIT
.\"
.\" Copyright 1998-2019. 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 FSMLIST 4 "January 2019" "Xsan File System"
.SH NAME
fsmlist \- Xsan File System FSM Auto-Start List 
.SH SYNOPSIS
.na
.nh
.HP
.B /Library/Preferences/Xsan/fsmlist
.ad
.hy
.SH DESCRIPTION
The \fIXsan File System\fR
\fBfsmlist\fR file 
defines for the
.BR fsmpm (8)
daemon the \fIFile System Manager\fR 
(\fIFSM\fR) daemons to start.
When the file does not exist,
the \fBfsmpm\fR will not start any \fIFSM\fR daemons.
.SH SYNTAX
The format for the \fBfsmlist\fR is simple.
On each line is the name of one local volume to start,
and an optional priority number from zero (0) to nine (9).
The name must not include cluster-naming information.
.PP
The optional priority number
is used when there is a redundant metadata controller (MDC).
A priority of zero makes the specified
\fIFSM\fR top priority and any number greater than zero means lower priority.
See
.BR cvfs_failover (8)
for details about setting up a failover-capable
file system service.
.PP
The format of an \fBfsmlist\fR line has the following format:
.IP
.IR File_System_Name \ [ priority ]
.PP
\fIFile_System_Name\fR is the public name of the volume
used in the
.BR mount (8)
command,
and as the prefix for the configuration file (see
.BR snfs_config (5)).
.PP
The \fIpriority\fR field is used to designate a priority when there are 
redundant \fBfsm\fR daemons for a volume.
Only one may be active at a
time and the \fBfsmpm\fR daemon executes failover votes to determine
the daemon to activate.
The priority value helps the \fBfsmpm\fR determine, all other 
things being equal, which service to activate.
.PP
The previous version of
.BR fsmlist (4)
was documented as requiring a dot (.)
character as an argument before the \fIpriority\fP argument, for
compatibility with even older versions of
.BR fsmlist (4).
In reality, it was optional.
The first argument will be ignored if it is just the dot (.) character.
.PP
Lines that contain white space only or that contain the comment token 
as the first non-white space character are ignored.
.SH FILES
.I /Library/Preferences/Xsan/fsmlist
.SH "SEE ALSO"
.BR cvfs (8),
.BR cvfs_failover (8),
.BR fsm (8),
.BR fsmpm (8),
.BR fsnameservers (4),
.BR mount (8),
.BR snfs_config (5)