Quantum STORNEXT 3.5.2.1 User Manual

6-00360-21
StorNext® 3.5.2.1
StorNext
Installation Guide Installation Guide Installation GuideInstallation Guide
Document Title, 6-00360-21 Rev A, June 2010, Product of USA.
Quantum Corporation provides this publication “as is” without warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability or fitness for a particular purpose. Quantum Corporation may revise this publication from time to time without notice.
COPYRIGHT STATEMENT
© 2010 Quantum Corporation. All rights reserved.
Your right to copy this manual is limited by copyright law. Making copies or adaptations without prior written authorization of Quantum Corporation is prohibited by law and constitutes a punishable violation of the law.
TRADEMARK STATEMENT
Quantum, the Quantum logo, DLT, DLTtape, the DLTtape logo, Scalar, and StorNext are registered trademarks of Quantum Corporation, registered in the U.S. and other countries.
Backup. Recovery. Archive. It’s What We Do., the DLT logo, DLTSage, DXi, DXi-Series, Dynamic Powerdown, FastSense, FlexLink, GoVault, MediaShield, Optyon, Pocket-sized. Well-armored, SDLT, SiteCare, SmartVerify, StorageCare, Super DLTtape, SuperLoader, and Vision are trademarks of Quantum.
LTO and Ultrium are trademarks of HP, IBM, and Quantum in the U.S. and other countries. All other trademarks are the property of their respective companies.
Specifications are subject to change without notice.

Contents

Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xi
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii
Document Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii
Notational Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiv
Contacting Quantum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Chapter 1 Installing StorNext File System and Storage Manager 1
Storage Manager System Requirements . . . . . . . . . . . . . . . . . . . . . . . . 2
Getting Ready to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Pre-Installation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
StorNext Installation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Chapter 2 Installing StorNext File System 17
File System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Getting Ready to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Installing StorNext File System on Linux or Unix . . . . . . . . . . . . . . . . . 22
StorNext 3.5.2.1 Installation Guide i
Contents
Installing StorNext File System on Windows . . . . . . . . . . . . . . . . . . . . 26
Chapter 3 Installing the StorNext Client 37
Client System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Client Installation Changes From Previous Releases . . . . . . . . . . . . . . . 41
Downloading the StorNext Client Software. . . . . . . . . . . . . . . . . . . . . 42
Installing the StorNext Client on Linux or Unix . . . . . . . . . . . . . . . . . . 45
Installing the StorNext Client on Windows . . . . . . . . . . . . . . . . . . . . . 52
Chapter 4 Configuring StorNext 61
StorNext GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Configuration Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Configuring a Distributed LAN Client Server . . . . . . . . . . . . . . . . . . . . 68
Windows Configuration Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Installing Promise RAID Controller Software . . . . . . . . . . . . . . . . . . . 110
Appendix A Uninstalling StorNext 113
Uninstalling StorNext on Unix and Linux . . . . . . . . . . . . . . . . . . . . . . 113
Uninstalling StorNext on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Appendix B StorNext Administration Tasks 117
Sharing a Library Between Applications . . . . . . . . . . . . . . . . . . . . . . 117
Manually Modifying Storage Manager Configuration . . . . . . . . . . . . 119
Connecting to a StorNext Network Using Xsan 1.4.2 . . . . . . . . . . . . 120
Connecting to a StorNext Network Using Xsan 2 . . . . . . . . . . . . . . . 123
Viewing a Fibre Channel Device. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
StorNext Log Rolling Administration . . . . . . . . . . . . . . . . . . . . . . . . . 127
Avoiding Poor System Performance. . . . . . . . . . . . . . . . . . . . . . . . . . 128
Contents
Appendix C StorNext Files 131
The example.cfg File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Cluster-Wide Central Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Commonly Used SNFS Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Appendix D Quality of Service Guide 145
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Real-time I/O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Non-Realtime I/O Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Callbacks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Sharing Disk Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
StorNext 3.5.2.1 Installation Guide iii
Contents

Figures

Figure 1 Pre-Installation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Figure 2 StorNext Installation Script . . . . . . . . . . . . . . . . . . . . . . . . 13
Figure 3 Configuration Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Figure 4 SNFS Installation Script. . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Figure 5 Configuration Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Figure 6 StorNext Installation Window: Remove StorNext . . . . . . . 28
Figure 7 StorNext Installation Window: Install StorNext. . . . . . . . . 29
Figure 8 SNFS Setup: Welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Figure 9 SNFS Setup: End-User License Agreement . . . . . . . . . . . . 30
Figure 10 SNFS Setup: Customer Information . . . . . . . . . . . . . . . . . 30
Figure 11 SNFS Setup: Choose Setup Type . . . . . . . . . . . . . . . . . . . . 31
Figure 12 SNFS Setup: Ready to Install . . . . . . . . . . . . . . . . . . . . . . . 32
Figure 13 SNFS Setup: Finish . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Figure 14 StorNext Installation Window: Configure StorNext. . . . . . 33
Figure 15 StorNext Configuration Window . . . . . . . . . . . . . . . . . . . 34
Figure 16 Import/Export Client Configuration Window . . . . . . . . . . 35
Figure 17 Select Platform Window . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Figure 18 Download Client Software Window . . . . . . . . . . . . . . . . . 44
StorNext 3.5.2.1 Installation Guide v
Figures
Figure 19 StorNext Installation Window: Remove StorNext . . . . . . . 53
Figure 20 StorNext Installation Window: Install StorNext. . . . . . . . . 55
Figure 21 SNFS Setup: Welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Figure 22 SNFS Setup: End-User License Agreement . . . . . . . . . . . . 56
Figure 23 SNFS Setup: Customer Information . . . . . . . . . . . . . . . . . 56
Figure 24 SNFS Setup: Choose Setup Type . . . . . . . . . . . . . . . . . . . . 57
Figure 25 SNFS Setup: Ready to Install . . . . . . . . . . . . . . . . . . . . . . . 57
Figure 26 SNFS Setup: Finish . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Figure 27 StorNext Installation Window: Configure StorNext. . . . . . 59
Figure 28 StorNext Configuration Window . . . . . . . . . . . . . . . . . . . 59
Figure 29 Import/Export Client Configuration Window . . . . . . . . . . 60
Figure 30 StorNext Home Page: File System and Storage Manager . 63
Figure 31 StorNext Home Page: File System Only . . . . . . . . . . . . . . . 63
Figure 32 StorNext Configuration Wizard: Storage Manager . . . . . . 64
Figure 33 StorNext Configuration Wizard: File System Only . . . . . . . 65
Figure 34 sndpscfg Configuration Utility . . . . . . . . . . . . . . . . . . . . . 71
Figure 35 Client Configuration: Mount Point . . . . . . . . . . . . . . . . . . 75
Figure 36 Client Configuration: Distributed LAN . . . . . . . . . . . . . . . 77
Figure 37 Client Configuration: Advanced Mount Options. . . . . . . . 79
Figure 38 Client Configuration: Advanced Cache Options . . . . . . . . 83
Figure 39 Disk Device Labeler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Figure 40 Disk Labeler Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Figure 41 Simple File System Configuration . . . . . . . . . . . . . . . . . . . 90
Figure 42 File System Startup List. . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Figure 43 Server Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Figure 44 Server Administration: File System Properties. . . . . . . . . . 96
Figure 45 Server Administration: Stripe Group Properties . . . . . . . . 98
Figure 46 Server Administration: Quota Properties. . . . . . . . . . . . . . 99
Figure 47 Configuration Administrator. . . . . . . . . . . . . . . . . . . . . . 101
Figures
Figure 48 Server Configuration: Global Settings. . . . . . . . . . . . . . . 102
Figure 49 Server Configuration: Disk Types . . . . . . . . . . . . . . . . . . 105
Figure 50 Server Configuration: Enter New Disk Type. . . . . . . . . . . 106
Figure 51 Server Configuration: Disk Definitions . . . . . . . . . . . . . . 107
Figure 52 Server Configuration: Stripe Groups . . . . . . . . . . . . . . . . 108
Figure 53 Windows Boot Manager Screen 1. . . . . . . . . . . . . . . . . . 111
Figure 54 Windows Boot Manager Screen 2. . . . . . . . . . . . . . . . . . 111
Figure 55 Advanced Boot Options Screen . . . . . . . . . . . . . . . . . . . 112
Figure 56 StorNext Remove Main Menu . . . . . . . . . . . . . . . . . . . . . 114
Figure 57 Sharing Access to Files . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Figure 58 Callback Flow for Initial RTIO Request. . . . . . . . . . . . . . . 158
Figure 59 Callback Retraction Example. . . . . . . . . . . . . . . . . . . . . . 159
Figure 60 Non-Real-time Token Adjustments . . . . . . . . . . . . . . . . . 161
StorNext 3.5.2.1 Installation Guide vii
Figures

Ta b l e s

Table 1 Storage Manager Supported Platforms . . . . . . . . . . . . . . . 2
Table 2 Storage Manager Hardware Requirements . . . . . . . . . . . . . 3
Table 3 Required Disk LUN Labels . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Table 4 StorNext Support Directories . . . . . . . . . . . . . . . . . . . . . . . 8
Table 5 Pre-Installation Script Recommendation Types . . . . . . . . . 11
Table 6 StorNext Installation Main Menu Options. . . . . . . . . . . . . 13
Table 7 File System Supported Platforms . . . . . . . . . . . . . . . . . . . 18
Table 8 File System Hardware Requirements. . . . . . . . . . . . . . . . . 19
Table 9 Required Disk LUN Labels . . . . . . . . . . . . . . . . . . . . . . . . . 21
Table 10 SNFS Installation Main Menu Options . . . . . . . . . . . . . . . 24
Table 11 StorNext Client Supported Platforms. . . . . . . . . . . . . . . . 38
Table 12 Default Memory Consumed by cachebufsize . . . . . . . . . . 40
Table 13 Distributed LAN Server Parameters . . . . . . . . . . . . . . . . . . 71
Table 14 Distributed LAN Client and Server Commands . . . . . . . . . 73
Table 15 Client Configuration: Mount Point . . . . . . . . . . . . . . . . . . 76
Table 16 Client Configuration: Distributed LAN . . . . . . . . . . . . . . . 77
Table 17 Client Configuration: Advanced Mount Options. . . . . . . . 80
Table 18 Client Configuration: Advanced Cache Options . . . . . . . . 84
StorNext 3.5.2.1 Installation Guide ix
Tables
Table 19 Disk Labeler Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Table 20 Simple File System Configuration . . . . . . . . . . . . . . . . . . . 90
Table 21 File System Startup List. . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Table 22 Server Administration: File System Properties. . . . . . . . . . 96
Table 23 Server Administration: Stripe Group Properties . . . . . . . . 98
Table 24 Server Administration: Quota Properties. . . . . . . . . . . . . 100
Table 25 Server Configuration: Global Settings. . . . . . . . . . . . . . . 103
Table 26 Server Configuration: Enter New Disk Type. . . . . . . . . . . 106
Table 27 Server Configuration: Disk Definitions . . . . . . . . . . . . . . 107
Table 28 Server Configuration: Stripe Groups . . . . . . . . . . . . . . . . 108
Table 29 QOS Configuration Keywords . . . . . . . . . . . . . . . . . . . . . 149

Preface

StorNext provides high performance data sharing and intelligent archiving that is compatible with an industry-leading range of operating systems, server platforms, and storage devices.
StorNext includes two main components:
• StorNext File System (SNFS) is high performance data sharing software that lets applications on multiple operating systems access a single data set.
• StorNext Storage Manger (SNSM) is an intelligent, policy-based data mover that automatically moves and locates data across multiple storage tiers.
You can choose to install both StorNext File System and Storage Manager, or install StorNext File System only. In addition, StorNext includes client software that allows client systems to mount and work with StorNext file systems.

Audience

This document is intended for service professionals and system administrators who install StorNext software. The installer should have
StorNext 3.5.2.1 Installation Guide xi
Preface Purpose

Purpose

strong familiarity with the operating system on which StorNext is installed.
Only service professionals, experienced StorNext users, or individuals who have successfully completed StorNext training should configure StorNext. Attempting to configure StorNext without proper experience or training can affect system performance and may result in data loss.
This document provides information about installing and configuring StorNext. The following topics are covered:
• System requirements
• Pre-installation tasks
• Installation
• Configuration
• Uninstalling StorNext

Document Organization

This document contains the following chapters:
Chapter 1, Installing StorNext File System and Storage Manager provides system requirements, pre-installation information, and instructions for installing StorNext File System and Storage Manger on a metadata controller (MDC).
Chapter 2, Installing StorNext File System provides system requirements, pre-installation information, and instructions for installing StorNext File System (without Storage Manager) on a metadata controller (MDC).
Preface

Notational Conventions

Chapter 3, Installing the StorNext Client provides system requirements, pre-installation information, and instructions for installing the StorNext client software.
Chapter 4, Configuring StorNext describes how to use the StorNext configuration wizard and the Windows configuration utilities to create a basic StorNext configuration, and how to configure a distributed LAN client or server.
Appendix A, Uninstalling StorNext describes how to remove StorNext software from a server or client system.
Appendix B, StorNext Administration Tasksdescribes how to perform file system tasks that do not apply to a typical StorNext setup.
Appendix C, StorNext Filesdescribes the files used and modified to configure a file system.
Appendix D, Quality of Service Guidedescribes how to configure and use the StorNext File System (SNFS) Quality of Service (QOS) feature.
Notational Conventions
This manual uses the following conventions:
Convention Example
User input is shown in Arial regular font.
User input variables are enclosed in angle brackets and are shown in Arial italic font.
For UNIX and Linux commands, the command prompt is implied.
File and directory names, menu commands, button names, and window names are shown in Arial bold font.
StorNext 3.5.2.1 Installation Guide xiii
./install.stornext
mkdir -p
./install.stornext
is the same as
# ./install.stornext
/stornext/snfs1
<mount point>
Preface Related Documents
Convention Example
Menu names separated by arrows indicate a sequence of menus to be navigated.
The following formats indicate important information:
Note: Notes emphasize important information related to the main
Caution: Cautions indicate potential hazards to equipment and are
WARNING: Warnings indicate potential hazards to personal safety

Related Documents

Admin > Download Client Software
topic.
included to prevent damage to equipment.
and are included to prevent injury.
Documents related to StorNext are shown below:

Quantum StorNext Documentation

Document No. Document Title Document Description
6-01658-12 StorNext User’s
Guide
6-01376-16 StorNext File System
Tuning Guide
Provides in-depth information about using StorNext to create and manage StorNext File Systems.
Provides information for maximizing file system performance.

Contacting Quantum

Document No. Document Title Document Description
Preface
6-01620-15 StorNext Upgrade
6-01688-12 StorNext CLI
6-00431-30 StorNext 3.5.2.1
Contacting Quantum
More information about StorNext is available on the Service and Support website at Support Website contains a collection of information, including answers to frequently asked questions (FAQs). You can also access software, firmware, and drivers through this site.
Provides procedures for
Guide
Reference Guide
Release Notes
www.quantum.com/support. The Service and
upgrading from earlier versions of StorNext.
Provides procedures for performing common tasks using the command line interface.
Includes the latest product information, fixes, and issues.
For further assistance, or if training is desired, contact Quantum:
Quantum Technical Assistance Center in the USA:
For additional contact information:
To open a Service Request:
For the most updated information on Quantum Global Services, please visit:
www.quantum.com/support
StorNext 3.5.2.1 Installation Guide xv
+1 800-284-5101
www.quantum.com/support
www.quantum.com/osr
Preface Contacting Quantum
Chapter 1
Installing StorNext File System
and Storage Manager
This chapter describes how to install StorNext File System (SNFS) and StorNext Storage Manager (SNSM) on a metadata controller (MDC). Install both SNFS and SNSM for storage systems that require policy­based data movement (for example, systems that include tape drives or libraries).
To ensure successful operation, do the following tasks before installing StorNext:
• Make sure the MDC meets all operating system and hardware requirements (see
• Make sure all storage devices are correctly configured and are visible to the MDC (see
Storage Manager System Requirements).
Getting Ready to Install on page 5)
• (Optional) Run the pre-installation script to check for available disk space and view recommended locations for support directories (see
Pre-Installation Script on page 8).
When you are ready to install StorNext File System and Storage Manager on the MDC, run the installation script (see on page 11).
Note: To install only StorNext File System (without Storage Manager),
see
Chapter 2, Installing StorNext File System To install the
StorNext client software, see Chapter 3, Installing the StorNext
Client
StorNext 3.5.2.1 Installation Guide 1
StorNext Installation Script
Chapter 1: Installing StorNext File System and Storage Manager Storage Manager System Requirements

Storage Manager System Requirements

To run StorNext File System and Storage Manager, the metadata controller must meet all operating system, hardware, and LAN requirements.

Operating System Requirements

Table 1 Storage Manager Supported Platforms
The operating systems, kernel versions, and hardware platforms supported by StorNext SNFS and SNSM are presented in sure the MDC uses a supported operating system and platform, and if necessary update to a supported kernel version before installing StorNext.
Operating System Kernel Platform
Red Hat® Enterprise
®
Linux
4
Red Hat Enterprise Linux 5
SUSETM Linux Enterprise Server 10
Sun SolarisTM 10
2.6.9-89 EL (Update 8) x86 64-bit
2.6.18-53.EL (Update 1)
2.6.18-92.EL (Update 2)
2.6.18-128.EL (Update 3)
2.6.18-164.EL (Update 4)
2.6.16-46-0.12 (SP1)
2.6.16-60-0.27 (SP2)
2.6.16.60-0.54.5 (SP3)
Generic 120011-14 Sparc 64-bit
Ta bl e 1. Make
x86 64-bit
x86 64-bit

Hardware Requirements

The minimum amount of RAM and available hard disk space required to run StorNext SNFS and SNSM are presented in files (such as database and journal files) are stored on the MDC, the amount of local disk space that is required increases with the number of data files stored on StorNext file systems.
If necessary, upgrade the RAM and local disk storage in the MDC to meet the minimum requirements before installing StorNext.
Ta bl e 2. Because support
Chapter 1: Installing StorNext File System and Storage Manager
Storage Manager System Requirements
Note: The RAM requirements in Ta bl e 2 are for running StorNext File
System and Storage Manager only. Running additional software (including the StorNext client software) requires additional RAM.
Table 2 Storage Manager Hardware Requirements
File Systems RAM Disk Space
1–4* 2 GB • For application binaries, log files,
5–8** 4 GB
and documentation: up to 30GB (depending on system activity)
• For support directories: 3 GB per million files stored
• For metadata: 25GB minimum
*Two CPUs recommended for best performance. **Two CPUs required for best performance. †For non-managed file systems, the requirement is 1GB per million files
stored.
Note: If a file system uses deduplicated storage disks (DDisks), note
the following additional requirements:
• Requires 2 GB RAM per DDisk in addition to the base RAM noted in
Ta bl e 2.
• Requires an additional 5GB of disk space for application binaries and log files.
• Deduplication is supported only for file systems running on a Linux operating system.
• An Intel Pentium 4 or later processor (or an equivalent AMD processor) is required. For best performance, Quantum recommends an extra CPU per blockpool.
StorNext 3.5.2.1 Installation Guide 3
Chapter 1: Installing StorNext File System and Storage Manager Storage Manager System Requirements
Partitioning Local Hard Disks
StorNext can be installed on any local file system (including the root file system) on the MDC. However, for optimal performance, as well as to aid disaster recovery, follow these recommendations:
• Avoid installing StorNext on the root file system.
• Partition local hard disks so that the MDC has four available local file systems (other than the root file system) located on four separate hard drives.
Note: You can run the pre-installation script to help determine the
estimated size of and optimal location for StorNext support directories. For more information, see
Pre-Installation Script on
page 8.

LAN Requirements The following LAN requirements must be met before installing StorNext

on the MDC:
• In cases where gigabit networking hardware is used and maximum StorNext performance is required, a separate, dedicated switched Ethernet LAN is recommended for the StorNext metadata network. If maximum StorNext performance is not required, shared gigabit networking is acceptable.
• A separate, dedicated switched Ethernet LAN is mandatory for the metadata network if 100 Mbit/s or slower networking hardware is used.
• The MDC and all clients must have static IP addresses.
Verify network connectivity with pings, and also verify entries in the
/etc/hosts file. Alternatively, telnet or ssh between machines to verify
connectivity.
• If using Gigabit Ethernet, disable jumbo frames and TOE (TCP offload engine).
Note: StorNext does not support file system metadata on the same
network as iSCSI, NFS, CIFS, or VLAN data when 100 Mbit/s or slower networking hardware is used.

Getting Ready to Install

Before installing StorNext SNFS and SNSM, complete the following tasks to ensure successful installation:
• Correctly configure all storage devices (see Configuring Storage
Devices).
• If using LUNs larger than 1 TB, decide on a label type and install any necessary operating system patches (see
than 1 TB).
• (Linux only) Install the kernel source code (see Installing the Linux
Kernel Source Code on page 7).
Chapter 1: Installing StorNext File System and Storage Manager
Getting Ready to Install
Planning for LUNs Larger

Configuring Storage Devices

Planning for LUNs Larger than 1 TB

Before installing StorNext SNFS and SNSM, make sure that all LUNs are visible to the MDC. (A LUN, or logical unit number, is a logical device that corresponds to one or more disks, drives, or storage devices.)
If there are any connection issues, resolve them before installing StorNext. For assistance in configuring storage devices, refer to the documentation that came with the storage device, or contact the manufacturer.
Note: LUNs that you plan to use in the same stripe group must be the
same size. Consider this when configuring storage devices. (For more information about stripe groups, see the
Guide
.)
Caution: StorNext does not support the connection of multiple
devices through fibre channel hubs. Multiple devices must be connected using fibre channel switches.
StorNext supports LUNs greater than 1 TB in size if they are allowed by the operating system. To enable support for 1 TB or larger LUNs, all StorNext LUNs must be correctly labeled according to the requirements of the operating system running on the MDC as well as the operating
StorNext User’s
StorNext 3.5.2.1 Installation Guide 5
Chapter 1: Installing StorNext File System and Storage Manager Getting Ready to Install
system running on all connected clients. Disk LUNs can have one of three labels: VTOC, EFI, or sVTOC (short VTOC).
Required disk LUN label settings based on operating system and LUN size are presented in
Ta bl e 3. Before installing StorNext, decide what
label type will be used, and then install any required operating system patches or updates (for both MDC and client) as indicated in the notes for
Ta bl e 3.
Note: After labeling a disk LUN, you must reboot systems running
Solaris before they can access the disk LUN.
Table 3 Required Disk LUN Labels
Operating System
Windows
a
Linux 2.6
Label for LUNs < 1 TB
Label for LUNs 1–2 TB
Label for LUNs > 2 TB
VTOC, EFI VTOC, EFI EFI, sVTOC
VTOC, EFI VTOC, EFI EFI, sVTOC
Kernel
Linux 2.4
VTOC, EFI VTOC, EFI Not supported
Kernel
Solaris 9
Solaris 10
d
HP-UX
IBM AIX
e
b
c
VTOC, EFI EFI Not supported
VTOC, EFI EFI EFI
VTOC, EFI VTOC, EFI EFI, sVTOC
VTOC, EFI VTOC, EFI EFI, sVTOC
SGI IRIX VTOC VTOC Not supported
Apple Xsan 1.3
VTOC, EFI VTOC, EFI EFI, sVTOC (MacOS X 10.4 Tiger)
Apple Xsan 1.3
VTOC, EFI VTOC, EFI EFI, sVTOC (MacOS X 10.3
Panther)
d
Apple Xsan
d
1.2
VTOC VTOC sVTOC
Chapter 1: Installing StorNext File System and Storage Manager
Getting Ready to Install

Installing the Linux Kernel Source Code

Operating System
a. For Windows XP 32-bit systems only, support for LUNs larger than 2 TB is
limited to the first 2 TB. All other supported Windows platforms
(including Windows XP 64-bit) support LUNs greater than 2 TB. b. Support for EFI labels requires the Multiterabyte Disk Support patch. c. Support for 2 TB or larger LUNs requires Solaris 10 Update 2 (06/06). d. Supports only the first 2 TB of LUNs larger than 2 TB. e. Supports only LUNs of 2.2 TB or less.
Label for LUNs < 1 TB
Label for LUNs 1–2 TB
Label for LUNs > 2 TB
Note: For best results, Quantum recommends using persistent
binding for disk LUNs. For more information, contact the vendor of your HBA (host bus adapter).
For management servers running Red Hat Enterprise Linux version 4 or 5, before installing SNFS and SNSM you must first install the kernel header files (shipped as the kernel-devel or kernel-devel-smp RPM, depending on your Linux distribution).
For servers running SUSE Linux Enterprise Server, you must install the first kernel source code (shipped as the kernel-source RPM). StorNext will not operate correctly if these packages are not installed. You can install the kernel header files or kernel source RPMs by using the installation disks for your operating system.

Verifying Hostname Length

The maximum hostname length for a StorNext server is limited to 25 characters. Before you begin the installation, verify that the destination hostname is not longer than 25 characters. (The hostname is read during the installation process, and if the hostname is longer than 25 characters the installation process could fail.)
StorNext 3.5.2.1 Installation Guide 7
Chapter 1: Installing StorNext File System and Storage Manager Pre-Installation Script

Pre-Installation Script

The StorNext pre-installation script (snPreInstall) is included on the StorNext installation CD. When you run for information about your system. The pre-installation script uses this information to estimate the amount of local disk space required for SNFS and SNSM support directories. In addition, the script recommends the optimal locations for support directories.
StorNext uses five directories to store application support information. These directories are stored locally on the metadata controller, except for the
The StorNext support directories are described in Ta bl e 4.
Backup directory, which is stored on the managed file system.
snPreInstall, you are prompted
Table 4 StorNext Support Directories
Support Directory Description
Database /adic/database
Journal /adic/database_jnl
Mapping /adic/mapping_dir
Metadata /adic/database_meta
Backup /backup
Records information about where and how data files are stored.
Records changes made to the database.
Contains index information that enables quick searches on the file system.
Stores metadata dumps (backups of file metadata).
Contains configuration files and support data required for disaster recovery.

Before You Begin Before running the pre-installation script, be prepared to answer the

following questions:
• Is this an upgrade installation?
• What local file systems can be used to store support information?
• Which version of StorNext will be installed?
Chapter 1: Installing StorNext File System and Storage Manager
Pre-Installation Script
• What is the maximum number of directories expected (in millions)?
• What is the maximum number of files expected (in millions)?
• How many copies will be stored for each file?
• How many versions will be retained for each file?
Note: Keep in mind that storage needs typically grow rapidly.
Consider increasing the maximum number of expected directories and files by a factor of 2.5x to ensure room for future growth.
Note: The pre-installation script ignores unmounted file systems.
Before running
snPreInstall, be sure to mount all local file
systems that will hold StorNext support information.

Running snPreInstall To run the pre-installation script, use the StorNext installation CD.

1 Log on to the MDC as root.
2 Mount the StorNext installation CD and change to the CD root
directory.
3 List the installation directories on the CD. At the command prompt,
type:
ls -l
4 Identify the correct installation directory for your operating system
and hardware platform, and then change to that directory.
For example, for Red Hat Linux 5 running on an x86 64-bit platform, change to the
RedHat50AS_26x86_64 directory.
5 Run the script. At the command prompt, type:
./snPreInstall
The pre-installation script runs (Figure 1).
StorNext 3.5.2.1 Installation Guide 9
Chapter 1: Installing StorNext File System and Storage Manager Pre-Installation Script
Figure 1 Pre-Installation Script
6 Follow the onscreen instructions, and answer each question when
prompted.
The script outputs results based on the information you entered.

Interpreting snPreInstall Output

After you enter all requested information, the pre-installation script outputs the following results:
• Estimated disk space required for each support directory.
• Recommended file system location for each support directory.
Te c h T i p : For optimal performance, each support directory
(other than the Backup directory) should be located on its own local file system, and each local file system should reside on a separate physical hard disk in the MDC.
There are three types of directory recommendations, as indicated by the text preceding the recommendation. The three types of recommendations are described in
Ta bl e 5.
Chapter 1: Installing StorNext File System and Storage Manager

StorNext Installation Script

Table 5 Pre-Installation Script Recommendation Types
Typ e Description
RECOMMEND The suggested directory locations will result in
optimal system performance.
NOTE The suggested directory locations are valid but
system performance will not be optimal.
SPACE Additional hard disk space is required to store
the required support directories.
The pre-installation script bases directory location recommendations on the following criteria:
• To aid disaster recovery, the Database and Journal directories should
be located on different file systems.
• For optimal performance, the Metadata directory should not be
located on the same file system as (in order of priority) the
Database, or Mapping directory.
Note: Do not change the location of support directories manually.
Instead, use the installation script to specify the location for support directories. For more information, see
Installation Script.
StorNext
Journal,
StorNext Installation Script
When you are ready to install StorNext, use the StorNext installation script to install StorNext File System and Storage Manager on the metadata controller. The installation script also installs the client software on the MDC.
If you are upgrading from a StorNext File System only system to include StorNext Storage Manager, please follow the instructions in
From a StorNext File System-Only Configuration. Otherwise, you can
proceed to Launching the StorNext Installation Script.
StorNext 3.5.2.1 Installation Guide 11
Upgrading
Chapter 1: Installing StorNext File System and Storage Manager StorNext Installation Script
Upgrading From a StorNext File System­Only Configuration

Launching the StorNext Installation Script

If you have StorNext File System only and are adding StorNext Storage Manager, some components remain from the File System installation and the new installation could fail. To prevent installation failure, you should first remove the old components.
The following procedure describes how to remove the old components before starting the new StorNext installation. Follow the steps below
only
if you are upgrading from a StorNext File System-only
configuration to StorNext File System and Storage Manger.
1 Log on to the MDC as root. 2 Save /etc/fstab and /usr/cvfs/config
3 Remove the existing rpms.
4 Install StorNext as described in Launching the StorNext Installation
Script.
5 Restore /etc/fstab and /usr/cvfs/config
The StorNext installation script lets you choose installation configuration options and install StorNext. To launch the script, use the correct StorNext installation CD for your operating system.
1 Log on to the MDC as root.
2 Mount the StorNext installation CD and change to the CD root
directory.
Note: When you mount a CD in a Red Hat 4 or 5 system, CDs are
mounted by default with a noexec (non-executable) option which prevents you from proceeding with the installation.
For Red Hat users only, before proceeding you must remount the CD by typing mount -o remount, exec ...
3 List the installation directories on the CD. At the command prompt,
type:
ls -l
4 Identify the correct installation directory for your operating system
and hardware platform, and then change to that directory.
Loading...
+ 152 hidden pages