About This Guide

This guide documents CXFS 5.6 running on a storage area network (SAN). It assumes that you are already familiar with the XFS filesystem and you have access to the XVM Volume Manager Administrator's Guide.

You should read through this entire book, especially Chapter 15, “Troubleshooting”, before attempting to install and configure a CXFS cluster.

Related Publications

For information about this release, see the SGI InfiniteStorage Software Platform (ISSP) release notes (/README.txt) and the CXFS release notes (README_NAME.txt ).

The following documents contain additional information:

  • CXFS 5 Client-Only Guide for SGI InfiniteStorage

  • XVM Volume Manager Administrator's Guide

  • SGI InfiniteStorage High Availability Using Linux-HA Heartbeat

  • Storage area network (SAN) documentation:

    • EL Serial Port Server Installation Guide (provided by Digi International)

    • EL Serial Port Server Installation Guide Errata

    • FDDIXPress Administration Guide

    • SGI InfiniteStorage RM610 and RM660 User's Guide

    • SGI® InfiniteStorage TP9400 and SGI® InfiniteStorage TP9500 and TP9500S RAID User's Guide

    • SGI InfiniteStorage TP9300 and TP9300S RAID User's Guide

    • SGI InfiniteStorage 6700 User's Guide

    • SGI Total Performance 9100 Storage System Owner's Guide

    • SGI TPSSM Administration Guide

  • SGI Foundation Software, SGI Altix, and SGI Altix XE documentation:

    • The user guide and quick start guide for your SGI Altix or SGI Altix XE system

    • Guide to Programming Environments and Tools Available on SGI Altix XE System

    • NIS Administrator's Guide

    • Personal System Administration Guide

    • Performance Co-Pilot for Linux User's and Administrator's Guide

    • SGI Foundation 1 Service Pack 5 Start Here

    • SGI L1 and L2 Controller Software User's Guide

The following man pages are provided on CXFS server-capable administration nodes:

Man Page

Software Product

cbeutil(1M)

cluster_admin

cdbBackup(1M)

cluster_admin

cdbRestore(1M)

cluster_admin

cdbconfig(1M)

cluster_admin

cdbutil(1M)

cluster_admin

cmond(1M)

cluster_admin

cxfslicense(1M)

cluster_admin

fs2d(1M)

cluster_admin

  

cms_intervene(1M)

cluster_control

cms_failconf(1M)

cluster_services

crsd(1M)

cluster_services

haStatus(1M)

cluster_services

cxfs_admin(1M)

cxfs_admin

  

cxfs-config(1M)

cxfs_util

cxfscp(1)

cxfs_util

cxfsdump(1M)

cxfs_util

  

xvm(1M)

N/A

xvm(7M)

N/A

xvm(5)

cxfs-xvm-cmds

xvm(8)

cxfs-xvm-cmds

  

cxfsmgr(1M)

sgi-sysadm_cxfs-client

  

xvmgr(1M)

sgi-sysadm_xvm-client


Obtaining Publications

You can obtain SGI documentation as follows:

  • See the SGI Technical Publications Library at http://docs.sgi.com. Various formats are available. This library contains the most recent and most comprehensive set of online books, man pages, and other information.

  • The /docs directory on the ISSP DVD or in the Supportfolio download directory contains the following:

    • The ISSP release note: /docs/README.txt

    • Other release notes: /docs/README_ NAME.txt

    • A complete list of the packages and their location on the media: /docs/RPMS.txt

    • The packages and their respective licenses: /docs/PACKAGE_LICENSES.txt

  • The release notes and manuals are provided in the noarch/sgi-isspdocs RPM and will be installed on the system into the following location:

    /usr/share/doc/packages/sgi-issp-ISSPVERSION-TITLE

  • You can view man pages by typing man title at a command line.


Note: The external websites referred to in this guide were correct at the time of publication, but are subject to change.


Conventions

This guide uses the following terminology abbreviations:

  • Linux refers to any supported distribution of Linux, including those platforms running SGI Foundation Software software, unless otherwise specified

  • Windows refers to Microsoft Windows 2000, Microsoft Windows 2003, Microsoft Windows XP, and Microsoft Windows Vista

  • SGI Foundation Software refers to SGI Foundation Software for Linux running the default kernel on SGI Altix systems and the smp kernel of SGI Altix XE systems, as specified in the release notes

The following conventions are used throughout this document:

Convention 

Meaning

command 

This fixed-space font denotes literal items such as commands, files, routines, path names, signals, messages, and programming language structures.

variable 

Italic typeface denotes variable entries and words or concepts being defined.

user input 

This bold, fixed-space font denotes literal items that the user enters in interactive sessions. (Output is shown in nonbold, fixed-space font.)

[ ] 

Brackets enclose optional portions of a command or directive line.

GUI element 

This bold font denotes the names of graphical user interface (GUI) elements, such as windows, screens, dialog boxes, menus, toolbars, icons, buttons, boxes, and fields.

<TAB> 

Represents pressing the specified key in an interactive session

server-admin# 

In an example, this prompt indicates that the command is executed on a server-capable administration node

client# 

In an example, this prompt indicates that the command is executed on a client-only node

MDS# 

In an example, this prompt indicates that the command is executed on an active metadata server

node# 

In an example, this prompt indicates that the command is executed on an any node

specificnode# 

In an example, this prompt indicates that the command is executed on a node named specificnode

This guide uses Windows to refer to both Microsoft Windows 2000 and Microsoft Windows XP nodes when the information applies equally to both. Information that applies to only one of these types of nodes is identified.

Reader Comments

If you have comments about the technical accuracy, content, or organization of this publication, contact SGI. Be sure to include the title and document number of the publication with your comments. (Online, the document number is located in the front matter of the publication. In printed publications, the document number is located at the bottom of each page.)

You can contact SGI in any of the following ways:

  • Send e-mail to the following address:

    [email protected]

  • Contact your customer service representative and ask that an incident be filed in the SGI incident tracking system.

  • Send mail to the following address:

    SGI
    Technical Publications
    46600 Landing Parkway
    Fremont, CA 94538

SGI values your comments and will respond to them promptly.