Sun Logo


Sun StorageTek QFS Installation and Upgrade Guide

Version 4, Update 6

819-7936-10



Contents

Tables

Preface

1. Planning Your File System

Product Overview

About the SAM-QFS File System

About Shared Sun StorageTek QFS File Systems and the Linux Client

About the Sun Cluster Environment

Installation Process Overview

2. Preparing For Installation

Hardware and Software Requirements

Hardware Requirements

Operating System Requirements

procedure iconsmall spaceTo Verify the Environment

Installing Solaris OS Patches

Verifying Third-Party Compatibilities

Verifying Sun StorageTek QFS Shared File System Requirements

Metadata Server Requirement

Operating System and Hardware Requirements

Sun StorageTek QFS Release Levels

Verify Requirements for a Sun Cluster Environment

Example: Verifying Devices and Device Redundancy

Performance Considerations

Verifying Requirements for File System Manager

Hardware Requirements

Browser Requirements

Operating System Requirements

Web Software Requirements

Determining Disk Space Requirements

Planning Your File System and Verifying Disk Cache

procedure iconsmall spaceTo Estimate Disk Cache Requirements

Verifying Disk Space

procedure iconsmall spaceTo Verify Disk Space

Obtaining the Release Files

procedure iconsmall spaceTo Obtain the Software From the Sun Download Center

Software Licensing

Setting Up the Network Management Station

3. Installing and Configuring Sun StorageTek QFS

Quick Start Instructions

procedure iconsmall spaceTo Install the Packages

procedure iconsmall spaceTo Enable SAM-QFS Logging

procedure iconsmall spaceTo Enable SAM-QFS Daemon Tracing

procedure iconsmall spaceTo Set Up the root PATH Variables

procedure iconsmall spaceTo Set Up Stand-alone QFS

procedure iconsmall spaceSet Up Shared QFS

Commands to Monitor Shared QFS

procedure iconsmall spaceTo Enable Network Time Protocol Daemon (Shared QFS)

procedure iconsmall spaceTo Set Up the Network File System

Detailed Installation Instructions

Installing the Software Packages

procedure iconsmall spaceTo Add the Packages

Installing the Linux Client Software

procedure iconsmall spaceTo Set Up PATH and MANPATH Variables

Installing the File System Manager Software

procedure iconsmall spaceTo Install the File System Manager Software

procedure iconsmall spaceTo Set the Session Timeout

Using the File System Manager Software

procedure iconsmall spaceTo Add Users

Assigning Privilege Levels

procedure iconsmall spaceTo Create an Account for Multiple Users

procedure iconsmall spaceTo Invoke File System Manager for the First Time

Setting Up the Environment Configuration

procedure iconsmall spaceTo Create an mcf File Using File System Manager

procedure iconsmall spaceTo Create an mcf File Using a Text Editor

procedure iconsmall spaceTo Verify the mcf File

Setting Up Mount Parameters

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

procedure iconsmall spaceTo Update the /etc/vfstab File Using File System Manager

procedure iconsmall spaceTo Update the /etc/vfstab File and Create the Mount Point Using a Text Editor

Creating and Editing the samfs.cmd File

procedure iconsmall spaceTo Create and Edit the samfs.cmd File Using File System Manager

procedure iconsmall spaceTo Create and Edit the samfs.cmd File Using a Text Editor

Initializing the Environment

procedure iconsmall spaceTo Initialize the Environment

procedure iconsmall spaceTo Initialize the File System

Initializing a Sun StorageTek QFS File System

Initializing a Sun StorageTek QFS Shared File System

Mounting the File System

procedure iconsmall spaceTo Mount the File System Using File System Manager

procedure iconsmall spaceTo Mount the File System on One Host From the Command Line

procedure iconsmall spaceTo Verify Metadata Server Changes

Performing Additional Configuration

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

Notes on NFS Sharing

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

procedure iconsmall spaceTo Change Default Values

Configuring the Remote Notification Facility

procedure iconsmall spaceTo Enable Remote Notification

procedure iconsmall spaceTo Disable Remote Notification

Adding the Administrator Group

procedure iconsmall spaceTo Add the Administrator Group

procedure iconsmall spaceTo Enable Logging

Configuring Other Products

Backing Up Data

Setting Up Dump Files

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

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

Backing Up Configuration Files

4. Configuring a Shared or Sun Cluster Configuration

Preparing the Host Systems

procedure iconsmall spaceTo Prepare the Host Systems

Editing mcf Files on Other Hosts

procedure iconsmall spaceTo Edit mcf Files for a Highly Available File System in a Sun Cluster Environment

procedure iconsmall spaceTo Edit mcf Files for a Sun StorageTek QFS Shared File System

Examples

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 spaceTo Create the Local Hosts File on a Client

How Metadata Server Addresses Are Obtained

Example

Verifying That the Daemons Are Running

procedure iconsmall spaceTo Verify the Daemons

Configuring the SUNW.qfs Resource Type

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

Configuring the HA Storage Plus Resource

procedure iconsmall spaceTo Configure a Highly Available File System as an HA Storage Plus Resource

Bringing the Shared Resource Online

procedure iconsmall spaceTo Bring the Shared Resource Online

Verifying the Resource Group on All Nodes

procedure iconsmall spaceTo Verify the Resource Group on All Nodes

5. Upgrading Sun StorageTek QFS

Preparing for an Upgrade

Upgrade Considerations

Preserving Information for an Upgrade

Example 1

Example 2

Preparing for a Hardware Device Upgrade

General Prerequisites

Switching Between SPARC and AMD Platforms

Backing Up Existing File Systems

Using the Version 1 and Version 2 Superblocks

procedure iconsmall spaceTo Back Up a File System

procedure iconsmall spaceTo Unshare File Systems

Unmounting File Systems

procedure iconsmall spaceTo Unmount Using File System Manager

procedure iconsmall spaceTo Unmount Using CLI Commands

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

Removing Existing Sun StorageTek QFS Software

procedure iconsmall spaceTo Remove Existing Software

Adding the Upgrade Packages

procedure iconsmall spaceTo Add the Packages

Upgrading File System Manager

procedure iconsmall spaceTo Install the File System Manager Software

Restoring the File System

procedure iconsmall spaceTo Verify the mcf File

procedure iconsmall spaceTo Modify the /etc/vfstab File

procedure iconsmall spaceTo Reinitialize and Restore the File System

procedure iconsmall spaceTo Check the File System

Mounting the File System

procedure iconsmall spaceTo Mount the File System Using File System Manager

procedure iconsmall spaceTo Mount the File System Using the CLI

Recompiling API-Dependent Applications

Upgrading the Solaris OS

procedure iconsmall spaceTo Upgrade the Solaris OS in a Sun StorageTek QFS Environment

A. Release Package Contents

Release Package Contents

Directories and Files Created

Directories Created at Installation

Files Created at Installation

Site Files

Modified System Files

B. Uninstalling the Software

Uninstalling the Sun StorageTek QFS Linux Client Software

Uninstalling the File System Manager Software

C. Command Reference

User Commands

General System Administrator Commands

File System Commands

Application Programming Interface

Operational Utilities

D. mcf File Examples

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 Shared File System on a Solaris OS Platform

procedure iconsmall spaceTo Configure the System

Configuration Examples for Highly Available File Systems

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

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

procedure iconsmall spaceTo Create an mcf File for a Shared File System in a Sun Cluster Environment

Glossary

Index