A P P E N D I X B

Release Package Contents and Directories Created

This chapter describes the content of the release packages and shows the directories and files that the software creates when it is installed. Specifically, it contains the following topics:

- Release Package Contents

- Directories and Files Created

##

Release Package Contents

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

TABLE B-1 shows the release packages.

TABLE B-1 Release Packages
Installed Package | Description
--- | ---
`SUNWqfsr, SUNWqfsu` | Sun StorEdge QFS software packages
`SUNWcqfs` | Chinese localized package for Sun StorEdge QFS software
`SUNWjqfs` | Japanese localized package for Sun StorEdge QFS software
`SUNWfqfs` | French localized package for Sun StorEdge QFS software
`SUNWsamfsr, SUNWsamfsu` | Sun StorEdge SAM-FS software packages
`SUNWcsamf` | Chinese localized package for Sun StorEdge SAM-FS software
`SUNWjsamf` | Japanese localized package for Sun StorEdge SAM-FS software
`SUNWfsamf` | French localized package for Sun StorEdge SAM-FS software
`SUNWsamqfsuir, SUNWsamqfsuiu` | SAM-QFS Manager software packages
`SUNWcsamqfsui` | Chinese localized package for SAM-QFS Manager software
`SUNWjsamqfsui` | Japanese localized package for SAM-QFS Manager software
`SUNWfsamqfsui` | French localized package for SAM-QFS Manager software

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

    major.minor.patch

TABLE B-2 explains the release numbering scheme.

TABLE B-2 Release Numbering
Release Level Component | Meaning
--- | ---
major | The release level of a major release.
minor | The release level of a minor feature release.
patch | The patch number. A number between 1 and 99 indicates a patch release. A letter from A through Z indicates prerelease software. The base release of a first feature release of a major release might not contain a patch level.

Examples:

- 4.0 is a major release with no minor release revisions and no bug fixes.

- 4.2 is a minor release.

- 4.2.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 and Sun StorEdge SAM-FS products. 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 B-3 lists the directories created when the Sun StorEdge QFS and Sun StorEdge SAM-FS software packages are installed.

TABLE B-3 Directories Created
Directory | Content | Used By
--- | --- | ---
`/dev/samst` | Device driver special files. | Sun StorEdge SAM-FS
`/etc/fs/samfs` | Commands specific to Sun StorEdge QFS and Sun StorEdge SAM-FS software. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/etc/opt/SUNWsamfs` | Configuration and license files. | Sun StorEdge QFS Sun StorEdge SAM-FS
/etc/opt/SUNWsamfs/scripts | Site-customizable scripts. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/opt/SUNWsamfs/bin` | User command binaries. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/opt/SUNWsamfs/client` | Files for RPC API client. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/opt/SUNWsamfs/examples` | Various example configuration files. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/opt/SUNWsamfs/include` | API include files. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/opt/SUNWsamfs/lib` | Relocatable libraries. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/opt/SUNWsamfs/man` | `man`(1) pages. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/opt/SUNWsamfs/sbin` | System administrator commands and daemon binaries. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/opt/SUNWsamfs/sc` | Sun Cluster binaries and configuration files. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/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. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/opt/SUNWsamqfsui/bin` | SAM-QFS Manager administrator commands. | SAM-QFS Manager
`/opt/SUNWsamqfsui/doc` | SAM-QFS Manager online documentation repository. | SAM-QFS Manager
`/opt/SUNWsamfs/mibs` | Standard MIB files and product MIB (`SUN-SAM-MIB.mib`). | Sun StorEdge QFS Sun StorEdge SAM-FS
`/var/opt/SUNWsamfs` | Device catalogs; catalog trace file; log files; archiver data directory and queue files. | Sun StorEdge SAM-FS

### Files Created at Installation

TABLE B-4 and TABLE B-5 list the files created when the Sun StorEdge QFS or Sun StorEdge SAM-FS software is installed.

TABLE B-4 Files Created - Miscellaneous
File | Description | Used By
--- | --- | ---
`/etc/opt/SUNWsamfs/inquiry.conf` |
`` | Vendor and product identification strings for recognized SCSI devices. | Sun StorEdge SAM-FS
`/etc/sysevent/config/SUNW,SUNWsamfs,sysevent.conf` |
`` | Solaris system event handler configuration file. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/kernel/drv/samst` | Driver for SCSI media changers, optical drives, and non-motion I/O for tape drives. | Sun StorEdge SAM-FS
`/kernel/drv/samst.conf` | Configuration file for the `samst` driver. | Sun StorEdge SAM-FS
`/kernel/drv/samioc` | Sun Solaris 32-bit file system interface module. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/kernel/drv/samioc.conf` | Configuration file for `samioc` module. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/kernel/drv/sparc9/samioc` | Sun Solaris 32- and 64-bit file system interface module. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/kernel/fs/samfs` | Sun Solaris 32-bit file system module. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/kernel/fs/sparcv9/samfs` | Sun Solaris 64-bit file system module. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/opt/SUNWsamfs/sc/etc/SUNW.qfs` |
`` | Sun Cluster configuration file. This is a link. Created only in the presence of Sun Cluster software. | Sun StorEdge QFS
`/usr/cluster/lib/rgm/rtreg/SUNW.qfs` |
`` | Sun Cluster configuration file. Created only in the presence of Sun Cluster software. | Sun StorEdge QFS
`/var/log/webconsole/host.conf` |
`` | SAM-QFS Manager configuration file. | SAM-QFS Manager
`/var/opt/SUNWsamfs/faults` | Faults history file. | Sun StorEdge QFS,Sun StorEdge SAM-FS
`/var/sadm/samqfsui/samqfsmgr_uninstall` |
`` | Software for removing SAM-QFS Manager and its supporting applications. | SAM-QFS Manager

The Sun StorEdge QFS and Sun StorEdge SAM-FS file systems have dynamically loadable components that are stored in the Sun Solaris `/kernel` directory (see TABLE B-4). 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 or Sun StorEdge SAM-FS software is installed, it creates files that it uses for fault notification. TABLE B-5 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 SAM-QFS Manager software.

TABLE B-5 Files Created - Fault Notification
File | Description | Used By
--- | --- | ---
`/etc/opt/SUNWsamfs/scripts/sendtrap` | Sends trap information. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/opt/SUNWsamfs/sbin/tapealert_trap` | Sends `tapealert`(1M) traps. | Sun StorEdge SAM-FS
`/opt/SUNWsamfs/sbin/tapealert_log` | Records `tapealert`(1M) faults. | Sun StorEdge SAM-FS
`/opt/SUNWsamfs/sbin/fault_log` | Records faults. | Sun StorEdge QFS Sun StorEdge SAM-FS

The software creates the files listed in TABLE B-5 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 and Sun StorEdge SAM-FS software uses these site files.

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

TABLE B-6 and TABLE B-7 list the site files you create. Some of the files in these lists are optional, depending on your configuration, and others are required.

TABLE B-6 shows the required site files. These are files that you must create at your site in order to use the Sun StorEdge QFS and Sun StorEdge SAM-FS software.

TABLE B-6 Required Site Files
File | Description | Used By
--- | --- | ---
`/etc/opt/SUNWsamfs/LICENSE.4.2` | License file. For more information, see the licensing information pertinent to your installation in Obtaining a Software License Key. This is a required file. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/etc/opt/SUNWsamfs/mcf` | Master configuration file. For more information, see the `mcf`(4) man page. This is a required file. | Sun StorEdge QFS Sun StorEdge SAM-FS

TABLE B-7 shows the optional site files. This is a partial list of the files that you might or might not create depending on the software packages you install and the features you use.

TABLE B-7 Optional Site Files
File | Description | Used By
--- | --- | ---
`/etc/opt/SUNWsamfs/archiver.cmd` | Archiver command file. For more information, see the `archiver.cmd`(4) man page or see the Sun StorEdge SAM-FS Storage and Archive Management Guide. | Sun StorEdge SAM-FS
`/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 and Sun StorEdge SAM-FS File System Administration Guide. | Sun StorEdge QFS Sun StorEdge SAM-FS
`/etc/opt/SUNWsamfs/recycler.cmd` | Recycler command file. For more information, see the `recycler.cmd`(4) man page or see the Sun StorEdge SAM-FS Storage and Archive Management Guide. | Sun StorEdge SAM-FS
`/etc/opt/SUNWsamfs/releaser.cmd` | Releaser command file. For more information, see the `releaser.cmd`(4) man page or see the Sun StorEdge SAM-FS Storage and Archive Management Guide. | Sun StorEdge SAM-FS
`/etc/opt/SUNWsamfs/preview.cmd` | Previewer command file. For more information, see the `preview.cmd`(4) man page or see the Sun StorEdge SAM-FS Storage and Archive Management Guide. | Sun StorEdge SAM-FS
`/etc/opt/SUNWsamfs/defaults.conf` | Miscellaneous default values. For more information, see the `defaults.conf`(4) man page. | Sun StorEdge QFS Sun StorEdge SAM-FS

### Modified System Files

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

The Sun StorEdge QFS and Sun StorEdge SAM-FS software adds information to the following files:

- `/etc/name_to_major`. This file maps drivers to major numbers. The Sun StorEdge SAM-FS software uses this file. The `samst` and `samrd` major numbers can vary depending on the major numbers in use by the Sun Solaris software. The system adds the lines shown in CODE EXAMPLE B-1.

CODE EXAMPLE B-1 Lines Added to `/etc/name_to_major`
    samst 63
    samrd 64

- `/etc/security/auth_attr`. This file is the authorization description database, and it is used by both Sun StorEdge QFS and Sun StorEdge SAM-FS software. The system adds the lines shown in CODE EXAMPLE B-2.

CODE EXAMPLE B-2 Lines Added to `/etc/security/auth_attr`
    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. The SAM-QFS Manager uses this file. The system adds the lines shown in CODE EXAMPLE B-3.

CODE EXAMPLE B-3 Lines Added to `/etc/user_attr`
    SAMadmin::::type=role;auths=com.sun.netstorage.samqfs.web.*
    samadmin::::type=normal;roles=SAMadmin

Copyright © 2004, Sun Microsystems, Inc. All rights reserved.