ADIC 2.2 manual

SNFS StorNext ® File System Inst allation Guide for UNIX Users StorNext FS V ersion 2.2 Document Number: 6-00905-01 Rev A[...]

ADIC • 10 BROWN ROAD • ITHACA, NE W YORK, USA • 1-607-241-480 0 ADIC CORPORATE • 11431 WI LLOWS ROAD, NE • REDMOND, WA SHINGTON, USA • 1-800-336-123 3 ADIC • 8560 UPLAND DRIVE • ENGLEW OOD, COLORADO, USA • 1-80 0-827-3822 Copyright Notice © 2002 , 2003 ADIC ® The information contained in this document is subject to change withou[...]

SNFS License Agr eement iii Advanced Digital Information Corporation Softwar e Licenses Agr eement This Software License is entered in to and ef fective as of this _____, day of_____________ 2003 ("Effective Date"), by and between: This License sets forth the terms and condi tions under which ADIC agrees to grant and Licensee agrees to ac[...]

SNFS iv 6-00905-01 Rev A “ Softwar e ” means only the current version of those software products specified in Exhibit A hereto, in object code form only , a nd the Documentation provided by ADIC in connection therewith or any portions th ereof, and any subsequent Releases. " Upgrade " means a modification to the Software th at adds si[...]

SNFS License Agr eement v d. T ransfer Rights . The Software will be installed initially on Licensee's Designated Computer(s) set forth in Exhibit A. Licensee may thereafter transfer the Software to another one of its computer s of the same machine arch itecture, provided that the Software is installed on one (1) Designated Computer at a time,[...]

SNFS vi 6-00905-01 Rev A ii. remove, obscure, or alter any copyright, tr ade secret, trademark, patent or other proprietary rights notice affixed to or di splayed on the Software or Documentation or affixed to or printed on a ny of its factory packaging; iii. modify , merge with other programs or tr anslate any portion of the Software into any othe[...]

SNFS License Agr eement vii Use and T raining Licensee will limit the use of the Softwa re to those individuals who have been appropriately trained. ADIC will make training for the Softwa re available to Licensee pursuant to its standard training procedur es. Unless otherwise mutually agreed, any additional training will be provided at ADIC's [...]

SNFS viii 6-00905-01 Rev A d. W arranty Exclusions . This warranty is made void if the Licensee or any other third party makes any modifications to the Software. Licensee will pay ADIC for corrections necessitated by difficulties or defects traceable to Licensee's errors or system changes in accordance with ADIC's th en current standard t[...]

SNFS License Agr eement ix deemed necessary , and conduct the defense a nd settlement of such claim. ADIC may , at its own expense and at its option, either (1) procure for Licensee the right to continue using the Software, or (2) replace the same with n on-infringing software, or (3) modify the Software so that it be comes non-infringing provided [...]

SNFS x 6-00905-01 Rev A b. T ermination . This License commences on the Effective Date and will continue in perpetuity unless Licensee fails to comply wi th any of the material conditions of this License. ADIC may , after allowing Licensee a reasonable time to cure its default, terminate this License upon writ ten notice to the Licensee. W ithin th[...]

SNFS License Agr eement xi OR PROPER TY DAMAGE ARISING OUT OF OR IN CONNECTION WITH THIS LICENSE OR THE USE, PERFORMANCE OR NON-PERFORMANCE OF THE SOFTW ARE, WHETHER IN ACTION, IN CONTRACT , OR TOR T INCLUDING NEGLIGENCE, EVEN IF ADIC KNEW , SHOULD HA VE KNOWN OR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. ADIC's LIAB ILITY FOR DAMAGE[...]

SNFS xii 6-00905-01 Rev A Entirety Licensee acknowledges that it ha s read this Software License, understands it, and agrees to be bound by its terms and conditions. Further , Licensee agrees that this is the complete and exclusive statement of the agreement betw een the parties and supe rsedes all proposals or prior agreements, oral or written and[...]

SNFS Contents 1 Introduction Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 Who Should Read this Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 -1 How This Book is O rganized . . . . . . . . . . . . . .[...]

SNMS 2 6-00905-01 Rev A Using Optional Pre-Installation C onfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7 Summary of Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8 Power Up Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

SNFS Contents 3 Setting Up StorNext FS on Linux Roadmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1 Installation Procedure for Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Prerequisites . . . . . . . . .[...]

SNMS 4 6-00905-01 Rev A Resolving Installation Problems Roadmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1 Resolving Problems with AIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2 Check Drive Connectivity[...]

SNFS Contents 5 Resolving Problems on Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2 0 Check Drive Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-21 Verify File System is Act ive . . . . . . . . . . . . . . . . . . . . . . . . [...]

SNMS 6 6-00905-01 Rev A[...]

SNFS Introduction 1-1 Introduction StorNext File System (StorN ext FS), formerly kn own as Centra Vision™, le ts heterogeneous clients share files across high-speed stor age Fibre Channel (FC) connections. By eliminating the need to duplicate, manage, and move multiple copies of the sa me file, StorNext FS increases storage efficiency, improves w[...]

SNFS 1-2 6-00905-01 Rev A This book contains the following chapte rs. • Chapter 2: Gett ing Started — Component descri ptions and summary of installation steps. • Chapter 3: Setting Up StorNext FS on AIX — Instructions for installing and configuring the StorNext File System. • Chapter 4: Setting Up StorN ext FS on IRIX — Instructions fo[...]

SNFS Introduction 1-3 The following symbols indica te important information. Explanation of Symbols Symbol Description Definition Consequence W ARNING: Advises y ou to take or avoid a specified action Failure to t ake or avoid this action could re sult in physical harm to the user or hardware CAUTION: Advises you to take or avoid a specified action[...]

SNFS 1-4 6-00905-01 Rev A Conventions used thro ughout this book are listed below. The following items comprise the techn ical documents supporting StorNext FS installed in a UNIX environment. These docu ments are shipped on CD along with the StorNext FS software. • StorNext FS Installation Gu ide (for UNIX Users) — Provides procedures to insta[...]

SNFS Introduction 1-5 The documentati on CD accompanying the StorNext FS product c ontains Sto rNext FS technical documents as PDF files. T o view and p rint th ese PDFs, you need Adobe® Acrobat® Reader, wh ich is available as a download from www.ad obe.com. The publications described in the fo llowing table are created and distributed on an as-n[...]

SNFS 1-6 6-00905-01 Rev A[...]

SNFS Getting Star ted 2-1 Getting S t arted T opic Refer to Chapt er Getting started: • Component description. • Installation summary. • Power up sequence. • Power dow n sequen ce. 2 On AIX: • Install StorNext FS. • Obtain license for the server. • Label the disk drives. • Configure the StorNext FS software. • Mount Stor Next FS. [...]

SNFS 2-2 6-00905-01 Rev A StorNext File System (StorNext FS) is supported on the following platforms: IBM AIX, SGI IRIX, Linux (RedHat and SuSE), Sun Solari s, Windows 2000, and Windows NT. This Guide provides instructions to install S torNext FS on su pported UNIX platforms (AIX, IRIX, Linux or Solaris). For information on installing Stor Next FS [...]

SNFS Getting Star ted 2-3 The following components comp rise the StorNext FS software. • StorNext FS server . Runs on a machine designated as the server for all StorNext FS activities. Th e StorNext FS server controls space allocation and regulates meta-d ata operations for all StorNext file sy stems. • StorNext FS client. Runs on all machines [...]

SNFS 2-4 6-00905-01 Rev A S torNext FS server ’s startup script. /etc/rc.cvfs /etc/init.d/cvfs /et c/init.d/cvfs /et c/init.d/cvfs Client Software on all S torNext FS clients. Contains the protocol interface required to communicate with the S torNext FS server . /usr/cvfs /usr/cvfs /usr/cvfs /usr/cvfs Mount Point Directory mounted (mapped) by the[...]

SNFS Getting Star ted 2-5 The StorNext FS serve r can be configured as either a dedicated or shared setup. Dedicated Setup In a dedicated setup, the Stor Next FS server has TCP/ IP connectivity to all St orNext FS clients, but it does not have Fibre Channel (FC) connec tivity to the Storage Area Network (SAN). Figure 2-1 illustrate s a dedicated se[...]

SNFS 2-6 6-00905-01 Rev A Shared Setup In a shared se tup, the Sto rNext FS serv er is also set u p as a StorNext FS client with Fibre Chan nel connectiv ity to the SAN. Figure 2-2 illustrate s a shared setup. Figure 2-2 StorNext FS server - sh ared setup TCP/IP StorNext FS server & StorNext FS client StorNext FS clients Fibre Channel Switch Di[...]

SNFS Getting Star ted 2-7 StorNext FS requires the user account www to exist in the passwd file, and the group acco unt adic to exist in the group file. During installation , StorNext FS uses a syst em utility to create these accounts if it cannot find them. • If you want the system utility to crea te the accounts, skip this section. • If you p[...]

SNFS 2-8 6-00905-01 Rev A The steps listed below summarize the StorNext FS installation proc ess. These steps are only guidelines, since the actual steps required for your site are unique. Summary of Inst allation Step s Step T ask 1 CAUTION: Back up the system data of all client machines before changing or installing any hardware or software. 2 Co[...]

SNFS Getting Star ted 2-9 5 Set up the SAN machine component s, which include the following items: • Install a Fibre Channel card. • Connect Fibre Ch annel optical and copper cab les to the s witch es or hubs. • Install Fibre Channel softw are and drivers . • If required, configure the Fibre Chann el software f or a loop or s witch network.[...]

SNFS 2-10 6-00905-01 Rev A 8 Label all the Fibre Channel disk driv es used by StorNe xt FS. F or instructions: • Ref er to Label Driv es on AIX on page 3-5 . • Ref er to Label Drives on IRIX on page 4-6 . • Ref er to Label Drives on Linux on page 5-12 . • Ref er to Label Driv es on Solaris on page 6-4 . 9 The StorNe xt FS ser ver maintains [...]

SNFS Getting Star ted 2-11 10 Mount the S torNext File System on each client machin e. For instructions, • Ref er to Mount StorNext FS on AIX on page 3-11 . • Ref er to Mount StorNext FS on IRIX on page 4-12 . • Ref er to Mount StorNext FS on Linux on page 5-18 . • Ref er to Mount StorNext FS on Solaris on page 6-11 . 11 On all StorNext FS [...]

SNFS 2-12 6-00905-01 Rev A To power up StorNext FS as part of a Fibre Channel enviro nment: Step 1 Enable FC fabric switches, if present. Step 2 Enable FC hubs, if present. Step 3 Enable FC disk arrays or disk drives . Step 4 Start the StorNext FS se rver . Power Up Sequence StorNext FS ser ver[...]

SNFS Getting Star ted 2-13 Step 5 Start all StorNext FS clients, in an y order . To power down StorNext FS: Step 1 Unmount all StorNext FS clients. Step 2 Shut down all StorNext FS clients, in any order. Step 3 Shut down the StorNext FS server . Step 4 Disable FC disk arrays or disk drive s. Step 5 Disable FC hubs, if present. Step 6 Disable FC fab[...]

SNFS 2-14 6-00905-01 Rev A[...]

SNFS Setting Up StorNext FS on AIX 3-1 Setting Up S torNext FS on AIX Roadmap T opic Refer to Chapt er Getting started: • Component description. • Installation summary. • Power up sequence. • Power dow n sequen ce. 2 On AIX: • Install StorNext FS. • Obtain license for the server. • Label the disk drives. • Configure the StorNext FS [...]

SNFS 3-2 6-00905-01 Rev A The installation and configuration of the StorNext File System (StorNext FS) on AIX includes the following procedures. On Solaris: • Install StorNext FS. • Obtain license for the se rver. • Label the disk drive s. • Configure the StorNe xt FS softwar e. • Mount StorNext FS. 6 T roubleshooting procedure s 7 Inst a[...]

SNFS Setting Up StorNext FS on AIX 3-3 Inst all StorNext FS on AIX To install StorNext FS on AIX: Step 1 Designate one AIX mach ine as the StorNext FS server. Step 2 Log onto th e machine as root . Step 3 Insert the StorNext File System CD into the drive and wait for the hardware to access it. Step 4 Run the installp utility to start th e AIX insta[...]

SNFS 3-4 6-00905-01 Rev A Obt ain License for AIX Server The StorNext FS server must have a va lid license. To obtain the license file: Step 1 Run the StorNext FS host identifier utility. Enter: # usr/cvfs/bin/cvfsid The output looks similar to this. 690CB94A sun 1 <host_name> The hexadecima l number is unique to the ser ver and the host_name[...]

SNFS Setting Up StorNext FS on AIX 3-5 Label Drives on AIX You must label each drive to be used by StorNext FS. A new drive needs to be labeled only one time. Drive labeling can be per formed from any Stor Next client that has a Fibre Channel connection to the drive. To label a drive: Step 1 From the system prompt on an y StorNext FS client, displa[...]

SNFS 3-6 6-00905-01 Rev A You can create any conventio n for the label na mes. For example, if a site cons ists of 12 Fibre Channel drives, you can use CvfsDisk[n] for each label name. Replace [n] with a decimal number starting at 0 and increment the number for each drive. In this case, the label name en tries in the file would be: CvfsDisk0 , Cvfs[...]

SNFS Setting Up StorNext FS on AIX 3-7 Configure S torNext FS Software on AIX To configure the StorNext FS software on an AIX machine, you have to configure the softwar e on both the StorNext FS server and clients. Server Configuration Step 1 Create a StorNext FS-mana ged file system by copying /usr/cvfs/examples/ example.cfg and renaming it. Ente [...]

SNFS 3-8 6-00905-01 Rev A DISK section - Identifies the di sk drive that is labeled and av ailable to StorNext F S. A disk type describes a category of disks with a capa city specified in number of se ctors. The following parts co mprise a disk def inition: • The required keyword Disk preceded by the open br acket symbol ( [ ) and followed by the[...]

SNFS Setting Up StorNext FS on AIX 3-9 Examples of stripe groups appe ar in the configuration file. • Find the stripe group named RegularFiles . • Edit the Node entries so that all the disk n ames are listed, with each entry followed by a space and then the stripe order nu mber (0, 1, 2, etc.) . For example: Step 3 Save, name and exit the /usr/[...]

SNFS 3-10 6-00905-01 Rev A Step 6 Create the fsmlist file. Enter: # cd /usr/cvfs/config # cp ../examples/fsmlist.example ./fsmlist Step 7 Edit /usr/cvfs/config/fsmlist so that it contains the names of all StorNext File Systems. Client Configuration Step 1 Create the fsna meservers file by copy ing /usr/cvfs/examples/ fsnameservers.example and renam[...]

SNFS Setting Up StorNext FS on AIX 3-11 Mount St orNext FS on AIX To mount StorNext FS: Step 1 Create the StorNext FS mount dire ctory. For example: # mkdir /usr/clips Step 2 Add the uniquel y named StorNext FS-managed file system to the /etc/filesystems file. Use cvfs as the vfs and file system type. The en try should be simila r to this format: /[...]

SNFS 3-12 6-00905-01 Rev A[...]

SNFS Setting Up StorNext FS on IRIX 4-1 Setting Up S torNext FS on IRIX Roadmap T opic Refer to Chapt er Getting started: • Component description. • Installation summary. • Power up sequence. • Power dow n sequen ce. 2 On AIX: • Install StorNext FS. • Obtain license for the server. • Label the disk drives. • Configure the StorNext F[...]

SNFS 4-2 6-00905-01 Rev A The installation and configu ration of th e StorNext File System (Sto rNext FS) on IRIX incl udes the following procedures. On Solaris: • Install StorNext FS. • Obtain license for the se rver. • Label the disk drive s. • Configure the StorNe xt FS softwar e. • Mount StorNext FS. 6 T roubleshooting procedure s 7 I[...]

SNFS Setting Up StorNext FS on IRIX 4-3 Inst all StorNext FS on IRIX To install StorNext FS on IRIX: Step 1 Designate one IRIX machine as the StorNext FS server. Step 2 Log onto th e machine as root. Step 3 Insert the StorNext File System CD into the drive and wait for the hardware to access it. Step 4 Mount the CD by associating it with a mount po[...]

SNFS 4-4 6-00905-01 Rev A Step 6 Click Toolchest > System > Software Manager. Step 7 In the Available Software text box, type this path: f /CDROM/StorNextFS/sgi/dist/dist65 [mf] Step 8 Click Customize In stallation . Step 9 From the list, select the it ems you want to install. • Install the base and services files on all StorNext FS clients[...]

SNFS Setting Up StorNext FS on IRIX 4-5 Obt ain License for IRIX Server The StorNext FS server must have a va lid license. To obtain the license file: Step 1 Run the StorNext FS host identifier utility. Enter: # usr/cvfs/bin/cvfsid The output looks similar to this. 690CB94A sgi 1 < host_name> The hexadecimal num ber is unique to the server an[...]

SNFS 4-6 6-00905-01 Rev A Label Drives on IRIX You must label each drive to be used by StorNext FS. A new driv e needs to be labeled only one time. Drive labeling can be performe d from any Stor Next client that has a Fibre Channel connectio n to the drive. To label a drive: Step 1 From the system prom pt on any StorNext FS client, display a list o[...]

SNFS Setting Up StorNext FS on IRIX 4-7 You can create any convention fo r the label na mes. For examp le, if a si te consists of 12 Fibre Channel drives, you can use CvfsDisk[n] for each label name. Replace [n] with a decimal number starting at 0 and increment the number for each drive . In this case, the label name en tries in the file would be: [...]

SNFS 4-8 6-00905-01 Rev A Configure St orNext FS Software on IRIX To configure the StorNext FS softwa re on an IRIX machine, you have to configure th e software on the StorNext FS server and StorNext FS clients. Server Configuration Step 1 Create a StorNext FS-managed file system by copying /usr/cvfs/examples/ example.cfg and renaming it. # cd/usr/[...]

SNFS Setting Up StorNext FS on IRIX 4-9 To obtain the number of sectors where the disks are set, use the cvlabel -1 command. If you are using di sk devices tha t do not h ave the sam e number of sector s, then sev eral disk types can be specified to handle each common number o f sectors. DISK section - Identifies the di sk drive that is labeled and[...]

SNFS 4-10 6-00905-01 Rev A Examples of stripe groups appe ar in the configuration file. • Find the stripe group named RegularFiles . • Edit the Node entries so that all the disk na mes are listed, with each entry followed by a space and then the stripe order nu mber (0, 1, 2, etc.). For example: Step 3 Save, name and exit the /usr/cvfs/config/ [...]

SNFS Setting Up StorNext FS on IRIX 4-11 Step 5 Initialize StorNext FS. Enter: # cd /usr/cvfs/bin/cvmkfs < file_system_name> Step 6 Create the fsmlist file. Enter: # cd /usr/cvfs/config # cp ../examples/fsmlist.example ./fsmlist Step 7 Edit /usr/cvfs/config/fsmlist so that it contain s the names of all StorNext File Systems. Client Configurat[...]

SNFS 4-12 6-00905-01 Rev A Mount St orNext FS on IRIX To mount StorNext FS: Step 1 Create the StorNext FS mount directory. For example, enter: # mkdir /usr/clips Step 2 Add the uniquely named StorNext FS-managed file system to the /etc/fstab file. Use cvfs as the file system type. <file_system_name> /usr/clips cvfs rw,threads=6 0 0 where: On [...]

SNFS Setting Up StorNext FS on Linux 5-1 Setting Up S torNext FS on Linux Roadmap T opic Refer to Chapt er Getting started: • Component description. • Installation summary. • Power up sequence. • Power dow n sequen ce. 2 On AIX: • Install StorNext FS. • Obtain license for the server. • Label the disk drives. • Configure the StorNext[...]

SNFS 5-2 6-00905-01 Rev A The installation an d configuration of the StorNext File System (StorNext FS) on Linux includes the following procedures. On Solaris: • Install StorNext FS. • Obtain license for the se rver. • Label the disk drive s. • Configure the StorNe xt FS softwar e. • Mount StorNext FS. 6 T roubleshooting procedure s 7 Ins[...]

SNFS Setting Up StorNext FS on Linux 5-3 Prerequisites Consider these prerequisites when working with Linux servers and clients: • Kernel requirements • Multiple LUN support Kernel Requirements StorNext FS supports two Linux operating systems , RedHat and SuSE, that have separate kernel requireme nts. RedHat Linux - Kernel Requirements To run S[...]

SNFS 5-4 6-00905-01 Rev A SuSE Linux - Kernel Requirements To run StorNext FS on SuSE Linux, use this proce dure to determine and insta ll the required kernels, including compilers. Step 1 Check to see whether the comp iler was installed at the same time as the rest of the system. a. Query the kernel. Enter: # rpm -qi `rpm -qa | grep k_` Output sim[...]

SNFS Setting Up StorNext FS on Linux 5-5 b. Query gcc. Enter: # rpm -qi `rpm -qa | grep gcc` Output similar to th e following displays. If the dates are substantially different (hour s or days ra ther than minutes), then the compiler was probably added afte rwards and the update will not work. In this situation, SuSE Linux Enterprise 8.1 must be re[...]

SNFS 5-6 6-00905-01 Rev A Step 2 Install the base system. a. Select the language in wh ich to run the ins tall. A system page displays with an area titled “Timezone” and a place to change the “Software”. b. Click on “Software” and then click “D etailed Selections”. A two-paned window displays with check boxes on the left pane and li[...]

SNFS Setting Up StorNext FS on Linux 5-7 Step 7 Change directory ( cd ) into /usr/src and create a link to the kernel sou rce. Enter: # cd /usr/src # ln -s linux-2.4 .19.SuSE linux-2.4 Step 8 Change directory ( cd ) into linux- 2.4 and delete any leftover config files in the directory. Copy the original config file into the current directory and re[...]

SNFS 5-8 6-00905-01 Rev A Step 12 Edit the /boot/grub/menu.lst file so the kernel can be booted. Make edits to reflect the new kernel co nfiguration parameters. file /boot/grub/menu.lst before changes: title linux kernel (hd1,0)/boot/vmlinuz root=/dev/sdb1 vga=791 initrd (hd1,0)/boot/initrd title floppy root (fd0) chainloader +1 file /boot/grub/men[...]

SNFS Setting Up StorNext FS on Linux 5-9 For example: Step 2 Create a new initial RAM disk file by using the mkinitrd command. For example: # cd /boot mkinitrd -f initrd-2.4.18.17.7.xsmp.img 2.4.18-17.7.xsmp Step 3 Reboot the system. Inst all StorNext FS on Linux To install StorNext FS on Linux: Step 1 Log onto th e machine as root . Step 2 Insert [...]

SNFS 5-10 6-00905-01 Rev A • If you use a Unipro cessor system, install the server and client files, i ncluding the word up in the f ilenames. Fo r examp le: # rpm -ivh cvfs-server.7.3_2417up-2.1.1-62.i386.rpm # rpm -ivh cvfs-client.7.3_2417up-2.1.1-62.i386.rpm • If you use a Multiprocessor syste m, install the server and c lie nt files, includ[...]

SNFS Setting Up StorNext FS on Linux 5-11 Step 10 Return to Step 1 to install Stor Next F S on anot her Linux m achine. Obt ain License for Linux Server The StorNext FS server must have a va lid license. To obtain the license file: Step 1 Verify that /etc/hosts has a proper entry for the system name. Step 2 Run the StorNext FS host identi fier util[...]

SNFS 5-12 6-00905-01 Rev A Label Drives on Linux You must label each drive to be used by StorNext FS. A new driv e needs to be labeled only one time. Drive labeling can be performe d from any Stor Next client that has a Fibre Channel connectio n to the drive. To label a drive: Step 1 From the system prom pt on any StorNext FS client, display a list[...]

SNFS Setting Up StorNext FS on Linux 5-13 Step 3 Create /usr/cvfs/config/cvlabels from the c opy of the StorNext FS label file example. Enter: # /usr/cvfs/bin/cvlabel -c > /usr/cvfs/config/cvlabels The created file displays an entry for disk located by the cvlabel command . Step 4 Edit /usr/cvfs/config/cvlabels file to provide a unique name fo r[...]

SNFS 5-14 6-00905-01 Rev A Configure St orNext FS Sof tware on Linux To configure the StorNe xt FS software on a Linux machine, you have to configure the software on the StorNext FS server and StorNext FS clients. Server Configuration Step 1 Create a StorNext FS-managed file system by copying /usr/cvfs/examples/ example.cfg to /usr/cvfs/config/ <[...]

SNFS Setting Up StorNext FS on Linux 5-15 DISK section - Identifies the disk type to be assigned to a disk drive that is labeled and available for StorNext FS. A disk type descr i bes a category of disks with a capacity specified in number of sectors. The following parts compr ise a disk definition: • The required keyword Disk preceded by the ope[...]

SNFS 5-16 6-00905-01 Rev A Examples of stripe groups appe ar in the configuration file. • Find the stripe group named RegularFiles . • Edit the Node entries so that all the disk na mes are listed, with each entry followed by a space and then the stripe order nu mber (0, 1, 2, etc.). For example: Step 3 Save the configura tion file. Step 4 Launc[...]

SNFS Setting Up StorNext FS on Linux 5-17 Step 7 In the fsmlist file, add the names of all of the StorNext File Systems. Step 8 Create a na meserver list by copying the /usr/cvfs/examples/fsnameservers.example to the /usr/cvfs/config/fsnameservers file. Enter: # cd /usr/cvfs/config # cp ../examples/fsnameservers.example ./fsnameservers Step 9 In th[...]

SNFS 5-18 6-00905-01 Rev A Mount St orNext FS on Linux To mount StorNext FS: Step 1 Create the StorNext FS mount directory. This is the path by which users access the file system. For example: # mkdir /usr/clips # chmod 777 /usr/clips Step 2 Add the StorNext FS name to the /etc/fstab file. Use cvfs as the file system ty pe. For example: # projA /us[...]

SNFS Setting Up StorNext FS on Solaris 6-1 Setting Up S torNext FS on Solaris Roadmap T opic Refer to Chapt er Getting started: • Component description. • Installation summary. • Power up sequence. • Power dow n sequen ce. 2 On AIX: • Install StorNext FS. • Obtain license for the server. • Label the disk drives. • Configure the Stor[...]

SNFS 6-2 6-00905-01 Rev A The installation and configuration of the StorNext F ile System (StorNext FS) on Solaris includes the following procedures. On Solaris: • Install StorNext FS. • Obtain license for the se rver. • Label the disk drive s. • Configure the StorNe xt FS softwar e. • Mount StorNext FS. 6 T roubleshooting procedure s 7 I[...]

SNFS Setting Up StorNext FS on Solaris 6-3 Inst all StorNext FS on Solaris To install StorNext FS on Solaris: Step 1 Designate one Solaris machine as the StorNext FS server. Step 2 Log onto th e machine as root . Step 3 Insert the StorNext File System CD into the drive and wait for the hardware to access it. Step 4 Run the pkgadd utility to start t[...]

SNFS 6-4 6-00905-01 Rev A Obt ain License for Solaris Server The StorNext FS server must hav e a va lid license. To obtain the license file: Step 1 Run the StorNext FS host identifier utility. Enter: # usr/cvfs/bin/cvfsid The output looks similar to this. 690CB94A sun 1 <host_name> The hexadecima l number is unique to the ser ver and host_nam[...]

SNFS Setting Up StorNext FS on Solaris 6-5 Step 2 From the output information, identify any drives that are un used or do not have a recognized Volum e Type and write do wn their associated device names. Step 3 Create /usr/cvfs/config/cvlabels from the c opy of the StorNext FS label file example. Enter: # cd/usr/cvfs/config # cp ../examples/cvlabel[...]

SNFS 6-6 6-00905-01 Rev A Step 4 Edit /usr/cvfs/config/cvlabels so that it contains a list of Stor Next FS label names that correspond to the device names of the drives captured in Step 2. You can create any conventio n for the label na mes. For example, if a site cons ists of 12 Fibre Channel drives, you can use CvfsDisk[n] for each label name. Re[...]

SNFS Setting Up StorNext FS on Solaris 6-7 Configure S torNext FS Software on Solaris To configure the Stor Next FS software on a Solari s machine, you have to configure the software on the StorNext FS server and S torNext FS clients. Server Configuration Step 1 Create a StorNext FS-mana ged file system by copying /usr/cvfs/examples/ example.cfg an[...]

SNFS 6-8 6-00905-01 Rev A For example: The SectorSize should reflect the Sector For mat Si ze of the disk d rives, for e xample: 512, 4096, 8192, 16384. To obtain the number of sectors where the disks are set, use the cvlabel -1 command . If you are using disk de vices that do not hav e the same number of sectors, then sev eral disk types can be sp[...]

SNFS Setting Up StorNext FS on Solaris 6-9 STRIPEGROUP DEFINITION sectio n - Describes a gro up of disks that comprise a stripe group. One or more stripe group s describe the entire file system. A stripe group is the smallest entity that can be manipulated by a system administrator us ing the File System Administration utility ( cvadmin ). Examples[...]

SNFS 6-10 6-00905-01 Rev A Step 5 Initialize StorNext FS. Enter: # cd /usr/cvfs/bin/cvmkfs < file_system_name> # cp ../examples/fsmlist.example ./fsmlist Step 6 Create the fsmlist file. Enter: # cd /usr/cvfs/config # cp ../examples/fsmlist.example ./fsmlist Step 7 Edit /usr/cvfs/config/fsmlist so that it contains the names of all StorNext Fil[...]

SNFS Setting Up StorNext FS on Solaris 6-11 Mount St orNext FS on Solaris To mount StorNext FS: Step 1 Create the StorNext FS mount dire ctory. For example: # mkdir /usr/clips Step 2 Add the uniqu ely named StorNext FS-managed file system to the /etc/vfstab file. Use cvfs as the file system type. <file_system_name> /usr/clips cvfs - yes rw,th[...]

SNFS 6-12 6-00905-01 Rev A[...]

SNFS Resolving Installation Problems 7-1 Resolving Inst allation Problems Roadmap T opic Refer to Chapt er Getting started: • Component description. • Installation summary. • Power up sequence. • Power dow n sequen ce. 2 On AIX: • Install StorNext FS. • Obtain license for the server. • Label the disk drives. • Configure the StorNext[...]

SNFS 7-2 6-00905-01 Rev A To resolve proble ms with a St orNext File System (StorNext FS) installation on AIX: On Solaris: • Install StorNext FS. • Obtain license for the se rver. • Label the disk drive s. • Configure the StorNe xt FS softwar e. • Mount StorNext FS. 6 T roubleshooting procedure s 7 Resolving Problems with AIX T opic Page [...]

SNFS Resolving Installation Problems 7-3 Check Drive Connectivity Step 1 On the StorNext FS server, log in as root. Step 2 Check for access to the Fibre Channel drive s. Enter: cvlabel -l V erify that the File System is Active Step 1 On the StorNext FS server, log in as root. Step 2 Verify that the file system is active. Enter: cvadmin> select f[...]

SNFS 7-4 6-00905-01 Rev A V erify the StorNext FS Setup Step 1 On the Sto rNext FS server, log in as root. Step 2 Verify the number of active StorNext FS clients using the default file system. a. Launch cvadmin. Enter: cvadmin Several status messages display. b. Select the file syst em. Enter: select file_system_name Output similar to th e follow i[...]

SNFS Resolving Installation Problems 7-5 V erify the Mounted File System To verify that StorNext FS is correc tly mounted on a Stor Next FS client: Step 1 On a StorNext FS clie nt, log in as root. Step 2 Verify the StorNext FS mount on the client. Enter: df -k A status message, similar to the follow ing, displays: File System kbytes Use Avail % use[...]

SNFS 7-6 6-00905-01 Rev A Unmount and Remount All File Systems To unmount and remo unt all Stor Next File Systems lis ted in /etc/filesystems (suc h as to troubleshoot or for system ma intenance): Step 1 On a StorNext FS clie nt, log in as root. Step 2 Unmount all StorNext File Systems listed in the /etc/filesystems file. Enter: umount -t cvfs Step[...]

SNFS Resolving Installation Problems 7-7 Reinitialize St orNext FS To reinitialize a StorNext FS: Step 1 On the StorNext FS server, log in as root. Step 2 Unmount the specific StorNe xt FS from all c lients. Step 3 In a system shell window, use the File System Administrator utility to stop the s pecific file system. a. Start cvadmin. Enter: cvadmin[...]

SNFS 7-8 6-00905-01 Rev A Step 6 Start the file system using the File System Administrator utility. a. Start cvadmi n. Enter: cvadmin Several status messages display. b. Start the file system. Enter : start file_system_name c. Activate the file system. Enter: activate file_system_name d. Select the file system. Enter: select file_system_name The fi[...]

SNFS Resolving Installation Problems 7-9 To resolve problems wit h a StorNe xt FS installation on IRIX: Check Drive Connectivity Step 1 On the StorNext File System (StorNext FS) server , log in as root. Step 2 Check for access to the Fibre Channel drive s. Enter: cvlabel -1 Resolving Problems with IRIX T opic Page Check Drive Connectivity 7-9 V eri[...]

SNFS 7-10 6-00905-01 Rev A V erify that the File System is Active Step 1 On the Sto rNext FS server, log in as root. Step 2 Verify that the file system is active. Enter: cvadmin> select file_system_name show long All stripe groups should display a statu s of “UP.” Step 3 After verifying the file system’s ac tive status, enter quit. Check E[...]

SNFS Resolving Installation Problems 7-11 V erify the StorNext FS Setup Step 1 On the StorNext FS server, log in as root. Step 2 Verify the numbe r of active S torNext F S clients using the default file system. a. Start cvadmin. Enter: cvadmin Several status messages display. b. Select the file syst em. Enter: select file_system_name Output similar[...]

SNFS 7-12 6-00905-01 Rev A V erify the Mounted File System To verify that StorNext FS is correc tly mounted on a StorNext FS client: Step 1 On a StorNext FS clie nt, log in as root. Step 2 Verify the StorNext FS mount on the client. Enter: df -k A status message, similar to the following, displays: Unmount and Remount All File Systems To unmount an[...]

SNFS Resolving Installation Problems 7-13 Step 3 Remount a specific StorNext FS on a client. Enter: mount mount_directory For example: mount /usr/clips Reinitialize St orNext FS To reinitialize a StorNext FS: Step 1 On the StorNext FS server, log in as root. Step 2 Unmount the specific StorNe xt FS from all c lients. Step 3 In a system shell window[...]

SNFS 7-14 6-00905-01 Rev A Step 6 Start the file system using the File System Administrator utility. a. Start cvadmi n. Enter: cvadmin Several status messages display. b. Start the file system. Enter : start file_system_name c. Activate the file system. Enter: activate file_system_name d. Select the file system. Enter: select file_system_name File [...]

SNFS Resolving Installation Problems 7-15 To resolve problems wit h a StorNe xt FS installation on Linux: Check Drive Connectivity Step 1 On the StorNext File System (StorNext FS) server , log in as root. Step 2 Check for access to the Fibre Channel drive s. Enter: cvlabel -1 Resolving Problems on Linux T opic Page Check Drive Connectivity 7-15 V e[...]

SNFS 7-16 6-00905-01 Rev A V erify File System is Active Step 1 On the StorNext FS server, log in as root. Step 2 Verify that the file system is active. a. Start cvadmi n. Enter: cvadmin Several status messages display. b. Select the file system. Enter: select file_system_name c. Enter: show long In the output, all the stripe groups should display [...]

SNFS Resolving Installation Problems 7-17 V erify the StorNext FS Setup Step 1 On the StorNext FS server, log in as root. Step 2 Verify the numbe r of active S torNext F S clients using the default file system. a. Start cvadmin. Enter: cvadmin Several status messages display. b. Select the file syst em. Enter: select file_system_name Output similar[...]

SNFS 7-18 6-00905-01 Rev A V erify the Mounted File System To verify that StorNext FS is correc tly mounted on a StorNext FS client: Step 1 On a StorNext FS clie nt, log in as root. Step 2 Verify the StorNext FS mount on the client. Enter: df -k A status message, similar to the following, displays: Unmount and Remount the File System To unmount and[...]

SNFS Resolving Installation Problems 7-19 Reinitialize St orNext FS To reinitialize a StorNext FS (such as after making configuratio n changes): Step 1 On the StorNext FS server, log in as root. Step 2 Unmount the specific StorNe xt FS from all c lients. Step 3 In a system shell window, use the File System Administrator utility to stop the s pecifi[...]

SNFS 7-20 6-00905-01 Rev A Step 6 Start the file system using the File System Administrator utility. a. Start cvadmi n. Enter: cvadmin Several status messages display. b. Start the file system. Enter : start file_system_name c. Activate the file system. Enter: activate file_system_name d. Select the file system. Enter: select file_system_name File [...]

SNFS Resolving Installation Problems 7-21 Check Drive Connectivity Step 1 On the StorNext File System (StorNext FS) server , log in as root. Step 2 Check for access to the Fibre Channel drive s. Enter: cvlabel -1 V erify File System is Active Step 1 On the StorNext FS server, log in as root . Step 2 Verify that the file system is active. a. Start c[...]

SNFS 7-22 6-00905-01 Rev A V erify the StorNext FS Setup Step 1 On the Sto rNext FS server, log in as root. Step 2 Verify the number of active StorNext FS clients using the default file system. a. Start cvadmi n. Enter: cvadmin Several status messages display. b. Select the file system. Enter: select file_system_name Output similar to th e follow i[...]

SNFS Resolving Installation Problems 7-23 V erify the Mounted File System To verify that StorNext FS is correc tly mounted on a Stor Next FS client: Step 1 On a StorNext FS clie nt, log in as root. Step 2 Verify the StorNext FS mount on the client. Enter: df -k A status message, similar to the follow ing, displays: Unmount and Remount All File Syst[...]

SNFS 7-24 6-00905-01 Rev A Unmount and Remount Specific File System To unmount and re mount a specific StorNext FS, follow these steps. Step 1 On a StorNext FS clie nt, log in as root. Step 2 Unmount a specific StorNext FS. Enter: umount mount_directory For example: umount /usr/clips Step 3 Remount a specific StorNext FS on a client. Enter: mount m[...]

SNFS Resolving Installation Problems 7-25 Step 4 If you want to change file system parameters and global se ttings, edit and save the /usr/cvfs/config/file_system_name.cfg file. Step 5 Run the StorNext FS in itialize utility. Enter: cvmkfs file_system_name Step 6 Reinitialize the specific StorNext FS by following the online instructions. Step 7 Sta[...]

SNFS 7-26 6-00905-01 Rev A[...]

SNFS Customer Assistance 8-1 Customer Assist ance ADIC provides the following ty pes of customer assi stance for the StorNext File System (StorNext FS). If problems cannot be solved with the aid of this docume nt or the online help or if tra ining is desired, contact ADIC T echnical A ssis tance Center (ATAC). The software distribution CDs contain [...]

SNFS 8-2 6-00905-01 Rev A[...]

SNMS Glossary Glossary 1 A ATAC (ADIC Technical Assistanc e Center) The ADIC customer help desk. F FC (Fibre Channel) A high-speed data transfer architecture for storage area networ ks (SANs). G GUI (Graphical User Int erface) A program interface that takes ad vantage of the computer's grap hics capabilities to make the program easier to use. [...]

SNFS 2 6-00905-0 1 Rev A S SAN (Storage Area Network) A SAN is a dedicated, high-performance network whose primary purpo se is the transfer of data along FC or high-speed Ether net connecti ons between servers, interconnect devices, and storage per ipherals. SNMS (StorNext Management Suit e) A scalable, high performance, data management so lution t[...]

SNFS Index 1 A ADIC publications 8-1 website 8-1 AIX drive connectivity problems 7-3 error messages 7-3 file system state problems 7-3 patches 7-3 reinitializing file system 7-7 remount all file systems 7-6 remount specific file system 7-6 resolving problems 7-2 unmount all file systems 7-6 unmount specific file system 7-6 verifying file system mou[...]

SNFS 2 6-0090501 Rev A file system server, configuring a shared set- up 2-6 file system state problems AIX 7-3 IRIX 7-10 Linux 7-16 Solaris 7-21 files, StorNext FS 2-3 H help, contact information 8-1 hubs, Fibre Channel 2-12 I installation problems checking error messages AIX 7-3 IRIX 7-10 Linux 7-16 Solaris 7-21 checking patches AIX 7-3 IRIX 7-10 [...]

SNFS Index 3 L Linux drive connectivity problems 7-15 error messages 7-16 file system state problems 7-16 patches 7-16 reinitializing file system 7-19 remount file system 7-18 resolving problems 7-15 unmount file system 7-18 verifying file system mount 7-18 verifying setup 7-17 Linux directory StorNext FS files 2-3 P platforms, supported 2-2 power [...]

SNFS 4 6-0090501 Rev A StorNext FS files AIX directory 2-3 IRIX directory 2-3 Linux directory 2-3 Solaris directory 2-3 major files 2-3 StorNext FS components 2-3 StorNext FS installation, summary 2-8 StorNext Management Suite 1-1 support, contacting 8-1 supported platforms 2-2 symbols in document, explanations 1-3 system requirements 2-2 U unmount[...]