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 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 on which you will be installing the Sun StorEdge SAM-FS software.

TABLE A-1 shows the release packages.

TABLE A-1 Release Packages
Installed Package | Description
--- | ---
`SUNWqfsr,` `SUNWqfsu` | Sun StorEdge QFS software packages
`SUNWsamfsr,` `SUNWsamfsu` | Sun StorEdge SAM-FS 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 SAM-FS 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 SAM-FS software packages are installed.

TABLE A-2 Directories Created
Directory | Content
--- | ---
`/dev/samst` | Device driver special files.
`/etc/fs/samfs` | Commands specific to Sun StorEdge QFS and Sun StorEdge SAM-FS software.
`/etc/opt/SUNWsamfs` | Configuration files.
`/etc/opt/SUNWsamfs/scripts` | Site-customizable scripts.
`/opt/SUNWsamfs/bin` | User command binaries.
`/opt/SUNWsamfs/client` | Files for 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, and archiver data directory and queue files.

### Files Created at Installation

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

TABLE A-3 Files Created - Miscellaneous
File | Description
--- | ---
`/etc/opt/SUNWsamfs/inquiry.conf` | Vendor and product identification strings for recognized SCSI devices.
`/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/amd64/samst | Sun StorEdge SAM-FS driver for SCSI media changers and optical drives for tape drives (64-bit version 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 under Solaris 10).
`/kernel/drv/samioc.conf` | Configuration file for the `samioc` module.
`/kernel/drv/samioc` | Sun Solaris 32-bit file system interface module (not present under Solaris 10).
`/kernel/drv/samst.conf` | Configuration file for the `samst` driver.
`/kernel/drv/samst` | Driver for SCSI media changers and optical drives for tape drives (not present under Solaris 10).
`/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/drv/sparcv9/samst` | Sun StorEdge SAM-FS driver for SCSI media changers and optical drives for tape drives (64-bit version for SPARC platforms).
/kernel/fs/amd64/samfs | Sun Solaris 64-bit file system module for the x64 platform.
`/kernel/fs/samfs` | Sun Solaris 32-bit file system module (not present under Solaris 10 SPARC).
`/kernel/fs/sparcv9/samfs` | Sun Solaris 64-bit file system module for SPARC platforms.
`/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 Solaris 10 packages on a SPARC platform.

The Sun StorEdge SAM-FS 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 SAM-FS 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.
`/opt/SUNWsamfs/sbin/tapealert_log` | Records `tapealert`(1M) faults.
`/opt/SUNWsamfs/sbin/tapealert_trap` | Sends `tapealert`(1M) traps.

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 SAM-FS 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 SAM-FS 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 files shown in TABLE A-5, depending on the software packages you install and the features you use.

TABLE A-5 Optional Site Files
File | Description
--- | ---
`/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.
`/etc/opt/SUNWsamfs/defaults.conf` | Miscellaneous default values. For more information, see the `defaults.conf`(4) man page.
`/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.
`/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.
`/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.
`/etc/opt/SUNWsamfs/samfs.cmd` | File system mount parameter command file. For more information, see the `samfs.cmd`(4) man page.

### Modified System Files

During installation, the Sun StorEdge SAM-FS 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 SAM-FS software adds information to the following files:

- `/etc/name_to_major` - The Sun StorEdge SAM-FS software uses this file to map drivers to major numbers. The `samst` and `samrd` major numbers can vary, depending on the major numbers in use by the Solaris OS. The system adds the following lines to this file:

    samst 63
    samrd 64
    samioc 236
    samaio 237

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

    # File System Manager Authorizations
    com.sun.netstorage.fsmgr.config:::File System Manager All Access::
    com.sun.netstorage.fsmgr.operator.media:::File System Manager Media
    Related Operation Access::
    com.sun.netstorage.fsmgr.operator.sam.control:::File System Manager
    Start/Stop/Idle Archiving Access::
    com.sun.netstorage.fsmgr.operator.file:::File System Manager File
    LevelOperation Access::
    com.sun.netstorage.fsmgr.operator.filesystem:::File System Manager
    FileSystem Level Operation Access::

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

    root::::profiles=Web Console Management,All;auths=Solaris.*,solaris.grant,com.sun.netstorage.fsmgr.*;lock_after_retries=no

- `/etc/inittab` - The system adds the following lines to this file:

    sf:023456:respawn:/usr/lib/fs/samfs/sam-fsd

Depending on the software configuration, the system might also add the following lines to `/etc/inittab`:

    sfad:3:respawn:/opt/SUNWsamfs/sbin/fsmgmtd

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