Editing the defaults.conf File

The /opt/SUNWsamfs/examples/defaults.conf file contains directives that control automated library actions in a Sun Storage Archive Manager environment. You can change these settings at any time after the initial installation, for example, to accommodate changes in your site's library information. If you change the information in the defaults.conf file after the system is running, you must then issue commands to propagate the defaults.conf file changes to the file system.

The following example shows lines from an example defaults.conf file. This file shows several parameters that can affect the configuration of an automated library.

Example 3-1 Example of a defaults.conf File

exported_media = unavailable 
attended = yes 
tape = lt 
log = LOG_LOCAL7 
timeout = 300 
# trace 
# all on 
# endtrace 
labels = barcodes_low 
lt_delay = 10 
lt_unload = 7 
lt_blksize = 256

Another sample file is located in the /opt/SUNWsamfs/examples/defaults.conf file.

For more information about the file's content, see the defaults.conf(4) in Sun QFS and Sun Storage Archive Manager Reference Manual man page.

Features You Can Control From defaults.conf

This section describes two common features that you can control from the defaults.conf file. For more information, see defaults.conf(4) in Sun QFS and Sun Storage Archive Manager Reference Manual.

Barcodes

If you have a tape library that uses a barcode reader, you can configure the system to set the tape label equal to the first or last characters of the barcode label. You can set the labels directive in the defaults.conf file, as shown in the following table.

Table 3-1 Labels Directive in the defaults.conf File

If labels = barcodes or labels = barcodes_low is in effect, the Sun SAM system writes a label before the write is started for any tape that is mounted for a write operation that is write enabled, is unlabeled, and has a readable barcode.

Drive Timing Values

You can set the unload and unload wait time for devices using the dev_unload and dev_delay directives, respectively.

The format of the dev_unload parameter is as follows:

dev_unload = seconds

For dev, specify the device type as described in the mcf(4) man page.

For seconds, specify the number of seconds that you want the system to wait after an unload command is issued. This gives the automated library time to eject the cartridge, open the door, and perform other operations before the cartridge is removed. The default is 0.

The format of the dev_delay directive is as follows:

dev_delay = seconds

For dev, specify the device type as specified in the mcf(4) man page.

For seconds, specify the minimum number of seconds that you want to have elapse between the time when a cartridge is loaded and the time when the same cartridge is able to be unloaded. The default is 30.

For example:

# hp_delay = 10
# lt_unload = 7

How to Customize Default Values

1. Use the cp command to copy /opt/SUNWsamfs/examples/defaults.conf to its functional location.

   For example:

   # cp /opt/SUNWsamfs/examples/defaults.conf /etc/opt/SUNWsamfs/defaults.conf

2. Edit the file.

   Edit the lines that control those aspects of the system that you want to change. Remove the hash character (#) from column 1 of the lines you change.

3. Use the pkill command to send a SIGHUP signal to the sam-fsd daemon.

   For example:

   # pkill -HUP sam-fsd

   This command restarts the sam-fsd daemon and enables the daemon to recognize the changes in the defaults.conf file.