Quantum STORNEXT 4.1 User Manual

User’s Guide

StorNext 4.1

6-01658-14 Rev A

Document Title, 6-01658-14 Rev A, December 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.

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.

ii Quantum StorNext User’s Guide

Chapter 1 Introduction 1

About StorNext File System. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

About StorNext Storage Manager. . . . . . . . . . . . . . . . . . . . . . . 2

About Distributed LAN Clients . . . . . . . . . . . . . . . . . . . . . . . . . 2

About Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Purpose of This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

How This Guide is Organized. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Notes, Cautions, and Warnings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Chapter 2 StorNext GUI Overview 7

Accessing the StorNext GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

The StorNext Home Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

StorNext Monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

StorNext Home Page Dropdown Menus . . . . . . . . . . . . . . . . . 14

Chapter 3 The Configuration Wizard 19

High Availability Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Step 1: Welcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Quantum StorNext User’s Guide iii

Contents

Step 2: Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

License Expiration and Limits . . . . . . . . . . . . . . . . . . . . . . . . . 26

Updating Licenses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Licensing and Upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Manually Editing the license.dat File. . . . . . . . . . . . . . . . . . . . 30

Step 3: Name Servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Multiple fsnameserver Hosts. . . . . . . . . . . . . . . . . . . . . . . . . . 31

Entering Name Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Deleting a Name Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Step 4: File Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Editing a File System and Performing Other Actions . . . . . . . . 39

Step 5: Storage Destinations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Adding a New Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Viewing an Existing Library . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Editing a Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Deleting a Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Performing Other Library Actions . . . . . . . . . . . . . . . . . . . . . . 45

Storage Disk Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Adding a New Storage Disk . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Viewing an Existing Storage Disks. . . . . . . . . . . . . . . . . . . . . . 48

Editing a Storage Disk. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Deleting a Storage Disk. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Adding a New Data Replication Host . . . . . . . . . . . . . . . . . . . 50

Editing a Data Replication Host . . . . . . . . . . . . . . . . . . . . . . . 51

Deleting a Data Replication Target . . . . . . . . . . . . . . . . . . . . . 52

Adding a New Mount Point . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Enabling Data Deduplication . . . . . . . . . . . . . . . . . . . . . . . . . 53

Step 6: Storage Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Adding a Storage Manager Storage Policy . . . . . . . . . . . . . . . 55

Adding a Replication Storage Policy . . . . . . . . . . . . . . . . . . . . 61

Viewing a Storage Policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Running a Storage Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Editing a Storage Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Deleting a Storage Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Step 7: Email Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Adding an Email Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Step 8: Email Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Adding an Email Recipient . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Viewing Email Recipient Information . . . . . . . . . . . . . . . . . . . 66

Editing an Email Recipient . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

iv Quantum StorNext User’s Guide

Contents

Deleting an Email Recipient . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Step 9: Done . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Chapter 4 File System Tasks 69

Label Disks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Labeling a Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Unlabeling a Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Check File System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Viewing and Deleting a Check Report. . . . . . . . . . . . . . . . . . . 74

File System Check Output Files . . . . . . . . . . . . . . . . . . . . . . . . 74

Affinities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Allocation Strategy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Example Use Cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Adding a New Affinity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Deleting an Affinity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Migrate Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Truncation Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Chapter 5 Storage Manager Tasks 83

Storage Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

Setting Devices Online and Offline . . . . . . . . . . . . . . . . . . . . . 85

Additional Options for Tape Drives . . . . . . . . . . . . . . . . . . . . . 85

Drive Pools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Viewing Drive Pool Information . . . . . . . . . . . . . . . . . . . . . . . 86

Adding a Drive Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Editing a Drive Pool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Deleting a Drive Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Media Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Viewing Media Information . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Filtering Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Performing Media Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Storage Exclusions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Accessing Storage Exclusions . . . . . . . . . . . . . . . . . . . . . . . . . 98

Adding an Exclusion Pattern . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Truncation Exclusions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Quantum StorNext User’s Guide v

Contents

Accessing Truncation Exclusions . . . . . . . . . . . . . . . . . . . . . . 102

Adding an Exclusion Pattern . . . . . . . . . . . . . . . . . . . . . . . . . 103

Tape Consolidation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Setting Tape Consolidation Parameters. . . . . . . . . . . . . . . . . 106

Scheduling Tape Cleaning and Defragmentation . . . . . . . . . 108

Library Operator Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Software Requests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Scheduler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Viewing a Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Adding a Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Editing an Existing Schedule . . . . . . . . . . . . . . . . . . . . . . . . . 114

Deleting an Existing Schedule . . . . . . . . . . . . . . . . . . . . . . . . 114

Alternate Retrieval Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

Distributed Data Mover (DDM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Distributed Data Mover Overview . . . . . . . . . . . . . . . . . . . . . 117

Installing the DDM Feature on Clients. . . . . . . . . . . . . . . . . . 121

Accessing Distributed Data Mover . . . . . . . . . . . . . . . . . . . . 121

Enabling DDM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

Managing DDM Hosts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Host Priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

Distributed Data Mover Reporting . . . . . . . . . . . . . . . . . . . . 127

Disaster Recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

Chapter 6 Replication and Deduplication 129

Replication Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

Replication Configuration Overview . . . . . . . . . . . . . . . . . . . 130

Replication Process Overview . . . . . . . . . . . . . . . . . . . . . . . . 131

Files Excluded From Replication . . . . . . . . . . . . . . . . . . . . . . 132

Replication Terms and Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

Namespace Realization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

Blockpool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Blackout Period. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Replication Source Policy and Replication Source Directory . 134

Replication Target Directory . . . . . . . . . . . . . . . . . . . . . . . . . 134

Replication Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Replication Copies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Bandwidth Throttling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Multilink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

vi Quantum StorNext User’s Guide

Contents

Virtual IP (vIP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Some Replication Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Scenario 1: Simplest Replication . . . . . . . . . . . . . . . . . . . . . . 136

Scenario 2: Replicating Multiple Copies in the Same Target

File System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

Scenario 3: Replicating to Multiple Target Hosts / File

Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

Additional Replication Possibilities . . . . . . . . . . . . . . . . . . . . 140

Non-Supported Replication Between Source and Target. . . . 143

Non-Supported “Chained” Replication . . . . . . . . . . . . . . . . . 143

Configuring Replication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

Step 1: Create Source and Target File Systems . . . . . . . . . . . 144

Step 2: Setting up the Blockpool. . . . . . . . . . . . . . . . . . . . . . 147

Step 3: Creating Replication Targets . . . . . . . . . . . . . . . . . . . 149

Step 4: Create a Replication Storage Policy. . . . . . . . . . . . . . 150

Configuration Steps Summary . . . . . . . . . . . . . . . . . . . . . . . 156

Scheduling Replication Blackouts (Optional). . . . . . . . . . . . . 157

Optional HA and Multilink Configuration . . . . . . . . . . . . . . . 159

Running Replication Manually (Optional) . . . . . . . . . . . . . . . . . . . . . 163

Replication Statuses and Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . 164

Replication Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

Replication Administration . . . . . . . . . . . . . . . . . . . . . . . . . . 164

StorNext Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

Troubleshooting Replication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

Data Deduplication Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

How Deduplication Works . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Deduplication and Replication . . . . . . . . . . . . . . . . . . . . . . . 167

Setting Up Deduplication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

Step 1: Creating a Deduplication-Enabled File System . . . . . 168

Step 2: Specifying the Blockpool. . . . . . . . . . . . . . . . . . . . . . 169

Step 3: Creating a Deduplication-Enabled Storage Policy . . . 169

Data Deduplication Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

Deduplication Administration . . . . . . . . . . . . . . . . . . . . . . . . 171

Deduplication Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

Chapter 7 Tools Menu Functions 173

User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

Quantum StorNext User’s Guide vii

Contents

Adding a New User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

Viewing an Existing User Profile . . . . . . . . . . . . . . . . . . . . . . 177

Modifying an Existing User . . . . . . . . . . . . . . . . . . . . . . . . . . 178

Deleting an Existing User . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

Changing the Admin Password. . . . . . . . . . . . . . . . . . . . . . . 179

Client Download . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

System Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

Starting or Stopping StorNext File System . . . . . . . . . . . . . . 183

Starting or Stopping StorNext Storage Manager . . . . . . . . . 183

Refreshing System Status . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Specifying Boot Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

File and Directory Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Store Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

Change File Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

Recover Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

Recover Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

Retrieve Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

Retrieve Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

Truncate Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

Move Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

Modify File Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

View File Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

File Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

Storage Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

Replication and Deduplication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

HA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

Chapter 8 Service Menu Functions 201

The Health Check Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Running a Health Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

Viewing the Health Check Results . . . . . . . . . . . . . . . . . . . . . 203

Viewing Health Check Histories. . . . . . . . . . . . . . . . . . . . . . . 204

The Capture State Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Creating a Capture State Log . . . . . . . . . . . . . . . . . . . . . . . . 205

Deleting a Previous System State Capture. . . . . . . . . . . . . . . 206

The System Backup Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

viii Quantum StorNext User’s Guide

Contents

The Admin Alerts Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

The Tickets Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

Viewing Ticket Information. . . . . . . . . . . . . . . . . . . . . . . . . . 209

Editing Ticket Information . . . . . . . . . . . . . . . . . . . . . . . . . . 211

Closing Tickets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

Chapter 9 Converting to HA 213

HA Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

HA Terms and Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

Failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

Primary Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

Secondary Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

Virtual IP (vIP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

Virtual Netmask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

HA Reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

Preparing for HA Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216

Pre-Conversion Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216

HA and Distributed LAN Clients . . . . . . . . . . . . . . . . . . . . . . 217

Converting to HA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217

HA Conversion Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

Managing HA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

HA Statuses and Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

Troubleshooting HA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

Chapter 10 StorNext Reports 223

Report Navigation Controls. . . . . . . . . . . . . . . . . . . . . . . . . . 224

StorNext Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

The Jobs Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226

Viewing Detailed Job Information. . . . . . . . . . . . . . . . . . . . . 227

Exiting the Jobs Report screen. . . . . . . . . . . . . . . . . . . . . . . . 228

The File Systems Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

The SAN Devices Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

The Media Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

Quantum StorNext User’s Guide ix

Contents

The Tape Consolidation Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

The SAN and LAN Clients Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

The LAN Client Performance Report. . . . . . . . . . . . . . . . . . . . . . . . . . 237

The Distributed Data Mover Report . . . . . . . . . . . . . . . . . . . . . . . . . . 239

Replication Deduplication Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . 240

Policy Activity Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

Policy Summary Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

Chapter 11 Customer Assistance 247

Quantum Technical Assistance Center . . . . . . . . . . . . . . . . . . . . . . . . 247

Appendix A Operating Guidelines 249

The Reserved Space Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

Linux Configuration File Format . . . . . . . . . . . . . . . . . . . . . . 250

Distributed LAN Server/Client Network and Memory Tuning . . . . . . . 251

Distributed LAN Server and Client Network Tuning. . . . . . . . 251

Distributed LAN Server Memory Tuning . . . . . . . . . . . . . . . . 253

Configuring LDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

Using LDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

UNIX File and Directory Modes . . . . . . . . . . . . . . . . . . . . . . . 255

LDAP Refresh Timeout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255

Setting Up Restrictive ACLs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

Default Single-Path I/O Retry Behavior. . . . . . . . . . . . . . . . . . . . . . . . 256

Event Handles for fsm.exe on a Windows Metadata Server. . . . . . . . 256

FSBlockSize, Metadata Disk Size, and JournalSize Settings . . . . . . . . 257

Disk Naming Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

Changing StorNext’s Default Session Timeout Interval . . . . . . . . . . . 260

General Operating Guidelines and Limitations . . . . . . . . . . . . . . . . . 261

Appendix B Additional Replication and Deduplication Information 277

Replication Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277

x Quantum StorNext User’s Guide

Contents

Replication Terminology and Conventions. . . . . . . . . . . . . . . . . . . . . 278

Copies and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

Replication Target Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

Number of Replication Copies. . . . . . . . . . . . . . . . . . . . . . . . 280

Isolating a Replication Target Directory. . . . . . . . . . . . . . . . . 281

Final Recommendation For Target Directories. . . . . . . . . . . . 282

StorNext snpolicyd Policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

Replication Copies = 2 (Detail) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286

More About Replication Target Directories . . . . . . . . . . . . . . . . . . . . 289

Deduplication Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291

Enabling Deduplication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293

Deduplication Modification Time . . . . . . . . . . . . . . . . . . . . . 293

Deduplication and Blockpools. . . . . . . . . . . . . . . . . . . . . . . . 294

Deduplication and Truncation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294

Enabling Deduplication and Truncation . . . . . . . . . . . . . . . . 295

Storage Manager Truncation . . . . . . . . . . . . . . . . . . . . . . . . 295

Replication, Deduplication and Truncation . . . . . . . . . . . . . . . . . . . . 296

Replication, Deduplication and Storage Manager . . . . . . . . . . . . . . . 297

Replicating into a Storage Manager Relation Point. . . . . . . . 297

Truncation and Deduplication / Replication (with and

without SM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299

The snpolicyd Debug Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306

Appendix C High Availability Systems 309

High Availability Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310

HA Internals: HAmon Timers and the ARB Protocol . . . . . . . . . . . . . . 312

Primary and Secondary Server Status . . . . . . . . . . . . . . . . . . 316

File System Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316

The ha_peer and fsnameservers File. . . . . . . . . . . . . . . . 318

HA Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318

Configuration and Conversion to HA. . . . . . . . . . . . . . . . . . . . . . . . . 323

Conversion to HA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324

SyncHA process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325

Managing High Availability in the StorNext GUI . . . . . . . . . . . . . . . . 327

Quantum StorNext User’s Guide xi

Contents

High Availability Operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329

Windows and Linux SNFS Installations Without the HaShared

File System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

Linux SNMS and SNFS Installations with the HaShared File

System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331

HA Resets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336

HA Resets of the First Kind . . . . . . . . . . . . . . . . . . . . . . . . . . 337

HA Resets of the Second Kind. . . . . . . . . . . . . . . . . . . . . . . . 338

HA Resets of the Third Kind . . . . . . . . . . . . . . . . . . . . . . . . . 338

Using HA Manager Modes . . . . . . . . . . . . . . . . . . . . . . . . . . 338

HA Tracing and Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

Single (Singleton) Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

FSM failover in HA Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . 341

Failover Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341

Replacing an HA System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

Appendix D Web Services API 349

Enabling WS-API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349

WS-API APIs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350

The doCancel API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350

The doMediaMove API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350

The doRetrieve API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

The doStore API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

The doTruncate API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

The getDriveReport API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352

The getFileLocation API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352

The getMediaInfo API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352

The getMediaReport API . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

The getSMQueue API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

The getSNAPIVersion API . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

The getSystemStatus API. . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

The setMediaMoveInfo API . . . . . . . . . . . . . . . . . . . . . . . . . . 354

Appendix E Storage Manager Truncation 355

Truncation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

Normal Truncation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

xii Quantum StorNext User’s Guide

Contents

Immediate Truncation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

Daily Truncation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

Space Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357

LOSPACE Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357

Emergency Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358

Disabling Truncation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359

Truncation Feature Locking. . . . . . . . . . . . . . . . . . . . . . . . . . 359

Disable Truncation Commands . . . . . . . . . . . . . . . . . . . . . . . 360

Common Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

Files Are Not Truncated as Expected . . . . . . . . . . . . . . . . . . . 360

"Old" Files Not Truncating According to Policy Class . . . . . . . 361

Small Files Not Truncating . . . . . . . . . . . . . . . . . . . . . . . . . . 361

Miscellaneous Usage Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361

Appendix F Security 363

StorNext Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

ACLs on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364

ACLs on Mac OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368

“Central Control” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

Cross-Platform Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . 374

Config (.cfg) File Options . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

Appendix G Troubleshooting 377

Troubleshooting StorNext File System. . . . . . . . . . . . . . . . . . 378

Troubleshooting StorNext Storage Manager. . . . . . . . . . . . . 386

Troubleshooting OS Issues . . . . . . . . . . . . . . . . . . . . . . . . . . 388

Troubleshooting Replication . . . . . . . . . . . . . . . . . . . . . . . . . 391

Troubleshooting HA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392

Troubleshooting StorNext Installation and Upgrade Issues. . 396

Troubleshooting Other Issues . . . . . . . . . . . . . . . . . . . . . . . . 397

Appendix H Offline File Notification 401

Installing the Notification Application . . . . . . . . . . . . . . . . . . . . . . . . 402

Installing onto a Standalone Machine. . . . . . . . . . . . . . . . . . 402

Quantum StorNext User’s Guide xiii

Contents

Starting the Notification Application. . . . . . . . . . . . . . . . . . . . . . . . . 408

Configuring the Notification Application. . . . . . . . . . . . . . . . . . . . . . 409

Setting Application Options . . . . . . . . . . . . . . . . . . . . . . . . . 409

Viewing Access Denied Files . . . . . . . . . . . . . . . . . . . . . . . . . 410

Viewing the Application Log. . . . . . . . . . . . . . . . . . . . . . . . . 412

Exiting Application Preferences. . . . . . . . . . . . . . . . . . . . . . . 412

Uninstalling the Notification Application . . . . . . . . . . . . . . . . . . . . . 413

Appendix I RAS Messages 415

Media and Drive RAS Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415

SNFS RAS Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425

Other RAS Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438

xiv Quantum StorNext User’s Guide

Figures

Figure 1 StorNext Login Window . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Figure 2 System Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Figure 3 StorNext Home Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Figure 4 Configuration > Configuration Wizard Welcome Screen . 21

Figure 5 Configuration > Licenses > Agreement Screen . . . . . . . . 24

Figure 6 Configuration > Licenses > Entry Screen . . . . . . . . . . . . . 25

Figure 7 Configuration > Licenses > Entry Screen . . . . . . . . . . . . . 26

Figure 8 Name Servers Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Figure 9 Configuration > File System Screen . . . . . . . . . . . . . . . . . 35

Figure 10 Configuration > File System > New Screen . . . . . . . . . . . 35

Figure 11 Configuration > File System > New Screen 2. . . . . . . . . . 36

Figure 12 Configuration > File System > New Screen 3. . . . . . . . . . 38

Figure 13 Configuration > File System > New Screen 3. . . . . . . . . . 39

Figure 14 Storage Destinations > Library Screen . . . . . . . . . . . . . . . 41

Figure 15 Storage Destinations > Library > New Screen. . . . . . . . . 42

Figure 16 Library Details Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Figure 17 Edit Library Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Quantum StorNext User’s Guide xv

Figures

Figure 18 Configuration > Storage Destinations > Storage Disk

Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47

Figure 19 Storage Destinations > Storage Disk > New Screen. . . . . 48

Figure 20 View Storage Disk Screen . . . . . . . . . . . . . . . . . . . . . . . . . 49

Figure 21 Configuration > Storage Destinations > Replication /

Deduplication Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Figure 22 Configuration > Storage Destinations > Replication /

Deduplication Screen (Blockpool) . . . . . . . . . . . . . . . . . . . 53

Figure 23 Configuration > Storage Policies Screen . . . . . . . . . . . . . 55

Figure 24 Storage Policies > New Screen . . . . . . . . . . . . . . . . . . . . . 56

Figure 25 Storage Policies > New > General Tab. . . . . . . . . . . . . . . 57

Figure 26 Storage Policies > New > Relocation Tab . . . . . . . . . . . . 58

Figure 27 Storage Policies > New > Steering Tab . . . . . . . . . . . . . . 59

Figure 28 Storage Policies > New > Schedule Tab. . . . . . . . . . . . . . 60

Figure 29 Storage Policies > New > Associated Directories Tab. . . . 61

Figure 30 View Storage Policies Screen . . . . . . . . . . . . . . . . . . . . . . 62

Figure 31 Configuration > Email Server Screen . . . . . . . . . . . . . . . . 64

Figure 32 Configuration > Email Notifications Screen . . . . . . . . . . . 65

Figure 33 Configuration > Email Notifications New Screen . . . . . . . 66

Figure 34 Configuration > Configuration Wizard Done Screen . . . . 68

Figure 35 Label Disks Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Figure 36 Check File System Screen . . . . . . . . . . . . . . . . . . . . . . . . . 73

Figure 37 Check File System Report . . . . . . . . . . . . . . . . . . . . . . . . . 74

Figure 38 Affinities Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Figure 39 New Affinity Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Figure 40 Migrate Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Figure 41 Truncation Parameters Screen . . . . . . . . . . . . . . . . . . . . . 81

Figure 42 Storage Components Screen . . . . . . . . . . . . . . . . . . . . . . 84

Figure 43 Drive Pools Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Figure 44 New Drive Pool Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

xvi Quantum StorNext User’s Guide

Figures

Figure 45 Media Actions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Figure 46 Storage Exclusions Screen. . . . . . . . . . . . . . . . . . . . . . . . . 99

Figure 47 Exclusion Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Figure 48 Truncation Exclusions Screen . . . . . . . . . . . . . . . . . . . . . 103

Figure 49 Exclusion Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Figure 50 Tape Consolidation Screen . . . . . . . . . . . . . . . . . . . . . . . 106

Figure 51 Library Operator Interface Screen . . . . . . . . . . . . . . . . . . 109

Figure 52 Software Requests Screen. . . . . . . . . . . . . . . . . . . . . . . . 110

Figure 53 Scheduler Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Figure 54 Scheduler > New Screen . . . . . . . . . . . . . . . . . . . . . . . . 113

Figure 55 Alternate Retrieval Location Screen . . . . . . . . . . . . . . . . 116

Figure 56 Configuration > Distributed Data Mover Screen . . . . . . 122

Figure 57 DDM Screen New Host . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Figure 58 Replication Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Figure 59 Replication scenario 1. . . . . . . . . . . . . . . . . . . . . . . . . . . 137

Figure 60 Replication Scenario 2 . . . . . . . . . . . . . . . . . . . . . . . . . . 138

Figure 61 Replication Scenario 3 . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Figure 62 Replicating From One Source to Multiple Targets. . . . . . 141

Figure 63 Replicating From Multiple Sources to One Target. . . . . . 142

Figure 64 Non-Supported Replication From Source to Target . . . . 143

Figure 65 Configuration > File System > New Screen . . . . . . . . . . 145

Figure 66 Configuration > File System > New Screen 2. . . . . . . . . 146

Figure 67 Configuration > File System > New Screen 3. . . . . . . . . 147

Figure 68 Configuration > Storage Destinations > Deduplication

Screen (Blockpool) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

Figure 69 Storage Destinations > Replication Targets Screen . . . . 149

Figure 70 Configuration > Storage Policies > New Screen . . . . . . 151

Figure 71 Configuration > Storage Policies > New / Source Directories

Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

Figure 72 Storage Policies > New > Outbound Replication Tab . . 153

Quantum StorNext User’s Guide xvii

Figures

Figure 73 Outbound Replication Tab > Replication Schedule. . . . . 154

Figure 74 Configuration > Storage Policies Screen (Select

“target”). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

Figure 75 Storage Policies > Edit > target > Inbound Replication

Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Figure 76 Configuration > Storage Policies (Run Policy). . . . . . . . . 157

Figure 77 Storage Policies > New > Blackout Tab . . . . . . . . . . . . . 158

Figure 78 Tools > HA Convert Screen. . . . . . . . . . . . . . . . . . . . . . . 160

Figure 79 Tools > Replication > Bandwidth Screen . . . . . . . . . . . . 162

Figure 80 Tools > Replication/Deduplication > Administration

Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

Figure 81 Deduplication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Figure 82 Replication/Deduplication Policy Screen . . . . . . . . . . . . . 170

Figure 83 User Accounts Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

Figure 84 New User Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

Figure 85 Edit User Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

Figure 86 Edit User Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178

Figure 87 Edit Admin Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

Figure 88 Client Download Screen . . . . . . . . . . . . . . . . . . . . . . . . . 181

Figure 89 Client Download Link . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

Figure 90 System Control Screen . . . . . . . . . . . . . . . . . . . . . . . . . . 183

Figure 91 File and Directory Action Screen . . . . . . . . . . . . . . . . . . . 185

Figure 92 Change File Version Screen. . . . . . . . . . . . . . . . . . . . . . . 187

Figure 93 Recover Files Browse Screen . . . . . . . . . . . . . . . . . . . . . . 188

Figure 94 Recover Directories Browse Screen . . . . . . . . . . . . . . . . . 190

Figure 95 Retrieve Files Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

Figure 96 Retrieve Directory Screen . . . . . . . . . . . . . . . . . . . . . . . . 193

Figure 97 Truncate Files Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

Figure 98 Move Files Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Figure 99 Modify File Attributes Screen . . . . . . . . . . . . . . . . . . . . . 196

xviii Quantum StorNext User’s Guide

Figures

Figure 100 View File Info Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Figure 101 Health Check Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

Figure 102 Health Check > View Selected Screen . . . . . . . . . . . . . . 203

Figure 103 Health Check > View History Screen. . . . . . . . . . . . . . . . 204

Figure 104 Capture State Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

Figure 105 Backup Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

Figure 106 Admin Alerts Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

Figure 107 Tickets Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

Figure 108 Tickets > View Ticket Screen . . . . . . . . . . . . . . . . . . . . . 210

Figure 109 Tickets > Edit Ticket Screen . . . . . . . . . . . . . . . . . . . . . . 212

Figure 110 Tools > HA Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

Figure 111 Manage HA Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

Figure 112 Reports > Logs Screen . . . . . . . . . . . . . . . . . . . . . . . . . . 225

Figure 113 Jobs Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226

Figure 114 File Systems Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

Figure 115 SAN Devices Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

Figure 116 Media Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232

Figure 117 Media Information Report . . . . . . . . . . . . . . . . . . . . . . . 234

Figure 118 Tape Consolidation Report . . . . . . . . . . . . . . . . . . . . . . . 235

Figure 119 SAN and LAN Clients Report . . . . . . . . . . . . . . . . . . . . . . 236

Figure 120 LAN Client Performance Report . . . . . . . . . . . . . . . . . . . 238

Figure 121 Distributed Data Mover Report. . . . . . . . . . . . . . . . . . . . 239

Figure 122 Replication/Deduplication Policy Activity Report. . . . . . . 241

Figure 123 Replication/Deduplication Policy Summary Report. . . . . 243

Figure 124 Replication/Deduplication Policy Details Report. . . . . . . 244

Figure 125 Replication/Deduplication Policy Completion Report . . . 245

Figure 126 High Availability Manage Screen . . . . . . . . . . . . . . . . . . 328

Figure 127 FSM Failover in an HA Cluster. . . . . . . . . . . . . . . . . . . . . 342

Figure 128 Run as Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . 403

Quantum StorNext User’s Guide xix

Figures

Figure 129 Logging in to the Administrator Account . . . . . . . . . . . . 403

Figure 130 Installing the .NET Framework . . . . . . . . . . . . . . . . . . . . 404

Figure 131 Offline File Notification Setup Wizard. . . . . . . . . . . . . . . 405

Figure 132 Quantum End User License Agreement . . . . . . . . . . . . . 405

Figure 133 Select Installation Folder . . . . . . . . . . . . . . . . . . . . . . . . 406

Figure 134 Confirm Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407

Figure 135 Installation Complete . . . . . . . . . . . . . . . . . . . . . . . . . . . 407

Figure 136 Manual Start. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408

Figure 137 Application Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409

Figure 138 Access Denied List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411

Figure 139 Application log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

Figure 140 Removing the Application . . . . . . . . . . . . . . . . . . . . . . . 413

Figure 141 Possible Drive/Media Mount Discrepancy RAS . . . . . . . . 416

Figure 142 Tape Drive Alerts RAS part 1 . . . . . . . . . . . . . . . . . . . . . . 417

Figure 143 Tape Drive Alerts RAS part 2 . . . . . . . . . . . . . . . . . . . . . . 418

Figure 144 Tape Drive Alerts RAS part 3 . . . . . . . . . . . . . . . . . . . . . . 419

Figure 145 Drive Reported Drive Error RAS. . . . . . . . . . . . . . . . . . . . 420

Figure 146 Cleaning of Drive Failed RAS. . . . . . . . . . . . . . . . . . . . . . 421

Figure 147 Wrong Firmware Level/Invalid Drive Type RAS . . . . . . . . 422

Figure 148 Tape Drive - Reported Media Error RAS . . . . . . . . . . . . . 423

Figure 149 Cleaning Media Expired RAS . . . . . . . . . . . . . . . . . . . . . . 424

Figure 150 Duplicate Physical Media Found RAS . . . . . . . . . . . . . . . 424

Figure 151 Storage Disk Taken Offline RAS . . . . . . . . . . . . . . . . . . . 425

Figure 152 Configuration Not Supported RAS . . . . . . . . . . . . . . . . . 426

Figure 153 Label Validation Failure RAS . . . . . . . . . . . . . . . . . . . . . . 426

Figure 154 Connection Rejected RAS . . . . . . . . . . . . . . . . . . . . . . . . 427

Figure 155 File System Failover RAS . . . . . . . . . . . . . . . . . . . . . . . . . 427

Figure 156 I/O Error RAS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428

Figure 157 Journaling Error Detected RAS . . . . . . . . . . . . . . . . . . . . 428

xx Quantum StorNext User’s Guide

Figures

Figure 158 SNFS License Required RAS . . . . . . . . . . . . . . . . . . . . . . . 429

Figure 159 SNFS License Failure RAS . . . . . . . . . . . . . . . . . . . . . . . . 429

Figure 160 LUN Mapping Changed RAS . . . . . . . . . . . . . . . . . . . . . . 430

Figure 161 Communication Failure RAS . . . . . . . . . . . . . . . . . . . . . . 430

Figure 162 Metadata Inconsistency Detected RAS . . . . . . . . . . . . . . 431

Figure 163 Bad File System Metadata Dump RAS. . . . . . . . . . . . . . . 431

Figure 164 Metadata Dump Failure RAS. . . . . . . . . . . . . . . . . . . . . . 432

Figure 165 File System or Metadata Capacity Warning RAS . . . . . . . 432

Figure 166 File Processing Failure RAS . . . . . . . . . . . . . . . . . . . . . . . 433

Figure 167 Missing LUNs RAS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433

Figure 168 Disk Space Allocation Failure RAS . . . . . . . . . . . . . . . . . . 434

Figure 169 System Resource Failure RAS . . . . . . . . . . . . . . . . . . . . . 434

Figure 170 Affinity Configuration Violations RAS. . . . . . . . . . . . . . . 435

Figure 171 Quota Limit or Fragmentation Warnings RAS. . . . . . . . . 436

Figure 172 Shutdown Error RAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436

Figure 173 Initialization Failure RAS . . . . . . . . . . . . . . . . . . . . . . . . . 437

Figure 174 SNFS I/O Error RAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437

Figure 175 Port Failure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438

Figure 176 Checksum Error RAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439

Figure 177 Troubleshooting the StorNext Software RAS . . . . . . . . . 440

Figure 178 Software Resource Violations RAS . . . . . . . . . . . . . . . . . 441

Figure 179 Vault Failure RAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442

Figure 180 Robotics - Not Ready RAS . . . . . . . . . . . . . . . . . . . . . . . . 442

Figure 181 Robotics - Move Failure RAS . . . . . . . . . . . . . . . . . . . . . . 443

Figure 182 Robotics - Wrong Firmware Level/Invalid Library Type

RAS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444

Figure 183 Backup Errors RAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445

Figure 184 Invalid Configuration RAS part 1 . . . . . . . . . . . . . . . . . . 446

Figure 185 Invalid Configuration RAS part 2 . . . . . . . . . . . . . . . . . . 447

Quantum StorNext User’s Guide xxi

Figures

xxii Quantum StorNext User’s Guide

Chapter 1

Introduction

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 Guide 1

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 Distributed LAN Client Performance Report. For more information about StorNext reports, see

Chapter 10, StorNext Reports.

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

2 Quantum StorNext User’s Guide

Step 2: Licenses on page 21

Chapter 1: Introduction

Purpose of This Guide

About Licensing Beginning 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 21 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 Guide 3

Chapter 1: Introduction Notes, Cautions, and Warnings

• Chapter 11, Customer Assistance

• Appendix A, Operating Guidelines

• Appendix B, Additional Replication and Deduplication Information

• Appendix C, High Availability Systems

• Appendix D, Web Services API

• Appendix E, Storage Manager Truncation

• Appendix F, Security

• Appendix G, Troubleshooting

• Appendix H, Offline File Notification

• Appendix I, RAS Messages

Notes, Cautions, and Warnings

The following table describes important information about Notes, Cautions, and Warnings used throughout this guide.

Description Definition Consequences

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.

4 Quantum 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.

Conventions Examples

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 <

where <filename> is a

variable and should be replaced with a user-defined value.

filename

Quantum StorNext User’s Guide 5

Chapter 1: Introduction Document Conventions

6 Quantum 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 Guide 7

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.

8 Quantum StorNext User’s Guide

Figure 2 System Control

Chapter 2: StorNext GUI Overview

Accessing the StorNext GUI

5 Click Login. The initial StorNext System Control screen appears.

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.

Quantum StorNext User’s Guide 9

Chapter 2: StorNext GUI Overview The StorNext Home Page

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

• 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.

10 Quantum StorNext User’s Guide

Figure 3 StorNext Home Page

Chapter 2: StorNext GUI Overview

The StorNext Home Page

StorNext Monitors The 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 r i 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.

Quantum StorNext User’s Guide 11

Chapter 2: StorNext GUI Overview The StorNext Home Page

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.

• 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

12 Quantum StorNext User’s Guide

Chapter 2: StorNext GUI Overview

The StorNext Home Page

• 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)

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.)

Quantum StorNext User’s Guide 13

Chapter 2: StorNext GUI Overview The StorNext Home Page

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

• 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

• Client Download: Download StorNext client software

• 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.

14 Quantum StorNext User’s Guide

Chapter 2: StorNext GUI Overview

The StorNext Home Page

• 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

• 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

Quantum StorNext User’s Guide 15

Chapter 2: StorNext GUI Overview The StorNext Home Page

• 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

• 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

16 Quantum StorNext User’s Guide

Chapter 2: StorNext GUI Overview

The StorNext Home Page

• 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.

Quantum StorNext User’s Guide 17

Chapter 2: StorNext GUI Overview The StorNext Home Page

18 Quantum 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 Guide 19

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 8: Email Notification: Add email notifications recipients

• 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.

High Availability Systems

Step 1: Welcome

This chapter contains some instructions that pertain to high availability (HA) systems, but if you plan to convert to HA you should read

Chapter 9, Converting to HA. In particular, be sure to read and follow

the Pre-Conversion Steps on page 216.

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.

20 Quantum StorNext User’s Guide

Figure 4 Configuration > Configuration Wizard Welcome Screen

Chapter 3: The Configuration Wizard

Step 2: Licenses

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 and Archive Conversion. 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.

Quantum StorNext User’s Guide 21

Chapter 3: The Configuration Wizard Step 2: Licenses

Note: On HA systems, auto-generated licenses must be replaced on

both

HA MDCs, and StorNext must be run on the secondary

only for this purpose.

Also, if you manually edit the license.dat file, you must restart StorNext after making changes.

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).

• 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.

22 Quantum StorNext User’s Guide

Chapter 3: The Configuration Wizard

Step 2: Licenses

• Failover (HA): A Failover (High Availability) license is required if you plan to use StorNext's HA failover features.

Note: Both MDCs’ license.dat files are merged into one file

when the conversion to HA is performed in the final Configuration Wizard steps. Be sure to read read

Chapter 9, Converting to HA so you understand this HA-

related step in the Configuration Wizard.

• Maintenance: A Maintenance license verifies that your site has purchased StorNext upgrade licenses, and is required for StorNext upgrades.

• Archive Conversion: An Archive Conversion license is required if you plan to use StorNext’s conversion tool to read and migrate data from non-StorNext archive media into the StorNext file system. (To purchase or configure the Archive Conversion tool, contact your Quantum Sales representative.)

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 Configuration > Licenses > Entry screen to begin using StorNext features.

Quantum StorNext User’s Guide 23

Chapter 3: The Configuration Wizard Step 2: Licenses

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 those 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.

Figure 5 Configuration > Licenses > Agreement Screen

24 Quantum StorNext User’s Guide

Figure 6 Configuration > Licenses > Entry Screen

Chapter 3: The Configuration Wizard

Step 2: Licenses

2 Read the license carefully, and then click Accept. The Configuration

> Licenses > Entry screen appears.

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 Guide 25

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).

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.

26 Quantum StorNext User’s Guide

Chapter 3: The Configuration Wizard

Step 2: Licenses

• The used space includes the size of the header information written to the media with the file. This header contains 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 Guide 27

Chapter 3: The Configuration Wizard Step 2: Licenses

• Maintenance: The date displayed is when your Maintenance license

expires. You cannot upgrade to a version of software whose release date is later than the Maintenance license expiration date. You can, however, upgrade if the release date is

For example, if your maintenance license expires in December, 2010 and a new version of StorNext is released in November 2010, you can upgrade to this new version at any time, even if you don’t get around to upgrading until some time in 2011.

• Archive Conversion: Unlimited

prior

to your expiration date.

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:

, not necessarily

actual capacity

. You can determine the

#snlicense–v<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–v<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.

For more information, see the man pages for both of these commands.

Updating Licenses You 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

28 Quantum StorNext User’s Guide

Chapter 3: The Configuration Wizard

Step 2: Licenses

screen appears, copy the license string you received from Quantum into the [License/Feature Name] License field, and then click Apply.

Licensing and Upgrades The new licensing implementation affects StorNext upgrades, both for

release 4.1 and future releases. Be aware of the following upgraderelated implications and plan accordingly:

• 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.1.

• 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 been installed and therefore you cannot enter licenses through the GUI. This applies to upgrades to StorNext 4.1 and also to future upgrades.

license.dat file because the StorNext GUI has not

• 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.

Quantum StorNext User’s Guide 29

Chapter 3: The Configuration Wizard Step 2: Licenses

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huFeb415:18:142010

MediaIDFillLevelWastedSpace

‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐ 00009910.000.00 00009830.005.00 00009670.9944.98 0000950.1299.65

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.

Manually Editing the license.dat File

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.

If you choose to manually edit the license.dat file instead of using the StorNext GUI, in order to reflect any manual changes to the license.dat file you must navigate to the license page in the StorNext GUI. Doing so will ‘re-read’ the license file and allow access to previously disabled sections. If changes are not recognized and the licenses are not updated immediately, click the Refresh button.

30 Quantum StorNext User’s Guide

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. 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.

Chapter 3: The Configuration Wizard

Step 3: Name Servers

Multiple fsnameserver Hosts

You should be aware that having multiple hosts in the fsnameservers file could have performance implications, possibly severe.

To help you weigh the benefits versus disadvantages of having multiple name server hosts, here are some points to consider:

• Metadata controllers needn’t be name servers.

• Name servers needn’t be MDCs.

• Each additional fsnameserver entry adds additional heartbeats from every file system host.

• If multiple metadata networks service an individual file system, each network must have an

fsnameserver interface. Each

fsnameserver host must have network interface(s) on every

metadata network, and each interface must be listed in the

fsnameserver file.

Quantum StorNext User’s Guide 31

Chapter 3: The Configuration Wizard Step 3: Name Servers

• Every host attempts to heartbeat every fsnameserver entry twice per second. Each heartbeat is limited to 32kB. This can add substantial traffic to a network.

•Each fsnameserver sends one reply to every host twice/second.

Calculating Network Requirements

The following example may help you understand how to calculate computing requirements for multiple name servers.

1 Every client sends a packet (<= 32kB) to every name server address,

twice per second, regardless of whether the fsnameserver is up or not. That is, total heartbeat traffic <= # of clients * # of name servers * 2 heartbeat-packets/sec * 32kB/packet. The size of the packet is determined by the number of file systems, the number of local FSMs, and so on.

For example, if the name servers are the FSMs, a simple network of 2 name servers, 2 FSMs, and six additional clients will heartbeat traffic of up to 8 hosts * 2 reply packets/sec * 32kB = 512kB/sec = 1/2 MB/sec = 4Mb/sec.

2 Every running name server sends a reply packet to every client host,

twice per second. In the example above, the heartbeat reply packet count will be identical to the heartbeat traffic: 8 hosts * 2 replies/sec * 2 fsnameservers = 32kB/sec <= 512kB/sec = 4 Mb/sec.

In this example, total heartbeat traffic is no more than 1MB/sec or 8Mb/ sec. In a more complicated example, these numbers can grow substantially. Picking a configuration with two dedicated name servers and three metadata networks, the

fsnameservers file will have six

entries: two name servers, each with three network interfaces. If there are 48 client and server hosts (plus the two dedicated name servers), then:

Heartbeat traffic <= 6 name server addresses * 50 clients * 2 heartbeat packets/sec * 32kB = 19.2 MB/sec = 153.6 Mb/sec. Reply traffic is somewhat less, 2 name servers * 50 clients * 2 reply packets/sec * 32kB = 6.4 MB/sec = 51.2 Mb/sec.

This comes to a total of 25.6MB/sec or 204.8 Mb/sec, which should be divided evenly between the name servers, and will be divided in some fashion between the three networks and six name server interfaces, depending on host/network connectivity.

32 Quantum StorNext User’s Guide

As a general rule, Quantum recommends having no more than two fsnameservers without first computing total traffic.

Entering Name Servers Follow these steps to add a name server:

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.)

Figure 8 Name Servers Screen

Chapter 3: The Configuration Wizard

Step 3: Name Servers

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.

5 After you click Yes, a message informs you that Name Servers has

been updated. Click OK to continue.

Quantum StorNext User’s Guide 33

Chapter 3: The Configuration Wizard Step 4: File Systems

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 Server To delete a name server, select the name server you want to delete and

then click Delete. Finalize the deletion by clicking Apply.

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 69.

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 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.

34 Quantum StorNext User’s Guide

File System Tasks on

Figure 9 Configuration > File System Screen

Chapter 3: The Configuration Wizard

Step 4: File Systems

2 Click New to add a new file system. The Configuration > File Systems

> New Screen appears.

Figure 10 Configuration > File System > New Screen

Quantum StorNext User’s Guide 35

Chapter 3: The Configuration Wizard Step 4: File Systems

Figure 11 Configuration > File System > New Screen 2

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.

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.

This value helps StorNext calculate capacity. You should select the option that most closely corresponds to your projected usage. You are not limited by the option you select. For example, if you indicate

36 Quantum StorNext User’s Guide

Chapter 3: The Configuration Wizard

Step 4: File Systems

that there will typically be fewer than 10 files per directory, there is nothing to prevent the directory from containing more than 10 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 Guide 37

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 mounts 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.)

38 Quantum StorNext User’s Guide

Figure 13 Configuration > File System > New Screen 3

Chapter 3: The Configuration Wizard

Step 4: File Systems

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.

Editing a File System and Performing Other

Once you have created a file system, you have the option of editing the file system or performing one of the following actions:

Actions

Stop or start the file system Update the file system

Start and activate the file system Perform a metadata dump for the file system

Start and mount the file system Check the file system

Quantum StorNext User’s Guide 39

Chapter 3: The Configuration Wizard Step 5: Storage Destinations

Activate the file system Expand the file system

Note: StorNext does not support expansion on

stripe groups containing mixed-sized LUNs. For example, if you create a file system that has two different-sized disks in a userdata only stripe group and then attempt to add a new disk to that stripe group and expand it, the expansion will fail.

Mount or unmount the file system Migrate the file system

Make the file system

Refer to the StorNext online help for instruction on editing a file system or performing one of the available actions.

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.

Adding a New Library Follow 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.)

40 Quantum StorNext User’s Guide

Figure 14 Storage Destinations > Library Screen

Chapter 3: The Configuration Wizard

Step 5: Storage Destinations

2 If necessary, click the Library tab. The Configuration > Storage

Destinations > Library Screen

appears.

Quantum StorNext User’s Guide 41

Chapter 3: The Configuration Wizard Step 5: Storage Destinations

Figure 15 Storage Destinations > Library > New Screen

3 Click New. The Configuration > Storage Destinations > Library > New

Screen

appears.

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.

42 Quantum StorNext User’s Guide

Chapter 3: The Configuration Wizard

Step 5: Storage Destinations

Viewing an Existing Library

Figure 16 Library Details Screen

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.

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

Quantum StorNext User’s Guide 43

Chapter 3: The Configuration Wizard Step 5: Storage Destinations

• EIF Port Config: The current EIF port configuration. EIF stands

for Enterprise Instrumentation Framework, and it helps StorNext process data from applications on the server.

• 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.

Editing a Library Follow 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

44 Quantum StorNext User’s Guide

Chapter 3: The Configuration Wizard

Step 5: Storage Destinations

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.

Deleting a Library Follow 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

Quantum StorNext User’s Guide 45

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 periodic audits on the library to ensure synchronization.

•Remap-Audit: This option synchronizes the StorNext databases with the library databases.

• Online: Select this option to set the library online.

Chapter 3: The Configuration Wizard Step 5: Storage Destinations

• Offline: Select this option to take the library offline.

• Drives Online: Select this option to place the drives in the library online.

• Drives Offline: Select this option to take the drives in the library offline.

• 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.

Storage Disk Overview Storage 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:

• 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

46 Quantum StorNext User’s Guide

Chapter 3: The Configuration Wizard

Step 5: Storage Destinations

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 47.)

Caution: Storage disks can be an important and integral part of your

system, but you should NEVER rely solely on storage disks as your only backup location.

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.

Quantum StorNext User’s Guide 47

Chapter 3: The Configuration Wizard Step 5: Storage Destinations

Figure 19 Storage Destinations > Storage Disk > New Screen

2 Click New. The Storage Destinations > Storage Disk > New

Screen appears.

3 Enter the fields on the screen. (For detailed information about what

to enter on this screen, see the online help.)

4 Click Apply.

5 Repeat steps 2 - 4 to add additional storage disks.

Viewing an Existing Storage Disks

Follow this procedure to view a list of previously configured storage disks.

1 Choose Storage Destinations from the Configuration menu.

2 Click the Storage Disk tab. Any previously configured storage disks

are displayed. (See

Figure 18 on page 47.)

3 Select the storage disk whose information you want to view.

48 Quantum StorNext User’s Guide

Figure 20 View Storage Disk Screen

Chapter 3: The Configuration Wizard

Step 5: Storage Destinations

4 Click View.

5 When you are finished viewing library information, click Done.

Editing a Storage Disk Follow this procedure to edit a currently configured storage disk.

1 If you have not already done so, choose Storage Destinations from

the Configuration menu and then click the Storage Disk tab.

2 Select the storage disk whose information you want to edit.

3 Click Edit.

4 Modify any of the fields you entered when creating the storage disk.

(For field information, see the online help or the descriptions in

Adding a New Storage Disk on page 47.)

5 Click Apply.

6 When a confirmation message appears, click Yes to proceed, or No

to abort.

7 After a message informs you that the storage disk was successfully

modified, click OK.

Quantum StorNext User’s Guide 49

Chapter 3: The Configuration Wizard Step 5: Storage Destinations

Deleting a Storage Disk Follow this procedure to delete a currently configured storage disk.

1 If you have not already done so, choose Storage Destinations from

the Configuration menu and then click the Storage Disk tab.

2 Select the storage disk you want to delete.

3 Click Delete.

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 storage disk was successfully

deleted, click OK.

Caution: Before deleting a storage disk, make sure the policies that

refer to the storage disk (as well as the file systems that use the storage disk for backup storage) have been safely backed up and configured or updated to not use the storage disk you want to delete.

Adding a New Data Replication Host

50 Quantum StorNext User’s Guide

The following procedure describes how to add a new replication target host. (For more information about the replication feature, see

Chapter 6, Replication and Deduplication and Appendix B, Additional Replication and Deduplication Information.)

1 Click the Replication Targets tab. The Configuration > Storage

Destinations > Replication / Deduplication Screen appears.

Figure 21 Configuration > Storage Destinations > Replication / Deduplication Screen

Chapter 3: The Configuration Wizard

Step 5: Storage Destinations

2 Click Add Host.

3 Enter the fields in the New Target section. (For detailed information

about what to enter on this screen, see the online help.)

4 Click Add to add the new replication target, or Cancel to abort

without saving.

5 Click Apply to save your changes.

6 Repeat steps 3 - 6 to add more targets.

7 After a message informs you that the target was successfully added,

click OK.

Editing a Data Replication Host

Follow this procedure to edit an existing data replication target.

1 If you have not already done so, click the Replication Targets tab.

2 If necessary, click the plus sign (+) beside the Replication Targets

heading in the box titled Replication Target Configuration.

3 Select the replication target you want to edit.

4 Click Edit.

Quantum StorNext User’s Guide 51

Chapter 3: The Configuration Wizard Step 5: Storage Destinations

5 At the Hostname or IP field, modify either the host name or IP

address for the replication target.

6 Click Update to save your changes, or Cancel to abort.

Deleting a Data Replication Target

Adding a New Mount Point

Follow this procedure to delete a replication target.

1 If you have not already done so, choose click the Replication

Ta rg et s tab.

2 If necessary, click the plus sign (+) beside the Replication Targets

heading in the box titled Replication Target Configuration.

3 Select the replication target you want to delete.

4 Click Delete.

Caution: There is no confirmation message for this delete function,

so make absolutely certain you want to delete the replication target before you click Delete.

Follow this procedure to add a new mount point to a replication target.

1 If you have not already done so, choose Storage Destinations on

the left side of the screen. (Alternatively, choose Storage

Destinations from the Configuration menu.)

2 Click the Replication Targets tab.

3 Select the replication target (host) to which you would like to add a

mount point. (You might need to click the dash to the left of the

Replication Targets heading to display the available hosts.)

4 Click Add Mount Point.

5 Click Scan Host to identify available mount points on the selected

host.

6 At the Mount Point field, select a mount point and then click Add.

7 Repeat steps 3 - 6 to add additional mount points.

8 Click Apply to save the changes.

52 Quantum StorNext User’s Guide

Chapter 3: The Configuration Wizard

Step 5: Storage Destinations

9 After a message informs you that changes were successfully

incorporated click OK.

Enabling Data Deduplication

Figure 22 Configuration > Storage Destinations > Replication / Deduplication Screen (Blockpool)

The Deduplication tab enables you to create a blockpool on a specified file system. (For more information about the deduplication feature, see

Chapter 6, Replication and Deduplication and Appendix B, Additional Replication and Deduplication Information.)

To create the blockpool, select the desired file system from the dropdown list next to the Blockpool File System label, and then click

Apply.

Note: The blockpool should not be placed on a file system that will be

used as the HA shared file system. This is a requirement even if you do not plan to use the StorNext Deduplication feature.

Quantum StorNext User’s Guide 53

Chapter 3: The Configuration Wizard Step 6: Storage Policies

Step 6: Storage Policies

There are two kinds of storage policies: Storage Manager storage polices and Replication/Deduplication storage policies. Replication/ Deduplication storage policies control the way StorNext’s replication and deduplication features behave. (For more information about the replication and deduplication features, see

Deduplication and Appendix B, Additional Replication and Deduplication Information.)

A Storage Manager storage policy defines how files will be managed in a directory and subdirectories. Specifically, these are the available Storage Manager 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

Chapter 6, Replication and

• 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.

Note: The connection between a storage policy and a directory is

called the relation point.

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 LTO 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.

54 Quantum StorNext User’s Guide

Chapter 3: The Configuration Wizard

Step 6: Storage Policies

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 Policy

Figure 23 Configuration > Storage Policies Screen

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.

2 Click New. The Storage Policies > New Screen appears.

Quantum StorNext User’s Guide 55

Chapter 3: The Configuration Wizard Step 6: Storage Policies

Figure 24 Storage Policies > New Screen

3 Enter the following fields:

• Policy Name: The name of the new policy you are creating

• 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.

56 Quantum StorNext User’s Guide

Figure 25 Storage Policies > New > General Tab

Chapter 3: The Configuration Wizard

Step 6: Storage Policies

For instructions on what to enter on this screen, see the online help.

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.

Quantum StorNext User’s Guide 57

Chapter 3: The Configuration Wizard Step 6: Storage Policies

Figure 26 Storage Policies > New > Relocation Tab

For instructions on what to enter on this screen, see the online help.

The Steering Tab

The Steering tab enables you to configure to direct a copy of a file to a designated drive pool. This is normally used when you want to direct two or more copies of a file to different archives by putting the tape drive in separate pools and then setting the copy number of the file to go to that pool. You can also use this feature to route your copies of the file to different media types, including storage disks.

58 Quantum StorNext User’s Guide

file steering

, which allows you

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. (Scheduled events are certain activities which you can set up to run at specified times using StorNext’s schedule. For more information, see

Scheduler on page 111.)

Quantum StorNext User’s Guide 59

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.

60 Quantum 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 Policy

Viewing a Storage Policy

The steps for creating a replication storage policy are described in Step

4: Create a Replication Storage Policy on page 150.

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 Guide 61

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 Policy To 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.

62 Quantum 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 Guide 63

Chapter 3: The Configuration Wizard Step 8: Email Notification

Adding an Email Server Follow 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.

64 Quantum 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

Adding an

Email Server on page 64.

Adding an Email Recipient

Figure 32 Configuration > Email Notifications Screen

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.

Quantum StorNext User’s Guide 65

Chapter 3: The Configuration Wizard Step 8: Email Notification

Figure 33 Configuration > Email Notifications New Screen

3 Click New. The Configuration > Email Notifications > New screen

appears.

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.)

66 Quantum StorNext User’s Guide

Chapter 3: The Configuration Wizard

Step 8: Email Notification

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.

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.

Quantum StorNext User’s Guide 67

Chapter 3: The Configuration Wizard Step 9: Done

Step 9: Done

Figure 34 Configuration > Configuration Wizard Done 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 217.

68 Quantum 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 34, 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 Guide 69

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.)

• VTOC labels were used for all operating systems in previous StorNext and Xsan releases, and are still required for Solaris releases prior to Solaris 10 Update 2, and LUNs less than 1TB.

Labeling a Device Follow 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.

70 Quantum 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 Guide 71

Chapter 4: File System Tasks Check File System

Unlabeling a Device Follow 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.

For more information about file system expansion, refer to the StorNext online help.

72 Quantum StorNext User’s Guide

Figure 36 Check File System Screen

Chapter 4: File System Tasks

Check File System

Use the following procedure to perform a file system check.

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 Guide 73

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.

File System Check Output Files

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‐

02_22_2010‐12_15_19

• /usr/adic/gui/logs/jobs/CHECK_FS‐<timestamp>‐<jobid>

For example:/usr/adic/gui/logs/jobs/CHECK_FS‐

20100222_121519‐77

74 Quantum StorNext User’s Guide

Affinities

Chapter 4: File System Tasks

Affinities

This section describes StorNext’s “stripe group affinity” feature, and also provides some common use cases.

stripe group

which data is striped. Each stripe group also has a number of associated attributes, including affinity and exclusivity.

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.

is a collection of LUNs (typically disks or arrays) across

is used to steer the allocation of a file’s data onto a set of

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.

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 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.

means a stripe group has both an affinity and the exclusive

StripeGroup section, Quantum

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

Quantum StorNext User’s Guide 75

Chapter 4: File System Tasks Affinities

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 Cases Affinities 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.)

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.)

76 Quantum StorNext User’s Guide

• 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 Affinity Follow this procedure to add affinities:

1 Choose Affinities from the Tools > File Systems menu. The To o l s >

File Systems > Affinities screen appears.

Figure 38 Affinities Screen

Chapter 4: File System Tasks

Affinities

Quantum StorNext User’s Guide 77

Chapter 4: File System Tasks Affinities

Figure 39 New Affinity Screen

2 Click New. The New Affinity screen appears.

3 At the Affinity field, enter the name of the new affinity.

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 Affinity Follow 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.

78 Quantum StorNext User’s Guide

Quantum STORNEXT 4.1 User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Contents

Figures

Introduction

About StorNext File System

About StorNext Storage Manager

About Distributed LAN Clients

Purpose of This Guide

About Licensing Beginning with StorNext 4.0, licensing has changed significantly

How This Guide is Organized

Notes, Cautions, and Warnings

Document Conventions

StorNext GUI Overview

Accessing the StorNext GUI

The StorNext Home Page

StorNext Monitors The StorNext Home Page displays the following status and capacity

File Systems Capacity Monitor

Libraries Capacity Monitor

Storage Disks Capacity Monitor

Tape Drive Status

Policy Capacity Monitor

StorNext Home Page Dropdown Menus

The Configuration Menu

The Tools Menu

The Service Menu

The Reports Menu

The Help Menu

The Configuration Wizard

High Availability Systems

Step 1: Welcome

Step 2: Licenses

License Expiration and Limits

Determining License Capacity

Updating Licenses You will need to update a license if the license expires or if your

Licensing and Upgrades The new licensing implementation affects StorNext upgrades, both for

Manually Editing the license.dat File

Step 3: Name Servers

Multiple fsnameserver Hosts

Calculating Network Requirements

Entering Name Servers Follow these steps to add a name server:

Deleting a Name Server To delete a name server, select the name server you want to delete and

Step 4: File Systems

Manual Configuration

Step 5: Storage Destinations

Adding a New Library Follow this procedure to add a new library:

Viewing an Existing Library

Editing a Library Follow this procedure to edit parameters for an existing library:

Deleting a Library Follow this procedure to delete an existing library:

Performing Other Library Actions

Storage Disk Overview Storage disks are external devices on UNIX-based file systems that can

Adding a New Storage Disk

Viewing an Existing Storage Disks

Editing a Storage Disk Follow this procedure to edit a currently configured storage disk.

Deleting a Storage Disk Follow this procedure to delete a currently configured storage disk.

Adding a New Data Replication Host

Editing a Data Replication Host

Deleting a Data Replication Target

Adding a New Mount Point

Enabling Data Deduplication

Step 6: Storage Policies

Adding a Storage Manager Storage Policy

The General Tab

The Relocation Tab

The Steering Tab

The Schedule Tab

The Associated Directories Tab

Adding a Replication Storage Policy

Viewing a Storage Policy

Running a Storage Policy

Editing a Storage Policy To edit an existing storage policy:

Step 7: Email Server

Deleting a Storage Policy

Adding an Email Server Follow this procedure to add a new email server.

Step 8: Email Notification

Adding an Email Recipient

Viewing Email Recipient Information

Editing an Email Recipient