Sun Logo


Sun StorEdge QFS Installation and Upgrade Guide

Version 4, Update 4

819-2757-10



Contents

Tables

Preface

procedure iconsmall spaceTo Access Documentation From docs.sun.com

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

1. Planning Your File System

Product Overview

About the SAM-QFS File System

About Shared Sun StorEdge QFS File Systems and the Linux Client

About the Sun Cluster Environment

Installation Process Overview

2. Pre-installation Tasks

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 StorEdge QFS Shared File System Requirements

Metadata Server Requirement

Operating System and Hardware Requirements

Sun StorEdge QFS Release Levels

Verifying 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. Installation and Configuration Tasks

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 and Using the File System Manager Software

procedure iconsmall spaceTo Install the File System Manager Software

Using the File System Manager Software

procedure iconsmall spaceTo Invoke File System Manager for the First Time

Setting Up the Environment Configuration

procedure iconsmall spaceTo Create an mcf File Using the File System Manager Software

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 StorEdge QFS File System

Initializing a Sun StorEdge 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 Tasks

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. Configuration Tasks for 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 StorEdge 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 StorEdge 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. Upgrade and Configuration Tasks

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 StorEdge QFS Software

procedure iconsmall spaceTo Remove Existing Software

Adding the Upgrade Packages

procedure iconsmall spaceTo Add the Packages

Installing 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

To 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 StorEdge 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 StorEdge 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