sam-fsd - Initializes Sun QFS and SAM-QFS environments
/usr/lib/fs/samfs/sam-fsd [ -C ] [ -N ] [ -D ] [ -c
defaults] [ -d diskvols] [ -f samfs] [ -m mcf] [ -v ]
sam-fsd initializes Sun QFS and SAM-QFS environments and
performs tasks for the file system kernel code. These tasks
include sending messages to syslog, and starting the
archiver, releaser, shared fs, and stager daemons. It is
managed as a service by the Solaris Service Management
When started, sam-fsd reads the configuration files
defaults.conf, diskvols.conf, mcf, and samfs.cmd located in
the directory /etc/opt/SUNWsamfs. These files may be
changed at any time while sam-fsd is running. The changes
will take place when sam-fsd is restarted, or sent the sig-
The file systems are configured and necessary daemons are
started. Configuration parameters are set, and table files
are written for use by other components of the SAM-QFS
If errors occur in any of the configuration files, sam-fsd
refuses to run and writes a notification message to syslog.
The problem must be corrected, and the signal SIGHUP sent to
sam-fsd. sam-fsd then rereads the configuration files. The
syslog message contains the command necessary to signal
'kill -HUP sam-fsd-pid'
Several Sun QFS and SAM-QFS daemons write messages to trace
files. These messages contain information about the state
and progress of the work performed by the daemons. The mes-
sages are primarily used by Sun engineers and support per-
sonnel to improve performance and diagnose problems. As
such, the message content and format are subject to change
with bugfixes and feature releases.
The daemons writing trace files are: sam-archiverd,
sam-catserver, sam-fsd, sam-rftd, sam-recycler,
sam-sharefsd, and sam-stagerd.
To prevent the trace files from growing indefinitely,
sam-fsd monitors the size and age of the trace files and
periodically executes the script
/opt/SUNWsamfs/sbin/trace_rotate. This script moves the
trace files to sequentially numbered copies. The script is
executed when the trace file exceeds a specified size, or
age. The size and age are specified in defaults.conf. If
/opt/SUNWsamfs/sbin/trace_rotate does not exist, sam-fsd
performs no action.
sam-fsd may be started by direct execution to provide
detailed messages about problems in configuration files. In
this case, the following options are allowed:
Sets an alternate defaults.conf file to check.
defaults is the path to the alternate defaults
Sets an alternate diskvols.conf file to check.
diskvols is the path to the alternate diskvols
Sets a single file system. fs_name is the family
set name from the mcf file.
Sets an alternate mcf file to check. mcf is the
path to the alternate mcf file.
-v Sets verbose mode.
-C Configure SAM-QFS if not already configured. Must
be the only option.
-N Exits with a non-zero status if any SAM-QFS file
systems are configured. Used by the Solaris SMF
facility. Must be the only option.
-D Used by the SMF facility to start sam-fsd as a
daemon. Used by the Solaris SMF facility. Must be
the only option.
/etc/opt/SUNWsamfs Location of SAM-QFS configuration files.
mcf The configuration file for SAM-QFS
samfs.cmd Sun QFS and SAM-QFS mount commands file.
defaults.conf Set default values for SAM-QFS environ-
defaults.conf(4), diskvols.conf(4), mcf(4), samfs.cmd(4).