Sun Logo


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

Release 4.2

817-7722-10



Contents

Preface

How This Book Is Organized

Using UNIX Commands

Shell Prompts

Typographic Conventions

Related Documentation

Accessing Sun Documentation Online

procedure iconsmall spaceTo Access Documentation from Sun`s Network Storage Documentation Web Site

procedure iconsmall spaceTo Access Documentation from docs.sun.com

Third-Party Web Sites

Contacting Sun Technical Support

Licensing

Diagnostics

Installation Assistance

Sun Welcomes Your Comments

1. System Requirements and Preinstallation Tasks

Overview

Sun StorEdge QFS File System

Sun StorEdge SAM-FS File System

Sun SAM-QFS File System

Sun StorEdge QFS Shared File System

Sun StorEdge QFS File Systems in a Sun Cluster Environment

Sun StorEdge QFS Local File System in a Sun Cluster Environment

Sun StorEdge QFS Highly Available File System in a Sun Cluster Environment

Sun StorEdge QFS Shared File System in a Sun Cluster Environment

Sun SAM-Remote

Server Requirements

Solaris Operating System Requirements

procedure iconsmall spaceTo Verify the Environment

Installing Solaris OS Patches

Sun StorEdge QFS and Sun StorEdge SAM-FS Software Host Requirements

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

(Optional) Verifying Archive Media

procedure iconsmall spaceTo Attach Removable Media Devices

Creating a List of 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.2 Software

Verifying Third-Party Compatibilities

(Optional) Verifying Sun StorEdge QFS Shared File System Requirements

Metadata Server Requirement

Operating System and Hardware Requirements

Sun StorEdge QFS Release Levels

Sun SAM-QFS Requirements

(Optional) Verifying Requirements for Installing the Sun StorEdge QFS File System in a Sun Cluster Environment

Example - Using the scdidadm(1M) Command in a Sun Cluster

Determining High Availability

Determining Redundancy

Analyzing the Output From the Commands

Performance Considerations

(Optional) Verifying Requirements for the SAM-QFS Manager

Hardware Requirements

Browser Requirements

Operating System Requirements

Web Software Requirements

(Optional) Verifying the Network Management Station

2. Sun StorEdge QFS Initial Installation Procedure

Ensuring That the Installation Prerequisites Are Met

Adding the Packages on the Sun StorEdge QFS Server

procedure iconsmall spaceTo Add the Packages

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

Preparing the Host Systems

procedure iconsmall spaceTo Prepare the Host Systems

(Optional) Enabling the SAM-QFS Manager

procedure iconsmall spaceTo Install the SAM-QFS Manager Software

Using 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

Where to Go From Here

mcf File Fields

The Equipment Identifier Field

The Equipment Ordinal Field

The Equipment Type Field

The Family Set Field

The Device State Field

The Additional Parameters Field

Configuration Examples for Local File Systems

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

Configuration Example for a Sun StorEdge QFS Shared File System on a Solaris OS Platform

procedure iconsmall spaceTo Configure the System

Configuration Examples for Sun StorEdge QFS Highly Available File Systems

procedure iconsmall spaceTo Create an mcf File for a Sun StorEdge QFS Highly Available File System

Configuration Example for a Sun StorEdge QFS Shared File System on a Sun Cluster Platform

procedure iconsmall spaceTo Create an mcf File for a Sun StorEdge QFS Shared File System on a Sun Cluster

(Optional) Editing mcf Files on Other Hosts

procedure iconsmall spaceTo Edit mcf Files on Other Hosts in a Sun Cluster for a Sun StorEdge QFS Highly Available File System

procedure iconsmall spaceTo Edit mcf Files on Other Hosts for a Sun StorEdge QFS Shared File System

Examples

(Optional) Creating the Shared Hosts File

procedure iconsmall spaceTo Create the Shared Hosts File on the Metadata Server

Example for Solaris OS Hosts

Example for Sun Cluster Hosts

procedure iconsmall space(Optional) To Create the Local Hosts File on a Client

Obtaining Addresses

Example

Initializing the Environment

procedure iconsmall spaceTo Initialize the Environment

(Optional) Editing the defaults.conf File

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

(Optional) Creating the samfs.cmd File

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

Example for a Sun StorEdge QFS File System

Example for a Sun StorEdge QFS Shared File System

(Optional) Verifying That the Daemons Are Running

procedure iconsmall spaceTo Verify the Daemons

Mounting the File System

procedure iconsmall spaceTo Mount the File System on One Host

procedure iconsmall space(Optional) To Verify Metadata Server Changes

(Optional) Configuring the SUNW.qfs Resource Type

procedure iconsmall spaceTo Enable a Sun StorEdge QFS Shared File System as a SUNW.qfs(5) Resource

(Optional) Configuring the HAStoragePlus Resource

procedure iconsmall spaceTo Configure a Sun StorEdge QFS Highly Available File System as an HAStoragePlus Resource

(Optional) Sharing the File System With NFS Client Systems

procedure iconsmall spaceTo NFS Share the File System in a Sun Cluster Environment

procedure iconsmall spaceTo NFS Share the File System in a Solaris OS Environment

procedure iconsmall spaceTo NFS Mount the File System on NFS Clients in a Solaris OS Environment

(Optional) Bringing the Shared Resource Online

procedure iconsmall spaceTo Bring the Shared Resource Online

(Optional) Verifying the Resource Group on All Nodes

procedure iconsmall spaceTo Verify the Resource Group on All Nodes

Establishing Periodic Dumps Using qfsdump(1M)

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

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

(Optional) Backing Up Configuration Files

(Optional) Configuring the Remote Notification Facility

procedure iconsmall spaceTo Enable Remote Notification

procedure iconsmall spaceTo Disable Remote Notification

(Optional) Adding the Administrator Group

procedure iconsmall spaceTo Add the Administrator Group

Configuring System Logging

procedure iconsmall spaceTo Enable Logging

(Optional) Configuring Other Products

3. Sun StorEdge QFS Upgrade Procedure

Ensuring That the Installation Prerequisites Are Met

(Optional) Backing Up Existing File Systems

Using the Version 1 and Version 2 Superblocks

procedure iconsmall spaceTo Back Up Each File System

(Optional) Unsharing the File Systems

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

procedure iconsmall spaceTo Unmount a Sun StorEdge QFS Shared File System

Removing Existing Sun StorEdge QFS Software

procedure iconsmall spaceTo Remove Software From a 4.1 Release

procedure iconsmall spaceTo Remove Software From a 4.0 Release

Adding the Packages

procedure iconsmall spaceTo Add the Packages

Updating the License Keys

procedure iconsmall space(Optional) To License the Sun StorEdge QFS Software

(Optional) Enabling the SAM-QFS Manager

Verifying the License and mcf Files

procedure iconsmall spaceTo Verify the License File

procedure iconsmall spaceTo Verify the mcf File

(Optional) Modifying the /etc/vfstab File

procedure iconsmall spaceTo Modify the /etc/vfstab File

(Optional) Reinitializing and Restoring the File Systems

procedure iconsmall spaceTo Reinitialize and Restore the File Systems

(Optional) Checking the File System

Mounting the File Systems

procedure iconsmall spaceTo Mount the File System

(Optional) Recompiling API-Dependent Applications

4. 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

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

procedure iconsmall spaceTo Verify Device Types

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

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

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

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

(Optional) Enabling the SAM-QFS Manager

procedure iconsmall spaceTo Install the SAM-QFS Manager Software

Using 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

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

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

Initializing the Sun StorEdge SAM-FS Environment

(Optional) Checking the Drive Order

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

(Optional) Creating the archiver.cmd File

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

(Optional) Enabling Disk Archiving

procedure iconsmall spaceTo Enable Disk Archiving on the Host That Contains the Files to Be Archived

procedure iconsmall space(Optional) To Enable Disk Archiving on the Host to Which the Archive Copies Will Be Written

(Optional) Editing the defaults.conf File

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

(Optional) Labeling Removable Media Cartridges

(Optional) Populating the Catalog

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

(Optional) Creating the samfs.cmd File

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

(Optional) Sharing the File System With NFS Client Systems

procedure iconsmall spaceTo NFS Share the File System

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

(Optional) Backing Up Configuration Files

(Optional) Configuring the Remote Notification Facility

procedure iconsmall spaceTo Enable Remote Notification

procedure iconsmall spaceTo Disable Remote Notification

(Optional) Adding the Administrator Group

procedure iconsmall spaceTo Add the Administrator Group

Configuring System Logging

procedure iconsmall spaceTo Enable Logging

(Optional) Configuring Other Sun StorEdge Products

5. Sun StorEdge SAM-FS Upgrade Procedure

Ensuring That the Installation Prerequisites Are Met

(Optional) Backing Up Existing File Systems

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

(Optional) Unsharing the File Systems

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.1 Release

procedure iconsmall spaceTo Remove Software From a 4.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 space(Optional) To License the Sun StorEdge SAM-FS Software

(Optional) Enabling the SAM-QFS Manager

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 space(Optional) To Verify the archiver.cmd File

(Optional) Modifying the /etc/vfstab File

procedure iconsmall spaceTo Modify the /etc/vfstab File

(Optional) Reinitializing and Restoring the File Systems

procedure iconsmall spaceTo Reinitialize and Restore the File Systems

(Optional) Checking the File System

Mounting the File Systems

procedure iconsmall spaceTo Mount the File System

(Optional) Recompiling API-Dependent Applications

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

Web Server Logging

Tracing

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

procedure iconsmall spaceTo Enable Tracing or To Adjust the Tracing Level

SAM-QFS Manager Daemon Information

procedure iconsmall spaceTo Determine Whether the RPC Daemon Is Running

B. 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

C. Command Reference

User Commands

General System Administrator Commands

File System Commands

Automated Library Commands

Archiver Commands

Specialized Maintenance Commands

Site-Customizable Scripts

Application Programming Interface

Operational Utilities

Glossary