diskvols.conf(4)

NAME
     diskvols.conf - Defines disk archive volumes for SAM-QFS
     environments

SYNOPSIS
     /etc/opt/SUNWsamfs/diskvols.conf

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     A SAM-QFS file can have one or more of its archive copies
     written to a disk archive resource.  A disk volume that
     represents the resource is stored in the inode of the
     archived file.

     The disk volume configuration file, diskvols.conf, defines
     the mapping between a disk volume and the corresponding
     resource.  The sam-fsd daemon reads the diskvols.conf file
     when the sam-fsd daemon is started.  The diskvols.conf file
     can be changed at any time while the sam-fsd daemon is
     running.  The changes take effect when the sam-fsd daemon is
     restarted or sent the signal SIGHUP.

     The mappings are specified one per line.  Each line consists
     of two fields separated by white space.  Leading white space
     is ignored.  Everything after a pound character (#) is
     ignored.  Lines can be continued by using a backslash
     character (\) as the last character on the line.  The syntax
     for this line is as follows:

     disk_volume resource

     where:

     disk_volume
               An alphanumeric string.  The string can contain up
               to 31 characters.

     resource  A resource specification in one of the following
               formats:

               pathname       This format contains the path name
                              of the disk archive directory on
                              the local host.

               [host:]pathname
                              This format specifies the host as
                              the name of the disk archive server
                              and pathname as the path name of
                              the disk archive directory on that
                              host.

               stk5800 host[:port]
                              This format defines a disk volume
                              as residing on a Sun StorageTek
                              5800 Storage System.  The host
                              field contains the name or IP
                              address and port as the port number
                              of the Sun StorageTek 5800 Storage
                              System.  By default, the port
                              number is 8080.

     NOTE: Extreme care must be taken when configuring disk
     archiving in an environment with multiple SAM-QFS servers.
     The diskvols.conf file for each SAM-QFS server must point to
     a unique set of disk volume resource specifications (disk
     archiving target directories). If any of these are shared
     between different SAM-QFS servers, then running the recycler
     from one SAM-QFS server will destroy the disk archive data
     that is being managed by the other SAM-QFS server.

CLIENT DEFINITIONS SECTION
     The clients and endclients directives delimit this section
     of the diskvols.conf file.

     The client definitions section defines the trusted client
     systems.  After the disk archiving server accepts a client
     connection, it verifies that the socket address belongs to a
     host in the trusted client definitions section.  If not, the
     connection is refused.

     The file transfer parameters which set the TCP window size
     and block size are defined in the rft.cmd configuration file
     on the server.  These can be tuned for best performance.

EXAMPLES
     This example shows two diskvols.conf files.

     File 1 is a diskvols.conf file on client system earth that
     defines the following:

     o  There is one volume serial name (VSN) for a local disk
        archive.

     o  There are two remote VSNs.  Remote VSN remote1 resides in
        /quidditch on the remote server gryffindor, and remote
        VSN remote2 resides in /quidditch on remote server
        ravenclaw.

     o  There is one volume serial name (VSN) for a Sun
        StorageTek 5800 Storage System.

     #
     # This is file /etc/opt/SUNWsamfs/diskvols.conf on local system earth

     #
     local_archive       /DiskArchive
     remote1  gryffindor:/quidditch
     remote2   ravenclaw:/quidditch
     stk_archive  stk5800 mars

     File 2 is the diskvols.conf file that resides on the server
     system gryffindor and ravenclaw.  Only the diskvols.conf
     file for server gryffindor is shown.

     #
     # This is file /etc/opt/SUNWsamfs/diskvols.conf on server system gryffindor
     #
     clients
     earth
     endclients

SEE ALSO
     archiver(1M), sam-fsd(1M).

     archiver.cmd(4), rft.cmd(4).

WARNINGS
     If more than one SAM-QFS environment is sharing a Sun
     StorageTek 5800 Storage System you must take extra care when
     configuring the diskvols.conf file.  If you are running
     multiple connections to a Sun StorageTek 5800 Storage System
     disk archive, then the disk_volume name needs to be unique
     across all SAM-QFS environments.  For example,
     stk_archive_earth on one server, stk_archive_pluto on the
     next server, etc.

     #
     # This is file /etc/opt/SUNWsamfs/diskvols.conf on server earth
     #
     stk_archive_earth  stk5800 mars

     #
     # This is file /etc/opt/SUNWsamfs/diskvols.conf on server pluto
     #
     stk_archive_pluto  stk5800 mars

     It is important to follow this recommendation, because there
     is no enforcement of this restriction in the SAM-QFS
     software.