Sun Logo


Sun StorEdge QFS & Sun StorEdge SAM-FS Software Installation & Configuration Guide

Release 4.1

817-4092-10



Contents

Preface

How This Book Is Organized

Using UNIX Commands

Shell Prompts

Typographic Conventions

Related Documentation

Accessing Sun Documentation Online

Third-Party Web Sites

Contacting Sun Technical Support

Licensing

Diagnostics

Installation Assistance

Sun Welcomes Your Comments

1. System Requirements and Preinstallation Tasks

Overview

Server Requirements

Solaris Operating System Requirements

procedure iconsmall spaceTo Verify the Environment

Installing Solaris OS Patches

Planning Your File System and Verifying Disk Cache

procedure iconsmall spaceTo Plan Your File System

procedure iconsmall spaceTo Estimate Disk Cache Requirements

Example 1 - Using the format(1M) Command On Fibre Channel-Attached Disks

Example 2 - Using the format(1M) Command on SCSI-Attached Disks

Verifying Disk Space

procedure iconsmall spaceTo Verify Disk Space

Verifying Removable Media Devices (Optional)

procedure iconsmall spaceTo Attach Removable Media Devices

procedure iconsmall spaceTo Create a List of Devices

Obtaining a Software License Key

Obtaining the Release Files

procedure iconsmall spaceTo Obtain the Software From the Sun Download Center

procedure iconsmall spaceTo Install From a CD-ROM

procedure iconsmall spaceTo Remove the Sun StorEdge QFS or Sun StorEdge SAM-FS 4.1 Software

Verifying Compatibilities

Verifying Requirements for the SAM-QFS Manager (Optional)

Hardware Requirements

Browser Requirements

Operating System Requirements

Web Software Requirements

Verifying the Network Management Station (Optional)

2. Release Package Contents and Directories Created

Release Package Contents

Directories and Files Created

Directories Created at Installation

Files Created at Installation

Site Files

Modified System Files

Installing Sun Solaris Patches

procedure iconsmall spaceTo Install Solaris OS Patches

procedure iconsmall spaceTo Add a samsys Entry to /etc/name_to_sysnum

procedure iconsmall spaceTo Verify a samsys Entry in /etc/name_to_sysnum

3. Sun StorEdge QFS Initial Installation Procedure

Ensuring that the Installation Prerequisites Are Met

Adding the Packages on the Sun StorEdge QFS Server

Enabling the Sun StorEdge QFS Software License

procedure iconsmall spaceTo Enable the Sun StorEdge QFS Software License

Setting Up PATH and MANPATH Variables

procedure iconsmall spaceTo Set Up PATH and MANPATH Variables

Rebooting the System

procedure iconsmall spaceTo Reboot the System

Enabling the SAM-QFS Manager (Optional)

procedure iconsmall spaceTo Install the SAM-QFS Manager Software

procedure iconsmall spaceTo Invoke the SAM-QFS Manager for the First Time

procedure iconsmall spaceTo Use the SAM-QFS Manager for Configuration

Defining the Sun StorEdge QFS Configuration by Creating the mcf File

procedure iconsmall spaceTo Create an mcf File

Creating an mcf File on a Sun Cluster Node

Configuration Examples

Configuration Example 1

procedure iconsmall spaceTo Configure the System

Configuration Example 2

procedure iconsmall spaceTo Configure the System

Configuration Example 3

procedure iconsmall spaceTo Configure the System

Configuration Example 4

procedure iconsmall spaceTo Configure the System

Initializing the Environment

procedure iconsmall spaceTo Initialize the Environment

Editing the defaults.conf File (Optional)

procedure iconsmall spaceTo Set Up Default Values

Verifying the License and mcf Files

procedure iconsmall spaceTo Verify the License File

procedure iconsmall spaceTo Verify the mcf File

Creating the samfs.cmd File (Optional)

procedure iconsmall spaceTo Create the samfs.cmd File

Updating the /etc/vfstab File and Creating the Mount Point

procedure iconsmall spaceTo Update the /etc/vfstab File and Create the Mount Point

Initializing the File System

procedure iconsmall spaceTo Initialize a File System

Mounting the File System

procedure iconsmall spaceTo Mount the File System

Sharing the File System With NFS Client Systems (Optional)

procedure iconsmall spaceTo NFS Share the File System

Mounting the File System on the NFS Client Systems (Optional)

procedure iconsmall spaceTo Mount the File System on Clients

Establishing Periodic Dumps Using qfsdump(1M)

procedure iconsmall spaceTo Run the qfsdump(1M) Command Automatically

procedure iconsmall spaceTo Run the qfsdump(1M) Command Manually

Backing Up Configuration Files (Optional)

Configuring the Remote Notification Facility (Optional)

procedure iconsmall spaceTo Enable Remote Notification

procedure iconsmall spaceTo Disable Remote Notification

Adding the Administrator Group (Optional)

procedure iconsmall spaceTo Add the Administrator Group

Configuring System Logging

procedure iconsmall spaceTo Enable Logging

Configuring Other Sun StorEdge Products (Optional)

4. Sun StorEdge QFS Upgrade Procedure

Ensuring that the Installation Prerequisites are Met for the Sun StorEdge QFS 4.1 Release

Backing Up Existing File Systems (Optional)

Using the Version 1 and Version 2 Superblocks

procedure iconsmall spaceTo Back Up Each File System

Unsharing the File Systems (Optional)

procedure iconsmall spaceTo Unshare the File Systems

Unmounting the File Systems

procedure iconsmall spaceTo Unmount Using the umount(1M) Command

procedure iconsmall spaceTo Unmount Using the fuser(1M), kill(1), and umount(1M) Commands

procedure iconsmall spaceTo Unmount by Editing the /etc/vfstab File and Rebooting

Removing Existing Sun StorEdge QFS Software

procedure iconsmall spaceTo Remove Software From a 4.0 Release

procedure iconsmall spaceTo Remove Software From a 3.5.0 Release

Adding the Packages

procedure iconsmall spaceTo Add the Packages

Updating the License Keys

procedure iconsmall spaceTo License the Sun StorEdge QFS Software (Optional)

Enabling the SAM-QFS Manager (Optional)

Verifying the License and mcf Files

procedure iconsmall spaceTo Verify the License File

procedure iconsmall spaceTo Verify the mcf File

Modifying the /etc/vfstab File (Optional)

procedure iconsmall spaceTo Modify the /etc/vfstab File

Reinitializing and Restoring the File Systems (Optional)

procedure iconsmall spaceTo Reinitialize and Restore the File Systems

Checking the File System (Optional)

Mounting the File Systems

procedure iconsmall spaceTo Mount the File System

Recompiling API-Dependent Applications (Optional)

5. Sun StorEdge SAM-FS Initial Installation Procedure

Ensuring that the Installation Prerequisites are Met

Adding the Packages on the Sun StorEdge SAM-FS Server

procedure iconsmall spaceTo Add the Packages

Verifying and Updating the st.conf and samst.conf Files (Optional)

procedure iconsmall spaceTo Verify Device Types

procedure iconsmall spaceTo Add Tape Devices to the /kernel/drv/st.conf File (Optional)

procedure iconsmall spaceTo Verify or Add a Target Device, LUN, or World Wide Name to the st.conf File

procedure iconsmall spaceTo Verify or Add Device Support in the samst.conf File (Optional)

procedure iconsmall spaceTo Verify that all Devices are Configured

Handling Errors in the st.conf File

Enabling the Sun StorEdge SAM-FS Software License

procedure iconsmall spaceTo License the Sun StorEdge SAM-FS Software

Setting Up PATH and MANPATH Variables

procedure iconsmall spaceTo Set Up PATH and MANPATH Variables

Rebooting the System

procedure iconsmall spaceTo Reboot the System

Enabling the SAM-QFS Manager (Optional)

procedure iconsmall spaceTo Install the SAM-QFS Manager Software

procedure iconsmall spaceTo Invoke the SAM-QFS Manager for the First Time

procedure iconsmall spaceTo Use the SAM-QFS Manager for Configuration

Defining the Sun StorEdge SAM-FS Configuration by Creating the mcf File

procedure iconsmall spaceTo Create an mcf File

Identifying Peripherals Using the /var/adm/messages File

Example Sun StorEdge SAM-FS Configuration

Example Sun StorEdge SAM-FS Disk Cache Configuration

procedure iconsmall spaceTo Write the mcf File

Configuring a Manually Loaded Magneto-optical Drive

procedure iconsmall spaceTo Configure the Drive

Configuring a Magneto-Optical Library

procedure iconsmall spaceTo Configure the Magneto-Optical Library

Configuring a Manually Loaded DLT Drive

procedure iconsmall spaceTo Configure the DLT Drive

Configuring a DLT Library

procedure iconsmall spaceTo Configure the DLT Library

Example mcf File Entries for Network-Attached Libraries

Creating Parameters Files for Network-Attached Automated Libraries (Optional)

ADIC/Grau Automated Libraries

procedure iconsmall spaceTo Configure the Parameters File for an ADIC/Grau Automated Library

Diagnostic Information

Fujitsu LMF Automated Libraries

procedure iconsmall spaceTo Configure the Parameters File for a Fujitsu LMF Automated Library

IBM 3494 Automated Libraries

procedure iconsmall spaceTo Configure the Parameters File for an IBM 3494 Automated Library

Sony Network-Attached Automated Libraries

procedure iconsmall spaceTo Configure the Parameters File for a Sony Network-Attached Automated Library

StorageTek ACSLS-Attached Automated Libraries

procedure iconsmall spaceTo Configure the Parameters File for a StorageTek ACSLS-Attached Automated Library

Shared Drives

Initialize the Sun StorEdge SAM-FS Environment

Checking the Drive Order (Optional)

procedure iconsmall spaceTo Check the Drive Order of Tape or Magneto-Optical Libraries With a Front Panel

procedure iconsmall spaceTo Check the Drive Order of Tape Libraries Without a Front Panel

procedure iconsmall spaceTo Check the Drive Order of Magneto-Optical Libraries Without a Front Panel

Creating the archiver.cmd File (Optional)

procedure iconsmall spaceTo Create an archiver.cmd File

Archiver Command File Directives

Specifying a Log File: logfile=pathname Directive

Determining the Number of Archive Copies: copy_number [ -norelease ] [ archive_age ] Directive

Reserving Volumes: vsns and endvsns Directives

Determining Whether Metadata is Archived: archivemeta=on|off Directives

Defining Archive Sets: the Archive Set Naming Directive

Setting the Maximum Archive File Size: archmax=media size Directive

Setting Miscellaneous Directives

Advanced Archiver Command File Example

Enabling Disk Archiving (Optional)

procedure iconsmall spaceTo Enable Disk Archiving on the Host that Contains the Files to be Archived

procedure iconsmall spaceTo Enable Disk Archiving on the Host to Which the Archive Copies Will be Written (Optional)

Editing the defaults.conf File (Optional)

procedure iconsmall spaceTo Customize Default Values for Your Site

Features You Can Control From defaults.conf

Barcodes

Drive Timing Values

Verifying the License and mcf Files

procedure iconsmall spaceTo Verify the License File

procedure iconsmall spaceTo Verify the mcf File

Labeling Removable Media Cartridges (Optional)

Populating the Catalog (Optional)

procedure iconsmall spaceTo Populate an Automated Library With Many Volumes

procedure iconsmall spaceTo Populate an Automated Library With A Small Number of Volumes

procedure iconsmall spaceTo Populate an IBM 3494 Automated Library

procedure iconsmall spaceTo Populate a Library Quickly (StorageTek ACSLS-Attached Libraries Only)

StorageTek ACSLS-Attached Automated Libraries -- Common Problems and Error Messages

Creating the samfs.cmd File (Optional)

procedure iconsmall spaceTo Create the samfs.cmd File

Updating the /etc/vfstab File and Creating the Mount Point

procedure iconsmall spaceTo Update the /etc/vfstab File and Create the Mount Point

Initializing the File System

procedure iconsmall spaceTo Initialize the File System

Mounting the File System

procedure iconsmall spaceTo Mount the File System

Sharing the File System With NFS Client Systems (Optional)

procedure iconsmall spaceTo NFS Share the File System

Mounting the File System on NFS Client Systems (Optional)

procedure iconsmall spaceTo Mount the File System on Clients

Writing Periodic Dump Files By Using samfsdump(1M)

procedure iconsmall spaceTo Run the samfsdump(1M) Command Automatically

procedure iconsmall spaceTo Run the samfsdump(1M) Command Manually

Backing Up Configuration Files (Optional)

Configuring the Remote Notification Facility (Optional)

procedure iconsmall spaceTo Enable Remote Notification

procedure iconsmall spaceTo Disable Remote Notification

Adding the Administrator Group (Optional)

procedure iconsmall spaceTo Add the Administrator Group

Configuring System Logging

procedure iconsmall spaceTo Enable Logging

Configuring Other Sun StorEdge Products (Optional)

6. Sun StorEdge SAM-FS Upgrade Procedure

Ensuring that the Installation Prerequisites are Met

Backing Up Each File System (Optional)

Using the Version 1 and Version 2 Superblocks

procedure iconsmall spaceTo Back Up File Systems

Stopping the Sun StorEdge SAM-FS File System

procedure iconsmall spaceTo Stop the File System

Unsharing the File Systems (Optional)

procedure iconsmall spaceTo Unshare the File Systems

Unmounting the File System

procedure iconsmall spaceTo Unmount Using the umount(1M) Command

procedure iconsmall spaceTo Unmount Using the fuser(1M), kill(1), and umount(1M) Commands

procedure iconsmall spaceTo Unmount by Editing the /etc/vfstab File and Rebooting

Removing Existing Sun StorEdge SAM-FS Software

procedure iconsmall spaceTo Remove Software from a 4.0 Release

procedure iconsmall spaceTo Remove Software from a 3.5.0 Release

Adding the Packages

procedure iconsmall spaceTo Add the Packages

Restoring File Changes (inquiry.conf and samst.conf)

Updating the License Keys

procedure iconsmall spaceTo License the Sun StorEdge SAM-FS Software (Optional)

Enabling the SAM-QFS Manager (Optional)

Verifying the License, mcf, archiver.cmd, and stager.cmd Files

procedure iconsmall spaceTo Verify the License File

procedure iconsmall spaceTo Verify the mcf File

procedure iconsmall spaceTo Remove Tracing Directives (Optional)

procedure iconsmall spaceTo Verify the archiver.cmd File (Optional)

Modifying the /etc/vfstab File (Optional)

procedure iconsmall spaceTo Modify the /etc/vfstab File

Reinitializing and Restoring the File Systems (Optional)

procedure iconsmall spaceTo Reinitialize and Restore the File Systems

Checking the File System (Optional)

Mounting the File Systems

procedure iconsmall spaceTo Mount the File System

Recompiling API-Dependent Applications (Optional)

A. SAM-QFS Manager Software Notes

Creating Additional Administrator and User Accounts

procedure iconsmall spaceTo Create Additional Administrator Accounts

procedure iconsmall spaceTo Create Additional Guest Accounts

Removing the SAM-QFS Manager Software

procedure iconsmall spaceTo Remove the SAM-QFS Manager Software from the Sun StorEdge QFS or Sun StorEdge SAM-FS Server

Messages

Log and Trace Files

SAM-QFS Manager Logging

TomCat Web Server Logging

Tracing

procedure iconsmall spaceTo Enable Logging and Tracing for SAM-QFS Manager Native Code

Management Software Remote Procedure Call (RPC) Daemon Information

procedure iconsmall spaceTo Determine Whether the RPC Daemon is Running

Glossary