A P P E N D I X A

Release Package Contents

This appendix describes the content of the release packages and shows the directories and files that the software creates when it is installed.

This appendix contains the following sections:

- Release Package Contents

- Directories and Files Created

##

Release Package Contents

The Sun StorEdge QFS software packages are in Sun Solaris `pkgadd`(1M) format. These packages reflect the Sun Solaris version for the platform on which you will be installing the Sun StorEdge QFS software.

TABLE A-1 shows the release packages.

TABLE A-1 Release Packages
Installed Package | Description
--- | ---
`SUNWqfsr, SUNWqfsu` | Sun StorEdge QFS software packages
`SUNWfsmgrr, SUNWfsmgru` | File System Manager software packages

The releases are identified using characters arranged in the following format:

    major U update.patch

The "U" in this format stands for "update."

In the patch number field, a number between 1 and 99 indicates a patch release, and a letter from A through Z indicates pre-release software. The base release of a first feature release of a major release might not contain a patch level.

For example:

- 4U0 is release 4, update 0, a major release with no minor release revisions and no bug fixes.

- 4U2 is release 4, update 2, a minor release.

- 4U2.1 is a patch release that contains software fixes for a major or minor release. This number appears in the patch's README file.

##

Directories and Files Created

This section describes the directories and files associated with the Sun StorEdge QFS product. You can obtain additional information about the files in this section from the man pages after the software is installed.

### Directories Created at Installation

TABLE A-2 lists the directories created when the Sun StorEdge QFS software packages are installed.

TABLE A-2 Directories Created
Directory | Content
--- | ---
`/etc/fs/samfs` | Commands specific to Sun StorEdge QFS software.
`/etc/opt/SUNWsamfs` | Configuration and license files.
`/etc/opt/SUNWsamfs/scripts` | Site-customizable scripts.
`/opt/SUNWsamfs/bin` | User command binaries.
`/opt/SUNWsamfs/client` | Files for the remote procedure call API client.
`/opt/SUNWsamfs/doc` | Documentation repository for any informational files included in the release. The README file, which summarizes the installed release's features, is included in this directory.
`/opt/SUNWsamfs/examples` | Various example configuration files.
`/opt/SUNWsamfs/include` | API include files.
`/opt/SUNWsamfs/lib` | Relocatable libraries.
`/opt/SUNWsamfs/man` | `man`(1) pages.
`/opt/SUNWsamfs/mibs` | Standard MIB files and product MIB (`SUN-SAM-MIB.mib`).
`/opt/SUNWsamfs/sbin` | System administrator commands and daemon binaries.
`/opt/SUNWsamfs/sc` | Sun Cluster binaries and configuration files.
`/opt/SUNWfsmgr/bin` | File System Manager administrator commands.
`/opt/SUNWfsmgr/doc` | File System Manager online documentation repository.
`/var/opt/SUNWsamfs` | Device catalogs, catalog trace file, log files, archiver data directory, and queue files.

### Files Created at Installation

TABLE A-3 lists miscellaneous files created when the Sun StorEdge QFS software is installed.

TABLE A-3 Files Created - Miscellaneous
File | Description
--- | ---
`/etc/sysevent/config/SUNW,SUNWsamfs,sysevent.conf`
`` | Solaris system event handler configuration file.
/kernel/drv/amd64/samaio | File system asynchronous I/O pseudo-driver (64-bit version for x64 platforms).
/kernel/drv/amd64/samioc | Sun Solaris 64-bit file system interface module (for x64 platforms).
`/kernel/drv/samaio.conf` | Configuration file for `samaio`.
`/kernel/drv/samaio` | File system 32-bit asynchronous I/O pseudo-driver (not present in the Solaris 10 OS).
`/kernel/drv/samioc.conf` | Configuration file for the `samioc` module.
`/kernel/drv/samioc` | Sun Solaris 32-bit file system interface module (not present under the Solaris 10 OS).
`/kernel/drv/sparcv9/samaio` | File system asynchronous I/O pseudo-driver (64-bit version for SPARC platforms).
`/kernel/drv/sparcv9/samioc` | Sun Solaris 64-bit file system interface module (for SPARC platforms)
/kernel/fs/amd64/samfs | Sun Solaris 64-bit file system module for x64 platforms.
`/kernel/fs/samfs` | Sun Solaris 32-bit file system module (not present under the Solaris 10 OS on SPARC).
`/kernel/fs/sparcv9/samfs` | Sun Solaris 64-bit file system module for SPARC platforms.
`/opt/SUNWsamfs/sc/etc/SUNW.qfs`
`` | Sun Cluster configuration file created only in the presence of Sun Cluster software.
`/usr/cluster/lib/rgm/rtreg/SUNW.qfs`
`` | Sun Cluster configuration file created only in the presence of Sun Cluster software.
`/var/log/webconsole/host.conf`
`` | File System Manager configuration file.
`/var/opt/SUNWsamfs/faults` | Faults history file.
`/var/sadm/samqfsui/fsmgr_uninstall`
`` | Software for removing File System Manager and its supporting applications.

Note - The 32-bit modules are not distributed for the Solaris 10 OS packages on a SPARC platform.

The Sun StorEdge QFS file system has dynamically loadable components that are stored in the Sun Solaris `/kernel` directory (see TABLE A-3). You can determine the modules that are loaded by using the `modinfo`(1M) command. Typically, the kernel loads the file system module at boot time. Alternatively, you can load the file system module when the file system is first mounted after the Sun software is installed.

After the Sun StorEdge QFS software is installed, it creates files that it uses for fault notification. TABLE A-4 lists these files. When the software detects faults serious enough to merit user attention, the software uses these trap and log files to convey fault information through the File System Manager software.

TABLE A-4 Files Created - Fault Notification
File | Description
--- | ---
`/etc/opt/SUNWsamfs/scripts/sendtrap` | Sends trap information.
`/opt/SUNWsamfs/sbin/fault_log` | Records faults.

The software creates the files listed in TABLE A-4 with `-rwxr-x---` permissions. Do not change these file permissions. If execute permissions are lost, for example, the system writes messages such as the following to `/var/adm/messages`:

    SUNW,SUNWsamfs,sysevent.conf, line1: no execute access to /opt/SUNWsamfs/sbin/tapealert_trap - No such file or directory.

### Site Files

The configuration procedures in this manual direct you to create several files. The Sun StorEdge QFS software uses these site files.

Note - Your site's configuration files must contain ASCII characters only.

There is only one site file that you are required to create at your site in order to use the Sun StorEdge QFS software. It is the master configuration (`mcf`) file `/etc/opt/SUNWsamfs/mcf`. For more information about this file, see the mcf(4) man page.

You might also create the following files, depending on the software packages you install and the features you use:

- `/etc/opt/SUNWsamfs/samfs.cmd` - File system mount parameter command file. For more information, see the `samfs.cmd`(4) man page or see the Sun StorEdge QFS Configuration and Administration Guide.

- `/etc/opt/SUNWsamfs/defaults.conf` - Miscellaneous default values. For more information, see the `defaults.conf`(4) man page.

Note - If you are also using the Sun StorEdge SAM-FS software for archive management, a number of additional site files are required. See the Sun StorEdge SAM-FS Installation and Upgrade Guide for more information.

### Modified System Files

During installation, Sun StorEdge QFS software adds information to certain Sun Solaris system files. These system files are ASCII text files. The Solaris OS uses these files to identify loadable kernel modules by number rather than by name.

The Sun StorEdge QFS software adds information to the following files:

- `/etc/security/auth_attr` - This file is the authorization description database. The system adds the following lines to this file:

    com.sun.netstorage.samqfs.web.read:::SAM-FS Read Access::
    com.sun.netstorage.samqfs.web.write:::SAM-FS Write Access::
    com.sun.netstorage.samqfs.web.*:::SAM-FS All Access::

- `/etc/user_attr` - This file is the extended user attributes database used by File System Manager. The system adds the following lines to this file:

    SAMadmin::::type=role;auths=com.sun.netstorage.samqfs.web.*
    samadmin::::type=normal;roles=SAMadmin

Copyright © 2006, Sun Microsystems, Inc. All Rights Reserved.