sam-fsd(1M)

NAME
     sam-fsd - Initializes Sun QFS and SAM-QFS environments

SYNOPSIS
     /usr/lib/fs/samfs/sam-fsd [ -C  ]  [  -N  ]  [  -D  ]  [  -c
     defaults] [ -d diskvols] [ -f samfs] [ -m mcf] [ -v ]

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     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
     Facility smf(5)

     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-
     nal SIGHUP.

     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
     environment.

     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
     sam-fsd .
      'kill -HUP sam-fsd-pid'

  Trace Files
     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.

OPTIONS
     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:

     -c        defaults
               Sets an alternate  defaults.conf  file  to  check.
               defaults  is  the  path  to the alternate defaults
               configuration file.

     -d        diskvols
               Sets an alternate  diskvols.conf  file  to  check.
               diskvols  is  the  path  to the alternate diskvols
               configuration file.

     -f        fs_name
               Sets a single file system.  fs_name is the  family
               set name from the mcf file.

     -m        mcf
               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.

FILES
     /etc/opt/SUNWsamfs  Location of SAM-QFS configuration files.

     mcf                 The  configuration  file   for   SAM-QFS
                         environments.

     samfs.cmd           Sun QFS and SAM-QFS mount commands file.

     defaults.conf       Set default values for SAM-QFS  environ-
                         ment.

SEE ALSO
     defaults.conf(4), diskvols.conf(4), mcf(4), samfs.cmd(4).

     trace_rotate(1M).