Document Title, 6-01658-13 Rev A, August 2010, Product of USA.
Quantum Corporation provides this publication “as is” without warranty of any kind, either express or
implied, including but not limited to the implied warranties of merchantability or fitness for a particular
purpose. Quantum Corporation may revise this publication from time to time without notice.
COPYRIGHT STATEMENT
Copyright 2010 by Quantum Corporation. All rights reserved.
Your right to copy this manual is limited by copyright law. Making copies or adaptations without prior
written authorization of Quantum Corporation is prohibited by law and constitutes a punishable
violation of the law.
TRADEMARK STATEMENT
Quantum, the Quantum logo, DLT, DLTtape, the DLTtape logo, Scalar, and StorNext are registered
trademarks of Quantum Corporation, registered in the U.S. and other countries.
Backup. Recovery. Archive. It’s What We Do., the DLT logo, DLTSage, DXi, DXi-Series, Dynamic
Powerdown, FastSense, FlexLink, GoVault, MediaShield, Optyon, Pocket-sized. Well-armored, SDLT,
SiteCare, SmartVerify, StorageCare, Super DLTtape, SuperLoader, and Vision are trademarks of Quantum.
LTO and Ultrium are trademarks of HP, IBM, and Quantum in the U.S. and other countries. All other
trademarks are the property of their respective companies.
Specifications are subject to change without notice.
StorNext is data management software that enables customers to
complete projects faster and confidently store more data at a lower
cost. Used in the world's most demanding environments, StorNext is the
standard for high performance shared workflow operations and
multitier archives. StorNext consists of two components: StorNext File
System (SNFS), a high performance data sharing software, and StorNext
Storage Manager (SNSM), the intelligent, policy-based data mover.
About StorNext File
System
Quantum StorNext User’s Guide1
StorNext File System streamlines processes and facilitates faster job
completion by enabling multiple business applications to work from a
single, consolidated data set. Using SNFS, applications running on
different operating systems (Windows, Linux, Solaris, HP-UX, AIX, and
Mac OS X) can simultaneously access and modify files on a common,
high-speed SAN storage pool.
This centralized storage solution eliminates slow LAN-based file
transfers between workstations and dramatically reduces delays caused
by single-server failures. In high availability (HA) configurations, a
redundant server is available to access files and pick up processing
requirements of a failed system, and carry on processing.
Chapter 1: Introduction
About StorNext Storage
Manager
About Distributed LAN
Clients
StorNext Storage Manager enhances the StorNext solution by
reducing the cost of long term data retention, without sacrificing
accessibility. SNSM sits on top of SNFS and utilizes intelligent data
movers to transparently locate data on multiple tiers of storage. This
enables customers to store more files at a lower cost, without having to
reconfigure applications to retrieve data from disparate locations.
Instead, applications continue to access files normally and SNSM
automatically handles data access – regardless of where the file resides.
As data movement occurs, SNSM also performs a variety of data
protection services to guarantee that data is safeguarded both on site
and off site.
StorNext supports
SAN client, a distributed LAN client does not connect directly to
StorNext via fibre channel or iSCSI, but rather across a LAN through a
gateway system called a
server is itself a directly connected StorNext client, but it processes
requests from distributed LAN clients in addition to running
applications.
Any number of distributed LAN clients can connect to multiple
distributed LAN servers. StorNext File System supports Distributed LAN
client environments in excess of 1000 clients.
distributed LAN clients
distributed LAN server
. Unlike a traditional StorNext
. The distributed LAN
Besides the obvious cost-savings benefit of using distributed LAN
clients, there will be performance improvements as well.
Distributed LAN clients must be licensed in the same way as StorNext
SAN clients. When you request your permanent StorNext license, you
will need to specify the number of distributed LAN clients you plan to
use. Naturally, you can always purchase additional distributed LAN client
licenses as your needs expand. For more information about StorNext
licensing, see
StorNext provides distributed LAN client information via the status
monitors on the StorNext home page. More detailed information is
available through the Clients Report and the Distributed LAN Client
Performance Report. For more information about StorNext reports, see
StorNext Reports on page 205.
Before you can fully use distributed LAN clients, you must first configure
a distributed LAN server and distributed LAN clients as described in the
StorNext Installation Guide
2Quantum StorNext User’s Guide
Step 2: Licenses on page 19
.
Chapter 1: Introduction
Purpose of This Guide
About LicensingBeginning with StorNext 4.0, licensing has changed significantly
compared to previous releases. Multiple licenses are now required for
various StorNext features, as well as to perform an upgrade to a new
release.
If you have not already installed StorNext 4.0 (or upgraded from a
previous release), be sure to read the procedure in the section
Licenses on page 19 before you proceed.
Step 2:
Purpose of This Guide
This guide is intended to assist StorNext users perform day-to-day tasks
with the software. This guide also describes how to generate reports.
Quantum recommends using the graphical user interface to accomplish
tasks, but an appendix provides alternative procedures for users who
wish to perform those tasks via the command line interface.
How This Guide is Organized
This guide contains the following chapters:
• Chapter 1, Introduction
• Chapter 2, StorNext GUI Overview
• Chapter 3, The Configuration Wizard
• Chapter 4, File System Tasks
• Chapter 5, Storage Manager Tasks
• Chapter 6, Replication and Deduplication
• Chapter 7, Tools Menu Functions
• Chapter 8, Service Menu Functions
• Chapter 9, Converting to HA
• Chapter 10, StorNext Reports
Quantum StorNext User’s Guide3
Chapter 1: Introduction
Notes, Cautions, and Warnings
• Chapter 11, Customer Assistance
• Appendix A, Operating Guidelines
• Appendix B, Replication and Deduplication
• Appendix C, High Availability Systems
• Appendix D, Web Services API
• Appendix E, Storage Manager Truncation
• Appendix F, Security
• Appendix G, Troubleshooting
• Appendix H, RAS Messages
Notes, Cautions, and Warnings
The following table describes important information about Notes,
Cautions, and Warnings used throughout this guide.
DescriptionDefinitionConsequences
Note:Indicates important
information that helps
you make better use of
the software.
Caution:Advises you to take or
avoid a specified action.
Warning:Advises you to take or
avoid a specified action.
4Quantum StorNext User’s Guide
No hazardous or
damaging
consequences.
Failure to take or avoid
this action could result
in loss of data.
Failure to take or avoid
this action could result
in physical harm to the
user or hardware.
Document Conventions
This guide uses the following document conventions to help you
recognize different types of information.
ConventionsExamples
Chapter 1: Introduction
Document Conventions
For all UNIX-based
commands, the # prompt is
implied, although it is not
shown.
For all UNIX-based
commands, words in
are variables and should be
replaced with user-defined
values.
italic
TSM_control stop
is the same as
# TSM_control stop
cvaffinity <filename>
where <filename> is a
variable and should be
replaced with a user-defined
value.
Quantum StorNext User’s Guide5
Chapter 1: Introduction
Document Conventions
6Quantum StorNext User’s Guide
Chapter 2
StorNext GUI Overview
This section describes how to access and navigate through the StorNext
GUI.
This chapter includes the following topics:
• Accessing the StorNext GUI
• The StorNext Home Page
Note: StorNext supports internationalization for the name space of
the file system. This support is fully UTF-8 compliant. It is up to
the individual client to set the proper UTF-8 locale.
Accessing the StorNext GUI
The StorNext GUI is browser-based and can be remotely accessed from
any machine with access to the StorNext server.
Use this procedure to access the StorNext GUI.
1 Open a Web browser.
Quantum StorNext User’s Guide7
Chapter 2: StorNext GUI Overview
Accessing the StorNext GUI
Note: The following browsers have been tested to work with
StorNext. Browsers not listed may work but are not
recommended.
• Internet Explorer 7.x and 8.x
•FireFox 3.x
To ensure proper browser operation, all monitors must be set to
display at a minimum resolution of 1024 x 768. If you use a
popup blocker, be sure to enable pop-ups in order to ensure
that StorNext displays properly.
2 In the browser’s Address field, type the full address of the machine
and its port number, and then press Enter. For example: http://<machine name>:<port number>. Use the name of the machine and
port number you copied when you installed the StorNext software.
Note: Typically, the port number is 81. If port 81 is in use, use the next
unused port number. (I.e., 82, 83, etc.)
Figure 1 StorNext Login
Window
After you enter the machine name and port number, the following
window appears:
3 In the User ID field, type admin.
4 In the Password field, type password.
5 Click Login. The initial StorNext System Control screen appears.
8Quantum StorNext User’s Guide
Figure 2 System Control
Chapter 2: StorNext GUI Overview
The StorNext Home Page
6 On this screen you can determine if the StorNext File System and
Storage Manager components are currently started. If not, click
Start for each component to start them.
7 Click the home (house) icon in the upper right corner to go to the
StorNext Home Page.
Note: When you log into StorNext for the first time, you might see a
message warning you about a security certificate. Refer to the
Quantum Knowledge Base for a permanent workaround to this
issue. For a temporary solution, create a certificate exception
that will allow you to log into StorNext without seeing the
warning message during subsequent logins.
The StorNext Home Page
On the home page you will find the following:
• Status and Capacity Monitors for file systems, libraries, storage
disks, and tape drives
Quantum StorNext User’s Guide9
Chapter 2: StorNext GUI Overview
The StorNext Home Page
Figure 3 StorNext Home Page
• Dropdown Menus: Setup, Tools, Service, Reports and Help
• Current status indicators for the file system and Storage Manager
• A link to the tickets page (if tickets exist)
• A link to admin alerts (if they exist)
• A link to the Library Operator Actions Required page if actions exist
• A link to blockpool status if the blockpool is in the process of
starting up
From any page you can return to the StorNext home page by clicking
the Home (house) icon in the upper right corner of the screen.
Beside the Home icon is a question mark icon. Clicking this icon displays
a list of StorNext online help topics.
Displayed in the upper right corner beneath the home and help icons is
the user name or IP address of the StorNext user currently logged in.
10Quantum StorNext User’s Guide
Chapter 2: StorNext GUI Overview
The StorNext Home Page
StorNext MonitorsThe StorNext Home Page displays the following status and capacity
monitors which are used to show the current state of the StorNext
system:
• File Systems Capacity Monitor
• Libraries Capacity Monitor
• Storage Disks Capacity Monitor
• Tap e D ri v e S t a tu s
• Policy Capacity Monitor
Use these monitors to view current statistics of managed or unmanaged
file systems and configured libraries and/or drives, including file system,
library, and drive information. Each of the status monitors provides an
at-a-glance view of the total number of components (file systems,
libraries, storage disks, or tape drives) and the current state of the file
system: green for normal, yellow for warning, and red for error.
The information shown in the monitors is refreshed periodically. You can
specify the refresh rate by choosing the desired interval from the
Refresh Rate list:
•No Refresh
• 30 seconds
• 1 minute
• 2 minutes
• 5 minutes
•10 minutes
File Systems Capacity Monitor
The File Systems Capacity Monitor provides the following information:
• Total space (in GB) for the file system
• A graphical representation of the free and used space amount
• The number of active StorNext SAN clients (connected via fibre
channel or iSCSI) for which you are licensed
• The number of StorNext distributed LAN clients for which you are
licensed. For more information about distributed LAN clients, see
About Distributed LAN Clients on page 2.
Quantum StorNext User’s Guide11
Chapter 2: StorNext GUI Overview
The StorNext Home Page
• The number of store candidates, which are files selected for storage
to secondary media.
• The number of files that have been stored and meet the criteria to
become a truncation candidate.
• Current status (Error, Warning or Normal)
Libraries Capacity Monitor
The Libraries Capacity Monitor provides the following information:
• Total space (in GB) for the library. (This amount is an approximation
if the library contains unformatted media.)
• A graphical representation of the library's free and used space
amount
• The number of mounted and unmounted media
• The number of used slots
• The total number of slots
• Current status (Error, Warning or Normal)
Storage Disks Capacity Monitor
The Storage Disks Capacity Monitor provides the following information:
• Total number of storage disks
• A graphical representation of the free and used space amount
• Current status (Error, Warning or Normal)
Tape Drive Status
The Tape Drive Status Monitor provides the following information:
• Total number of tape drives
• A graphical representation of the free and used space amount
• Current status (Error, Warning or Normal)
12Quantum StorNext User’s Guide
Chapter 2: StorNext GUI Overview
The StorNext Home Page
Policy Capacity Monitor
The Policy Capacity Monitor provides the following information:
• Total space (in GB) for policy
• A graphical representation of the free and used space amount
Note: NOTE: The home page status and capacity monitors are
intended to give you an approximate at-a-glance view of all
the file systems, libraries, storage disks etc. on your system.
For a detailed, more accurate summary of your system's
components, click inside one of the Status or Capacity boxes to
view all file system, libraries, storage disks, and so on. (For
example, click inside either the File Systems Status or Capacity
box to view all file systems.)
StorNext Home Page
Dropdown Menus
The dropdown menu options located in the bar at the top of every page
allow you to access StorNext setup, tools, service, and reporting
options.
The StorNext home page contains these drop-down menus and menu
options:
The Configuration Menu
Use these menu options to launch the Configuration Wizard or
complete individual configuration tasks.
• Configuration Wizard: Launches the StorNext Configuration
Wizard
• License: Enter StorNext license information
• Name Servers: Enter and set order for servers used for StorNext file
systems
• File Systems: Add a file system to your environment
• Storage Destinations: Add a library or storage disk, or set up data
replication and deduplication
• Storage Policies: Add a storage policy to a file system
Quantum StorNext User’s Guide13
Chapter 2: StorNext GUI Overview
The StorNext Home Page
• Email Server: Configure the email server to use for notifications
• Email Notifications: Configure email notifications for Service
Tickets, Admin Alerts, StorNext Backups, and Policy Class Alerts
The Tools Menu
Use these options to control day-to-day operations of StorNext.
• User Accounts: Control user access to StorNext tasks
• System Control: Stop or start the file system or StorNext Storage
Manager, and specify whether to automatically start StorNext at
system startup
• File and Directory Actions: Perform file-related and directoryrelated tasks such as storing and moving files, recovering and
retrieving files and directories, and modifying file attributes.
• File Systems
• Label Disks: Label disk drives
• Check File System: Run a check on your file system before
expanding the file system or migrating a stripe group.
• Affinities: Add affinities to the file system.
• Migrate Data: Migrate the file system's stripe group(s)
• Truncation Parameters: Manage the file system's truncation
parameters
• Storage Manager
• Storage Components: View current status for libraries, storage
disks, and tape drives; place one or more of these components
online or offline
• Drive Pools: Add, modify, or delete drive pools
• Media Actions: Remove media from a library or move media
from one library to another
• Library Operator Interface: Enter or eject media from the
Library Operator Interface
• Software Requests: View or cancel pending software requests
14Quantum StorNext User’s Guide
Chapter 2: StorNext GUI Overview
The StorNext Home Page
• Scheduler: Schedule file system events including Clean Info,
Clean Versions, Full Backup, Partial Backup, and Rebuild Policy
• Alternate Retrieval Location: Specify a remote retrieval
location to use in situations where files stored on tape or a
storage disk cannot be accessed.
• Distributed Data Mover: Distribute data movement operations
from the metadata controller to client machines.
• Replication/Deduplication
• Administration: View current progress for data replication,
data deduplication, and truncation operations
• Replication Targets: Add replication hosts and mount points to
your replication targets, and edit properties for existing hosts
and mount points
• Replication Bandwidth: Monitor bandwidth usage for ongoing
data replication processes
• High Availability
• Convert: Convert to a High Availability (HA) configuration
• Manage: Manage an HA configuration
The Service Menu
Use these options to monitor and capture system status information.
• Health Check: Perform one or more health checks on StorNext and
view recent health check results
• Capture State: Obtain and preserve detailed information about the
current StorNext system state
• System Backup: Run a backup of StorNext software
• Admin Alerts: View informational messages about system activities
• Tickets: View, edit, or close service tickets generated for the system
The Reports Menu
Use these options to view StorNext reports.
• Logs: Access logs of StorNext operations
Quantum StorNext User’s Guide15
Chapter 2: StorNext GUI Overview
The StorNext Home Page
• Jobs: View a list of pending and completed jobs on the system
• File Systems: View file system statistics including active clients,
space, size, disks, and stripe groups
•SAN Devices: View information about devices currently attached to
your SAN, including disks/LUNs, libraries, and tape drives
• LAN Client Performance: View information about distributed LAN
clients and servers, including read and write speed
• SAN and LAN Clients: View statistics for StorNext clients, including
the number of connected clients and distributed LAN clients, and
client performance
• Replication/Deduplication
• Policy Activity: View replication and deduplication performance
statistics
• Policy Summary: View replication and deduplication
information for each policy
• Distributed Data Mover: View activity related to the Distributed
Data Mover feature
The Help Menu
Use these options to access StorNext documentation, find Quantum
contact information, or detailed information about this version of
StorNext.
• Documentation: Access the StorNext documentation
• Support: Access Quantum Technical Support information
• About: Access detailed information about your version of
StorNext and the system on which it is running. Also shows
StorNext patent information.
16Quantum StorNext User’s Guide
Chapter 3
The Configuration Wizard
StorNext includes a Configuration Wizard that guides you through the
process of setting up your StorNext system. The wizard includes tasks
you would typically perform when you are first configuring your system.
The Configuration Wizard appears automatically when you launch
StorNext for the first time. As you complete tasks, click Next to proceed
to the next configuration task, or click Back to return to the previous
task. Some tasks allow you to skip the task for configuration at a later
time. These tasks have a Next/Skip button instead of a Next button.
You can display the Configuration Wizard at any time by selecting
Configuration Wizard from the StorNext Configuration menu. If you
have completed all of the tasks, each task will be marked as Complete. If
you have not completed all tasks, the ones you finished will be marked
Complete and the wizard will be ready for you to begin the next
uncompleted task.
You can perform any of the Configuration Wizard’s tasks separately
rather than through the wizard. Each of these tasks is selectable from
the StorNext Configuration menu.
Following are the setup and configuration tasks the Configuration
Wizard allows you to complete:
• Step 1: Welcome: View disks and libraries currently available for
StorNext usage
• Step 2: Licenses: Enter StorNext License Information
Quantum StorNext User’s Guide17
Chapter 3: The Configuration Wizard
Step 1: Welcome
• Step 3: Name Servers: Specify and order the machines acting as
StorNext name servers
• Step 4: File Systems: Add a StorNext file system
• Step 5: Storage Destinations: Add a library, storage disks, and other
storage destinations
• Step 6: Storage Policies: Add a Storage Manager or replication
storage policy
• Step 7: Email Server: Specify an email server to handle StorNext
notifications
• Step 9: Done: Signify that you are finished using the Configuration
Wizard. You can also convert to a high availability (HA) system.
This chapter provides an overview of the steps necessary to complete
each of the Configuration Wizard’s tasks.
Step 1: Welcome
The first screen in the Configuration Wizard is the Welcome screen. This
screen shows disks and libraries that are currently available for StorNext
usage. As you add new disks and libraries, the information on this
screen is updated.
If desired, you can manually update the screen by clicking Refresh.
When you are ready to proceed to the next step, click Next in the left
column.
Use the Enter License wizard to enter license strings for the StorNext
products you have purchased. You must have a license to configure or
use StorNext products or features.
If the license.dat file does not contain permanent licenses, StorNext
produces an auto-generated license with an expiration date for all
StorNext products and features except Deduplication. In some cases
Quantum may provide evaluation licenses for features. Evaluation
licenses also have a fixed expiration date.
Beyond the evaluation period, you must have a permanent license to
configure or use StorNext features.
Here is a list of StorNext licenses:
• File System: A File System license enables you to create and modify
StorNext-supported file systems.
• LAN Client: You must have a Distributed LAN Client license for each
LAN client you use with StorNext (in addition to any SAN clients).
Quantum StorNext User’s Guide19
Chapter 3: The Configuration Wizard
Step 2: Licenses
• Storage Manager: A Storage Manager license provides full access
to StorNext's Storage Manager features that are not licensed
separately.
• Replication: A Replication license is required if you want to use
StorNext's Data Replication feature.
• Deduplication: A Deduplication license is required if you want to
use StorNext’s Data Deduplication (blockpool) feature.
• Vaulting: A Vaulting license provides the ability to move seldomused media to a manual archive vault, freeing room for media in the
managed archives.
• Storage Disk: You must have a Storage Disk license to be able to
configure and use StorNext storage disks.
• Checksum: A Checksum license enables you to verify data integrity
by ensuring that the checksum created when data was stored
matches the checksum upon data retrieval.
• Distributed Data Mover (DDM): A license is required for using
DDM if you plan to use additional machines besides the primary
server to distribute data streams.
• Failover (HA): A Failover (High Availability) license is required if you
plan to use StorNext's HA failover features.
• Maintenance: A Maintenance license verifies that your site has
purchased StorNext upgrade licenses, and is required for StorNext
upgrades. It is also used at run time to verify the revision number in
the software matches what was purchased.
To obtain permanent product/feature licenses, you must contact the
Quantum Technical Assistance Center at
licenses@Quantum.com and
give them the following information:
• The serial number from your product CD or box.
• A list of the products/features you wish to license
• The number of StorNext SAN clients and distributed LAN clients you
want to support, as well as capacity.
• The StorNext server identification number. You can find this number
on the Configuration Wizard’s Configuration > Licenses screen.
After the Quantum Technical Assistance Center receives the above
information, a representative will send you license strings for the
products/features you specified. Enter these license strings on the
20Quantum StorNext User’s Guide
Chapter 3: The Configuration Wizard
Step 2: Licenses
Configuration > Licenses > Entry screen to begin using StorNext
features.
Note: You cannot mix auto-generated/evaluation and permanent
licenses. Once you enter one or more permanent licenses in
StorNext, all auto-generated/evaluation licenses are deleted. If
you are using an auto-generated or evaluation license period to
evaluate new features, be aware that you will lose any
remaining time on your temporary licenses as soon as you
enter one or more permanent license.
After you have entered permanent licenses, you should not
install an evaluation license.
There are two ways to access the Enter License wizard:
• Through the StorNext Configuration wizard
• By choosing Licenses from the Configuration menu
1 When the Configuration Wizard is displayed, choose Licenses on
the left side of the screen. (Alternatively, choose Licenses from the
Configuration menu.) The Configuration > Licenses >
Agreement screen appears. You must accept the license agreement
in order to continue with the licensing process.
Quantum StorNext User’s Guide21
Chapter 3: The Configuration Wizard
Step 2: Licenses
2 Read the license carefully, and then click Accept. The Configuration
> Licenses > Entry screen appears.
22Quantum StorNext User’s Guide
Figure 6 Configuration >
Licenses > Entry Screen
Chapter 3: The Configuration Wizard
Step 2: Licenses
3 To import license string information from a text file, click Import.
When the Import License File window appears, click Browse and
navigate to the file's location. Click Close to continue.
A message at the top of the screen informs you whether the
information was successfully imported and copied from the file into
the StorNext license file. The status indicator changes to enabled (a
green check mark icon and you are now ready to activate your
licenses.
4 To enter licenses individually, select the product/feature and then
click Enter/Update. At the [License/Feature Name] License field,
enter the license string you received from Quantum. Click Apply to
apply the string.
Quantum StorNext User’s Guide23
Chapter 3: The Configuration Wizard
Step 2: Licenses
Figure 7 Configuration >
Licenses > Entry Screen
A message at the top of the screen informs you whether the
information was successfully validated and copied into the StorNext
license file. The status indicator changes to enabled (a green check
mark icon) and you are now ready to activate your licenses.
License Expiration and
Limits
Each StorNext feature license has a license expiration date (shown in the
Expires column) and a limit shown in the Limit column.
Following is an explanation of the limit for each feature as it pertains to
licensing:
• File System: The number displayed is the maximum number of SAN
clients allowed
• LAN Clients: The number displayed is the maximum number of LAN
clients allowed
• Storage Manager: The number displayed is the licensed capacity
for files being managed by the SNSM software.
The current used capacity for the Storage Manager feature is
determined as follows: It is the sum of all managed files that have
been copied to Storage Manager media. This includes tape media
and also storage disk. (The capacity calculation does not include
files on tape media that have been moved to a vault archive.)
Note the following about the used space that is tracked:
• The used space includes the sizes of all files stored to the media.
This includes multiple copies of files, if present, as well as old
versions available for recovery.
• The used space includes the size of the header information
written to the media with the file. This header contains
24Quantum StorNext User’s Guide
Chapter 3: The Configuration Wizard
Step 2: Licenses
information used to verify file information at retrieve time,
etcetera.
• If compression is enabled, the used space is determined by the
native size of the files and not the compressed size.
• For tape media, the used space includes “dead space” for files
that have been removed or modified, and for which fsclean has
been run to clean up knowledge of the file in the Storage
Manager database.
Note: The capacity for storage disks does not include “dead
space” but does include
all
data on the file system where
the storage disk has been configured, not just files copied
to the file system by the Storage Manager. To maximize the
licensed Storage Manager capacity, the storage disk file
systems should be restricted to Storage Manager data only.
If your storage disk contains ‘user’ data you should
consider moving that data to an alternate location prior to
performing a StorNext upgrade.
If you are unsure about the location of the Storage
Manager data on a file system run the command
fsdiskcfg with no arguments. This command produces a
report on the configured storage disks and the location of
the managed data on each file system. The ‘Path’ column
in the command output indicates the directory containing
the managed data.
• Replication: Unlimited
• Deduplication: The number displayed is the size of the blockpool.
The capacity is tracked to the nearest terabyte.
• Vaulting: Unlimited
• Storage Disk: Unlimited
• Checksum: Unlimited
• Distributed Data Mover (DDM): The number displayed is the
maximum number of clients that can be used to run mover
processes.
• Failover (HA): Unlimited
Quantum StorNext User’s Guide25
Chapter 3: The Configuration Wizard
Step 2: Licenses
• Maintenance: The number displayed is the release number for the
StorNext software.
Determining License Capacity
The numbers displayed on the StorNext License screen represent
licensed capacity
actual capacity for the File System, LAN Clients, Deduplication,
Replication, Failover and Maintenance licenses by running the following
command from the command line:
# snlicense <license type>
When running this command, do not use capital letters or include the
angled brackets around the license type.
To obtain capacities for the Storage Manager, Vaulting, Storage Disk,
Checksum, DDM and Maintenance features, run the following
command from the command line:
# sntsm -l <feature name>
Note that character after the dash in the preceding command is the
letter L, not the numeral 1. As before, when running this command do
not use capital letters or include the angled brackets around the feature
name.
, not necessarily
actual capacity
. You can determine the
For more information, see the man pages for both of these commands.
Updating LicensesYou will need to update a license if the license expires or if your
configuration changes (for example, if you add additional clients or
increase capacity.)
To update a license, select the desired product/feature and then click
Enter/Update. When the Configuration > Licenses > Enter/Update
screen appears, copy the license string you received from Quantum into
the [License/Feature Name] License field, and then click Apply.
Licensing and UpgradesThe new licensing implementation affects StorNext upgrades, both for
release 4.0 and future releases. Be aware of the following upgraderelated implications and plan accordingly:
26Quantum StorNext User’s Guide
Chapter 3: The Configuration Wizard
Step 2: Licenses
• A non-expired Maintenance license is required to perform a
StorNext upgrade. This means you must contact Quantum Technical
Support for a Maintenance license before you can upgrade to
StorNext 4.0.
• The Maintenance license provided by Quantum Technical Support
must be put into place prior to the upgrade, or you will not be
allowed to proceed with the upgrade. This step is done by manually
editing the license.dat file because the StorNext GUI has not
been installed and therefore you cannot enter licenses through the
GUI. This applies to upgrades to StorNext 4.0 and also to future
upgrades.
• For future upgrades, for any StorNext feature or component
currently in use, you must have a license in place prior to the
upgrade. Otherwise, you will not be allowed to proceed with the
upgrade.
• For future upgrades, after an upgrade you will still be allowed to
run StorNext if the Maintenance license expires. However, no future
upgrades will be allowed.
• The Maintenance license must remain in place even after expiration
to allow the StorNext software to run, because it indicates which
version of the software was purchased.
• If you are ready to upgrade and then notice that the Storage
Manager capacity has been exceeded, you can follow the procedure
below to free up capacity to bring it under the licensed value. These
steps will clean up “dead space” on tape media, and do not apply to
storage disks.
1 Run the fsmedcopy command with no arguments. Running
command generates a report of media and wasted space. The
report looks similar to this:
% fsmedcopy
---------------------------------------------------- Media Fragmentation Report Thu Feb 4
Chapter 3: The Configuration Wizard
Step 3: Name Servers
The “Fill Level” column shows how full the media is. The
“Wasted Space” column indicates how much of the used space
is wasted, NOT the percentage of the entire tape.
Media with high percentages for both values (such as media
000096 in the example) are good candidates for eliminating
dead space.
2 For each media you identify as having significant dead space,
run this command:
% fsmedcopy -r <mediaid>
Note: On a large system, the fsmedcopy report can take a
long time to complete. If your site is dynamic (that is, it
has a lot of file removes and updates,) you can skip
step 1 and just pick media you know are full, and then
run the command fsmedcopy -r against those
media.
Manually Editing the
license.dat File
If you choose to manually edit the license.dat file instead of using the
StorNext GUI, your manual changes will not be reflected in the StorNext
GUI until you restart services by running #service cvfs restart
from the command line. Alternatively, you can restart services using the
StorNext GUI as described in
System Control on page 165.
Step 3: Name Servers
This screen enables you to manage machines acting as File System name
servers. These machine names are copied into the StorNext
fsnameservers file, which specifies machines serving as File System
Name Server coordinator(s). The File System Name Server coordinator is
a critical component of the StorNext File System Services (FSS).
A principal function of the coordinator is to manage failover voting in a
high-availability configuration. Therefore, it is critical to select highly
reliable systems as coordinators. Redundancy is provided by listing
multiple machine entries in the fsnameservers file, one entry per line.
28Quantum StorNext User’s Guide
Figure 8 Name Servers Screen
Chapter 3: The Configuration Wizard
Step 3: Name Servers
The first machine listed is the primary coordinator and any subsequent
machines listed serve as backup coordinators. To create redundancy, it is
recommended that you list two machines. Typically, the selected systems
are also configured for FSM services, but this is not a requirement.
If the fsnameservers file does not exist, then the file system operates
as a local file system, requiring both a client and a server. The file system
will not communicate with any other StorNext File System product on
the network, thus eliminating the sharing of the FSS over the SAN.
1 When the Configuration Wizard is displayed, choose Name Servers
on the left side of the screen. (Alternatively, choose Name Servers
from the Configuration menu.) The Configuration > Name Servers screen appears. (If name servers were previously created, a
list of those IP addresses appears on the Name Servers screen.)
2 To add a new name server, enter the IP address in the field to the left
of the Add button. The new name server appears in the list of
available name servers.
3 Click Apply to use the name server specified.
4 When the confirmation message warns you that changing the name
server is a cluster-wide event, click Yes to continue or No to abort.
Quantum StorNext User’s Guide29
Chapter 3: The Configuration Wizard
Step 4: File Systems
5 After you click Yes, a message informs you that Name Servers has
been updated. Click OK to continue.
6 If there are previously configured name servers, you can specify the
order in which name servers are used. To set the order, select a
server and then click Move Up or Move Down until the selected
server is in the correct order.
A green check mark icon under the Enabled column heading indicates
that the server is currently enabled as a name server. A red X icon
indicates that the server is not currently enabled.
Deleting a Name ServerTo delete a name server, select the name server you want to delete and
then click Delete. Finalize the deletion by clicking Apply.
Caution: This delete function does not provide a confirmation
message before completing the deletion, so be absolutely
certain you want to delete a name server before clicking
Delete.
Step 4: File Systems
After entering license information, the next task is to create a file
system. When you reach this step, any previously created file systems
are displayed.
The following procedure describes the easiest way to create a new file
system quickly so you can complete the Configuration Wizard tasks and
begin using StorNext immediately. For more detailed information about
file systems such as editing, modifying or deleting existing file systems
or performing additional file system actions, see
page 63.
1 When the Configuration Wizard is displayed, choose File Systems
on the left side of the screen. (Alternatively, choose File Systems
from the Configuration menu.) The Configuration > File Systems
screen displays all currently configured file systems. (If you are
30Quantum StorNext User’s Guide
File System Tasks on
Figure 9 Configuration > File
System Screen
Chapter 3: The Configuration Wizard
Step 4: File Systems
running the Configuration Wizard for the first time, there will be no
existing file systems.)
From this screen you can view, add, edit, or delete a file system. For
information on these procedures, see the online help.
2 Click New to add a new file system. The Configuration > File Systems
> New Screen appears.
Quantum StorNext User’s Guide31
Chapter 3: The Configuration Wizard
Step 4: File Systems
Figure 10 Configuration > File
System > New Screen
3 Enter the following fields:
• File System Name
• Mount Point
•Storage Manager
• Replication/Deduplication
• Stripe Group Configuration: Generated or Manual
(For detailed information about what to enter on this screen, see
the online help.)
If you chose Manual Configuration, skip to Manual Configuration.
4 Click Continue to proceed to the second configuration screen.
32Quantum StorNext User’s Guide
Figure 11 Configuration > File
System > New Screen 2
Chapter 3: The Configuration Wizard
Step 4: File Systems
5 At the Avg Files/Directory field, select one of the options to
indicate the approximate average number of files per directory you
anticipate the new file system will contain. Options range from
fewer than 10 files to more than 1000 files.
6 At the RAID Type field, select the type of RAID the file system uses.
7 Select one or more disks to assign to the file system.
8 After selecting one or more disks, click the Metadata checkbox to
designate the disk(s) as used for metadata, or click the Journal
checkbox to use the disk(s) for journaling. A disk can be used for
both metadata and journaling.
9 At the field to the left of the Label button, enter a disk label name.
Click Label to apply the label name to the selected disks. (Clicking
Unlabel removes label names from selected disks.) When asked to
confirm the action (either Label or Unlabel), click OK to continue or
Cancel to abort.
10 After you are finished entering label information, click Assign to
assign the disk(s) to the file system. (Clicking Unassign removes any
existing associations between disks and the file system. For example,
if you assign disks erroneously, clicking Unassign is an easy way to
remove associations and reassign disks.)
11 Click Continue.
Quantum StorNext User’s Guide33
Chapter 3: The Configuration Wizard
Step 4: File Systems
Figure 12 Configuration > File
System > New Screen 3
12 Click the arrows beside the headings Advanced Parameters and
Stripe Group/Disk Management to display that information. If
desired, make any changes in these areas.
13 When you are satisfied with the file system parameters, click Apply.
StorNext automatically configures and creates the file system based
on the information you entered.
Manual Configuration
If you chose Manual Configuration, you must enter the fields on the
Advanced Parameters tabs and the Stripe Group/Disk Management
fields. (Click the arrow to the left of these headings to display the tabs
and fields.)
34Quantum StorNext User’s Guide
Figure 13 Configuration > File
System > New Screen 3
Chapter 3: The Configuration Wizard
Step 5: Storage Destinations
For information about entering these tabs and fields, see the online
help.
1 When you are finished entering Advanced Parameter and Stripe
Group/Disk Management information for the manually configured
file system, click Apply to save your changes and create the file
system.
2 When a message informs you that the file system was successfully
created, click OK.
Step 5: Storage Destinations
After you have created at least one file system, the Configuration
menu's Storage Destinations option allows you to add, edit, or delete
libraries and storage disks. You can also enter or edit targets for data
replication, and specify a blockpool host file system for data
deduplication.
Quantum StorNext User’s Guide35
Chapter 3: The Configuration Wizard
Step 5: Storage Destinations
Adding a New LibraryFollow this procedure to add a new library:
1 When the Configuration Wizard is displayed, choose Storage
Destinations on the left side of the screen. (Alternatively, choose
Storage Destinations from the Configuration menu.)
2 If necessary, click the Library tab. The Configuration > Storage
Destinations > Library Screen
Figure 14 Storage Destinations
> Library Screen
appears.
3 Click New. The Configuration > Storage Destinations > Library > New
Screen
appears.
36Quantum StorNext User’s Guide
Figure 15 Storage Destinations
> Library > New Screen
Chapter 3: The Configuration Wizard
Step 5: Storage Destinations
4 Enter the fields at the top of the screen. (For detailed information
about what to enter on this screen, see the online help.)
5 In the Drives section, select a tape drive to add to your new library,
or click Scan to have StorNext discover available drives for you.
6 In the Media section, view media available for use. (Click Scan to
have StorNext discover available media for you.)
7 Click Apply.
8 After a message informs you that the library was successfully
created, click OK.
9 Repeat steps 3 - 8 to add additional tape drives and media to the
new library.
Viewing an Existing
Library
Follow this procedure to view details for a previously created library:
1 Choose Storage Destinations from the Configuration menu. If
necessary, click the Library tab. The Configuration > Storage Destinations > Library screen appears. (See
Figure 14.)
2 Select the library whose information you want to view.
Quantum StorNext User’s Guide37
Chapter 3: The Configuration Wizard
Step 5: Storage Destinations
Figure 16 Library Details
Screen
3 Click View, or choose View from the actions dropdown list. The
library detail screen appears.
4 The library information screen provides the following information:
• Name: The name of the library
• Serial Number: The library's serial number
• Fill Level: The library's current fill level
• Typ e: The type of library (e.g., SCSI, ACSLS, etc.)
• State: The library's current state (e.g., online or offline)
• Dual Aisle: Indicates whether the library has a dual aisle
configuration
• EIF Port Config: The current EIF port configuration
• HA Failover: Indicates whether HA failover is enabled for the
library
• Drive Count: The number of tape drives in the library
• Media Count: The number of media in the library
5 When you are finished viewing library information, click Done.
38Quantum StorNext User’s Guide
Chapter 3: The Configuration Wizard
Step 5: Storage Destinations
Editing a LibraryFollow this procedure to edit parameters for an existing library:
1 If you have not already done so, choose Storage Destinations from
the Configuration menu and then click the Library tab.
2 Select the library you want to edit.
3 Click Edit, or choose Edit from the actions dropdown list. After you
select this option StorNext scans the library, which could take some
time to complete depending on your configuration.
Figure 17 Edit Library Screen
4 If desired, click Scan if you want StorNext to scan the library for
drives.
5 Select the tape drives you want included in your library, or click All
to include all available tape drives. (To exclude all drives, click None.)
6 Click Apply.
7 When a confirmation message appears, click Yes to proceed, or No
to abort.
8 After a message informs you that the library was successfully
modified, click OK.
Quantum StorNext User’s Guide39
Chapter 3: The Configuration Wizard
Step 5: Storage Destinations
Deleting a LibraryFollow this procedure to delete an existing library:
1 If you have not already done so, choose Storage Destinations from
the Configuration menu and then click the Library tab.
2 Select the library you want to delete.
3 Click Delete, or choose Delete from the actions dropdown list.
4 When a confirmation message appears, click Yes to proceed with
the deletion or No to abort.
5 After a message informs you that the library was successfully
deleted, click OK.
Performing Other
Library Actions
Towards the middle of the Configuration > Storage Destinations >
Library screen is a dropdown list of actions you can perform for
libraries.
Select the library for which you want to perform the action, and then
choose one of these options from the Select Action dropdown list:
• Audit: Select this option to perform an audit on the selected library.
An audit is a physical check of each library component to verify its
integrity and make sure the database and library are synchronized.
Quantum recommends that you audit the library after each restore.
•Remap-Audit: Select this option to perform an audit on the
selected library with a physical inventory of the library. This option
synchronizes the StorNext databases with the library databases.
• Online: Select this option to set the library online. No additional
actions are required.
• Offline: Select this option to take the library offline. No additional
actions are required.
• Drives Online: Select this option to place the drives in the library
online. No additional actions are required.
• Drives Offline: Select this option to take the drives in the library
offline. No additional actions are required.
• Add Media Bulkload: Select this option to add media to the library
via the bulk loading method.
• Add Media Mailbox: Select this option to add media to the library
through the library's mailbox.
40Quantum StorNext User’s Guide
Chapter 3: The Configuration Wizard
Step 5: Storage Destinations
Storage Disk OverviewStorage disks are external devices on UNIX-based file systems that can
be used for long term data storage. Storage disks function and operate
the same way as physical tape media.
When a storage disk is configured, the StorNext Storage Manager
moves data to storage disks for long-term retention in addition to, or
instead of tape. This enables users to leverage the specialized third-party
functionality of appliances or store small files that might take longer to
retrieve from tape. Many users will still use tape for long-term storage
and vaulting, but storage disk can be used to create tape-free archives.
Here are a few differences storage disks have over tape media, aside
from the obvious cost-saving benefit:
• A storage disk either belongs to no policy class, or belongs to a
single policy class
• A storage disk can store file copies only with the same copy ID.
Note: Before you create a storage disk, the disks you plan to use must
reside in an existing, mounted file system.
After you create a storage disk, observe the following usage
recommendations:
• If your file system includes storage disks, avoid using that file system
for any data other than storage disk stored data.
• Use complete and physically dedicated file systems (snfs, local, NFS,
or other,) for storage disk data, not shared file systems or file
systems with linked directories.
• If your file system includes storage disks and you accidentally fill it
with unrelated user data (i.e., non-storage disk data,) call the
Quantum Technical Assistance Center and ask for a procedure to
clean up and transcribe data.
The following procedures describe how to view, edit and delete storage
disks. The procedure for adding a storage disk is identical to entering
one through the StorNext Configuration Wizard as described in
Adding
a New Storage Disk on page 42.)
Quantum StorNext User’s Guide41
Chapter 3: The Configuration Wizard
Step 5: Storage Destinations
Adding a New Storage
Disk
Figure 18 Configuration >
Storage Destinations >
Storage Disk Screen
Follow this procedure to add a new storage disk.
1 Click the Storage Disk tab. The Configuration > Storage
Destinations > Storage Disk Screen appears.
2 Click New. The Storage Destinations > Storage Disk > New
Screen appears.
42Quantum StorNext User’s Guide
Figure 19 Storage Destinations
> Storage Disk > New Screen
Chapter 3: The Configuration Wizard
Step 5: Storage Destinations
3 Enter the fields on the screen. (For detailed information about what
A storage policy defines how files will be managed in a directory and
subdirectories.
These are the available storage policy settings:
• Number of copies to create
• Media type to use when storing data
• Amount of time to store data after data is modified
• If disk-to-disk relocation is enabled, the amount of time (in days)
before relocating a file
• Amount of time before truncating a file after a file is modified
Storage policies can be related to one or more directories. In this
situation, all files in that directory and sub-directories are governed by
the storage policy. The connection between a storage policy and a
directory is called the relation point.
48Quantum StorNext User’s Guide
Chapter 3: The Configuration Wizard
Step 6: Storage Policies
Here are some examples of storage policy usage:
• A directory in which to store backups every night is created. This
directory is seldom accessed after the files are copied over. A storage
policy could be set up to create two tape copies of the files, store
one copy of the files to AIT media after residing on disk for 10
minutes, and then truncate the other set of files immediately after
storing the other set to tape in order to free up disk space. This
policy can be associated with a directory such as: /sandsm/dsm1/
backup.
• A directory has been created to store all documents that are
accessed frequently, and if truncated, need to be retrieved quickly.
The in this case could be set up to create a single tape copy, store
the files to LTO media 15 minutes after being on disk, and then
truncate after 60 days of non-use. This policy can be associated with
a directory such as: /sandsm/dsm1/docs.
Adding a Storage
Manager Storage
Policies
Follow this procedure to add a new Storage Manager storage policy:
1 When the Configuration Wizard is displayed, choose Storage
Policies on the left side of the screen. (Alternatively, choose Storage
Policies from the Configuration menu.) The Configuration >
Storage Policies Screen appears.
Quantum StorNext User’s Guide49
Chapter 3: The Configuration Wizard
Step 6: Storage Policies
Figure 23 Configuration >
Storage Policies Screen
2 Click New. The Storage Policies > New Screen appears.
Figure 24 Storage Policies >
New Screen
3 Enter the following fields:
• Policy Name: The name of the new policy you are creating
50Quantum StorNext User’s Guide
Chapter 3: The Configuration Wizard
Step 6: Storage Policies
• Policy Type: choose Storage Manager to create a policy for
StorNext Storage Manager
•Click Configure to continue.
4 Enter information on the General, Relocation, Steering, Schedule
and Associated Directories tabs. (See the sections following for
more information about these tabs.)
5 When you are finished entering information about the new policy,
click Apply, or click Cancel to exit without saving.
6 After the Status screen informs you that the policy was created
successfully, click OK.
The General Tab
The General tab contains parameters that apply to all storage policies.
Fields marked with an asterisk are required. Enter additional fields as
desired, or accept the displayed default values.
Figure 25 Storage Policies >
New > General Tab
For instructions on what to enter on this screen, see the online help.
Quantum StorNext User’s Guide51
Chapter 3: The Configuration Wizard
Step 6: Storage Policies
Figure 26 Storage Policies >
New > Relocation Tab
The Relocation Tab
The Relocation tab enables you to configure the Disk-to-Disk relocation
feature.
Disk-to-Disk relocation allows you to move data from one set of disks
(disk stripe group) to another without affecting the file name space.
For instructions on what to enter on this screen, see the online help.
The Steering Tab
The Steering tab enables you to configure file steering, which allows you
to direct a copy to a designated drive pool. For example, you could have
a file system with one drive pool of SATA disks intended for proxy files
or temporary storage such as less critical data on lower-duty cycle,
slower disks. You might have another larger fibre channel drive pool for
storing raw content such as high value data, on higher duty cycle,
higher performance disks.
52Quantum StorNext User’s Guide
Figure 27 Storage Policies >
New > Steering Tab
Chapter 3: The Configuration Wizard
Step 6: Storage Policies
For instructions on what to enter on this screen, see the online help.
The Schedule Tab
The Schedule tab allows you to enable or disable the Store Files
Automatically feature.
When this feature is enabled, StorNext automatically stores files for the
current storage policy. If this feature is disabled, Quantum recommends
that the files for the policy class be stored by scheduled events.
Quantum StorNext User’s Guide53
Chapter 3: The Configuration Wizard
Step 6: Storage Policies
Figure 28 Storage Policies >
New > Schedule Tab
For instructions on what to enter on this screen, see the online help.
The Associated Directories Tab
The Associated Directories tab enables you to view or delete any existing
associated directories in the file system for the policy, and to add new
directories.
54Quantum StorNext User’s Guide
Figure 29 Storage Policies >
New > Associated Directories
Ta b
Chapter 3: The Configuration Wizard
Step 6: Storage Policies
For instructions on what to enter on this screen, see the online help.
Adding a Replication
Storage Policies
Viewing a Storage
Policy
The steps for creating a replication storage policy are described in Step
4: Create a Replication Storage Policy on page 135.
To view storage policy details To view storage policy details for a Storage
Manager or Replication policy, do the following:
1 From the Configuration > Storage Policies screen, select the
storage policy you wish to view.
2 Click View.
Quantum StorNext User’s Guide55
Chapter 3: The Configuration Wizard
Step 6: Storage Policies
Figure 30 View Storage
Policies Screen
3 Click Done to return to the Configuration > Storage Policies
screen.
Running a Storage
Policy
Follow this procedure to run an existing storage policy.
1 If you have not already done so, choose Storage Policies from the
Configuration menu.
2 Select the policy you want to run, and then click Run.
3 When a message informs you that the job was successfully initiated,
click OK to continue.
4 To view job progress, select Jobs from the Reports menu.
Editing a Storage PolicyTo edit an existing storage policy:
1 From the Configuration > Storage Policies screen, select the
policy you wish to edit.
2 Click Edit.
3 Modify policy information as desired by clicking the tabs and editing
or adding information. The process is the same as when you first
created the policy.
56Quantum StorNext User’s Guide
Chapter 3: The Configuration Wizard
Step 7: Email Server
If you are editing a Storage Manager policy, you can edit fields on
the General, Relocation, Steering, Schedule and Associated Directories tabs. For more information about fields on these tabs,
see the online help.
If you are editing a Replication global policy, you can edit fields on
Deduplication, Truncation, Outbound Replication, Inbound
Replication, and Blackout tabs. If you are editing a Replication
target policy, you can modify field on only the Inbound Replication
tab. For more information about fields on these tabs, see the online
help.
4 Click Apply to save changes and return to the Configuration >
Storage Policies screen, or Cancel to abort.
Deleting a Storage
Policy
To delete an existing storage policy:
1 From the Configuration > Storage Policies screen, select the
policy you wish to delete.
2 Click Delete.
3 Click Yes to confirm the deletion, or No to cancel.
Step 7: Email Server
The Email Server option allows you to specify the email server used for
processing StorNext notification email messages. On this screen you will
enter basic information such as the email server name and sending
entity. You also have the option of sending a test message so you can
verify that StorNext recognizes the email server whose information you
entered.
Note: The Email Server option does not configure your email server.
Instead, it allows you to specify a previously configured email
server so StorNext knows which server is responsible for
processing notification messages. Before you use the Email
Server option, make sure your email SMTP server is already
configured.
Quantum StorNext User’s Guide57
Chapter 3: The Configuration Wizard
Step 8: Email Notification
Adding an Email ServerFollow this procedure to add a new email server.
1 When the Configuration Wizard is displayed, choose Email on the
left side of the screen. (Alternatively, choose Email Server from the
Configuration menu.) The Configuration > Email Server Screen
appears.
Figure 31 Configuration >
Email Server Screen
2 Complete the fields related to your email system configuration on
the Configuration > Email Server screen. (For detailed information
about what to enter on this screen, see the online help.)
3 Click Apply to save your changes.
Step 8: Email Notification
The Email Notification feature allows you to specify parties who should
receive StorNext email messages about backup statuses, service tickets,
admin alerts, and policy class messages.
58Quantum StorNext User’s Guide
Chapter 3: The Configuration Wizard
Step 8: Email Notification
Note: In order for this feature to work properly, make sure you have
specified a configured email server as described in
Follow this procedure to add a new email recipient.
1 Choose Email Notifications from the Configuration menu.
2 When the Configuration Wizard is displayed, choose Email
Notifications on the left side of the screen. (Alternatively, choose
Email Notifications from the Configuration menu.) The
Configuration > Email Notifications Screen appears.
3 Click New. The Configuration > Email Notifications > New screen
appears.
Quantum StorNext User’s Guide59
Chapter 3: The Configuration Wizard
Step 8: Email Notification
Figure 33 Configuration >
Email Notifications New Screen
4 Complete the fields for the new email recipient. (For detailed
information about what to enter on this screen, see the online
help.)
5 Click Apply to save your changes.
6 When the confirmation message appears, click Ye s to proceed or No
to abort.
7 When a message informs you that the email notification recipient
was successfully added, click OK to return to the Configuration >
Email Notifications screen.
Viewing Email Recipient
Information
Follow this procedure to view details for an existing email recipient.
1 If you have not already done so, when the Configuration Wizard is
displayed, choose Email Notifications on the left side of the screen.
(Alternatively, choose Email Notifications from the Configuration
menu.)
2 On the Configuration > Email Notifications screen, review the list
of current email recipients.
3 Select the recipient whose information you want to view, and then
click View.
60Quantum StorNext User’s Guide
Chapter 3: The Configuration Wizard
Step 8: Email Notification
4 When you are finished viewing recipient information, click Cancel to
return to the Configuration > Email Notifications screen.
Editing an Email
Recipient
Deleting an Email
Recipient
Follow this procedure to edit information for a previously entered email
recipient.
1 If you have not already done so, when the Configuration Wizard is
displayed, choose Email Notifications on the left side of the screen.
(Alternatively, choose Email Notifications from the Configuration
menu.)
2 On the Configuration > Email Notifications screen, select the
recipient whose information you want to edit and then click Edit.
3 Modify any of the fields on the screen. (For detailed information
about what to enter on this screen, see the online help.)
4 When you are finished making modifications, click Apply to save
your changes and return to the Configuration > Email Notifications screen. (To exit without saving, click Cancel.)
Follow this procedure to delete a previously entered email recipient.
1 If you have not already done so, when the Configuration Wizard is
displayed, choose Email Notifications on the left side of the screen.
(Alternatively, choose Email Notifications from the Configuration
menu.)
2 On the Configuration > Email Notifications screen, review the list
of current email recipients.
3 Select the recipient you want to delete and then click Delete.
4 When the confirmation message appears, click Ye s to proceed or No
to abort the deletion.
5 When a message informs you that the email notification recipient
was successfully deleted, click OK return to the Configuration > Email Notifications screen.
The last step in the Configuration Wizard is to click Done to indicate
that you have completed all configuration steps.
On this screen you can also convert to a high availability (HA)
configuration by clicking Convert to HA. Clicking this button is the
same as choosing High Availability > Convert from the To o ls menu.
For information about entering the fields on this screen and converting
to an HA system, see
Converting to HA on page 197.
62Quantum StorNext User’s Guide
Chapter 4
File System Tasks
In addition to the basic file system tasks described for the Configuration
Wizard in
menu contains additional options that enable you to perform the
following file system-related tasks:
• Label Disks: Apply EFI or VTOC label names for disk devices in your
• Check File System: Run a check on StorNext files systems prior to
• Affinities: Allocate additional storage to a file system by creating a
Step 4: File Systems on page 30, the Tools > File Systems
StorNext libraries
expanding or migrating the file system
new stripe group in the file system configuration file, and assigning
new disks to the stripe group
• Migrate Data: Move data files from a source file system to a
destination stripe group, freeing stripe groups so they can be
removed from an existing StorNext file system
• Truncation Parameters: Enter truncation parameters for your file
systems in order to free up file storage that isn’t being actively used
Quantum StorNext User’s Guide63
Chapter 4: File System Tasks
Label Disks
Label Disks
Each drive used by StorNext must be labeled. (A new drive must be
labeled only one time.) You can label a drive from any StorNext server or
client that has a fibre channel (FC) connection to the drive.
There are two types of label:
• EFI labels are required if you plan to create LUNs that are larger than
2TB. (For Solaris, EFI labels are also required for LUNs with a raw
capacity greater than 1TB.) EFI labels will not work with the IRIX
operating system.
• VTOC labels were used for all operating systems in previous
StorNext and Xsan releases, and are still required for the SGI IRIX
operating system, Solaris releases prior to Solaris 10 Update 2, and
LUNs less than 1TB.
Labeling a DeviceFollow this procedure to label any new or unused devices, or relabel a
device that has been unlabeled.
Caution: Labeling a disk device may result in a complete loss of data
on that disk device.
1 Choose Label Disks from the Tools > File Systems menu. The To ol s
> Label Disks screen appears.
64Quantum StorNext User’s Guide
Figure 35 Label Disks Screen
Chapter 4: File System Tasks
Label Disks
2 Select the disk devices to which you want to apply labels. (Click All
to select all available disks.) If a disk device already has a label,
continuing with this procedure overwrites the existing label.
Caution: Overwriting or renaming a disk device label may result
in a complete loss of data on that disk device.
3 Specify the label type by choosing EFI or VTOC.
4 Enter a label name in the text field to the right of the EFI and VTOC
buttons.
5 Click Label.
6 When the confirmation message appears, verify that the disk you
are labeling is empty, and then click OK to proceed. (Click Cancel to
abort without labelling the disk.)
Note: If you later unlabel a device and then decide to make the
unlabeled device usable by the StorNext File System, you must
first relabel the device. The relabeling process is identical to
labeling initially.
Quantum StorNext User’s Guide65
Chapter 4: File System Tasks
Check File System
Unlabeling a DeviceFollow this procedure to remove a label from a previously labeled
device. If you unlabel a device and then decide later to make the
unlabeled device usable by the StorNext File System, you must first
relabel the device. The relabeling process is identical to labeling initially
as described in
Note: You cannot remove the label from a disk device that has been
previously assigned to a file system. You can identify these
devices by the file system name under the Filesystem heading.
1 If you have not already done so, choose Label Disks from the To ol s
> File Systems menu.
2 Select the disk devices from which you want to remove labels. (Click
All to select all available disks.)
3 Click Unlabel.
4 When the confirmation message appears, click OK to verify that you
want to unlabel the selected disk(s). (Click Cancel to abort without
unlabelling the disk.)
Labeling a Device.
Caution: When you unlabel a device, all data on that device will be
lost. Additionally, the unlabeled device will no longer be
used by the file system until it is relabeled.
Check File System
Before you perform either File System Expansion or Migration, you must
first perform a check on the file system you plan to use for these
features. This operation could take a significant amount of time
depending on the size of the file system, so plan accordingly.
Also, this operation could consume a significant amount of space on the
local file system. For example, for large file systems you should allow at
least 20GB of free space on the local file system for temporary files.
Use the following procedure to perform a file system check.
66Quantum StorNext User’s Guide
Figure 36 Check File System
Screen
Chapter 4: File System Tasks
Check File System
1 Choose Check File System from the Tools > File Systems menu.
The Tools > Check > [file system name] screen appears.
2 At the Temp File Directory field, enter a new directory if the
specified directory does not have enough space to perform the
check. (The checking process on large file systems can take
hundreds of megabytes or more of local system disk space for
working files.)
3 Select the file system you want to check. (Only file systems eligible
for File System Expansion or Migration are shown.)
4 Click Check to begin checking the selected file system. Current
progress and other details about the checking process appear at the
bottom of the screen.
Note: If the file system you select is currently started and mounted,
the check will be automatically performed in read-only mode.
In read-only mode on a live file system (started and mounted,)
you could receive false errors.
Quantum StorNext User’s Guide67
Chapter 4: File System Tasks
Check File System
Viewing and Deleting a
Check Report
Figure 37 Check File System
Report
After you have run at least one file system check, information about the
process appears at the bottom of the screen: file system name, the time
the check was initiated and completed, and the status of the check. To
view details about a specific check, select the desired check at the
bottom of the screen and then click Report. When you are finished
viewing the report, click Done to return to the previous screen.
To delete a check report from the list, select the check you want to
delete and then click Delete. To delete all previously run checks listed,
click Delete All.
68Quantum StorNext User’s Guide
Chapter 4: File System Tasks
Affinities
File System Check
Output Files
Affinities
If you do not want to use StorNext to view output from the file system
check, you can view output in two files:
• /usr/cvfs/data/<fsname>/trace/cvfsck-<timestamp>
For example: /usr/cvfs/data/snfs1/trace/cvfsck-
For example: /usr/adic/gui/logs/jobs/CHECK_FS20100222_121519-77
This section describes StorNext’s “stripe group affinity” feature, and also
provides some common use cases.
A
stripe group
which data is striped. Each stripe group also has a number of associated
attributes, including affinity and exclusivity.
is a collection of LUNs (typically disks or arrays) across
An
affinity
stripe groups. Affinities are referenced by their name, which may be up
to eight characters long. An affinity may be assigned to a set of stripe
groups, representing a named pool of space, and to a file or directory,
representing the logical point in the file system and directing the
storage to use the designated pool.
Exclusivity
attribute, and can have its space allocated only by files with that affinity.
Files without a matching affinity cannot allocate space from an exclusive
stripe group. Files with an affinity that is exclusive cannot be stored on
other stripe groups without that affinity. If the exclusive stripe group(s)
become filled, no more files with that affinity can be stored.
Quantum StorNext User’s Guide69
is used to steer the allocation of a file’s data onto a set of
means a stripe group has both an affinity and the exclusive
Chapter 4: File System Tasks
Affinities
Affinities for stripe groups are defined in the file system configuration
file. Although stripe groups can be created by adding one or more
Affinity lines to the configuration file’s StripeGroup section, Quantum
recommends using the StorNext GUI to add stripe groups. A stripe
group may have multiple affinities, and an affinity may be assigned to
multiple stripe groups.
Allocation Strategy• StorNext has multiple allocation strategies which can be set at the
file system level. These strategies control where a new file’s first
blocks will be allocated. Affinities modify this behavior in two ways:
• A file with an affinity will be allocated only on a stripe group with
matching affinity.
• A stripe group with an affinity and the exclusive attribute will be
used only for allocations by files with matching affinity.
Once a file has been created, StorNext attempts to keep all of its data on
the same stripe group. If there is no more space on that stripe group,
data may be allocated from another stripe group. If the file has an
affinity, only stripe groups with that affinity will be considered; if all
stripe groups with that affinity are full, new space may not be allocated
for the file, even if other stripe groups are available.
Example Use CasesAffinities can be used to segregate audio and video files onto their own
stripe groups. For example:
• Create one or more stripe groups with an AUDIO affinity and the
exclusive attribute.
• Create one or more stripe groups with a VIDEO affinity and the
exclusive attribute.
• Create one or more stripe groups with no affinity (for non-audio,
non-video files).
• Create a directory for audio using ‘cvmkdir -k AUDIO audio’.
• Create a directory for video using ‘cvmkdir -k VIDEO video’.
Files created within the audio directory will reside only on the AUDIO
stripe group. (If this stripe group fills, no more audio files can be
created.)
70Quantum StorNext User’s Guide
Chapter 4: File System Tasks
Affinities
Files created within the video directory will reside only on the VIDEO
stripe group. (If this stripe group fills, no more video files can be
created.)
To reserve high-speed disk for critical files:
• Create a stripe group with a FAST affinity and the exclusive
attribute.
• Label the critical files or directories with the FAST affinity.
The disadvantage here is that the critical files are restricted to only using
the fast disk. If the fast disk fills up, the files will not have space
allocated on slow disks.
To reserve high-speed disk for critical files, but allow them to grow onto
slow disks:
• Create a stripe group with a FAST affinity and the exclusive
attribute.
• Create all of the critical files, pre allocating at least one block of
space, with the FAST affinity. (Or move them using snfsdefrag, after
ensuring they are non-empty.)
• Remove the FAST affinity from the critical files.
Because files will allocate from their existing stripe group, even if they
no longer have a matching affinity, the critical files will continue to
grow on the FAST stripe group. Once this stripe group is full, they can
allocate space from other stripe groups, since they do not have an
affinity.
This will not work if critical files may be created later, unless there is a
process to move them to the FAST stripe group, or an affinity is set on
the critical files by inheritance but removed after their first allocation (to
allow them to grow onto non-FAST groups).
Adding a New AffinityFollow this procedure to add affinities:
1 Choose Affinities from the Tools > File Systems menu. The To o l s >
File Systems > Affinities screen appears.
Quantum StorNext User’s Guide71
Chapter 4: File System Tasks
Affinities
Figure 38 Affinities Screen
2 Click New. The New Affinity screen appears.
Figure 39 New Affinity Screen
3 At the Affinity field, enter the name of the new affinity.
72Quantum StorNext User’s Guide
4 At the File Systems field, select the file system to which you want to
associate the new affinity.
5 Click Apply to create the affinity.
6 When a message notifies you that the affinity was successfully
created, click OK to continue.
Deleting an AffinityFollow this procedure to delete affinities:
1 If you have not already done so, choose Affinities from the Tools >
File Systems menu. The Tools > File Systems > Affinities screen
appears.
2 Select the affinity you want to delete.
3 Click Delete.
4 When asked to confirm the deletion, click Yes to proceed or No to
abort.
5 When a message notifies you that the affinity was successfully
deleted, click OK to continue.
Chapter 4: File System Tasks
Migrate Data
Migrate Data
Migrating file system data refers to moving data files from a file
system’s source stripe group to all the other stripe groups on the same
file system, and then freeing the source stripe group so it can be
removed from the file system. You can select the source stripe group
only, not the destination stripe group(s). Files will be moved randomly
to new stripe groups while respecting their affinity rules (if any). When
migrating, make sure the source stripe group is completely empty when
the process completes, because source files that are updated while the
file system is running may be left behind, requiring a second iteration of
the migration.
During file system migration, you indicate a file system from which to
move data.
StorNext then moves all data of the same type (either data or
metadata,) from the source file system to the specified destination
Quantum StorNext User’s Guide73
Chapter 4: File System Tasks
Migrate Data
Figure 40 Migrate Screen
stripe group. During movement the file system is left online and read/
write operations occur normally.
The time it takes to complete the migration process depends on the
amount of data being moved between source file system and target
stripe groups. When moving a data stripe group, the file system
continues to run during the move. StorNext does not block any new
read/write requests, or block updates to existing files on the source file
system. All operations (including metadata operations) are handled
normally, but no new writes are allowed to the source stripe group,
which will be marked read-only.
Use the following procedure to perform file system migration.
1 Choose Migrate Data from the Tools > File Systems menu. The
Tools > File systems > Migrate screen appears.
2 Select the target file system from which files will be migrated.
3 Select the destination stripe group to which files will be migrated.
4 Click Migrate.
74Quantum StorNext User’s Guide
Caution: This particular function does not provide a confirmation
Truncation Parameters
The Truncation Parameters screen enables you to view or change the
following information pertinent to the truncation feature as it pertains
to StorNext Storage Manager:
• Run: Indicates the current status of the truncation feature: Online of
Offline.
• Mount: Indicates whether the file system is currently mounted.
Chapter 4: File System Tasks
Truncation Parameters
message, so be absolutely sure you want to migrate data
from the selected file system to the selected stripe group
before you click Migrate.
• File System: Displays the name of the truncation-enabled file
system.
• Mount Point: Shows the mount point for the truncation-enabled
file system
• Truncation Parameters: Shows the current truncation setting, such
as Time-based 75%.
Note: This screen pertains ONLY to truncation for StorNext Storage
Manager users. It does not apply to deduplication or other
StorNext features.
Quantum StorNext User’s Guide75
Chapter 4: File System Tasks
Truncation Parameters
Figure 41 Truncation
Parameters Screen
To change truncation parameters:
1 Click the line containing the file system whose truncation
parameters you want to change. Parameters appear at the bottom
of the screen.
2 As desired, modify any of the following fields. (See the online help
for information about what to enter at each field.)
• Enable Truncation
• Truncation Mode
• Minimum Usage (%)
•Low Water (%)
•High Water (%)
3 Click Apply to save your changes.
4 When a confirmation message appears, click Yes to continue or No
to abort without saving.
Note: When you save changes to truncation parameters, the
StorNext Policy Manager must be restarted. This process
could take several minutes, so plan accordingly.
76Quantum StorNext User’s Guide
Chapter 4: File System Tasks
Truncation Parameters
5 Click Done when you are finished viewing or changing truncation
parameters.
Quantum StorNext User’s Guide77
Chapter 4: File System Tasks
Truncation Parameters
78Quantum StorNext User’s Guide
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.