StorNext 3.5 Installation Guide, 6-00360-14 Rev B, October 2009, Made in 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.
US Patent No: 5,990,810 applies. Other Patents pending in the US and/or other countries.
StorNext is either a trademark or registered trademark of Quantum Corporation in the US and/or other countries.
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
ADIC, Quantum, DLT, DLTtape, the Quantum logo, and the DLTtape logo are all registered trademarks of Quantum
Corporation.
SDLT and Super DLTtape are trademarks of Quantum Corporation.
Other trademarks may be mentioned herein which belong to other companies.
Contents
Chapter 1Installing StorNext File System and Storage Manager1
Storage Manager System Requirements.........................................................2
Operating System Requirements.............................................................. 2
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.
StorNext 3.5 Installation Guidexii
Audience
Purpose
Preface
Audience
This document is intended for service professionals and system
administrators who install StorNext software. The installer should have
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
StorNext 3.5 Installation Guidexiii
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).
• 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.
Preface
Document Organization
• Appendix A, “Uninstalling StorNext,” describes how to remove
StorNext software from a server or client system.
• Appendix B, “StorNext Administration Tasks,”describes how to
perform file system tasks that do not apply to a typical StorNext
setup.
• Appendix C, “StorNext Files,”describes the files used and modified
to configure a file system.
• Appendix D, “Quality of Service Guide,”describes how to configure
and use the StorNext File System (SNFS) Quality of Service (QOS)
feature.
StorNext 3.5 Installation Guidexiv
Notational Conventions
This manual uses the following conventions:
ConventionExample
Preface
Notational Conventions
User input is shown in Arial regular
./install.stornext
font.
User input variables are enclosed in
mkdir -p <mount point>
angle brackets and are shown in
Arial italic font.
For UNIX and Linux commands, the
command prompt is implied.
File and directory names, menu
./install.stornext
is the same as
# ./install.stornext
/stornext/snfs1
commands, button names, and
window names are shown in Arial
bold font.
Menu names separated by arrows
indicate a sequence of menus to be
Admin > Download Client
Software
navigated.
The following formats indicate important information:
Note:Notes emphasize important information related to the main
topic.
Tech Tip:Tech Tips provide technical information which may be
helpful in performing the procedure.
Caution:Cautions indicate potential hazards to equipment and are
included to prevent damage to equipment.
StorNext 3.5 Installation Guidexv
Related Documents
Documents related to StorNext are shown below:
Quantum StorNext Documentation0
Preface
Related Documents
Warning:Warnings indicate potential hazards to personal safety and
are included to prevent injury.
Document No.Document TitleDocument Description
6-01658-05StorNext User’s GuideProvides in-depth
information about using
StorNext to create and
manage StorNext File
Systems.
6-01376-09StorNext File System
Tuning Guide
6-01620-08StorNext Upgrade
Guide
6-01688-05StorNext CLI Reference
Guide
StorNext 3.5 Installation Guidexvi
Provides information for
maximizing file system
performance.
Provides procedures for
upgrading from earlier
versions of StorNext.
Provides procedures for
performing common tasks
using the command line
interface.
Preface
Contacting Quantum
Document No.Document TitleDocument Description
6-01564-02AMASS Conversion
6-00431-22StorNext 3.5 Release
Contacting Quantum
More information about this product is available on the Quantum Service
and Support website at
Quantum Service and 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.
To request a software upgrade, visit www.quantum.com/
ServiceandSupport/Upgrade/Index.aspx. For further assistance, or if
training is desired, contact Quantum Global Services:
Provides information about
Guide
Notes
www.quantum.com/ServiceandSupport. The
migrating systems running
AMASS to StorNext.
Includes the latest product
information, fixes, and
issues.
North America
EMEA
Online Service and
Support
World Wide Web
(Local numbers for specific countries are listed on the Quantum Service
and Support Website.)
StorNext 3.5 Installation Guidexvii
+1 800-284-5101 Option 5
00800 9999 3822
www.quantum.com/OSR
www.quantum.com/ServiceandSupport
Chapter 1
1Installing 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 policybased 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 12).
Note:To install only StorNext File System (without Storage
Manager), see
install the StorNext client software, see Chapter 3, “Installing
the StorNext Client.”
StorNext 3.5 Installation Guide1
Chapter 2, “Installing StorNext File System.” To
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
Requirements1
Table 1 Storage Manager
Supported Platforms
Hardware Requirements1
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 SystemKernelPlatform
Red Hat® Enterprise
®
Linux
SUSETM Linux
Enterprise Server 10
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.
5
2.6.18-53.EL (Update 1)
2.6.18-92.EL (Update 2)
2.6.16-46-0.12 (SP1)
2.6.16-60-0.27 (SP2)
Table 2. Because support
Table 1. Make
x86 64-bit
x86 64-bit
Note:The RAM requirements in Table 2 are for running StorNext
File System and Storage Manager only. Running additional
software (including the StorNext client software) requires
additional RAM.
StorNext 3.5 Installation Guide2
Chapter 1 Installing StorNext File System and Storage Manager
Storage Manager System Requirements
Table 2 Storage Manager
Hardware Requirements
File SystemsRAMDisk 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
Table 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.
Partitioning Local Hard Disks1
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.
StorNext 3.5 Installation Guide3
Chapter 1 Installing StorNext File System and Storage Manager
Storage Manager System Requirements
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 Requirements1
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.
StorNext 3.5 Installation Guide4
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
Devices1
Planning for LUNs Larger
than 1 TB1
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 StorNext 3.5 User’s 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
StorNext 3.5 Installation Guide5
Chapter 1 Installing StorNext File System and Storage Manager
Getting Ready to Install
of the operating system running on the MDC as well as the operating
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
Table 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
Table 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 XP
Windows 2003
Label for
LUNs < 1 TB
a
VTOC, EFIVTOC, EFIEFI, sVTOC
Label for
LUNs 1–2 TB
VTOC, EFIVTOC, EFIEFI, sVTOC
Label for
LUNs > 2 TB
Server
Linux 2.6
VTOC, EFIVTOC, EFIEFI, sVTOC
Kernel
Linux 2.4
VTOC, EFIVTOC, EFINot supported
Kernel
Solaris 9
Solaris 10
HP-UX
IBM AIX
b
c
a
d
VTOC, EFIEFINot supported
VTOC, EFIEFIEFI
VTOC, EFIVTOC, EFIEFI, sVTOC
VTOC, EFIVTOC, EFIEFI, sVTOC
SGI IRIXVTOCVTOCNot supported
Apple Xsan 1.3
VTOC, EFIVTOC, EFIEFI, sVTOC
(MacOS X 10.4
Tiger)
Apple Xsan 1.3
(MacOS X 10.3
Panther)
StorNext 3.5 Installation Guide6
a
VTOC, EFIVTOC, EFIEFI, sVTOC
Chapter 1 Installing StorNext File System and Storage Manager
Getting Ready to Install
Installing the Linux
Kernel Source Code1
Operating
System
Apple Xsan
a
1.2
a. Supports only the first 2 TB of LUNs larger 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 LUNs of 2.2 TB or less.
Label for
LUNs < 1 TB
Label for
LUNs 1–2 TB
Label for
LUNs > 2 TB
VTOCVTOCsVTOC
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
Length1
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 Installation Guide7
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
Backup directory, which is stored on the managed file system.
The StorNext support directories are described in Table 4.
Chapter 1 Installing StorNext File System and Storage Manager
Pre-Installation Script
snPreInstall, you are prompted
Table 4 StorNext Support
Directories
Before You Begin1
Support DirectoryDescription
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 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?
StorNext 3.5 Installation Guide8
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.
systems that will hold StorNext support information.
Running snPreInstall1
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 Installation Guide9
Figure 1 Pre-Installation Script
Chapter 1 Installing StorNext File System and Storage Manager
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
Output1
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.
Tech Tip: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
StorNext 3.5 Installation Guide10
Table 5.
Chapter 1 Installing StorNext File System and Storage Manager
RECOMMENDThe suggested directory locations will result in
optimal system performance.
NOTEThe suggested directory locations are valid but
system performance will not be optimal.
SPACEAdditional 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.
Journal,
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
StorNext
Installation Script.
StorNext 3.5 Installation Guide11
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.
Chapter 1 Installing StorNext File System and Storage Manager
StorNext Installation Script
Upgrading
Upgrading From a
StorNext File SystemOnly Configuration1
Launching the StorNext
Installation Script1
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.
StorNext 3.5 Installation Guide12
Chapter 1 Installing StorNext File System and Storage Manager
StorNext Installation Script
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.
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:
./install.stornext
The installation script runs (figure 2).
Figure 2 StorNext Installation
Script
StorNext 3.5 Installation Guide13
Chapter 1 Installing StorNext File System and Storage Manager
StorNext Installation Script
6 Type the number corresponding to a menu option and press <Enter>.
Installation menu options are described in
Table 6.
Table 6 StorNext Installation
Main Menu Options
Changing Installation
Configuration Options1
Menu OptionDescription
1Change installation options, including the
location of application directories and the
default media type (see
Changing Installation
Configuration Options).
2Install StorNext using the installation options
specified on the Configuration Menu (see
Performing an Installation Operation on page
17).
3View the status of an installation operation that
is currently in progress.
4Exit the StorNext installation script.
Use the Configuration Menu to change StorNext installation options. You
can specify the location of application and support directories and change
the default media type for storage devices.
On the Main Menu, type 1 and press <Enter>. The Configuration Menu
appears (
figure 3).
StorNext 3.5 Installation Guide14
Figure 3 Configuration Menu
Chapter 1 Installing StorNext File System and Storage Manager
StorNext Installation Script
Changing Application Directory Locations1
When you first enter the Configuration Menu, it displays recommended
locations for StorNext application directories based on the available file
systems detected by the installation script. To accept the recommended
directory locations and return to the Main Menu, press
<Enter>.
Alternately, customize the installation by specifying the file systems
where application and support files are stored.
1 On the Configuration Menu, type the number that corresponds to the
directory location you want to customize (
<Enter>.
1–14), and then press
A list of available local file systems is shown.
2 To change the file system where the directory is located, type the
name of the file system and press
StorNext 3.5 Installation Guide15
<Enter>.
Chapter 1 Installing StorNext File System and Storage Manager
StorNext Installation Script
3 To confirm the change, type yes and press <Enter>.
To customize additional directory locations, repeat steps 1–3.
4 When you are done customizing the installation, press <Enter> to
return to the Main Menu.
Note:To help determine the optimal location for StorNext support
directories, use the StorNext pre-installation script. For more
information, see
Pre-Installation Script on page 8.
Changing the Default Media Type1
If you do not specify a different media type, the StorNext installation
script selects LTO as the default media type for storage devices. If storage
devices in your system use a different media type, change the default
media type before installing StorNext.
1 On the Configuration Menu, type 15 and press <Enter>.
A list of valid default media types is shown. The valid media types
are: DDISK, SDISK, LTO, LTOW, 3590, 3592, 9840, 9940, AITW, AIT,
DLT4, and T10K.
Note:The DDISK option is available only for MDCs running
the x86 64-bit version of Linux.
2 Type the correct default media type for storage devices in your
system and press
<Enter>.
3 To confirm the change, type yes and press <Enter>.
4 When you are done customizing the installation, press <Enter> to
return to the Main Menu.
Note:For multiple libraries or systems with mixed media types,
specify the media type used in the primary backup.
StorNext 3.5 Installation Guide16
Chapter 1 Installing StorNext File System and Storage Manager
StorNext Installation Script
Performing an
Installation Operation1
Figure 4 StorNext Installation
Status
To install StorNext using the options specified on the Configuration
Menu, perform an installation operation.
1 On the Main Menu, type 2 and press <Enter>.
The StorNext installation script runs (figure 4). The script displays
the current progress of the installation.
Note:Depending on your system configuration, the post-
installation procedure could take a long time (up to
several hours) to complete. Until the status changes to
Complete, a message informs you that the procedure is
still running. Please be patient while this step runs.
2 When the installation is complete, press <Enter> to return to the Main
Menu.
3 To exit the installation script, type 4 and press <Enter>.
Note:The script displays the URL at which the MDC can be
accessed. Make a note of this information.
You can now access StorNext File System and Storage Manager, and run
the configuration wizard. For more information, see
Chapter 4,
“Configuring StorNext.”
StorNext 3.5 Installation Guide17
Chapter 2
2Installing StorNext File System
This chapter describes how to install StorNext File System (SNFS) on a
metadata controller (MDC). Install SNFS to create data sets that can be
shared by clients and applications running on multiple operating
systems.
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
When you are ready, install StorNext File System on the MDC using the
appropriate method for your operating system (see
File System on Linux or Unix on page 23 or Installing StorNext File
System on Windows on page 27).
File System Requirements).
Getting Ready to Install on page 20).
Installing StorNext
Note:To install both StorNext File System and StorNext Storage
Manager, see
Storage Manager.” To install the StorNext client software, see
Chapter 3, “Installing the StorNext Client.”
StorNext 3.5 Installation Guide18
Chapter 1, “Installing StorNext File System and
File System Requirements
To run StorNext File System, the metadata controller must meet all
operating system and hardware requirements.
Chapter 2 Installing StorNext File System
File System Requirements
Operating System
Requirements2
Table 7 File System
Supported Platforms
Hardware Requirements2
The operating systems, releases and kernels, and hardware platforms
supported by StorNext SNFS are presented in
MDC uses a supported operating system and platform, and if necessary
update to a supported release or kernel version before installing
StorNext.
Operating SystemRelease or KernelPlatform
Windows Server 2003®SP2x86 64-bit
Windows Server 2008®n/ax86 64-bit
Red Hat® Enterprise
®
Linux
SUSETM Linux
Enterprise Server 10
The minimum amount of RAM and available hard disk space required to
run StorNext SNFS are presented in
If necessary, upgrade the RAM and local disk storage in the MDC to meet
the minimum requirements before installing StorNext.
5
2.6.18-53.EL (Update 1)
2.6.18-92.EL (Update 2)
2.6.16.46-0.12 (SP1)
2.6.16.60-0.27 (SP2)
Table 8.
Table 7. Make sure the
x86 64-bit
x86 64-bit
Note:The RAM requirements in Table 8 are for running StorNext
File System only. Running additional software (including the
StorNext client software) requires additional RAM.
StorNext 3.5 Installation Guide19
Chapter 2 Installing StorNext File System
Getting Ready to Install
Table 8 File System Hardware
Requirements
LAN Requirements2
File SystemsRAMDisk Space
1–4*2 GB2 GB
5–8**4 GB4 GB
* Two CPUs recommended for best performance.
** Two CPUs required for best performance.
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.
• 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, complete the following tasks to ensure
successful installation:
StorNext 3.5 Installation Guide20
Chapter 2 Installing StorNext File System
Getting Ready to Install
• Correctly configure all storage devices (see Configuring Storage
Devices on page 21).
• If using LUNs larger than 1 TB, decide on a label type and install any
necessary operating system patches (see
Planning for LUNs Larger
than 1 TB on page 21).
• (Linux only) Install the kernel source code (see Installing the Linux
Kernel Source Code on page 23).
Configuring Storage
Devices2
Planning for LUNs Larger
than 1 TB2
Before installing StorNext SNFS, 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 StorNext 3.5 User’s 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
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
Table 9. Before installing StorNext, decide what
label type will be used, and then install any required operating system
StorNext 3.5 Installation Guide21
Chapter 2 Installing StorNext File System
Getting Ready to Install
patches or updates (for both MDC and client) as indicated in the notes for
Table 9.
Note:After labeling a disk LUN, you must reboot systems running
Solaris before they can access the disk LUN.
Table 9 Required Disk LUN
Labels
Operating
System
Windows XP
Windows 2003
Label for
LUNs < 1 TB
a
VTOC, EFIVTOC, EFIEFI, sVTOC
Label for
LUNs 1–2 TB
VTOC, EFIVTOC, EFIEFI, sVTOC
Label for
LUNs > 2 TB
Server
Linux 2.6
VTOC, EFIVTOC, EFIEFI, sVTOC
Kernel
Linux 2.4
VTOC, EFIVTOC, EFINot supported
Kernel
Solaris 9
Solaris 10
HP-UX
IBM AIX
b
c
a
d
VTOC, EFIEFINot supported
VTOC, EFIEFIEFI
VTOC, EFIVTOC, EFIEFI, sVTOC
VTOC, EFIVTOC, EFIEFI, sVTOC
SGI IRIXVTOCVTOCNot supported
Apple Xsan 1.3
VTOC, EFIVTOC, EFIEFI, sVTOC
(MacOS X 10.4
Tiger)
Apple Xsan 1.3
(MacOS X 10.3
Panther)
Apple Xsan
1.2
StorNext 3.5 Installation Guide22
a
a
VTOC, EFIVTOC, EFIEFI, sVTOC
VTOCVTOCsVTOC
Chapter 2 Installing StorNext File System
Installing StorNext File System on Linux or Unix
Installing the Linux
Kernel Source Code2
Operating
System
a. Supports only the first 2 TB of LUNs larger 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 LUNs of 2.2 TB or less.
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 MDCs running Red Hat Linux or SUSE Linux Enterprise Server you
must install the kernel source code as well as all tools required to compile
the kernel before installing SNFS. StorNext will not operate correctly if
the kernel source code is not installed.
The kernel source code can be installed using the installation disks for
your operating system.
Label for
LUNs < 1 TB
Label for
LUNs 1–2 TB
Label for
LUNs > 2 TB
Installing StorNext File System on Linux or Unix
When you are ready to install StorNext, use the SNFS installation script to
install StorNext File System on a metadata controller running Linux or
Unix. The installation script also installs the client software on the MDC.
StorNext can be installed on any local file system (including the root file
system) on the MDC. However, for optimal performance, avoid installing
StorNext on the root file system.
Launching the SNFS
Installation Script2
StorNext 3.5 Installation Guide23
The SNFS 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.
Chapter 2 Installing StorNext File System
Installing StorNext File System on Linux or Unix
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.
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:
./install.snfs
The installation script runs (figure 5).
Figure 5 SNFS Installation
Script
6 Type the number corresponding to a menu option and press <Enter>.
Installation menu options are described in
StorNext 3.5 Installation Guide24
Table 10.
Chapter 2 Installing StorNext File System
Installing StorNext File System on Linux or Unix
Table 10 SNFS Installation
Main Menu Options
Changing Installation
Configuration Options2
Menu OptionDescription
1Change installation options for the location of
application directories (see
Changing
Installation Configuration Options on page 25).
2Install StorNext using the installation options
specified on the Configuration Menu (see
Performing an Installation Operation on page
26).
3View the status of an installation operation that
is currently in progress.
4Exit the SNFS installation script.
Use the Configuration Menu to change the location of application
directories.
On the Main Menu, type 1 and press <Enter>. The Configuration Menu
appears (
figure 6).
Figure 6 Configuration Menu
When you first enter the Configuration Menu, it displays recommended
locations for StorNext application directories based on the available file
systems detected by the installation script. To accept the recommended
directory locations and return to the Main Menu, press
<Enter>.
Alternately, customize the installation by specifying the file systems
where application and support files are stored.
StorNext 3.5 Installation Guide25
Chapter 2 Installing StorNext File System
Installing StorNext File System on Linux or Unix
1 On the Configuration Menu, type the number that corresponds to the
directory location you want to customize (
<Enter>.
1–6), and then press
A list of available local file systems is shown.
2 To change the file system where the directory is located, type the
name of the file system and press
<Enter>.
3 To confirm the change, type yes and press <Enter>.
To customize additional directory locations, repeat steps 1–3.
4 When you are done customizing the installation, press <Enter> to
return to the Main Menu.
Performing an
Installation Operation2
Figure 7 StorNext Installation
Status
To install StorNext using the options specified on the Configuration
Menu, perform an installation operation.
1 On the Main Menu, type 2 and press <Enter>.
The installation script runs (figure 7). The script displays the current
progress of the installation.
Note:Depending on your system configuration, the post-
installation procedure could take a long time (up to
several hours) to complete. Until the status changes to
Complete, a message informs you that the procedure is
still running. Please be patient while this step runs.
StorNext 3.5 Installation Guide26
Chapter 2 Installing StorNext File System
Installing StorNext File System on Windows
2 When the installation is complete, press <Enter> to return to the Main
Menu.
3 To exit the installation script, type 4 and press <Enter>.
Note:The script displays the URL at which the MDC can be
accessed. Make a note of this information.
You can now access StorNext File System and run the configuration
wizard. For more information, see
Chapter 4, “Configuring StorNext.”
Installing StorNext File System on Windows
The StorNext setup wizard guides you through the process of installing
StorNext File System on a metadata controller running Windows 2003
Server. (The installation wizard also installs the client software on the
MDC.)
Before installing StorNext, remove any previously installed versions (see
Removing a Previous Version of StorNext on page 28).
When you are ready, use the setup wizard to install StorNext (see
Running the Setup Wizard on page 29).
(Optional) After installation, restore the previous client configuration (see
Restoring a Previous Client Configuration on page 33).
Note:You must log on as an Administrator to install StorNext.
Disabling Automatic IP
Address Configuration 2
StorNext 3.5 Installation Guide27
Before installing StorNext, you should disable automatic IP address
configuration in Windows. Disabling automatic IP address configuration
ensures that the FSM passes the correct IP address to file system
nameservers. Failure to disable automatic IP address configuration could
result in StorNext clients or servers being unable to talk to the active FSM.
There are two methods for disabling automatic IP address configuration:
Chapter 2 Installing StorNext File System
Installing StorNext File System on Windows
•Manually configuring the TCP/IP information, which disables
DHCP. You should use this method if any static IP addresses have
been configured.
•Editing the Windows registry to disable automatic IP address
configuration but not disable DHCP. To use this method, follow the
procedure outlined in Microsoft article 220874 available here:
If a previous version of StorNext older than version 3.0 exists on the
system, you must remove it before installing the new version. If you are
upgrading from a version of StorNext newer than version 3.0, the old
client configuration is retained so there is no need to restore the old
configuration.
1 Insert the StorNext installation CD.
2 Browse to the root directory of the installation CD and double-click
the file
SnfsSetup64.exe.
The StorNext Installation window appears (figure 8).
3 Click Remove StorNext.
A dialog box appears informing you that the current client
configuration has been saved.
StorNext 3.5 Installation Guide28
Chapter 2 Installing StorNext File System
Installing StorNext File System on Windows
4 Note the name and location of the saved configuration file, and then
click
OK.
5 If prompted, click Yes to continue, and then click OK to finish the
removal.
6 When the removal is complete, click Yes to reboot the system.
Note:After installing the new version of StorNext, you can restore
the saved client configuration (see
Restoring a Previous Client
Configuration on page 33).
Running the Setup
Wizard2
To launch the setup wizard, use the correct StorNext installation CD for
your operating system.
Note:Due to variables and different system configurations, the
installation process for Windows could be slightly different
than described. For example, you may or may not be asked to
reboot your system, depending on your configuration.
Generally speaking, the best policy is to follow the onscreen
instructions after you launch the Setup Wizard.
1 Insert the StorNext installation CD.
2 Browse to the root directory of the installation CD and double-click
the file
SnfsSetup64.exe.
The StorNext Installation window appears (figure 9).
software, and help files in the default location (
Files\StorNext
).
C:\Program
Figure 14 SNFS Setup: Ready
to Install
•Custom: Lets you choose which components to install and specify
an installation location. When ready, click
Next.
•Complete: Same as a typical installation.
The Ready to Install window appears (figure 14).
StorNext 3.5 Installation Guide32
Figure 15 SNFS Setup: Finish
Chapter 2 Installing StorNext File System
Installing StorNext File System on Windows
8 Click Install to continue.
Wait while the setup wizard installs StorNext. When installation is
complete, the
Finish window appears (figure 15).
9 Click Finish to close the setup wizard.
10 On the StorNext Installation window, click Exit.
You are prompted to reboot the system.
11 Click Yes to reboot.
You can now configure StorNext File System. For more information, see
Chapter 4, “Configuring StorNext.” Or, to restore a previous client
configuration, see the next section.
Restoring a Previous
Client Configuration2
If you saved a client configuration file (for example, when removing a
previous version of StorNext), you can import it after installing StorNext.
This configures StorNext using the same settings as the previous
installation.
1 Insert the StorNext installation CD.
2 Browse to the root directory of the installation CD and double-click
the file
SnfsSetup32.exe (32-bit systems) or SnfsSetup64.exe (64-bit
systems).
The StorNext Installation window appears (figure 16).
5 Under Import, click Browse. Locate the client configuration (*.reg) file
to import, and then click
Open.
Client configuration files saved during removal of a previous version
of StorNext are located in one the following directories:
•C:\SNFS\config\
•C:\Program Files\StorNext\confi g\
6 Click an option for handling current configuration settings:
•Merge with current configuration: The imported configuration is
merged with the current configuration settings.
•Replace current configuration: The imported configuration
overwrites the current configuration settings.
7 Click Import, and then click Yes to confirm.
A message appears informing you the configuration settings were
successfully added to the registry.
8 Click OK, and then click Quit to close the Import/Export Client
Configuration
StorNext 3.5 Installation Guide35
window.
Chapter 3
3Installing the StorNext Client
This chapter describes how to install the StorNext client software. The
StorNext client software lets you mount and work with StorNext file
systems.
To ensure successful operation, make sure the client system meets all
operating system and hardware requirements (see
Requirements).
To install the StorNext client software, first download the client software
from the metadata controller (MDC) (see
Client Software on page 39).
After downloading the client software, install and configure it using the
appropriate method for your operating system (see
StorNext Client on Linux or Unix on page 42 or Installing the StorNext
Client on Windows on page 49).
Downloading the StorNext
Client System
Installing the
Note:Before installing the StorNext client software, you must install
and configure StorNext on an MDC. For more information, see
Chapter 1, “Installing StorNext File System and Storage
Manager” or Chapter 2, “Installing StorNext File System.”
StorNext 3.5 Installation Guide36
Client System Requirements
To run the StorNext client software, the client system must meet all
operating system and hardware requirements.
Chapter 3 Installing the StorNext Client
Client System Requirements
Operating System
Requirements3
Table 11 StorNext Client
Supported Platforms
The operating systems, releases and kernels, and hardware platforms
supported by the StorNext client software are presented in
Make sure the client system uses a supported operating system and
platform, and if necessary update to a supported release or kernel version
before installing StorNext.
Operating SystemRelease or KernelPlatform
Windows XPSP3x86 32-bit
Windows 2003 ServerSP2x86 32-bit
Windows VistaSP1x86 32-bit
Windows 2008 Server—x86 32-bit
Red Hat Enterprise
Linux 4
Red Hat Enterprise
Linux 5
2.6.9-67.EL (Update 6)
2.6.9-78.EL (Update 7)
2.6.18-53.EL (Update 1)
2.6.18-92.EL (Update 2)
Table 11.
x86 64-bit
x86 64-bit
x86 64-bit
x86 64-bit
x86 64-bit
x86 64-bit
SUSE Linux Enterprise
Server 10
Sun Solaris 105.10SPARC 64-bit
HP-UX11i v2IA-64
StorNext 3.5 Installation Guide37
2.6.16-46-0.12 (SP1)
2.6.16-60-0.27 (SP2)
x86 64-bit
x86 64-bit
Chapter 3 Installing the StorNext Client
Client System Requirements
Operating SystemRelease or KernelPlatform
IBM AIX5.364-bit Power
Architecture
Hardware Requirements3
StorNext File System
Client Buffer Cache3
To install and run the StorNext client software, the client system must
meet the following minimum hardware requirements.
For SAN (FC-attached) clients or for distributed LAN clients:
•1 GB RAM
• 500 MB available hard disk space
For SAN clients acting as a distributed LAN server:
•2 GB RAM
• 500 MB available hard disk space
Note:Distributed LAN servers may require additional RAM
depending on the number of file systems, distributed LAN
clients, and NICs used. See
Distributed LAN Server Memory
Tuning in the StorNext User’s Guide for Distributed LAN
Server memory tuning guidelines.
As of StorNext 3.0, multiple mounted file systems typically share a single
buffer cache. A StorNext client buffer cache is created for each different
cachebufsize. By default, all file systems have the same cachebufsize of
64K, so they all share the same buffer cache.
Note:These settings do not apply to Apple Xsan clients, which do
not use the StorNext buffer cache.
The amount of memory consumed by default for each cachebufsize
depends on the platform type and the amount of memory in the system.
Table 12 shows the default amount of memory consumed by cachebufsize.
StorNext 3.5 Installation Guide38
Table 12 Default
Memory Consumed by
cachebufsize
Chapter 3 Installing the StorNext Client
Downloading the StorNext Client Software
Platform Type<=2GB Memory>2GB Memory
32-bit Windows32MB64MB
32-bit Linux64MB128MB
All other platforms64MB256MB
To see information about the buffer cache after mounting file systems,
use the
memory used by the buffer cache at mount time, use the
cvdb(1) command with the -b option. To change the amount of
buffercachecap
parameter.
On Windows, the non-paged pool is used for buffer cache memory until
it consumes up to 64 megabytes (32-bit systems) or 64 gigabytes (64-bit
systems). Any additional buffer cache memory comes from the paged
pool.
Downloading the StorNext Client Software
The StorNext client software can be downloaded from a metadata
controller. (To download the client software, the client system must have
network access to the MDC.)
Note:You can download the client software only from MDCs
running Linux or Unix.
1 On the client system, point a web browser to the URL (host name and
port number) of the MDC. For example,
Use one of the following web browsers to access the MDC (make sure
pop-up blockers are turned off):
•Internet Explorer 6.0 or later (including 7.0)
•Mozilla Firefox 1.5 or later (including 2.0 or later)
StorNext 3.5 Installation Guide39
http://servername:81
Figure 19 Select Platform
Window
Chapter 3 Installing the StorNext Client
Downloading the StorNext Client Software
2 When prompted, type the username and password for the MDC, and
then click
admin.)
OK. (The default value for both username and password is
The StorNext home page appears.
3 Do one of the following:
•For a MDC running SNFS and SNSM: On the Admin menu, click
Download Client Software.
•For a MDC running SNFS only: On the home page, click
Download Client Software.
The Select Platform window appears (figure 19).
4 In the list, click the operating system running on the client system,
and then click
Next.
The Download Client Software window appears (figure 20).
StorNext 3.5 Installation Guide40
Figure 20 Download Client
Software Window
Chapter 3 Installing the StorNext Client
Downloading the StorNext Client Software
5 Click the download link that corresponds to your operating system
version and hardware platform. (Depending on the operating
system, you may have only one choice.)
For example, for Red Hat Linux 4 running on an x86 64-bit platform,
click
Linux Redhat AS 4.0 (Intel 64bit).
6 When prompted, click Save or OK to download the file to the client
system.
Make sure to note the file name and the location where you save the
file.
7 After the download is complete, click Cancel to close the Download
Client Software
window.
Do not follow the onscreen installation instructions. Instead, continue
with the correct procedure for your operating system:
•Installing the StorNext Client on Linux or Unix on page 42
•Installing the StorNext Client on Windows on page 49.
StorNext 3.5 Installation Guide41
Chapter 3 Installing the StorNext Client
Installing the StorNext Client on Linux or Unix
Installing the StorNext Client on Linux or Unix
After downloading the StorNext client software from the metadata
controller, install it on the client system using the correct procedure for
your operating system:
• Installing the StorNext Client on Linux on page 42
• Installing the StorNext Client on Sun Solaris on page 44
• Installing the StorNext Client on HP-UX on page 46
• Installing the StorNext Client on IBM AIX on page 47
Installing the StorNext
Client on Linux3
To run the StorNext client software on Red Hat Linux or SUSE Linux
Enterprise, first install the client software package, and then configure the
client.
Caution:Before installing the StorNext client software, you must
install the kernel source code. You can install the kernel
source code by using the installation disks for your
operating system.
1 Log on to the client system as root.
2 Change to the directory where the client software archive file you
downloaded from the MDC is located.
3 Extract the software archive file. At the command prompt, type:
tar xf <archive name>
where <archive name> is the name of the software archive file you
downloaded from the MDC.
4 List the packages extracted from the software archive file. At the
command prompt, type:
ls -l
Identify the correct package to install. The correct package begins
with
snfs-client and ends with the .rpm file name extension.
StorNext 3.5 Installation Guide42
Chapter 3 Installing the StorNext Client
Installing the StorNext Client on Linux or Unix
Note:The file that ends with .rpm.md5sum is a checksum file, not
the client software package.
5 Install the client software package. At the command prompt, type:
rpm -ivh <package name>
where <package name> is the name of the client software package you
identified in
step 4.
6 Configure the boot order for system services. Do one of the following:
•For Red Hat Linux, at the command prompt, type:
chkconfig --level 3456 cvfs on
•For SUSE Linux Enterprise, at the command prompt, type:
chkconfig -s raw 235
chkconfig -s cvfs 345
7 Edit the /usr/cvfs/config/fsnameservers text file to contain the IP
address of the MDC the client will connect to.
The fsnameservers file on the client must be exactly the same as on
the MDC. If the
fsnameservers file does not exist, use a text editor to
create it.
Note:The fsnameservers file only needs to contain the name of
the MDC. For example, if the MDC is named
the
fsnameservers file should contain a single line with a
single word:
snserver
snserver, then
8 Create a mount point for the file system. At the command prompt,
type:
mkdir -p <mount point>
chmod 777 <mount point>
where <mount point> is the directory path where you want the file
system to be mounted. For example:
/stornext/snfs1
StorNext 3.5 Installation Guide43
Chapter 3 Installing the StorNext Client
Installing the StorNext Client on Linux or Unix
9 Configure the file system to automatically mount after reboot. To do
this, edit the
<file system> <mount point> cvfs verbose=yes 0 0
/etc/fstab file so that it contains the following line:
where <file system> is the name of the StorNext file system and <mount
point>
is the directory path created in step 8.
10 Reboot the client system.
After reboot, the StorNext file system is mounted at the mount point
you specified.
Note:To manually mount a file system, at the command prompt,
type:
mount -t cvfs <file system> <mount point>
where <file system> is the name of the StorNext file system and
<mount point> is the directory path where you want the file
system to be mounted.
Installing the StorNext
Client on Sun Solaris3
To run the StorNext client software on Sun Solaris, first install the client
software package, and then configure the client.
1 Log on to the client system as root.
2 Change to the directory where the client software archive file you
downloaded from the MDC is located.
3 Extract the software archive file. At the command prompt, type:
tar xf <archive name>
where <archive name> is the name of the software archive file you
downloaded from the MDC.
4 Install the client software package. At the command prompt, type:
pkgadd -d .
5 Type 1 to select the ADICsnfs package.
6 Type y to confirm installation of the ADICsnfs package. When
installation is complete, type
StorNext 3.5 Installation Guide44
q to quit the installation program.
Chapter 3 Installing the StorNext Client
Installing the StorNext Client on Linux or Unix
7 Edit the /usr/cvfs/config/fsnameservers text file to contain the IP
address of the MDC the client will connect to.
The fsnameservers file on the client must be exactly the same as on
the MDC. If the
fsnameservers file does not exist, use a text editor to
create it.
Note:The fsnameservers file only needs to contain the name of
the MDC. For example, if the MDC is named
the
fsnameservers file should contain a single line with a
single word:
snserver
snserver, then
8 Create a mount point for the file system. At the command prompt,
type:
mkdir -p <mount point>
chmod 777 <mount point>
where <mount point> is the directory path where you want the file
system to be mounted. For example:
/stornext/snfs1
9 Configure the file system to automatically mount after reboot. To do
this, edit the
/etc/vfstab file so that it contains the following line:
<file system> - <mount point> cvfs 0 auto rw
where <file system> is the name of the StorNext file system and <mount
point>
is the directory path created in step 8.
10 Reboot the client system.
After reboot, the StorNext file system is mounted at the mount point
you specified.
Note:To manually mount a file system, at the command prompt
type:
mount -F cvfs <file system> <mount point>
where <file system> is the name of the StorNext file system and
<mount point> is the directory path where you want the file
system to be mounted.
StorNext 3.5 Installation Guide45
Chapter 3 Installing the StorNext Client
Installing the StorNext Client on Linux or Unix
Installing the StorNext
Client on HP-UX3
To run the StorNext client software on HP-UX, first install the client
software package, and then configure the client.
1 Log on to the client system as root.
2 Change to the directory where the client software archive file you
downloaded from the MDC is located.
3 Extract the software archive file. At the command prompt, type:
tar xf <archive name>
where <archive name> is the name of the software archive file you
downloaded from the MDC.
4 List the packages extracted from the software archive file. At the
command prompt, type:
ls -l
Identify the correct package to install. The correct package begins
with
snfs-client and ends with the .depot file name extension.
5 Install the client software package. At the command prompt, type:
swinstall -s <package path and name> -x mount_all_filesystems=false \*
where <package path and name> is the full path and name of the client
software package you identified in
step 4.
6 Edit the /usr/cvfs/config/fsnameservers text file to contain the IP
address of the MDC the client will connect to.
The fsnameservers file on the client must be exactly the same as on
the MDC. If the
fsnameservers file does not exist, use a text editor to
create it.
Note:The fsnameservers file only needs to contain the name of
the MDC. For example, if the MDC is named
the
fsnameservers file should contain a single line with a
single word:
StorNext 3.5 Installation Guide46
snserver
snserver, then
Chapter 3 Installing the StorNext Client
Installing the StorNext Client on Linux or Unix
7 Create a mount point for the file system. At the command prompt,
type:
mkdir -p <mount point>
chmod 777 <mount point>
where <mount point> is the directory path where you want the file
system to be mounted. For example:
/stornext/snfs1
8 Configure the file system to automatically mount after reboot. To do
/etc/fstab file so that it contains the following line:
where <mount point> is the directory path created in step 7 and <file
system> is the name of the StorNext file system.
9 Reboot the client system.
After reboot, the StorNext file system is mounted at the mount point
you specified.
Note:To manually mount a file system, at the command prompt,
type:
mount -F cvfs <mount point> <mount point>
where <mount point> is the directory path where you want the
file system to be mounted.
Installing the StorNext
Client on IBM AIX3
To run the StorNext client software on IBM AIX, first install the client
software package, and then configure the client.
1 Log on to the client system as root.
2 Change to the directory where the client software archive file you
downloaded from the MDC is located.
3 Extract the software archive file. At the command prompt, type:
tar xf <archive name>
where <archive name> is the name of the software archive file you
downloaded from the MDC.
StorNext 3.5 Installation Guide47
Chapter 3 Installing the StorNext Client
Installing the StorNext Client on Linux or Unix
4 List the packages extracted from the software archive file. At the
command prompt, type:
ls -l
Identify the correct package to install. The correct package begins
with
snfs and ends with the .bff file name extension.
5 Install the client software package. At the command prompt, type:
installp -ac -d <package name> all .
where <package name> is the name of the client software package you
identified in
step 4.
6 Edit the /usr/cvfs/config/fsnameservers text file to contain the IP
address of the MDC the client will connect to.
The fsnameservers file on the client must be exactly the same as on
the MDC. If the
fsnameservers file does not exist, use a text editor to
create it.
Note:The fsnameservers file only needs to contain the name of
the MDC. For example, if the MDC is named
the
fsnameservers file should contain a single line with a
single word:
snserver
snserver, then
7 Create a mount point for the file system. At the command prompt,
type:
mkdir -p <mount point>
chmod 777 <mount point>
where <mount point> is the directory path where you want the file
system to be mounted. For example:
/stornext/snfs1
8 Configure the file system to automatically mount. At the command
prompt, type:
crfs -v cvfs -d <file system> -a verbose=yes -a type=cvfs -A yes -m <mount
point>
where <file system> is the name of the StorNext file system and <mount
point>
is the directory path created in step 7.
The StorNext file system is mounted at the mount point you
specified.
StorNext 3.5 Installation Guide48
Chapter 3 Installing the StorNext Client
Installing the StorNext Client on Windows
Note:To manually mount a file system, at the command prompt,
type:
mount <mount point>
where <mount point> is the directory path where you want the
file system to be mounted.
Installing the StorNext Client on Windows
The StorNext setup wizard guides you through the process of installing
the StorNext client software on Windows XP, Windows 2003 Server, or
Windows Vista.
Before installing StorNext, remove any previously installed versions (see
Removing a Previous Version of StorNext on page 49).
When you are ready, use the setup wizard to install StorNext (see
Running the Setup Wizard on page 50).
(Optional) After installation, restore the previous client configuration (see
Restoring a Previous Client Configuration on page 54).
Note:You must log on as an Administrator to install StorNext.
If you are installing on Windows Vista, answer Yes to any
messages asking if you want to run the installation process
with administrative privileges.
Removing a Previous
Version of StorNext3
StorNext 3.5 Installation Guide49
If a previous version of StorNext exists on the system, you must remove it
before installing the new version.
1 Unzip the client software archive file you downloaded from the
MDC.
2 Open the unzipped folder and double-click the client software
The StorNext Installation window appears (figure 21).
3 Click Remove StorNext.
A dialog box appears informing you that the current client
configuration has been saved.
4 Note the name and location of the saved configuration file, and then
click
OK.
5 If prompted, click Yes to continue, and then click OK to finish the
removal.
6 When the removal is complete, click Yes to reboot the system.
Note:After installing the new version of StorNext, you can restore
the saved client configuration (see
Restoring a Previous Client
Configuration on page 54).
Running the Setup
Wizard3
To launch the setup wizard, use the correct StorNext installation CD for
your operating system, or use the client software installer you
downloaded from the MDC.
1 If necessary, unzip the client software archive file you downloaded
2 Open the unzipped folder and double-click the client software
installer file. This file is named
SnfsSetup64.exe (64-bit systems).
SnfsSetup32.exe (32-bit systems) or
The StorNext Installation window appears (figure 22).
3 Click Install StorNext to begin installation.
The StorNext setup wizard appears (figure 23).
Figure 23 SNFS Setup:
Welcome
4 Click Next to continue.
StorNext 3.5 Installation Guide51
Figure 24 SNFS Setup: EndUser License Agreement
Chapter 3 Installing the StorNext Client
Installing the StorNext Client on Windows
The License Agreement window appears (figure 24).
5 Click the option to accept the license agreement, and then click Next
to continue.
The Customer Information window appears (figure 25).
Figure 25 SNFS Setup:
Customer Information
6 Type your name and the name of your company or organization in
the boxes, and then click
Next to continue.
The Choose Setup Type window appears, (figure 26).
StorNext 3.5 Installation Guide52
Figure 26 SNFS Setup:
Choose Setup Type
Chapter 3 Installing the StorNext Client
Installing the StorNext Client on Windows
7 Click an installation option:
•Typical: (Recommended) Installs the StorNext client software and
help files in the default location (
C:\Program Files\StorNext).
•Custom: Lets you choose which components to install and specify
an installation location. When ready, click
Next.
•Complete: Same as a typical installation.
The Ready to Install window appears (figure 27).
Figure 27 SNFS Setup: Ready
to Install
StorNext 3.5 Installation Guide53
Figure 28 SNFS Setup: Finish
Chapter 3 Installing the StorNext Client
Installing the StorNext Client on Windows
8 Click Install to continue.
Wait while the setup wizard installs StorNext. When installation is
complete, the
Finish window appears (figure 28).
9 Click Finish to close the setup wizard.
10 On the StorNext Installation window, click Exit.
You are prompted to reboot the system.
11 Click Yes to reboot.
You can now configure StorNext File System. For more information, see
Chapter 4, “Configuring StorNext.”
Restoring a Previous
Client Configuration3
If you saved a client configuration file (for example, when removing a
previous version of StorNext), you can import it after installing StorNext.
This configures StorNext using the same settings as the previous
installation.
1 If necessary, unzip the client software archive file you downloaded
from the MDC.
2 Open the unzipped folder and double-click the client software
installer file. This file is named
SnfsSetup64.exe (64-bit systems).
SnfsSetup32.exe (32-bit systems) or
The StorNext Installation window appears (figure 29).
5 Under Import, click Browse. Locate the client configuration (*.reg) file
to import, and then click
Open.
Client configuration files saved during removal of a previous version
of StorNext are located in one the following directories:
•C:\SNFS\config\
•C:\Program Files\StorNext\confi g\
6 Click an option for handling current configuration settings:
•Merge with current configuration: The imported configuration is
merged with the current configuration settings.
•Replace current configuration: The imported configuration
overwrites the current configuration settings.
7 Click Import, and then click Yes to confirm.
A message appears informing you the configuration settings were
successfully added to the registry.
8 Click OK, and then click Quit to close the Import/Export Client
Configuration
StorNext 3.5 Installation Guide56
window.
Chapter 4
4Configuring StorNext
This chapter describes how to configure StorNext after installation. To
configure StorNext, enter license information and create one or more file
systems. In addition, on metadata controllers (MDCs) running StorNext
Storage Manager, you can add storage devices and media, create storage
policies, and set up e-mail notifications. In addition, Linux or Windows
SAN clients can be configured as a distributed LAN client or a distributed
LAN server.
For system running Unix or Linux, use the web-based GUI (graphical
user interface) to access StorNext running on an MDC (see
GUI).
The first time you log on to StorNext, the Configuration Wizard appears.
The wizard guides you through the process of setting up StorNext (see
Configuration Wizard on page 60).
StorNext
To configure a StorNext client as a distributed LAN client or server, edit
the distributed LAN configuration file (see
LAN Client Server on page 65).
For systems running Windows, use the Windows-based configuration
utilities to set up server and client features (see
Utilities on page 70).
StorNext 3.5 Installation Guide57
Configuring a Distributed
Windows Configuration
StorNext GUI
Chapter 4 Configuring StorNext
StorNext GUI
The StorNext GUI provides access to StorNext features and displays
system status information. Use the StorNext GUI to create and work with
file systems. In addition, on metadata controllers running Storage
Manager, you can use the StorNext GUI to configure storage devices and
media, and to set up storage policies.
Note:The StorNext GUI is available only for MDCs running on Unix
or Linux. For MDCs running on Windows, use the
configuration utilities to configure StorNext (see
Configuration Utilities on page 70).
Windows
Accessing the StorNext
GUI4
To log on to the StorNext GUI, use a web browser running on the MDC,
or on any system that has network access to the MDC.
1 Point a web browser to the URL of the MDC.
The URL consists of the host name or IP address of the MDC
followed by the port number at which StorNext can be reached. (The
default port number is
Use one of the following web browsers to access the MDC (make sure
pop-up blockers are turned off):
•Internet Explorer 6.0 or later (including 7.0)
•Mozilla Firefox 1.5 or later (including 2.0 or later)
2 When prompted, type the user name and password for the MDC, and
click
OK. (The default value for both user name and password is
admin.)
The StorNext home page appears. The appearance of the home page
differs depending on if both Storage Manager and File System are
installed on the MDC, or if File System only is installed.
The StorNext home page for an MDC running File System and
Storage Manager is shown in
an MDC running File System only is shown in figure 33.
81.) For example: http://servername:81
figure 32. The StorNext home page for
StorNext 3.5 Installation Guide58
Figure 32 StorNext Home
Page: File System and Storage
Manager
Figure 33 StorNext Home
Page: File System Only
Chapter 4 Configuring StorNext
StorNext GUI
StorNext 3.5 Installation Guide59
Configuration Wizard
The first time you log onto the StorNext GUI, the Configuration Wizard
appears. The wizard guides you step-by-step through the process of
configuring StorNext.
The appearance of the wizard differs depending on if both Storage
Manager and File System are installed on the MDC, or if File System only
is installed.
The Configuration Wizard for an MDC running File System and Storage
Manager is shown in
running File System only is shown in figure 35.
Figure 35 StorNext
Configuration Wizard: File
System Only
Chapter 4 Configuring StorNext
Configuration Wizard
Displaying the
Configuration Wizard4
The Configuration Wizard appears each time you log on to StorNext until
all steps of the wizard are completed. You can also control the wizard
manually:
• To set the Configuration Wizard to not appear the next time you log
in, select the
Don’t Show CW Again check box.
• To display the Configuration Wizard at any time, on the Config
Using the Configuration
Wizard4
menu, click
The Configuration Wizard consists of eight steps. (If Storage Manager is
not installed on the MDC, only the first two steps appear.) The wizard
Configuration Wizard.
lets you navigate between steps and tracks your progress as you
complete each step.
• To go to the next step, click Next.
• To return to a previous step, click the step in the list.
• To start the wizard over from the beginning, click Reset.
• To exit the wizard, click Done.
StorNext 3.5 Installation Guide61
Chapter 4 Configuring StorNext
Configuration Wizard
The following sections describe each step of the Configuration Wizard.
Each step consists of a separate wizard that guides you through a task. To
complete a task, follow the onscreen instructions. To see more detailed
instructions for completing a task, refer to the indicated section in the
StorNext User’s Guide.
Note:Using the Configuration Wizard to configure StorNext is
optional. All configuration tasks can be accessed at any time
using the StorNext main menu, as described in the following
sections.
Step 1: Enter License4
The Enter License Wizard guides you through the steps of entering a
license string. A license string must be entered before you can configure
or use StorNext.
You can generate a temporary license that is valid for 30 days. To obtain a
permanent license, contact the Quantum Technical Assistance center at
licenses@quantum.com and provide the following information:
• The product serial number from the StorNext box or CD.
• The number of client machines connecting to the MDC.
• The StorNext Server ID number. (This number can be found on the
Enter License String window of the Enter License Wizard.)
To display the Enter License Wizard at any time, on the Config menu,
click
Enter License. For more information about entering a license, see
Chapter 4, “Common StorNext Tasks,” in the StorNext User’s Guide.
Step 2: Add File System4
The Add New File System Wizard guides you through the steps of
creating and configuring a new file system. The wizard also lets you
establish a mount point for the file system, specify disk block size, and
customize stripe groups.
A file system is a shared data pool that can be accessed by client systems
and applications. Each file system contains one or more stripe groups. (A
stripe group is a logical volume that consists of one or more disks.)
StorNext 3.5 Installation Guide62
Chapter 4 Configuring StorNext
Configuration Wizard
To display the Add New File System Wizard at any time, on the Config
menu, click
Add File System. For more information about adding file
systems, see Chapter 6, “Managing the File System,” in the StorNext
User’s Guide.
Step 3: Add Library4
The Add Library wizard guides you through the steps of adding and
configuring a tape library or vault. The wizard lets you specify the type of
library (SCSI, ACSLS, DAS, or vault) and set the appropriate parameters
for that library type.
To display the Add Library Wizard at any time, on the Config menu, click
Add Library. For more information about adding libraries, see Chapter 7,
“Managing Libraries,” in the StorNext User’s Guide.
Step 4: Add Tape Drive4
The Add Drive Wizard guides you through the steps of adding and
configuring tape drives. The wizard lets you associate hardware devices
with libraries and, if necessary, map them to slots.
To display the Add Drive Wizard at any time, on the Config menu, click
Add Tape Drive. For more information about adding tape drives, see
Chapter 8, “Managing Drives and Disks,” in the StorNext User’s Guide.
Step 5: Add Media4
The Add Media Wizard guides you through the steps of adding media to
a configured library. The wizard lets you specify a media type and, for
vaults, specify media IDs. (Before adding media, make sure no tape
drives contain media.)
To display the Add Media Wizard at any time, on the Config menu, click
Add Media. For more information about adding media, see Chapter 9,
“Managing Media,” in the StorNext User’s Guide.
StorNext 3.5 Installation Guide63
Chapter 4 Configuring StorNext
Configuration Wizard
Step 6: Add Storage Disks4
The Add Storage Disk wizard guides you through the steps of adding
external storage disks to a managed system. The wizard lets you specify
which file systems to define as storage disks. Once defined, storage disks
can be used as a target media type when creating storage policies.
To display the Add Storage Disk Wizard at any time, on the Config menu,
click
Add Storage Disk. For more information about adding storage disks,
see Chapter 10, “Managing Storage Disks,” in the StorNext User’s Guide.
Step 7: Add Storage Policy4
The Add New Storage Policy Wizard guides you through the steps of
adding disk-to-disk policy classes to a managed system. Storage policies
allow data to be intelligently moved between disks (stripe groups)
without affecting the file name space.
To display the Add New Storage Policy Wizard at any time, on the Config
menu, click
Add Storage Policy. For more information about adding
storage policies, see Chapter 11, “Data Migration Management,” in the
StorNext User’s Guide.
Step 8: E-Mail Notification4
The E-mail Notification Wizard guides you through the steps of setting
up e-mail notifications on the MDC. The wizard lets you specify the
SMTP server to use for outgoing e-mail, and the addresses to which
system alerts and notifications are sent. (Make sure the SMTP server is
configured before setting up e-mail notifications.)
To display the E-mail Notification Wizard at any time, on the Config
menu, click
E-Mail Notification. For more information about setting up
e-mail notifications disks, see Chapter 4 “Common StorNext Tasks,” in
the StorNext User’s Guide.
StorNext 3.5 Installation Guide64
Configuring a Distributed LAN Client Server
Configuring a Distributed LAN Client Server
Traditional StorNext SAN clients access data disks using a high
throughput, low-latency fibre channel connection. In addition, using the
distributed LAN client and server feature, StorNext clients can access
data disks over a network instead of directly accessing disks.
A StorNext client running on Linux or Windows can be configured as a
distributed LAN client or a distributed LAN server. (This is a licensed
feature.)
• Distributed LAN Server: A distributed LAN server has direct access to
data disks (using fibre channel) and makes the shared storage pool
available to distributed LAN clients over a network.
• Distributed LAN Client: A distributed LAN client does not have direct
access to data disks and instead accesses the shared storage pool by
connecting to a distributed LAN server over a network. (Distributed
LAN clients have full StorNext client functionality.)
Chapter 4 Configuring StorNext
Note:A StorNext client configured as a distributed LAN server
requires a dedicated system. Do not run other applications or
services on a system configured as a distributed LAN server.
To configure a Linux client as a distributed LAN client, see Configuring a
Distributed LAN Client on Linux. To configure a Linux client as a
distributed LAN server, see Configuring a Distributed LAN Server on
Linux.
To configure a Windows client as a distributed LAN server or a
distributed LAN client, use the Windows Client Configuration utility. For
more information, see
LAN on page 73.
StorNext 3.5 Installation Guide65
Client Configuration on page 71 and Distributed
Chapter 4 Configuring StorNext
Configuring a Distributed LAN Client Server
Configuring a Distributed
LAN Client on Linux4
Configuring a Distributed
LAN Server on Linux4
To configure a StorNext client as a distributed LAN client, edit mount
options in the
/etc/fstab file.
1 Stop the StorNext client. At the command prompt, type:
/etc/init.d/cvfs stop
2 Configure the client to mount a file system as a distributed LAN
where <file system> is the name of the StorNext file system and <mount
point>
is the directory path where the file system is mounted.
3 Change to the /usr/cvfs/bin/ directory.
4 Launch the StorNext distributed LAN server configuration utility. At
the command prompt, type:
./sndpscfg -e
Note:To get help for the sndpscfg utility, at the command
prompt, type:
./sndpscfig -h
The distributed LAN server configuration utility appears (figure 36).
StorNext 3.5 Installation Guide66
Figure 36 sndpscfg
Configuration Utility
Chapter 4 Configuring StorNext
Configuring a Distributed LAN Client Server
5 Edit the default distributed LAN server configuration:
• (Required) Uncomment (delete the # next to) the line that
corresponds to the network interface used by the distributed LAN
server when connecting to distributed LAN clients. (For best
performance, do not choose the network used for metadata.)
• (Optional) To change a tunable parameter from the default value,
uncomment the parameter, and then specify a new value.
Table 13
describes the tunable parameters.
Note:The distributed LAN server configuration utility uses the
default text editor. If a default text editor has not been
specified, the utility uses the
vi editor.
StorNext 3.5 Installation Guide67
Chapter 4 Configuring StorNext
Configuring a Distributed LAN Client Server
Table 13 Distributed LAN
Server Parameters
Field / ButtonDescription
tcp_window_size_kb
The TCP window size (in KB) used by the
distributed LAN server. (Default: 64)
transfer_buffer_size_kb
The transfer buffer size (in KB) used by the
distributed LAN server. A larger buffer may
increase performance for larger files.
(Default: 256)
transfer_buffer_count
The number of transfer buffers used by the
distributed LAN server. This parameter is
used only by Windows servers and clients.
Linux servers pass the value of this
parameter to Windows clients. (Default: 16)
server_buffer_count
The number of I/O buffers allocated for
each network interface on the distributed
LAN server. This parameter is used only by
Linux servers. (Default: 8)
daemon_threads
The maximum number of daemon threads
used by the distributed LAN server.
(Default: 8)
6 When you are done making edits, type :x to save and close the
configuration file.
The configuration is saved in the file dpserver in the /user/cvfs/config/
directory.
Note:To edit this file at a later date, you can run the sndpscfg
utility again or edit the
dpserver file directly.
7 Start the StorNext client. At the command prompt, type:
/etc/init.d/cvfs start
StorNext 3.5 Installation Guide68
Chapter 4 Configuring StorNext
Configuring a Distributed LAN Client Server
Creating an Override Configuration4
By default, the settings specified in the dpserver configuration file are
used for all file systems mounted by the distributed LAN server. To use
different settings for a file system, create an override configuration file for
that file system. At the command prompt, type:
./sndpscfg -E <file system>
where <file system> is the name of the file system to which the override
settings apply. Edit the configuration file, and then save and exit. A new
configuration file with the name
/user/cvfs/config/ directory.
dpserver.<file system> is created in the
Using Distributed LAN Client and Server Commands4
Use the cvadmin commands described in Table 14 to see information
about distributed LAN servers and clients. (For more information about
using
cvadmin commands, see the CLI Reference Guide.)
Table 14 Distributed LAN
Client and Server Commands
CommandDescription
proxy
Lists all distributed LAN servers for the
currently selected file system.
proxy long
Lists all distributed LAN servers for the
currently selected file system, as well as
tunable parameters and attached disks.
proxy who <distributed LAN
client>
Lists distributed LAN servers connected
to the specified distributed LAN client, as
well as current I/O statistics.
proxy who <distributed LAN
server>
Lists distributed LAN clients connected to
the specified distributed LAN server, as
well as current I/O statistics.
StorNext 3.5 Installation Guide69
Windows Configuration Utilities
To configure StorNext File System or the StorNext client software on
Windows operating systems, use the Windows configuration utilities.
The configuration utilities let you set up a Windows-based metadata
controller, configure a StorNext client, and work with StorNext file
systems.
To run a configuration utility, on the Windows Start menu, click All
Programs > StorNext File System
The StorNext client software includes the following configuration
utilities:
• Client Configuration on page 71
• Disk Device Labeler on page 83
• License Identifier on page 85
• Simple File System Configuration on page 85
Chapter 4 Configuring StorNext
Windows Configuration Utilities
, and then click the utility.
• Start File System Services on page 87
• Stop and Remove File System Services on page 87
• Stop File System Services on page 87
• Version Information on page 88
StorNext File System server includes all the configuration utilities
installed by the client software as well as the following additional
utilities:
• Check (Read-Only) a File System on page 88
• File System Startup List on page 88
• Re-initialize a File System on page 90
• Repair a File System on page 90
• Server Administration on page 90
• Server Configuration on page 96
StorNext 3.5 Installation Guide70
Chapter 4 Configuring StorNext
Windows Configuration Utilities
Client Configuration4
The Client Configuration utility lets you view and modify properties for
the StorNext client software. Use the utility to specify mount points and
mount options, set various cache settings, and configure a distributed
LAN server or a distributed LAN client.
To run the Client Configuration utility, on the Windows Start menu, click
All Programs > StorNext File System > Client Configuration.
The Client Configuration utility includes four tabs:
• Mount Point on page 71
• Distributed LAN on page 73
• Advanced Mount Options on page 75
• Advanced Cache Options on page 79
Click a tab to view or modify StorNext client properties. After making
changes on one or more tabs, click
appears prompting you to restart the system. Click
OK to save the changes. A message
Yes. Most changes do
not take affect until the system is restarted.
Mount Point4
StorNext file systems can be mapped to a drive letter or to a folder. When
mapping to a folder, the folder must be empty or non-existent, and must
exist within an NTFS file system (e.g., C:\Mount\MySnfs).
Use the Mount Point tab (figure 37) to specify drive mappings. Table 15
describes the fields on the Mount Point tab.
Note:Make sure the host list is the same for all clients on the SAN.
An incorrect or incomplete host list may prevent the client
from connecting to the file system.
StorNext 3.5 Installation Guide71
Figure 37 Client Configuration:
Mount Point
Chapter 4 Configuring StorNext
Windows Configuration Utilities
Table 15 Client Configuration:
Mount Point
Field / ButtonDescription
Map to Drive Letter
Select Map to Drive Letter to map the drive to
a specific drive letter.
Drive (Letter)
Map to Directory
Select the desired drive letter.
Instead of selecting Map to Drive Letter, select
Map to Directory. Enter a directory path, or
click Browse to navigate to the directory path.
Note:If this is a Distributed LAN client or server, be sure to enter the
parameters on the Distributed LAN tab.
StorNext 3.5 Installation Guide72
Chapter 4 Configuring StorNext
Windows Configuration Utilities
Distributed LAN4
The Distributed LAN tab is used to enable and configure StorNext
Distributed LAN (DLAN) Clients and Servers for a file system. The
Enable Client and Enable Server radio buttons determine whether the
system is a Client or Server. Note that separate licensing is required for
DLAN.
StorNext Distributed LAN Clients provide the same functionality as
normal StorNext Clients but do not need to be connected directly to the
SAN. They instead send I/O via the TCP/IP network to a Distributed
LAN Server; a normal SAN client with DLAN Server Selected in its
configuration. Metadata is sent over the TCP/IP network directly to the
File System Metadata Controller (Server/MDC).
Distributed LAN Clients request the location of normal DLAN Servers
via the Name Server.
• Distributed LAN Server: A distributed LAN server has direct access to
data disks (using fibre channel) and makes the shared storage pool
available to distributed LAN clients over a network.
• Distributed LAN Client: A distributed LAN client does not have direct
access to data disks and instead accesses the shared storage pool by
connecting to a distributed LAN server over a network. (Distributed
LAN clients have full StorNext client functionality.)
Note:A StorNext client configured as a distributed LAN server
requires a dedicated system. Do not run other applications or
services on a system configured as a distributed LAN server.
Use the Distributed LAN tab (figure 38) to configure a distributed LAN
server or a distributed LAN client. Table 16 describes the fields on the
Distributed LAN tab.
StorNext 3.5 Installation Guide73
Figure 38 Client Configuration:
Distributed LAN
Chapter 4 Configuring StorNext
Windows Configuration Utilities
Table 16 Client Configuration:
Distributed LAN
Field / ButtonDescription
Disable
Select this option to disable the StorNext client
as a distributed LAN client or distributed
LANserver.
Enable Client
Select to configure the StorNext client as a
distributed LAN client. The StorNext client
will connect to all available distributed LAN
servers.
(If you select this check box, all other fields on
the tab become unavailable.)
Enable Server
Select to configure the StorNext client as a
distributed LAN server. The StorNext client
will make the disks for this file system
available to distributed LAN clients over the
specified LAN.
StorNext 3.5 Installation Guide74
Field / ButtonDescription
Chapter 4 Configuring StorNext
Windows Configuration Utilities
Number of Transfer
Buffers
Read Timeout (sec)
Write Timeout (sec)
Transfer Buffer Size
(kb)
TCP Window Size (kb)
Max Threads
Server Interfaces
Specify the number of socket transfer buffers
used for Distributed LAN Client I/O.
Specify how long the Distributed LAN Client
will wait for a read operation to complete
before retrying it on a different Distributed
LAN Server.
Specify how long the Distributed LAN Client
will wait for a write operation to complete
before retrying it on a different Distributed
LAN Server.
Specify the size in kilobytes of the socket
transfer buffers used for Distributed LAN
Client I/O.
Specify the size in kilobytes of the TCP
window used for Distributed LAN Client I/O
connections.
Specify the number of kernel threads that will
be used to service Distributed LAN Client I/O
requests.
To complete Distributed LAN Server
configuration, select one or more network
interfaces to be used for Distributed LAN
Client traffic.
Advanced Mount Options4
The Mount Options tab (figure ) displays the mount options for the drive
currently selected on the Drive Mappings tab. Table 16 describes the fields
on the Distributed LAN tab.
Caution:Changing the values on the Mount Options tab can affect
system performance and stability. Do not change mount
options unless instructed to do so by the Quantum
Technical Assistance Center.
StorNext 3.5 Installation Guide75
Figure 39 Client Configuration:
Advanced Mount Options
Chapter 4 Configuring StorNext
Windows Configuration Utilities
Table 17 Client Configuration:
Advanced Mount Options
Field / ButtonDescription
Mount Retransmit
Limit
Specify the number of times the driver will retransmit a message to the FSM. After a
successful connection, this value is no longer
used.
The default is 1.
Hard Mount
When this box is checked, the driver attempts
to mount the file system forever.
The default is off (Soft Mount). Quantum
recommends that Hard Mount NOT be used
on Windows systems.
StorNext 3.5 Installation Guide76
Field / ButtonDescription
Chapter 4 Configuring StorNext
Windows Configuration Utilities
Allow Diskless Mount
Read Only
Restrict Pre-allocation
API
Number of Async I/O
Threads
Number of System
Threads
Message TImeout x 1/
10th Sec.
When this box is checked, the file system can
be mounted and accessed without all the
disks being accessible in the file system stripe
groups. In this mode, file metadata can be
viewed and changed, but no data can be
accessed.
The default is to not allow a file system to be
mounted unless all disks are accessible.
When this box is checked, the file system is
mounted in read-only mode. The default is off
or not checked.
When set to yes, non-administrator users are
unable to use the preallocation ioctl.
Specify the number of threads created to be
used as asynchronous I/O threads for user
applications. The default is 8. The allowed
range is 4 to 32.
Specify the number of threads created for use
by the file system. The default value is 16.
Specify (in tenths of a second) the amount of
time before a message to the FSM is timed out.
The default is 50 (five seconds).
Message Retry Count
Specify the number of attempts to be made for
sending a message to the File System Service.
The default is 12.
Retry I/Os Forever
or Allow I/O Timeouts
Choose either Retry I/Os Forever or Allow
I/O Timeouts, depending on whether you
want to allow timeouts or keep trying I/O.
The default value is to Retry I/Os Forever.
StorNext 3.5 Installation Guide77
Field / ButtonDescription
Chapter 4 Configuring StorNext
Windows Configuration Utilities
I/O Retry Time
Seconds
I/O Penalty TIme
Seconds
When you choose Allow I/O Timouts, this
option controls the I/O retry behavior. This
parameter establishes the amount of time that
may elapse during an I/O retry sequence.
An I/O retry sequence consists of the
following:
• Retry an I/O request across all available
paths that are currently present.
• Compare the current time to the
Instantiation time of the I/O request, if at
least <n> seconds have elapsed, return the
I/O request in error, otherwise reset the
paths used, and retry again.
This option controls the Multi-Path I/O
penalty value, where <n> is expressed in
seconds with a minimum value of 1 and a
maximum value of 15.
This parameter establishes the amount of time
a Path_In_Error will be bypassed in favor of
an Operational Path during a Multi-Path
selection sequence. If all paths are currently in
the Path_In_Error state, the first available
path will be selected, independent of the
Path_In_Error state.
The default value is 5 seconds.
Fast Failover
Detection
When this box is checked, the client uses a
more aggressive approach to detecting if the
FSM has failed. With this option on, the client
monitors the FSM heartbeat. If no heartbeat is
detected within three (3) seconds, a failover
request is initiated.
This option is desirable for near realtime
activities that cannot sustain more than 10
seconds of access loss to the server. Quantum
does not recommend enabling this option for
normal file system operations.
StorNext 3.5 Installation Guide78
Field / ButtonDescription
Chapter 4 Configuring StorNext
Windows Configuration Utilities
Hard Reconnect
Token Hold Seconds
When this box is checked, the file system
attempts to reconnect to the FSM forever. If
this option is not enabled, the file system
attempts to reconnect to the FSM for the
number of times specified at the Mount
Retransmit Limit field before failing the
request.
The default value is off.
The QOS Token Hold Time parameter is
applicable only when using the StorNext
Quality of Service (QOS) feature for real-time
IO.
This parameter determines the number of
seconds a client stripe group holds on to a
non-realtime I/O token during periods of
inactivity. If no I/O is performed on a stripe
group within the specified number of
seconds, the token is released back to the FSM.
The default value is 60 seconds. The
parameter should be specified in five-second
increments; if the parameter is not a multiple
of five, it will be rounded up automatically.
Advanced Cache Options4
The Data Buffer Cache keeps the file system data in memory on the local
computer to speed up performance for small I/O operations.
The Advanced Cache Options tab (figure 40) displays performance values
that control how many file system lookup names are kept in memory.
Caution:Changing the values on the Advanced Cache Options tab
can affect system performance and stability. Do not change
cache parameters unless instructed to do so by the
Quantum Technical Assistance Center.
When this box is not checked, the file system
will not buffer any data. All files will be read
directly into the application's memory using
DMA. Requests that are not properly aligned
will be read into temporary buffers, then
copied to the application's buffer.
If Buffer Cache is disabled, the remaining
Data Buffer Cache options are ignored.
StorNext 3.5 Installation Guide80
Field / ButtonDescription
Chapter 4 Configuring StorNext
Windows Configuration Utilities
Individual Buffer Size
Minimum Total Cache
Size
Auto-DMA Read/Write
Sizes
This option sets the size of each cache buffer.
This determines the I/O transfer size used for
the buffer cache. For optimal performance,
Individual Buffer Size should match the RAID
stripe size. If Individual Buffer Size is less
than the RAID stripe size write performance
may be severely degraded.
This size must be divisible by the file system
block size. The maximum value allowed is
512K and the minimum value allowed is the
file system block size. The value default is
64K.
This value controls the amount of memory
used to cache data from the file system. This
parameter is shared by all file systems with
the same block size.
Buffer Cache Auto DMA Read Length and
Buffer Cache Auto DMA Write Length control
the minimum I/O size for DMA transfers.
That is, any smaller transfer will always go
through the buffer cache.
The default value is 1MB.
Number of Readahead Buffers
This option controls the size of the read-ahead
window used by the buffer cache.
The default value is 16 buffers with a
maximum of 100. Using a value of 0 disables
read-ahead.
Number of Threads
This option controls the number of dedicated
background threads used by the buffer cache
for performing I/O.
The default value is 8, with a minimum of 1
and a maximum of 100. Using a larger value
can increase I/O concurrency in the buffer
cache and therefore improve performance.
StorNext 3.5 Installation Guide81
Field / ButtonDescription
Chapter 4 Configuring StorNext
Windows Configuration Utilities
Seconds for Shared/
Non-Shared
Delay Atime Updates
The Attribute Flush Time parameters control
the length of time attributes are held on the
client before they are flushed back to the FSM
(unless there is an explicit attribute request
from the FSM).
The default values are 30 seconds for nonshared files (Attribute Flush Time, non
shared), and 2 seconds for shared files
(Attribute Flush Time, shared).
Setting these parameters lower will greatly
increase the amount of metadata traffic
between clients and the FSM. However, in
circumstances where files are frequently
shared on the SAN, setting the Attribute Flush
Time Shared can result in other clients seeing
size updates more frequently if a file is being
written on one client and read on another.
A value of zero is invalid, and will result in
using the default setting.
When this box is checked, the file system
delays Atime (access time) updates when
reading a file to the time when the file is
closed. This cuts down on FSM metadata
updates at the expense of coherency.
Low Water Mark
High Water Mark
Max. Entries
Purge Period
(Seconds)
Minimum Directory
Cache Size
Metadata Caches contain non-data
information such as file names, sizes, update
times, etc.
Tuning the low and high water marks and the
frequency of purge passes can help certain
large mix applications.
This option sets the size of the directory cache.
Directory entries are cached on the client to
reduce client-FSM communications during
directory reads.
The default value is 10 MB.
StorNext 3.5 Installation Guide82
Chapter 4 Configuring StorNext
Windows Configuration Utilities
Disk Device Labeler4
The Disk Device Labeler utility lets you configure StorNext File System
storage area network (SAN) disks. Use the Disk Device Labeler to create a
list of disk labels, associated device names, and (optional) the sectors to
use.
Note:Run the Disk Device Labeler on a system that has visibility to
all disk devices on the SAN.
The file system uses the volume labels to determine which disk drives to
use. The label name written to a disk device must match the disk name
specified in the Server Configuration utility. For more information, see
Server Configuration on page 96.
Caution:Modifying the label of a system disk may render the
system inoperable and require you to repair the volume.
Only label disk devices that are intended for use with the
StorNext File System SAN.
To run the Disk Device Labeler utility, on the Windows Start menu, click
All Programs > StorNext File System > Disk Device Labeler. The Disk
Labeler
window (figure 41) appears.
Figure 41 Disk Device Labeler
On the Disk Labeler window, do one of the following:
StorNext 3.5 Installation Guide83
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.