Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 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.