Configuring the File System Environment

Each SAM-QFS software environment is unique. The system requirements and hardware differ from site to site. SAM-QFS environments support a wide variety of tape and optical devices, automated libraries, and disk drives. The system administrator at your site must set up the specific configuration for your environment.

The master configuration file, /etc/opt/SUNWsamfs/mcf, defines the equipment topology that is managed by the SAM-QFS software. This file specifies the devices, automated libraries, and file systems included in the environment. You must assign a unique equipment identifier to each piece of equipment listed in the mcf file.

Edit the mcf file in one of these ways:

• Use the SAM-QFS Manager to configure archiving and file system devices. When you create a file system using SAM-QFS Manager, it creates an mcf file in the /etc/opt/SUNWsamfs/mcf directory that contains a line for each device and family set of the file system.

• Use a text editor to directly edit the mcf file.

The mcf file has two kinds of entries:

• File system device entries for disk devices. In the mcf file, you organize the entries into one or more file systems.

• Removable media device entries that you can organize into family sets. The mcf file contains information that enables you to identify the drives to be used and associate them with the automated libraries to which they are attached.

For detailed information about mcf file structures and contents, see Chapter 2, About the Master Configuration File, in Sun QFS File System 5.3 Configuration and Administration Guide.

The /opt/SUNWsamfs/examples directory contains example mcf files. See other example mcf file configurations in Chapter 3, mcf File Examples, in Sun QFS File System 5.3 Configuration and Administration Guide.

The following sections provide examples and describe the activities that are related to creating and maintaining the mcf file.

Identifying Peripherals Using the /var/adm/messages File

When your system boots, a series of messages is written to /var/adm/messages. These messages identify the Oracle Solaris hardware path to each of the peripherals on your system. You can use this information to create the mcf file. To view information from the latest system reboot, search backward from the end of the file.

Example 7-1 SCSI Peripheral Lines in the /var/adm/messages File

The following example shows the vendor and product information that the SCSI peripheral reported to the Oracle Solaris kernel.

# tail -200 /var/adm/messages | more
May 22 23:59:24 sam-v490a samst: [ID 902828 kern.notice] scsiclass,082: \
Vendor/Product ID = STK SL500

Matching the symbolic link to the correct peripheral is the key to configuring a Sun Storage Archive Manager environment. Use the ls -l command in both the /dev/st, /dev/samst, and /dev/rmt directories to view the path name of the peripheral.

You might want to configure the “device down” notification script. dev_down.sh(1M) in Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual has information about setting up this script, which sends email to root when a device is marked down or off.

Manually Creating the Master Configuration File

Use a text editor to create the /etc/opt/SUNWsamfs/mcf file.

For detailed information about the contents of the mcf file, see Chapter 2, About the Master Configuration File, in Sun QFS File System 5.3 Configuration and Administration Guide.

Follow these guidelines when you create the mcf file:

• Delimit the fields in each line with spaces or tabs.

• Begin each comment line entered into this file with a pound sign character (#).

• Use a dash character (-) to indicate optional fields that are omitted.

The following example shows the mcf file fields:

#
# Sun Storage Archive Manager file system configuration
#
# Equipment       Equip  Equip Fam   Dev    Additional
# Identifier      Ord    Type  Set   State  Parameters
# ----------      -----  ----- ----  -----  ----------

The mcf file can include both comments and device entries. The types of device entries are as follows:

• Family set parent identifiers and family set devices

• Family set member devices

• Stand-alone devices

How to Verify the Master Configuration File

• Verify the mcf file.
  • If you created your mcf file using SAM-QFS Manager, you do not need to verify its syntax.
  • If you created your mcf file manually, use the sam-fsd command to verify the file.

Example 7-2 Using the sam-fsd Script to Verify the mcf File

If the mcf file is free of syntax errors, the sam-fsd output includes information about the file systems, archiving, and other system information. If the mcf file contains errors, however, the output is similar to the following example:

# sam-fsd
13: /dev/dsk/c1t1d0s0   10      md      samfs1  on      /dev/rdsk/c1t1d0s0
*** Error in line 13: Equipment name '/dev/dsk/c1t1d0s0' already in use by eq 10
72: /dev/rmt/3cbn       45      ug      l1000   on
*** Error in line 72: Equipment name '/dev/rmt/3cbn' already in use by eq 44
2 errors in '/etc/opt/SUNWsamfs/mcf'
sam-fsd: Read mcf /etc/opt/SUNWsamfs/mcf failed.

If the mcf file has errors, see Manually Creating the Master Configuration File. Also see, mcf(4) in Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual for information about creating this file. You can also refer to Chapter 3, mcf File Examples, in Sun QFS File System 5.3 Configuration and Administration Guide.

How to Create the Master Configuration File (SAM-QFS Manager)

Before You Begin

When you configure QFS file systems using the SAM-QFS Manager, it creates or edits the appropriate configuration files on that server. You can use either SAM-QFS Manager or the command line interface to later edit these files.

1. Log in to the SAM-QFS Manager as an administrator user.
2. Expand the Getting Started section, and choose First Time Configuration.
3. In section 2, click Create a File System.

   The New File System wizard appears.

4. Follow the steps for creating a new file system.

   When you have completed this process, the mcf file is created. For more information, see the SAM-QFS Manager online help.