SNFS StorNext® File System Installation Guide for UNIX Users StorNext FS Version 2.
Copyright Notice © 2002, 2003 ADIC® The information contained in this document is subject to change without notice. This document contains proprietary information which is protected by copyright. All rights are reserved. No part of this document may be photocopied, reproduced, or translated to another language without prior written consent of ADIC.
SNFS Advanced Digital Information Corporation Software Licenses Agreement This Software License is entered into and effective as of this _____, day of_____________ 2003 ("Effective Date"), by and between: Advanced Digital Information Corporation PO Box 97057 Redmond, WA 98073-9757 (Referred to as “ADIC") and Company: _______________________ Located at: _______________________ _______________________ _______________________ (Referred to as “Licensee") This License sets forth the terms and conditions under
SNFS “Software” means only the current version of those software products specified in Exhibit A hereto, in object code form only, and the Documentation provided by ADIC in connection therewith or any portions thereof, and any subsequent Releases. "Upgrade" means a modification to the Software that adds significant features and/or functionality and causes a change in ADIC's base version number. Upgrades may have a new initial License fee or upgrade charge associated with it. Software License a. License.
SNFS d. Transfer 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 computers of the same machine architecture, provided that the Software is installed on one (1) Designated Computer at a time, b) is covered under a current maintenance support plan with ADIC, and c) provides ADIC with written notice thirty (30) days prior to the transfer.
SNFS ii. remove, obscure, or alter any copyright, trade secret, trademark, patent or other proprietary rights notice affixed to or displayed on the Software or Documentation or affixed to or printed on any of its factory packaging; iii. modify, merge with other programs or translate any portion of the Software into any other assembly or foreign language; and iv. reverse-assemble, reverse-compile or attempt to derive a source code equivalent of the Software. d. Protections.
SNFS Use and Training Licensee will limit the use of the Software to those individuals who have been appropriately trained. ADIC will make training for the Software available to Licensee pursuant to its standard training procedures. Unless otherwise mutually agreed, any additional training will be provided at ADIC's Englewood, Colorado facility at ADIC's then current rates. Warranty and Warranty Servicing a. Warranty.
SNFS d. Warranty 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 then current standard time and material charges. e. Warranty Disclaimer.
SNFS deemed necessary, and conduct the defense and 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 non-infringing software, or (3) modify the Software so that it becomes non-infringing provided such modified intellectual property will reasonably meet Licensee's needs. b.
SNFS b. Termination. This License commences on the Effective Date and will continue in perpetuity unless Licensee fails to comply with any of the material conditions of this License. ADIC may, after allowing Licensee a reasonable time to cure its default, terminate this License upon written notice to the Licensee.
SNFS OR PROPERTY DAMAGE ARISING OUT OF OR IN CONNECTION WITH THIS LICENSE OR THE USE, PERFORMANCE OR NON-PERFORMANCE OF THE SOFTWARE, WHETHER IN ACTION, IN CONTRACT, OR TORT INCLUDING NEGLIGENCE, EVEN IF ADIC KNEW, SHOULD HAVE KNOWN OR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. ADIC's LIABILITY FOR DAMAGES HEREUNDER WILL IN NO EVENT EXCEED THE AMOUNT OF FEES PAID BY LICENSEE UNDER THIS LICENSE. General a. No Assignment. This License is not assignable.
SNFS Entirety Licensee acknowledges that it has 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 between the parties and supersedes all proposals or prior agreements, oral or written and all other communications between the parties relating to the subject matter of this License.
SNFS Introduction Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 Who Should Read this Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 How This Book is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Explanation of Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SNMS Using Optional Pre-Installation Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7 Summary of Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8 Power Up Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12 Power Down Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SNFS Setting Up StorNext FS on Linux Roadmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1 Installation Procedure for Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3 Install StorNext FS on Linux . . . . . . . . . . . . . . . . . . .
SNMS Resolving Installation Problems Roadmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1 Resolving Problems with AIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Check Drive Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Verify that the File System is Active . . . . . . . . . . . . . . . . . . . . . . . .
SNFS Resolving Problems on Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Check Drive Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Verify File System is Active . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Check Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SNMS 6 6-00905-01 Rev A
SNFS Introduction StorNext File System (StorNext FS), formerly known as CentraVision™, lets heterogeneous clients share files across high-speed storage Fibre Channel (FC) connections. By eliminating the need to duplicate, manage, and move multiple copies of the same file, StorNext FS increases storage efficiency, improves workflow productivity, and reduces network bottlenecks. StorNext FS is the core file system technology used in the StorNext Management Suite (SNMS).
SNFS How This Book is Organized This book contains the following chapters. • • • • • • • 1-2 Chapter 2: Getting Started — Component descriptions 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 StorNext FS on IRIX — Instructions for installing and configuring the StorNext File System.
SNFS Explanation of Symbols The following symbols indicate important information.
SNFS Conventions Conventions used throughout this book are listed below. Convention Example Screen text, file names, program names, and commands are in Courier font. # mkdir -p The root prompt for UNIX is shown as the number/ pound symbol. # tar xvf Site-specific or user-defined variables are enclosed within greater than and less than characters, < >. # chmod 777 A menu name with a greater-than character refers to a sequence of menus.
SNFS Online Books The documentation CD accompanying the StorNext FS product contains StorNext FS technical documents as PDF files. To view and print these PDFs, you need Adobe® Acrobat® Reader, which is available as a download from www.adobe.com. Related Publications The publications described in the following table are created and distributed on an as-needed basis.
SNFS 1-6 6-00905-01 Rev A
SNFS Getting Started Topic Refer to Chapter Getting started: • • • • Component description. Installation summary. Power up sequence. Power down sequence. On AIX: • • • • • 3 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS. On IRIX: • • • • • 4 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS. On Linux: • • • • • 2 5 Install StorNext FS.
SNFS Topic Refer to Chapter On Solaris: • • • • • 6 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS. Troubleshooting procedures 7 Supported Platforms StorNext File System (StorNext FS) is supported on the following platforms: IBM AIX, SGI IRIX, Linux (RedHat and SuSE), Sun Solaris, Windows 2000, and Windows NT.
SNFS StorNext FS Components The following components comprise the StorNext FS software. • StorNext FS server. Runs on a machine designated as the server for all StorNext FS activities. The StorNext FS server controls space allocation and regulates meta-data operations for all StorNext file systems. • StorNext FS client. Runs on all machines that access file systems managed by the StorNext FS server. The following table lists major StorNext FS files.
SNFS AIX Directory IRIX Directory Linux Directory Solaris Directory StorNext FS server’s startup script. /etc/rc.cvfs /etc/init.d/cvfs /etc/init.d/cvfs /etc/init.d/cvfs Client Software on all StorNext FS clients. Contains the protocol interface required to communicate with the StorNext FS server. /usr/cvfs /usr/cvfs /usr/cvfs /usr/cvfs Mount Point Directory mounted (mapped) by the StorNext FS clients.
SNFS Configure File System Server The StorNext FS server can be configured as either a dedicated or shared setup. Dedicated Setup In a dedicated setup, the StorNext FS server has TCP/IP connectivity to all StorNext FS clients, but it does not have Fibre Channel (FC) connectivity to the Storage Area Network (SAN). NOTE Failover cannot be used in a dedicated setup. To use failover, the StorNext FS must have a Fibre Channel connection. Figure 2-1 illustrates a dedicated setup.
SNFS Shared Setup In a shared setup, the StorNext FS server is also set up as a StorNext FS client with Fibre Channel connectivity to the SAN. Figure 2-2 illustrates a shared setup.
SNFS Using Optional Pre-Installation Configuration StorNext FS requires the user account www to exist in the passwd file, and the group account adic to exist in the group file. During installation, StorNext FS uses a system utility to create these accounts if it cannot find them. • • If you want the system utility to create the accounts, skip this section. If you prefer to manually add these accounts, use the procedure described below.
SNFS Summary of Installation Steps The steps listed below summarize the StorNext FS installation process. These steps are only guidelines, since the actual steps required for your site are unique. Step Task 1 CAUTION: Back up the system data of all client machines before changing or installing any hardware or software. 2 Connect all client machines that will access the StorNext FS to a TCP/IP network, such as Ethernet.
SNFS Step 5 Task Set up the SAN machine components, which include the following items: • Install a Fibre Channel card. • Connect Fibre Channel optical and copper cables to the switches or hubs. • Install Fibre Channel software and drivers. • If required, configure the Fibre Channel software for a loop or switch network. 6 Select one of your machines to run the StorNext FS server component. This machine is referred to as the StorNext FS server. Select the machines to run the StorNext FS client component.
SNFS Step 8 Task Label all the Fibre Channel disk drives used by StorNext FS. For instructions: • Refer to Label Drives on AIX on page 3-5. • Refer to Label Drives on IRIX on page 4-6. • Refer to Label Drives on Linux on page 5-12. • Refer to Label Drives on Solaris on page 6-4. 9 The StorNext FS server maintains operation and file structure integrity of the shared StorNext File Systems. Configure the StorNext FS software for all machines.
SNFS Step 10 Task Mount the StorNext File System on each client machine. For instructions, • Refer to Mount StorNext FS on AIX on page 3-11. • Refer to Mount StorNext FS on IRIX on page 4-12. • Refer to Mount StorNext FS on Linux on page 5-18. • Refer to Mount StorNext FS on Solaris on page 6-11. Getting Started 11 On all StorNext FS clients: Add the uniquely named StorNext File System to the list of devices to be mounted at boot.
SNFS Power Up Sequence To power up StorNext FS as part of a Fibre Channel environment: 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 server.
SNFS Step 5 Start all StorNext FS clients, in any order. StorNext FS clients StorNext FS clients StorNext FS clients Power Down Sequence 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 drives. Step 5 Disable FC hubs, if present. Step 6 Disable FC fabric switches, if present.
SNFS 2-14 6-00905-01 Rev A
SNFS Setting Up StorNext FS on AIX Roadmap Topic Refer to Chapter Getting started: • • • • Component description. Installation summary. Power up sequence. Power down sequence. On AIX: • • • • • 3 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS. On IRIX: • • • • • 4 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS.
SNFS Topic Refer to Chapter On Solaris: • • • • • 6 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS. Troubleshooting procedures 7 Installation Procedure for AIX The installation and configuration of the StorNext File System (StorNext FS) on AIX includes the following procedures.
SNFS Install StorNext FS on AIX NOTE For upgrade instructions, refer to the StorNext Management Suite Release Notes. To install StorNext FS on AIX: Step 1 Designate one AIX machine as the StorNext FS server. Step 2 Log onto the 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 the AIX installation.
SNFS Obtain License for AIX Server The StorNext FS server must have a valid 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 The hexadecimal number is unique to the server and the host_name parameter should match the server’s host name. This number is known as the ID string. Step 2 Email the ID string and the number of client machines to ATAC at support@adic.com.
SNFS 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 performed from any StorNext client that has a Fibre Channel connection to the drive. CAUTION The process of disk labeling re-partitions the drives. If you select an incorrect drive, you may lose data. To label a drive: Step 1 From the system prompt on any StorNext FS client, display a list of connected drives.
SNFS You can create any convention for the label names. For example, if a site 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 entries in the file would be: CvfsDisk0, CvfsDisk1, CvfsDisk2, and so on.
SNFS Configure StorNext FS Software on AIX To configure the StorNext FS software on an AIX machine, you have to configure the software on both the StorNext FS server and clients. Server Configuration Step 1 Create a StorNext FS-managed file system by copying /usr/cvfs/examples/ example.cfg and renaming it. Enter: # cd/usr/cvfs/config # cp ../examples/example.cfg ./.cfg NOTE Step 2 The example.
SNFS DISK section - Identifies the disk drive that is labeled and available to StorNext FS. A disk type describes a category of disks with a capacity specified in number of sectors. The following parts comprise a disk definition: • The required keyword Disk preceded by the open bracket symbol ( [ ) and followed by the closed bracket symbol ( ] ). • On the next line, the words Status UP • On the next line, the required keyword Type and the name of the disk type assigned to the disk definition.
SNFS Examples of stripe groups appear in the configuration file. • Find the stripe group named RegularFiles. • Edit the Node entries so that all the disk names are listed, with each entry followed by a space and then the stripe order number (0, 1, 2, etc.). For example: [StripeGroup RegularFiles] Status UP Type Regular Read Enabled Write Enabled StripeBreadth 64 Node CvfsDisk0 0 Node CvfsDisk1 1 Node CvfsDisk2 2 Node CvfsDisk3 3 Step 3 Save, name and exit the /usr/cvfs/config/.cfg file.
SNFS 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 fsnameservers file by copying /usr/cvfs/examples/ fsnameservers.example and renaming it. # cd /usr/cvfs/config # cp ../examples/fsnameservers.example .
SNFS Mount StorNext FS on AIX To mount StorNext FS: Step 1 Create the StorNext FS mount directory. For example: # mkdir /usr/clips Step 2 Add the uniquely named StorNext FS-managed file system to the /etc/filesystems file. Use cvfs as the vfs and file system type.
SNFS 3-12 6-00905-01 Rev A
SNFS Setting Up StorNext FS on IRIX Roadmap Topic Refer to Chapter Getting started: • • • • Component description. Installation summary. Power up sequence. Power down sequence. On AIX: • • • • • 3 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS. On IRIX: • • • • • 4 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS.
SNFS Topic Refer to Chapter On Solaris: • • • • • 6 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS. Troubleshooting procedures 7 Installation Procedure for IRIX The installation and configuration of the StorNext File System (StorNext FS) on IRIX includes the following procedures.
SNFS Install StorNext FS on IRIX NOTE For upgrade instructions, refer to the StorNext Management Suite Release Notes. To install StorNext FS on IRIX: Step 1 Designate one IRIX machine as the StorNext FS server. Step 2 Log onto the 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 point. For example, use CDROM as shown in the example in Step 5.
SNFS 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 Installation. Step 9 From the list, select the items you want to install. • Install the base and services files on all StorNext FS clients. • Install the base and services files on all StorNext FS clients. Step 10 Click Start. Step 11 After the installation is complete, close the Software Manager utility.
SNFS Obtain License for IRIX Server The StorNext FS server must have a valid 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 The hexadecimal number is unique to the server and host_name should match the server’s host name. This number is known as the ID string. Step 2 Email the ID string and the number of client machines to ATAC at support@adic.com.
SNFS Label Drives on IRIX 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 performed from any StorNext client that has a Fibre Channel connection to the drive. CAUTION The process of disk labeling re-partitions the drives. If you select an incorrect drive, you may lose data. To label a drive: Step 1 From the system prompt on any StorNext FS client, display a list of connected drives.
SNFS You can create any convention for the label names. For example, if a site 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 entries in the file would be: CvfsDisk0, CvfsDisk1, CvfsDisk2, and so on.
SNFS Configure StorNext FS Software on IRIX To configure the StorNext FS software on an IRIX 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 and renaming it. # cd/usr/cvfs/config # cp ../examples/example.cfg ./.cfg NOTE Step 2 The example.
SNFS To obtain the number of sectors where the disks are set, use the cvlabel -1 command. If you are using disk devices that do not have the same number of sectors, then several disk types can be specified to handle each common number of sectors. DISK section - Identifies the disk drive that is labeled and available to StorNext FS. A disk type describes a category of disks with a capacity specified in number of sectors.
SNFS Examples of stripe groups appear in the configuration file. • Find the stripe group named RegularFiles. • Edit the Node entries so that all the disk names are listed, with each entry followed by a space and then the stripe order number (0, 1, 2, etc.). For example: [StripeGroup RegularFiles] Status UP Type Regular Read Enabled Write Enabled StripeBreadth 64 Node CvfsDisk0 0 Node CvfsDisk1 1 Node CvfsDisk2 2 Node CvfsDisk3 3 Step 3 Save, name and exit the /usr/cvfs/config/.cfg file.
SNFS Step 5 Initialize StorNext FS. Enter: # cd /usr/cvfs/bin/cvmkfs CAUTION Step 6 This step cannot be undone and all data on the file system will be lost, so make sure you are ready to initialize the file system before you proceed. 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.
SNFS Mount StorNext 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. /usr/clips cvfs rw,threads=6 0 0 where: Option Description Uniquely named StorNext FS-managed file system.
SNFS Setting Up StorNext FS on Linux Roadmap Topic Refer to Chapter Getting started: • • • • Component description. Installation summary. Power up sequence. Power down sequence. On AIX: • • • • • 3 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS. On IRIX: • • • • • 4 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS.
SNFS Topic Refer to Chapter On Solaris: • • • • • 6 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS. Troubleshooting procedures 7 Installation Procedure for Linux The installation and configuration of the StorNext File System (StorNext FS) on Linux includes the following procedures.
SNFS 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 requirements. RedHat Linux - Kernel Requirements To run StorNext FS on RedHat Linux, you must use one of these kernels: • • For uniprocessor and multiprocessor systems, RedHat Linux 7.3, kernels 2.4.17-2.4.
SNFS SuSE Linux - Kernel Requirements To run StorNext FS on SuSE Linux, use this procedure to determine and install the required kernels, including compilers. Step 1 Check to see whether the compiler was installed at the same time as the rest of the system. a. Query the kernel. Enter: # rpm -qi `rpm -qa | grep k_` Output similar to the following displays. Name: k_smp Relocations:(not relocateable) Version: 2.4.
SNFS b. Query gcc. Enter: # rpm -qi `rpm -qa | grep gcc` Output similar to the following displays. Name: Version: Release: Install Date: Group: Size: Packager: Summary: Description: SuSE series: Distribution: Name: Version: Release: Install Date: Group: Size: Packager: Summary: Description: Name: Version: Release: Install Date: Group: Size: Packager: Summary: Description: gcc-info Relocations:(not relocateable) 3.
SNFS Step 2 Install the base system. a. Select the language in which to run the install. A system page displays with an area titled “Timezone” and a place to change the “Software”. b. Click on “Software” and then click “Detailed Selections”. A two-paned window displays with check boxes on the left pane and list of packages on the right pane. c. On the left side, only click the box that is not already checked and click Accept. d. Complete the installation.
SNFS Step 7 Change directory (cd) into /usr/src and create a link to the kernel source. 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-name the .cfg file. Enter: # cd linux-2.4 # cp /boot/vmlinuz.config /usr/src/linux-2.4/.config Step 9 Configure the kernel, build the kernel, build the modules and install the modules.
SNFS Step 12 Edit the /boot/grub/menu.lst file so the kernel can be booted. Make edits to reflect the new kernel configuration parameters. file /boot/grub/menu.lst before changes: title linux kernel (hd1,0)/boot/vmlinuz root=/dev/sdb1 initrd (hd1,0)/boot/initrd title floppy root (fd0) chainloader +1 vga=791 file /boot/grub/menu.
SNFS For example: alias parport_lowlevel parport_pc alias scsi_hostadapter aic7xxx alias eth0 eepro100 alias eth1 e1000 alias scsi_hostadapter1 qla2300 options scsi_mod max_scsi_luns=128 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. Install StorNext FS on Linux NOTE For upgrade instructions, refer to the StorNext Management Suite Release Notes.
SNFS • If you use a Uniprocessor system, install the server and client files, including the word up in the filenames. For example: # 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 system, install the server and client files, including the word smp in the filenames. # rpm -ivh cvfs-server.7.3_2419smp-2.1.1-62.i386.rpm # rpm -ivh cvfs-client.7.3_2418smp-2.1.1-62.i386.
SNFS Step 10 Return to Step 1 to install StorNext FS on another Linux machine. Obtain License for Linux Server The StorNext FS server must have a valid license. To obtain the license file: Step 1 Verify that /etc/hosts has a proper entry for the system name. NOTE In certain situations, the Linux installation program attaches the system name to 127.0.0.1, instead of an entry for the Ethernet card. The following example illustrates this situation for /etc/hosts with the system name, snpc4: 127.0.0.
SNFS Label Drives on Linux 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 performed from any StorNext client that has a Fibre Channel connection to the drive. CAUTION The process of disk labeling re-partitions the drives. If you select an incorrect drive, you may lose data. To label a drive: Step 1 From the system prompt on any StorNext FS client, display a list of connected drives.
SNFS Step 3 Create /usr/cvfs/config/cvlabels from the copy 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. CvfsDisk_UNKNOWN sdb CvfsDisk_UNKNOWN sdc CvfsDisk UNKNOWN sdd Step 4 Edit /usr/cvfs/config/cvlabels file to provide a unique name for each drive used by StorNext FS. In this example, _UNKNOWN has been changed to a sequential list.
SNFS Configure StorNext FS Software on Linux To configure the StorNext 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/.cfg where file_system_name is a unique, descriptive name. For example: # cd/usr/cvfs/config # cp ../examples/example.cfg ./projA.cfg NOTE Step 2 The example.
SNFS DISK section - Identifies the disk type to be assigned to a disk drive that is labeled and available for StorNext FS. A disk type describes a category of disks with a capacity specified in number of sectors. The following parts comprise a disk definition: • The required keyword Disk preceded by the open bracket symbol ( [ ) and followed by the closed bracket symbol ( ] ).
SNFS Examples of stripe groups appear in the configuration file. • Find the stripe group named RegularFiles. • Edit the Node entries so that all the disk names are listed, with each entry followed by a space and then the stripe order number (0, 1, 2, etc.). For example: [StripeGroup RegularFiles] Status UP Read Enabled Write Enabled StripeBreadth 16 Node CvfsDisk12 0 Node CvfsDisk13 1 Step 3 Save the configuration file. NOTE Step 4 Make sure you have a .
SNFS Step 7 In the fsmlist file, add the names of all of the StorNext File Systems. Step 8 Create a nameserver 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 the fsnameservers file, add the host IP address or name of the StorNext FS server. For more information about failover environments, refer to the cvfs_failover man page.
SNFS Mount StorNext 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 type. For example: # projA /usr/clips/ cvfs rw,threads=6 0 0 When the StorNext FS server starts up or reboots, StorNext FS automatically mounts any file systems listed in the /etc/fstab file.
SNFS Setting Up StorNext FS on Solaris Roadmap Topic Refer to Chapter Getting started: • • • • Component description. Installation summary. Power up sequence. Power down sequence. On AIX: • • • • • 3 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS. On IRIX: • • • • • 4 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS.
SNFS Topic Refer to Chapter On Solaris: • • • • • 6 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS. Troubleshooting procedures 7 Installation Procedure for Solaris The installation and configuration of the StorNext File System (StorNext FS) on Solaris includes the following procedures.
SNFS Install StorNext FS on Solaris NOTE For upgrade instructions, refer to the StorNext Management Suite Release Notes. To install StorNext FS on Solaris: Step 1 Designate one Solaris machine as the StorNext FS server. Step 2 Log onto the 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 the Solaris installation. # pkgadd -d Step 5 Select the package for ADICcvfs.
SNFS Obtain License for Solaris Server The StorNext FS server must have a valid 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 The hexadecimal number is unique to the server and host_name should match the server’s host name. This number is known as the ID string. Step 2 Email the ID string and the number of client machines to ATAC at support@adic.com.
SNFS Step 2 From the output information, identify any drives that are unused or do not have a recognized Volume Type and write down their associated device names. CAUTION Step 3 Identify any drives that already contain a recognized Volume Type. Do not write a label to these drives or you may lose data. Create /usr/cvfs/config/cvlabels from the copy of the StorNext FS label file example. Enter: # cd/usr/cvfs/config # cp ../examples/cvlabels.example .
SNFS Step 4 Edit /usr/cvfs/config/cvlabels so that it contains a list of StorNext FS label names that correspond to the device names of the drives captured in Step 2. You can create any convention for the label names. For example, if a site 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.
SNFS Configure StorNext FS Software on Solaris To configure the StorNext FS software on a Solaris 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 and renaming it. # cd/usr/cvfs/config # cp ../examples/example.cfg ./.cfg NOTE Step 2 The example.
SNFS For example: [DiskType ST318202FC] Sectors 35563520 SectorSize 512 The SectorSize should reflect the Sector Format Size of the disk drives, for example: 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 devices that do not have the same number of sectors, then several disk types can be specified to handle each common number of sectors. DISK section - Identifies the disk drive that is labeled and available to StorNext FS.
SNFS STRIPEGROUP DEFINITION section - Describes a group of disks that comprise a stripe group. One or more stripe groups describe the entire file system. A stripe group is the smallest entity that can be manipulated by a system administrator using the File System Administration utility (cvadmin). NOTE All disks defined in any given stripe group must have the same number of sectors, as reported by cvlabel -1. Examples of stripe groups appear in the configuration file.
SNFS Step 5 Initialize StorNext FS. Enter: # cd /usr/cvfs/bin/cvmkfs # cp ../examples/fsmlist.example ./fsmlist CAUTION Step 6 This step cannot be undone and all data on the file system will be lost, so make sure you are ready to initialize the file system before you proceed. 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.
SNFS Mount StorNext FS on Solaris To mount StorNext FS: Step 1 Create the StorNext FS mount directory. For example: # mkdir /usr/clips Step 2 Add the uniquely named StorNext FS-managed file system to the /etc/vfstab file. Use cvfs as the file system type. /usr/clips cvfs - yes rw,threads=6 where: Option Description Uniquely named StorNext FS-managed file system.
SNFS 6-12 6-00905-01 Rev A
SNFS Resolving Installation Problems Roadmap Topic Refer to Chapter Getting started: • • • • Component description. Installation summary. Power up sequence. Power down sequence. On AIX: • • • • • 3 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS. On IRIX: • • • • • 4 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS.
SNFS Topic Refer to Chapter On Solaris: • • • • • 6 Install StorNext FS. Obtain license for the server. Label the disk drives. Configure the StorNext FS software. Mount StorNext FS.
SNFS Check Drive Connectivity Step 1 On the StorNext FS server, log in as root. Step 2 Check for access to the Fibre Channel drives. Enter: cvlabel -l Verify 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 file_system_name show long All stripe groups should display a status of “UP.” Step 3 After verifying the file system’s active status, enter quit.
SNFS Verify the StorNext FS Setup Step 1 On the StorNext 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 system.
SNFS Verify the Mounted File System To verify that StorNext FS is correctly mounted on a StorNext FS client: Step 1 On a StorNext FS client, log in as root. Step 2 Verify the StorNext FS mount on the client.
SNFS Unmount and Remount All File Systems To unmount and remount all StorNext File Systems listed in /etc/filesystems (such as to troubleshoot or for system maintenance): Step 1 On a StorNext FS client, log in as root. Step 2 Unmount all StorNext File Systems listed in the /etc/filesystems file. Enter: umount -t cvfs Step 3 Remount all StorNext File Systems on a client. Enter: umount -at cvfs Unmount and Remount Specific File System To unmount and remount a specific StorNext FS, follow these steps.
SNFS Reinitialize StorNext FS To reinitialize a StorNext FS: CAUTION Use caution when performing this procedure because it will erase all existing data on the specified StorNext FS. Step 1 On the StorNext FS server, log in as root. Step 2 Unmount the specific StorNext FS from all clients. Step 3 In a system shell window, use the File System Administrator utility to stop the specific file system. a. Start cvadmin. Enter: cvadmin Several status messages display. b. Stopr the file system.
SNFS Step 6 Start the file system using the File System Administrator utility. a. Start cvadmin. 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 file system configuration status displays. e. Exit cvadmin. Enter: quit Step 7 Mount StorNext FS.
SNFS Resolving Problems with IRIX To resolve problems with a StorNext FS installation on IRIX: Topic Page Check Drive Connectivity 7-9 Verify that the File System is Active 7-10 Check Error Messages 7-10 Check IRIX Patches 7-10 Verify the StorNext FS Setup 7-11 Verify the Mounted File System 7-12 Reinitialize StorNext FS 7-13 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 drives.
SNFS Verify 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 file_system_name show long All stripe groups should display a status of “UP.” Step 3 After verifying the file system’s active status, enter quit. Check Error Messages Step 1 On the StorNext FS server, log in as root. Step 2 Check for error messages in the system’s system log .
SNFS Verify the StorNext FS Setup Step 1 On the StorNext FS server, log in as root. Step 2 Verify the number of active StorNext FS clients using the default file system. a. Start cvadmin. Enter: cvadmin Several status messages display. b. Select the file system.
SNFS Verify the Mounted File System To verify that StorNext FS is correctly mounted on a StorNext FS client: Step 1 On a StorNext FS client, log in as root. Step 2 Verify the StorNext FS mount on the client.
SNFS Step 3 Remount a specific StorNext FS on a client. Enter: mount mount_directory For example: mount /usr/clips Reinitialize StorNext FS To reinitialize a StorNext FS: CAUTION Use caution when performing this procedure because it will erase all existing data on the specified StorNext FS. Step 1 On the StorNext FS server, log in as root. Step 2 Unmount the specific StorNext FS from all clients.
SNFS Step 6 Start the file system using the File System Administrator utility. a. Start cvadmin. 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 system configuration status displays. e. Exit cvadmin. Enter: quit Step 7 Mount StorNext FS.
SNFS Resolving Problems on Linux To resolve problems with a StorNext FS installation on Linux: Topic Page Check Drive Connectivity 7-15 Verify File System is Active 7-16 Check Error Messages 7-16 Check Linux Patches 7-16 Verify the StorNext FS Setup 7-17 Verify the Mounted File System 7-18 Reinitialize StorNext FS 7-19 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 drives.
SNFS Verify 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 cvadmin. 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 a status of “UP.” Step 3 After verifying the file system’s active status, enter quit. Check Error Messages Step 1 On the StorNext FS server, log in as root.
SNFS Verify the StorNext FS Setup Step 1 On the StorNext FS server, log in as root. Step 2 Verify the number of active StorNext FS clients using the default file system. a. Start cvadmin. Enter: cvadmin Several status messages display. b. Select the file system.
SNFS Verify the Mounted File System To verify that StorNext FS is correctly mounted on a StorNext FS client: Step 1 On a StorNext FS client, log in as root. Step 2 Verify the StorNext FS mount on the client.
SNFS Reinitialize StorNext FS To reinitialize a StorNext FS (such as after making configuration changes): CAUTION Use caution when performing this procedure because it will erase all existing data on the specified StorNext FS. Step 1 On the StorNext FS server, log in as root. Step 2 Unmount the specific StorNext FS from all clients. Step 3 In a system shell window, use the File System Administrator utility to stop the specific file system. a. Start cvadmin.
SNFS Step 6 Start the file system using the File System Administrator utility. a. Start cvadmin. 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 system configuration status displays. e. Exit cvadmin.
SNFS 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 drives. Enter: cvlabel -1 Verify 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 cvadmin. Enter: cvadmin Several status messages display. b. Select the file system. Enter: select file_system_name c.
SNFS Verify the StorNext FS Setup Step 1 On the StorNext FS server, log in as root. Step 2 Verify the number of active StorNext FS clients using the default file system. a. Start cvadmin. Enter: cvadmin Several status messages display. b. Select the file system.
SNFS Verify the Mounted File System To verify that StorNext FS is correctly mounted on a StorNext FS client: Step 1 On a StorNext FS client, log in as root. Step 2 Verify the StorNext FS mount on the client.
SNFS Unmount and Remount Specific File System To unmount and remount a specific StorNext FS, follow these steps. Step 1 On a StorNext FS client, 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.
SNFS Step 4 If you want to change file system parameters and global settings, edit and save the /usr/cvfs/config/file_system_name.cfg file. Step 5 Run the StorNext FS initialize utility. Enter: cvmkfs file_system_name Step 6 Reinitialize the specific StorNext FS by following the online instructions. CAUTION Step 7 This step cannot be undone and all data on the file system will be lost, so make sure you are ready to initialize the file system before you proceed.
SNFS 7-26 6-00905-01 Rev A
SNFS Customer Assistance ADIC provides the following types of customer assistance for the StorNext File System (StorNext FS). Contacting Support If problems cannot be solved with the aid of this document or the online help or if training is desired, contact ADIC Technical Assistance Center (ATAC). In the USA: 800.827.3822 Outside the USA, toll free: 00.800.9999.3822 Internet: support@adic.
SNFS 8-2 6-00905-01 Rev A
SNMS Glossary A ATAC (ADIC Technical Assistance Center) The ADIC customer help desk. F FC (Fibre Channel) A high-speed data transfer architecture for storage area networks (SANs). G GUI (Graphical User Interface) A program interface that takes advantage of the computer's graphics capabilities to make the program easier to use. M Managed file system A file system that enables automatic data movement between the tape library and disk storage.
SNFS S SAN (Storage Area Network) A SAN is a dedicated, high-performance network whose primary purpose is the transfer of data along FC or high-speed Ethernet connections between servers, interconnect devices, and storage peripherals. SNMS (StorNext Management Suite) A scalable, high performance, data management solution that ensures the long-term safety and recoverability of data in SAN environments, while optimizing the use of storage resources.
SNFS 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 mount 7-5 verifying setup 7-4 AIX directory StorNext FS files 2-3 assistance, customer 8-1 connectivity problems AIX 7-3 IRIX 7-9 Linux 7-15 Solaris 7-21 contacting suppor
SNFS file system server, configuring a shared setup 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 Linux 7-16 Solaris 7-21 drive connectivity AIX 7-3 IRIX 7-9 Linux 7-15 Solaris 7-21 2 file system state AIX 7-3 IRIX 7-10 Linux 7-16 Solaris 7-21 verifying file system mount AIX 7
SNFS 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 up sequence 2-12 pre-installation configuration (optional) 27 publications, ADIC 8-1 R reinitializing file system AIX 7-7 IRIX 7-13 Linux 7-19 Solaris 7-24 remount all f
SNFS 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 AIX 7-5 IRIX 7-12 Linux 7-18 Solaris 7-23 verifying setup AIX 7-4 IRIX 7-11 Linux 7-17 Solaris 7-22 W Website, ADIC 8-1 U unmount all file systems AIX 7-6 IRIX 7-12 Solaris 7-23 file sys