Skip Headers
Oracle Hierarchical Storage Manager and QFS Software Command Reference
Section 4: File Formats
Release 6.1.1


diskvols.conf - Defines disk archive volumes for Oracle HSM environments






A Oracle HSM 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 (\fB\) as the last character on the line. The syntax for this line is as follows:

disk_volume resource



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


A resource specification in one of the following formats:


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

stk5800 host[:port]

This format defines a disk volume as residing on an Oracle StorageTek 5800 Storage System. The host field contains the name or IP address and port as the port number of the Oracle 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 Oracle HSM servers. The diskvols.conf file for each Oracle HSM server must point to a unique set of disk volume resource specifications (disk archiving target directories). If any of these are shared between different Oracle HSM servers, then running the recycler from one Oracle HSM server will destroy the disk archive data that is being managed by the other Oracle HSM server.


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:

# 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


archiver (1m), sam-fsd (1m).

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


If more than one Oracle HSM environment is sharing an Oracle StorageTek 5800 Storage System you must take extra care when configuring the diskvols.conf file. If you are running multiple connections to an Oracle StorageTek 5800 Storage System disk archive, then the disk_volume name needs to be unique across all Oracle HSM 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 Oracle HSM software.