diskvols.conf - Defines disk archive volumes for SAM-QFS
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
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:
An alphanumeric string. The string can contain up
to 31 characters.
resource A resource specification in one of the following
pathname This format contains the path name
of the disk archive directory on
the local host.
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
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.
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
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
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
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
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