samadm(1M)

NAME
     samadm - Sun QFS and SAM-QFS main administrative command

SYNOPSIS
     samadm servicetag add|delete

     samadm eq-add eq_number#

     samadm eq-release eq_number#

     samadm eq-remove eq_number#

     samadm eq-alloc eq_number#

     samadm eq-noalloc eq_number#

     samadm -?|--help

DESCRIPTION
     The samadm command is a single  command  line  interface  to
     many  Sun  QFS and SAM-QFS commands.  Initially, it contains
     commands that are new to Sun QFS and SAM-QFS 5.0,  but  will
     in  the  future contain subcommands for most QFS administra-
     tive functions.

     The detailed description of each subcommand follows.

SUBCOMMANDS
     servicetag

         The add operand to the servicetag subcommand  adds  ser-
         vice  tags  to  the  service tag repository depending on
         whether the SUNWqfs or SUNWsamfs package  is  installed.
         If  the  SUNWqfs package is installed, a Sun QFS service
         tag is added.  If the SUNWsamfs  package  is  installed,
         both a Sun QFS and a SAM-QFS service tag are added.  See
         stclient(1M) for more information on service tags.

         The delete operand to the servicetag subcommand  deletes
         both  Sun  QFS and SAM-QFS service tags from the service
         tag repository.

         The servicetag subcommand is not intended to  be  needed
         to  be  invoked  by  the  administrator.   The  Sun  QFS
         software automatically adds service tags when first con-
         figured  or  mounted,  and deletes service tags when the
         Sun QFS or SAM-QFS package is removed.

     eq-add

         This subcommand adds an equipment to an existing mounted
         Sun QFS file system.  The equipment must be added to the
         mcf(4) file, and samd config must be run prior to adding
         the  equipment  number  to a file system.  The equipment
         will be placed into the off state.

         In a non-shared file system, after the equipment  number
         is added, it is placed into the on state.

         In a shared file system, after the equipment  number  is
         added,  it  is  initially placed into the unavail state.
         All the mcf files on the  clients  must  be  updated  to
         include  the new/changed equipment number, and samd con-
         fig run. After this has been done, To place this  equip-
         ment  number  into  full  read/write  status, change the
         state to alloc via samadm eq-alloc eq_number#.

     eq-release

         This subcommand releases the disk space associated  with
         files  that  have  valid archive copies from SAM-QFS. It
         can be used prior to an  eq-remove  command  to  quickly
         release  space  on  a  device  that is to be removed for
         hardware failure or other reasons.

         The eq-release subcommand starts  a  background  process
         called  sam-shrink which releases space on the equipment
         number The releasing process may take some time to  com-
         plete.   Progress  can  be  monitored  via  samu(1M)  (m
         display).  When the release is started, the equipment is
         first  put  into  noalloc  state to prevent further data
         allocation on that equipment.  When the  releasing  pro-
         cess is complete, the equipment is placed into off state
         if all space was successfully released.

     eq-remove

         This subcommand removes  an  equipment  number  from  an
         existing mounted Sun QFS file system.  It is intended to
         be used to remove an equipment for reuse, or  to  remove
         an  equipment that needs replacement because of hardware
         failure.

         The eq-remove subcommand  starts  a  background  process
         called sam-shrink which copies the data on the equipment
         number to be removed to other  equipments  in  the  file
         system.   The removal process may take some time to com-
         plete.   Progress  can  be  monitored  via  samu(1M)  (m

         display).   When the remove is started, the equipment to
         be removed is first put into noalloc  state  to  prevent
         further  data  allocation  on  that equipment.  When the
         removal process is complete,  the  equipment  is  placed
         into  off  state  if all space was successfully moved to
         other equipments.

     eq-alloc

         This subcommand changes the state of an equipment number
         to  alloc which allows new data allocations to be placed
         on it.  This subcommand is  only  legal  for  equipments
         which are currently in the noalloc or unavail state.

     eq-noalloc

         This subcommand changes the state of an equipment number
         to  noalloc  which  prevents  new data allocations to be
         placed on it.  This subcommand is only legal for  equip-
         ments which are currently in the on state.

     -?|--help

         Displays a command syntax summary.

SEE ALSO
     samservicetag(1M) samu(1M) samd(1M) mcf(4)