6-01658-05 User's Guide User's Guide User's Guide User's Guide User's Guide StorNext® 3.
StorNext User’s Guide, 6-01658-05, Ver. A, Rel. 3.5, December 2008, Made in USA. Quantum Corporation provides this publication “as is” without warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability or fitness for a particular purpose. Quantum Corporation may revise this publication from time to time without notice. COPYRIGHT STATEMENT © Copyright 2000 - 2008 Quantum Corporation. All rights reserved. US Patent No: 5,990,810 applies.
Contents Chapter 1 Introduction 1 About StorNext File System ..................................................................... 1 About StorNext Storage Manager ........................................................... 1 About Distributed LAN Clients .............................................................. 2 Purpose of This Guide ...................................................................................... 3 How This Guide is Organized ................................................
The SNSM Home Page ..............................................................23 SNSM Home Page Drop-Down Menus ..................................23 The Configuration Wizard ...............................................................26 Chapter 3 SNFS-Only GUI Overview 29 Accessing the SNFS GUI ..................................................................29 The SNFS Home Page .......................................................................31 The File System Monitor ....................
Chapter 5 Backing Up StorNext 76 Types of StorNext Software Backups ........................................................... 76 Setting up Email Notification For Backup ........................................... 77 Performing a StorNext Software Backup .................................................... 78 Managing the Backup Policy ......................................................................... 79 Chapter 6 Managing the File System 82 Working With File Systems ........................
Retrieving a File .......................................................................140 Retrieving a Directory .............................................................141 Freeing Disk Blocks .................................................................142 Moving Files to New Media ...................................................144 Modifying a File’s Attributes .................................................145 Understanding Dynamic Resource Allocation ...........................
Adding a Drive Pool .............................................................................. 200 Modifying a Drive Pool ........................................................................ 202 Deleting a Drive Pool ............................................................................ 204 Managing Disk Space ................................................................................... 205 Changing Watermark Parameters ..............................................................
Adding a Storage Policy .................................................................253 Adding a Policy Class Through SNSM Without a Relation Point ....................................................................................260 Adding a Relation Point to a Policy Class ............................265 Modifying a Policy Class ...............................................................267 Deleting a Policy Class ...................................................................
Chapter 14 Customer Assistance 322 Quantum Technical Assistance Center ...................................................... 322 Appendix A Operating Guidelines 327 The Reserved Space Parameter ................................................................... 327 Distributed LAN Server/Client Network and Memory Tuning ........... 329 Distributed LAN Server and Client Network Tuning ..................... 329 Distributed LAN Server Memory Tuning ..........................................
Manual Disk-to-Disk Relocation ...........................................365 Enabling Stub File Support ............................................................366 Managing Storage Disks with Deduplication Enabled .............367 Adding a Dedup Sdisk ............................................................367 Modifying a Dedup Sdisk .......................................................367 Deleting a Dedup Sdisk ..........................................................
Figures StorNext User’s Guide Figure 1 StorNext Login Window ............................................................. 7 Figure 2 StorNext Home Page ................................................................... 8 Figure 3 File System Monitor................................................................... 10 Figure 4 Library Monitor .......................................................................... 11 Figure 5 Storage Disk Monitor...............................................
x Figure 18 Complete Start/Stop SNFS Screen.............................37 Figure 19 SNFS Configuration Wizard Screen ..........................38 Figure 20 Enter License Introduction Screen .............................42 Figure 21 Quantum License Agreement.....................................43 Figure 22 Enter License Strings Screen .......................................44 Figure 23 Complete Enter License Screen (Temporary)...........45 Figure 24 License Reminder ...........................
StorNext User’s Guide Figure 47 Backup Policy Screen ................................................................. 80 Figure 48 File System - Introduction Screen ............................................ 83 Figure 49 Add New File System Screen ................................................... 84 Figure 50 Directory Browser Window...................................................... 85 Figure 51 Select Directory Window ..........................................................
Figure 76 Exclusive Stripe Group Screen .................................126 Figure 77 Complete Add Affinity Task Screen........................127 Figure 78 Add, Modify, or Delete Affinities Screen................128 Figure 79 Add Affinity Screen ...................................................128 Figure 80 Set Affinity Screen ......................................................130 Figure 81 Set Affinity Screen ......................................................
Figure 105 Move Options Screen............................................................... 161 Figure 106 Data Stripe Group Move Screen............................................. 162 Figure 107 No Writable Stripe Groups Warning.................................... 162 Figure 108 Destination Stripe Group Too Small Warning..................... 163 Figure 109 Metadata Stripe Group Message............................................ 163 Figure 110 Metadata/Journal Move Screen .............................
Figure 134 Match Devices with Slots Screen..............................194 Figure 135 Tape Drive Mapping Help Screen ...........................195 Figure 136 Configure Drives Screen............................................196 Figure 137 Modify Drive Screen ..................................................197 Figure 138 Delete Warning Window ..........................................198 Figure 139 Change Drive State Screen ........................................198 Figure 140 Clean Drive Screen ......
Figure 163 Select Destination Library Screen .......................................... 223 Figure 164 Library Operator Interface Screen ......................................... 224 Figure 165 LOI Enter Screen....................................................................... 225 Figure 166 Manually Move Media Screen................................................ 227 Figure 167 Media Browser Screen ............................................................. 227 Figure 168 Mount Media Screen ........
Figure 192 Complete Storage Policy Task Screen .....................260 Figure 193 Manage Policy Classes Screen ..................................261 Figure 194 Add Policy Class Screen ............................................261 Figure 195 Modify Parameters Screen ........................................262 Figure 196 Manage Policy Class Relationships Screen.............265 Figure 197 Add Relationship Screen ...........................................266 Figure 198 Directory Browser Window..............
Figure 220 Storage Disk Report Screen..................................................... 297 Figure 221 Storage Disk Information Report ........................................... 298 Figure 222 Affinities Report Screen........................................................... 299 Figure 223 Directory Browser Screen........................................................ 300 Figure 224 Directory Affinity Report ........................................................
xviii Figure 7 Cleaning of Drive Failed RAS...................................383 Figure 8 Wrong Firmware Level/Invalid Drive Type RAS 383 Figure 9 Drive Removed RAS ..................................................384 Figure 10 Tape Drive -Configuration Failed RAS...................384 Figure 11 Tape Drive - Reported Media Error RAS................385 Figure 12 Cleaning Media Expired RAS...................................385 Figure 13 No Cleaning Media Available RAS .........................
StorNext User’s Guide Figure 36 Disk Space Allocation Failure RAS........................................ 399 Figure 37 System Resource Failure RAS................................................. 399 Figure 38 Affinity Configuration Violations RAS................................. 400 Figure 39 Quota Limit or Fragmentation Warnings RAS .................... 401 Figure 40 Shutdown Error RAS ............................................................... 401 Figure 41 Initialization Failure RAS ...
xx StorNext User’s Guide
Chapter 1 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.
Chapter 1 Introduction 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. About Distributed LAN Clients 1 StorNext supports distributed LAN clients.
Chapter 1 Introduction Purpose of This Guide 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.
Chapter 1 Introduction Notes, Cautions, and Warnings • Appendix C, Using The Command Line Interface • Appendix D, RAS Messages Notes, Cautions, and Warnings The following table describes important information about Notes, Cautions, and Warnings used throughout this guide. StorNext User’s Guide Description Definition Consequences Note: Indicates important information that helps you make better use of the software. No hazardous or damaging consequences.
Chapter 1 Introduction Document Conventions Document Conventions This guide uses the following document conventions to help you recognize different types of information. StorNext User’s Guide Conventions Examples For all UNIX-based commands, the # prompt is implied, although it is not shown. TSM_control stop is the same as # TSM_control stop For all UNIX-based commands, words in italic are variables and should be replaced with user-defined values.
an Chapter 2 StorNext GUI Overview 2 This section describes how to access and navigate through the StorNext GUI, which includes both SNFS and SNSM. If you purchased SNFS only, refer to SNFS-Only GUI Overview. This chapter includes the following topics: • Accessing the StorNext GUI • The StorNext Home Page • The SNFS and SNSM Home Pages • The Configuration Wizard Note: StorNext supports internationalization for the name space of the file system. This support is fully UTF-8 compliant.
Chapter 2 StorNext GUI Overview Accessing the StorNext GUI Use this procedure to access the StorNext GUI. 1 Open a Web browser. StorNext-supported browsers are: • Internet Explorer 5.5, 6 and 7 • Netscape 7.x • Mozilla 1.0 and later • FireFox 1.5 and later or 2.0 and later To ensure proper browser operation, all monitors must be set to display at a minimum resolution of 1073 x 768.
Chapter 2 StorNext GUI Overview Accessing the StorNext GUI The following illustration shows the main components of the StorNext Home Page.
Chapter 2 StorNext GUI Overview The StorNext Home Page The StorNext Home Page On the home page you will find the following: • Link to the Quantum Home Page - Click the link for information about Quantum • System Monitors • StorNext Home Page Drop-Down Menus • StorNext System Status • StorNext Admin Alerts • StorNext Server Status • Home and Help Links • Application Link System Monitors 2 The StorNext Home Page displays three system monitors that are used to monitor the state of the StorNext system: • Th
Chapter 2 StorNext GUI Overview The StorNext Home Page • 10 minutes 2 The File System Monitor The File System Monitor enables you to view statistics on each configured file system. When you open a browser to access StorNext, the File System Monitor appears at the top of the browser window. Figure 3 File System Monitor The File System Monitor provides the following information: • Refresh: Click this button to manually refresh the File System Monitor.
Chapter 2 StorNext GUI Overview The StorNext Home Page Note: The #Store Candidates and # Trunc Candidates fields show “N/A” for a non-managed file system. For a managed file system, if these fields show “refresh,” click the Refresh button to retrieve current information for these fields. • # SAN Clients: The number of StorNext SAN clients (connected via fibre channel or iSCSI) for which you are licensed • # LAN Clients: The number of StorNext distributed LAN clients for which you are licensed.
Chapter 2 StorNext GUI Overview The StorNext Home Page • Refresh Rate: Set the Library Monitor refresh rate with this drop down menu. Options range from No Refresh to every 10 Minutes.
Chapter 2 StorNext GUI Overview The StorNext Home Page state during blockpool verification because this process could take a long time to complete, depending on the blockpool size. Storage disks in the online-pending state are not used for store operations. • Storage Disk Name: Name of the storage disk • Deduplication: Indicates if deduplication is enabled for the storage disk. (This field appears only on 32 bit and 64 bit Linux systems.
Chapter 2 StorNext GUI Overview The StorNext Home Page • Enter License: Enter StorNext license information • Add File System: Add a file system to your environment • Add Library: Add a library or vault • Add Tape Drive: Add tape drive • Add Media: Add media • Add Storage Disk: Add a storage disk • Add Storage Policy: Add a storage policy and a directory relation point to a file system • E-Mail Notification: Configure e-mail notifications for System Status Tickets, Backup information, and Policy Class alert
Chapter 2 StorNext GUI Overview The StorNext Home Page 2 Reports Menu Options The following Reports menu options allow you to view StorNext reports: • SNFS: View the following SNFS reports: • Affinities: View the existing affinities for a selected directory in the file system. • File Systems: View file system statistics including active clients, space, size, disks, and stripe groups. • Stripe Groups: View statistics for the stripe group, such as space, affinities, and current statuses.
Chapter 2 StorNext GUI Overview The StorNext Home Page 2 Service Menu Options The following Service menu options help you monitor and capture system status information: • Health Check: Perform one or more health checks on StorNext and view recent health check results • State Capture: Obtain and preserve detailed information about the current StorNext system state • System Status: View tickets indicating faults reported by the StorNext system • Admin Alerts: View informational messages about system activi
Chapter 2 StorNext GUI Overview The StorNext Home Page Figure 6 Service - System Status screen You can display tickets according to Open or Closed status, or view all tickets. If there are multiple screens of tickets, you can display the Previous or Next screen by clicking those buttons. Alternatively, you can go directly to a page by entering that number (such as 3 or 4) and then clicking the Page button.
Chapter 2 StorNext GUI Overview The StorNext Home Page • MSM media console errors • MSM drive dismount request when drive is already dismounted • MSM media audit failures To view admin alerts, select Admin Alerts from the StorNext home page’s Service menu. (Alternatively, you can click the Admin Alert button at the bottom of the screen.) The Service - Admin Alerts screen appears. Figure 7 Service - Admin Alerts Screen You can display the Previous or Next screen of alerts by clicking those buttons.
Chapter 2 StorNext GUI Overview The StorNext Home Page StorNext Server Status 2 The StorNext Server Status button is located at the bottom right of the StorNext Home Page.
Chapter 2 StorNext GUI Overview The SNFS and SNSM Home Pages Figure 8 Application Link The SNFS and SNSM Home Pages The Navigation Pane on the left side of the screen contains links to the SNFS and SNSM home pages along with a Home button to return to the main StorNext Home Page. • The SNFS Home Page - In SNFS mode, you perform file systemspecific tasks. The SNFS Home Page contains several drop-down menus: Config, Admin, and Reports.
Chapter 2 StorNext GUI Overview The SNFS and SNSM Home Pages • A file system monitor • System and server status indicators Figure 9 SNFS Home Page Note: SNFS Home Page DropDown Menus 2 The figure shows the SNFS Home Page as it appears when it is part of the full StorNext application. The interface for the SNFS standalone application looks slightly different, but has many of the same major features.
Chapter 2 StorNext GUI Overview The SNFS and SNSM Home Pages Note: You must unmount and stop the file system before using most of the options listed in this section. See Chapter 4, Common StorNext Tasks for more information.
Chapter 2 StorNext GUI Overview The SNFS and SNSM Home Pages • Metadata Dump: Generate a Metadata dump of a file system • Check File System: Run a check on your file system before expanding the file system or migrating a stripe group. • Expand File System: Add new stripe groups to your file system. • Move Stripe Group: Move data or metadata from one source stripe group to one or more destination stripe groups.
Chapter 2 StorNext GUI Overview The SNFS and SNSM Home Pages Figure 10 SNSM Menu The SNSM File Menu 2 The following SNSM File menu options allow you to manage file data and directories: • Store: Store files to a storage medium • Version: Show the version(s) of files stored on storage medium • Recover File: Recover deleted files • Recover Directory: Recursively recover deleted directories • Retrieve File: Retrieve truncated files from a storage medium • Retrieve Directory: Recursively retrieve truncated
Chapter 2 StorNext GUI Overview The SNFS and SNSM Home Pages 2 The SNSM Media Menu The following SNSM Media menu options help you manage media and libraries: • Library: Perform media movement tasks within a library (Manual Move, Mount, and Dismount) • Assign Policy: Add media types to a policy class • Remove: Remove media from StorNext • Assign Policy: Associate blank media with a policy class • Transcribe: Transcribe (copy) media • Attributes: Change the media’s state or attributes • Reclassify: Reclassi
Chapter 2 StorNext GUI Overview The Configuration Wizard • Alternate Retrieval Location: Retrieve a copy of a truncated file from a specified foreign machine when copies of the file are not accessible from the local StorNext Storage Manager machine. 2 The SNSM Reports Menu The options on the SNSM Reports menu allow you to view all SNFS reports. These are the same reports described in Reports Menu Options on page 15.
Chapter 2 StorNext GUI Overview The Configuration Wizard Figure 11 StorNext Configuration Wizard You can display the Configuration Wizard at any time by selecting Configuration Wizard from the StorNext home page’s Config 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.
Chapter 2 StorNext GUI Overview The Configuration Wizard Figure 12 Config Menu Options Each of the Configuration Wizard’s tasks are described in detail elsewhere in this guide: • Step 1: Enter License (See Entering the StorNext License on page 40) • Step 2: Add File System (See Adding a File System on page 83) • Step 3: Add Library (See Adding a Library on page 170) • Step 4: Add Tape Drive (See Adding a Tape Drive on page 190) • Step 5: Add Media (See Adding Media to a Configured Library on page 208) • S
Chapter 3 3 SNFS-Only GUI Overview The SNFS GUI is browser-based and can be accessed remotely from any machine with access to the local network and the SNFS server. This chapter describes how to access and navigate through the SNFS-only GUI. If you purchased StorNext, refer to StorNext GUI Overview on page 6. This chapter includes the following topics: • Accessing the SNFS GUI • The SNFS Home Page • The SNFS Configuration Wizard Accessing the SNFS GUI Use the following procedure to access the SNFS GUI.
Chapter 3 SNFS-Only GUI Overview Accessing the SNFS GUI Supported browsers are: • Internet Explorer 5.5, 6 and 7 • Netscape 7.x • Mozilla 1.0 and later • FireFox 1.5 and later, or 2.0 and later To ensure proper browser operation, all monitors must be set to display at a minimum resolution of 1074 x 768. Note: 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:// :.
Chapter 3 SNFS-Only GUI Overview The SNFS Home Page The SNFS Home Page The SNFS home page contains the following components: • A link to the Quantum Home Page • The File System Monitor • Drop-down Menus and Options • Shortcut Menu Options • Home and Help Links • StorNext Server Status Figure 14 SNFS Home Page Link to Quantum Menus FS Monitor Help Shortcut Menu Options StorNext Server Status The File System Monitor 3 StorNext User’s Guide The File System Monitor enables you to view statistics on e
Chapter 3 SNFS-Only GUI Overview The SNFS Home Page The File System Monitor has a Refresh button that allows you to manually update (refresh) the information shown in the monitor.
Chapter 3 SNFS-Only GUI Overview The SNFS Home Page • Used Inodes: The number of inodes currently in use on the file system • #Store Candidates: Number of files selected for storage to secondary media. This field does not apply to SNFS-only configurations. • #Trunc Candidates: Number of files that have been stored and meet the criteria to become a truncation candidate. This field does not apply to SNFS-only configurations.
Chapter 3 SNFS-Only GUI Overview The SNFS Home Page • Globals: Modify global settings • Disks: Add or delete a disk to a file system • Stripe Groups: Add, modify, or delete a stripe group from a file system • Affinities: Add, modify, or delete an affinity from file systems Note: Detailed descriptions of the Config menu options are located in Chapter 6, Managing the File System.
Chapter 3 SNFS-Only GUI Overview The SNFS Home Page Note: Detailed descriptions of the Report menu options are located in Chapter 12, StorNext Reports. The Help Menu 3 The Help menu provides you with access to StorNext reference material such as this user’s guide, the installation guide, and other useful documents.
Chapter 3 SNFS-Only GUI Overview The SNFS Home Page • Home and Help Links 3 Start/Stop StorNext: Start or Stop StorNext Software. For more information about starting and stopping StorNext, see StorNext Server Status on page 36. In the upper right corner of the screen are Home and Help links. Clicking Home returns you immediately to the StorNext home page regardless of your current location. Clicking Help displays a list of current StorNext documentation in pdf format.
Chapter 3 SNFS-Only GUI Overview The SNFS Home Page 1 On the Start/Stop SNFS screen, select Start or Stop to manually start or stop the StorNext File System. 2 Select Enable or Disable to enable or disable the feature that automatically starts SNFS upon reboot. Your selection will be reflected the next time you reboot. 3 Do one of the following: • Click Cancel to exit the Start/Stop SNFS screen without saving • Click Next to save your changes and proceed. The Complete Start/Stop SNFS screen appears.
Chapter 3 SNFS-Only GUI Overview The SNFS Configuration Wizard The SNFS Configuration Wizard SNFS includes a Configuration Wizard that guides you through the steps necessary to obtain a StorNext license and create a file system. You can complete these steps at any time, and the wizard will resume at the remaining step if you do not finish completing both tasks. If desired, you can select the option Don’t Show CW Again to prevent the wizard from automatically appearing the next time you launch StorNext.
Chapter 3 SNFS-Only GUI Overview The SNFS Configuration Wizard For more information about completing the two Configuration Wizard tasks, see Entering the StorNext License on page 40, and Adding a File System on page 83.
Chapter 4 4 Common StorNext Tasks This chapter provides instructions on performing the following StorNext and SNFS tasks: • Entering the StorNext License • Controlling User Access • Starting and Stopping StorNext Components • Accessing StorNext Logs • Scheduling StorNext Events • Setting Up E-mail Notification • Cancelling SNSM Requests • Setting up Alternate Retrieval Locations Entering the StorNext License Use the Enter License wizard to enter a permanent license string.
Chapter 4 Common StorNext Tasks Entering the StorNext License Note: If you use the temporary license, be sure to obtain a permanent license from Quantum before the 30-day temporary license expires. To obtain a permanent license, 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. • The number of StorNext SAN clients and distributed LAN clients you want to support.
Chapter 4 Common StorNext Tasks Entering the StorNext License Figure 20 Enter License Introduction Screen 2 Click Next to continue. The Quantum license agreement appears. You must accept the license agreement in order to continue with the licensing process.
Chapter 4 Common StorNext Tasks Entering the StorNext License Figure 21 Quantum License Agreement StorNext User’s Guide 43
Chapter 4 Common StorNext Tasks Entering the StorNext License 3 Read the license agreement and then click Accept. The Enter License Strings screen appears. This screen summarizes the information you must send to licenses@Quantum.com in order to receive the license string you enter on this screen. Figure 22 Enter License Strings Screen Note: The illustration shows the Enter License Strings screen that appears when you access the Enter License wizard from the StorNext Configuration wizard.
Chapter 4 Common StorNext Tasks Entering the StorNext License 5 After selecting Generate 30 day temporary license, click Next to continue. The Complete Enter License screen appears. Figure 23 Complete Enter License Screen (Temporary) 6 On the Complete Enter License screen, click Next to complete the task, or Back to make changes. When you click Next, a message reminds you to contact the Quantum Technical Assistance Center within 30 days to receive your permanent license string.
Chapter 4 Common StorNext Tasks Entering the StorNext License 7 Click OK to close the message box. 8 In order to receive your permanent StorNext license you must email to licenses@quantum.com the following information, as listed on the Enter License Strings screen (figure 22 on page 44): • The StorNext serial number from the StorNext box or CD. • The total number of StorNext SAN clients (if any) you want to license for your system.
Chapter 4 Common StorNext Tasks Entering the StorNext License Figure 25 Complete Enter License Screen (Permanent) 10 Review the information on the screen, and then click Next to continue, or Back to make changes. 11 After the status screen informs you that the operation was completed successfully, click Finish. Entering a License String in the .dat File 4 Alternatively, when you receive your license string via email, you can copy and paste the license string into the /usr/adic/DSM/config/license.
Chapter 4 Common StorNext Tasks Controlling User Access Figure 26 License String Example Note: When using this method to obtain your permanent license, you should copy and paste all of the text into the license.dat file, including the portions that are commented out (i.e., preceded by the pound sign, “#”). In particular, be sure to include the serial number. If you have Distributed LAN clients, you must also copy and paste the text for those clients.
Chapter 4 Common StorNext Tasks Controlling User Access Changing the Admin Password Use this procedure to change the admin password. 4 1 From the StorNext Home Page choose User Access Control from the Admin menu. The User Access Control screen appears.
Chapter 4 Common StorNext Tasks Controlling User Access 2 From the User Access Control screen, select Admin in the User List and click Modify. The Modify User “admin” screen appears. Figure 28 Modify User Screen 3 Enter your new password. 4 Confirm the new password by entering it again, and then click OK. 5 Click OK when the Status Screen displays Success.
Chapter 4 Common StorNext Tasks Controlling User Access Adding a New User 4 Use this procedure to add a new StorNext user. 1 From the User Access Control screen, click Add. The Add New User Screen appears.
Chapter 4 Common StorNext Tasks Controlling User Access 2 In the Enter User Name field, type the name the new user will enter at the User ID field when he or she logs on to StorNext. 3 In the Enter Password field, type the password the new user will enter when logging on to StorNext. 4 In the Re-enter Password field, retype the password you entered at the previous field.
Chapter 4 Common StorNext Tasks Controlling User Access Modifying an Existing User Use this procedure to modify an existing user’s StorNext access. 4 1 From the User Access Control screen, select a name (other than “admin”) from the User List and click Modify. The Modify User screen appears with the user’s name displayed in the header.
Chapter 4 Common StorNext Tasks Starting and Stopping StorNext Components 2 Change the user’s password or modify permissions as described in Adding a New User, and then click OK. 3 Click Close when the Status screen displays Success. Note: If there is only one administrator, you can modify only the password. A sole administrator has full access permissions, and you cannot modify these permissions. Use this procedure to delete an existing StorNext user.
Chapter 4 Common StorNext Tasks Starting and Stopping StorNext Components Figure 31 Start/Stop StorNext Screen 2 Select either the Start or Stop option. 3 Select the items you want to start or stop: • All Components • StorNext File System • StorNext Storage Manager Note: The current status (Started, Stopped, or Warning) is shown next to each StorNext application. A Warning status indicates one of your configured file systems is either not mounted or has not been started.
Chapter 4 Common StorNext Tasks Accessing StorNext Logs Figure 32 Complete Start/Stop StorNext Task Screen 6 Click Next. A status screen appears. 7 Click Finish when the status screen shows Success. The StorNext Server Status in the lower right corner of the screen now displays Stopped, Warning or Active, depending on your action.
Chapter 4 Common StorNext Tasks Accessing StorNext Logs • SNSM - Library Manager Logs: Logs that track library events and status • Server System Logs: Logs that record system messages • StorNext Web Server Logs: Various logs related to the web server Use the following procedure to access the StorNext log files. The process is the same regardless of the type of log you are viewing. 1 From the StorNext home page, select Access StorNext Logs from the Admin menu. The Select Log screen appears.
Chapter 4 Common StorNext Tasks Accessing StorNext Logs 2 Select the type of log you wish to view, and then click Next. The Select File screen appears. Figure 34 Select File Screen 3 Select the log file you wish to view, and then click one of the following: • Delete: Delete the selected log file • Mail: E-mail the selected log file to Quantum support • Show: Show the selected log file in a separate window 4 If you clicked Show, the selected log file appears in a separate window.
Chapter 4 Common StorNext Tasks Scheduling StorNext Events • Cancel to close the window Figure 35 Log File Example 5 When you are finished viewing logs, click Cancel to close the Select File window. Scheduling StorNext Events StorNext events are tasks that are scheduled to run automatically based on a specified schedule. The following events can be scheduled: • Clean Info: This scheduled background operation removes from StorNext knowledge of media.
Chapter 4 Common StorNext Tasks Scheduling StorNext Events • Full Backup: By default, a full backup is run once a week to back up the entire database, configuration files, and the file system metadata dump file. • Health Check: By default, health checks are set up to run every day of the week, starting at 7:00 a.m. • Partial Backup: By default, a partial backup is run on all other days of the week that the full backup is not run.
Chapter 4 Common StorNext Tasks Scheduling StorNext Events Figure 36 Schedule Events Screen 1 2 Select an event type: • Clean Info • Clean Versions • Full Backup • Health Check • Partial Backup • Rebuild Policy 3 Click Configure. The second Schedule Events screen displays the selected event type and any existing schedules.
Chapter 4 Common StorNext Tasks Scheduling StorNext Events Figure 37 Schedule Events Screen 2 4 Click Close when you are finished viewing the schedule. (You can also click Back to return to the previous screen.) Adding a New Schedule 4 Use the following procedure to schedule StorNext events. The procedure for adding a new schedule for an event is the same regardless of the event type. 1 From the StorNext Home Page, select Schedule Events from the Admin menu.
Chapter 4 Common StorNext Tasks Scheduling StorNext Events 3 Click Configure. The second Schedule Events screen displays the selected event type and any existing schedules (figure 37). 4 Click Add. The third Schedule Events screen appears. Figure 38 Schedule Events Screen 3 5 In the Name field, enter a name for the new schedule. 6 Select either Days of Week or Days of Month. • If you selected Days of Week, select the days on which you want the event to run.
Chapter 4 Common StorNext Tasks Scheduling StorNext Events 8 At the Start Window field, specify the window in which you want the StorNext Scheduler to start the event. The Scheduler attempts to begin the event within the specified Start Window time (e.g, 30 minutes). If the event cannot begin at that time, the Scheduler tries again during the next cycle. 9 Do one of the following: • Click Apply to save your entry and create the new schedule. When the Status screen displays Success, click Close.
Chapter 4 Common StorNext Tasks Scheduling StorNext Events 3 Click Configure. The second Schedule Events screen displays the selected event type and any existing schedules (figure 37). 4 Select the schedule you want to change, and then click Modify. The third Schedule Events screen appears (figure 38). 5 In the Name field, view or change the name for the new schedule. 6 Select either Days of the Week or Days of the Month.
Chapter 4 Common StorNext Tasks Scheduling StorNext Events 2 Select an event type: • Clean Info • Clean Versions • Full Backup • Health Check • Partial Backup • Rebuild Policy 3 Click Configure. The second Schedule Events screen displays the selected event type and any existing schedules (figure 37). 4 Select the schedule you want to change, and then click Delete. Caution: After you click Delete you will NOT be asked to confirm that you want to delete the schedule.
Chapter 4 Common StorNext Tasks Setting Up E-mail Notification • Rebuild Policy 3 Click Configure. The second Schedule Events screen displays the selected event type and any existing schedules (figure 37). 4 Click Reset. 5 When prompted, confirm that you want to delete all existing schedules and create a single schedule that uses default values: click Yes to proceed or No to abort. 6 Do one of the following: • Click Cancel to exit the screen. The Schedule Events window closes.
Chapter 4 Common StorNext Tasks Setting Up E-mail Notification 1 From the StorNext home page, choose E-mail Notification from the Admin menu. The Configure E-mail Notification Introduction screen appears.
Chapter 4 Common StorNext Tasks Setting Up E-mail Notification 2 On the Configure E-mail Notification Introduction screen, review your current e-mail settings (if any) and then click Next to continue. The Configure SMTP E-mail screen appears.
Chapter 4 Common StorNext Tasks Setting Up E-mail Notification • Sender Address: Enter the e-mail address for the entity sending alert messages to recipients. • Send Test E-mail to: Enter an e-mail address to which you can send test messages in order to confirm successful configuration. 4 Click Next to continue. The Configure E-mail Addresses screen appears.
Chapter 4 Common StorNext Tasks Setting Up E-mail Notification • Service Tickets: Select this option to receive e-mail when a service ticket for your system is generated. Notifications for service tickets will be sent for events at the specified alert level and higher. You must specify an alert level. • Policy Class: Select this option to receive e-mail about policy class. You must specify a policy class.
Chapter 4 Common StorNext Tasks Cancelling SNSM Requests 8 Review your selections and do one of the following: • Click Back to change information you entered, or add or remove another e-mail recipient. • Click Next to continue. 9 When the Status screen informs you that your e-mail notifications were successfully processed, click Close.
Chapter 4 Common StorNext Tasks Setting up Alternate Retrieval Locations 2 Select from the Select Request ID list the pending requests you want to cancel. If desired, you can click Select All to select all requests. 3 Click Apply to continue. 4 When the Status screen informs you that the selected requests have been successfully cancelled, click OK. The requests you selected are now removed from the list on the Cancel Request screen.
Chapter 4 Common StorNext Tasks Setting up Alternate Retrieval Locations Setting up this feature consists of the following steps: • Enter the IP address of the alternate machine you want to use for retrieval. (This alternate machine may or may not contain StorNext. StorNext is not required on an alternate machine.
Chapter 4 Common StorNext Tasks Setting up Alternate Retrieval Locations Modifying or Disabling This Feature 4 As your needs or configuration changes, you can modify the remote machine information or disable the feature on one or more file systems. 1 From the SNSM home page, choose Alternate Retrieval Locations from the Admin menu. The Alternate Retrieval Locations screen appears. 2 As needed, change the information in the Remote Node IP and Remote Path fields.
Chapter 5 5 Backing Up StorNext This chapter provides instructions on backing up the StorNext software. This chapter covers these topics: • Types of StorNext Software Backups • Performing a StorNext Software Backup • Managing the Backup Policy Types of StorNext Software Backups There are two types of StorNext software backup: Full and Partial. By default, a full backup runs once a week, and partial backups are scheduled to run on all other days of the week that the full backup is not run.
Chapter 5 Backing Up StorNext Types of StorNext Software Backups • StorNext database journals • Configuration files • File system journal files Note: Setting up Email Notification For Backup 5 These backups DO NOT back up user data. This procedure backs up only StorNext-related system files. Before you run a StorNext backup, be sure to set up email notification as described in Setting Up E-mail Notification on page 67. Email notification is an important part of the StorNext backup process.
Chapter 5 Backing Up StorNext Performing a StorNext Software Backup Performing a StorNext Software Backup Use the following procedure to manually run a StorNext backup. 1 From the StorNext home page select Run Backup from the Admin menu. The Backup StorNext screen appears.
Chapter 5 Backing Up StorNext Managing the Backup Policy 2 Select the type of backup you want run (Full or Partial), and then click Next. The Complete Backup Task screen appears. Figure 46 Complete Backup Task Screen 3 Click Next to start the backup. 4 Click Finish when the Status screen displays success. Managing the Backup Policy The Backups option on the SNSM home page’s Admin menu allows you to manage your backup policy by setting the media type for each copy.
Chapter 5 Backing Up StorNext Managing the Backup Policy 1 From the SNSM home page, choose Backups from the Admin menu. The Backup Policy screen appears. Figure 47 Backup Policy Screen 2 Enter the following information: • File Copy 1 - 4: For each copy number (1 - 4,) select the media type. Only the media types applicable to your configuration are selectable. • Max Backup Sets: If desired, specify the maximum number of backup sets you want to create.
Chapter 5 Backing Up StorNext Managing the Backup Policy 4 After the Status screen informs you that the operation was performed successfully, click OK.
Chapter 6 6 Managing the File System This chapter describes how to manage file systems by performing these major configuration and administration tasks: • Working With File Systems • Managing File System Operations • Working With Disks • Working With Stripe Groups • Working With Affinities • Using the SNSM File System Functions • Understanding Dynamic Resource Allocation • Performing File System Expansion • Performing Stripe Group Movement Working With File Systems This section includes the following fil
Chapter 6 Managing the File System Working With File Systems • Modifying a File System • Deleting a File System Note: Adding a File System 6 This section describes how to create, modify, expand, and delete a file system using the GUI. For instructions on using the CLI to accomplish the same tasks, see Using The Command Line Interface. The following procedure describes how to create an empty file system.
Chapter 6 Managing the File System Working With File Systems 2 Click Next to continue. The Add New File System screen appears. Figure 49 Add New File System Screen 3 On the Add New File System screen, click Browse to enter a mount point (directory) for the file system. This allows you to navigate to an existing directory or create a new one. The Directory Browser screen appears.
Chapter 6 Managing the File System Working With File Systems Figure 50 Directory Browser Window 4 Select from the Select Directory list an existing directory in which you want to create the file system. Figure 51 Select Directory Window 5 To create a new directory underneath the selected directory, click Create Directory and enter the new directory name. Click OK to continue. The new directory is shown in the Directory Browser’s Current Directory Field. 6 Click OK to accept the new directory.
Chapter 6 Managing the File System Working With File Systems Caution: Do not select the Enable Data Migration option if the file system will be used as a storage disk. 8 If desired, select the Enable Distributed Lan Server on this machine option if you want the machine on which the file system is located to act as a Distributed Lan server. (This option appears only for Linux machines.
Chapter 6 Managing the File System Working With File Systems 10 On the Disk Settings screen, type valid values and click Next. • Block size field: The block size in bytes for the file system. The block size is the minimum unit of data accessed from physical devices. The default value of 16384 bytes is the recommended setting for best overall efficiency. Note: • If the file system you are adding will be used for deduplication-enabled storage disks, you must accept the default value of 16384 bytes.
Chapter 6 Managing the File System Working With File Systems Figure 53 Customize Stripe Group Screen 12 Enter values for the Customize Stripe Group screen. • Name Field: The name of the stripe group. • Select disks list: The disks available to assign to the stripe group. You must select at least one disk for each stripe group. • Label Type: If you plan to create LUNs larger than 2TB, you must specify the EFI label type when configuring a file system.
Chapter 6 Managing the File System Working With File Systems For more information about 2TB LUN requirements, see the StorNext Installation Guide. • Label Help: Click this link to display guidelines for determining whether to select VTOC or EFI labels. The matrix looks like this: • Stripe breadth drop-down menu: The stripe breadth for the file system. The stripe breadth is the number of kilobytes (KB) that is read from or written to each disk in the stripe.
Chapter 6 Managing the File System Working With File Systems • Metadata, Journal, and User Data checkboxes: Enable one or more of these options (check the boxes) to create a location for metadata, journaling or user data. • To enable metadata to be placed on the stripe group, select the Metadata checkbox. • To enable journaling to be placed on the stripe group, select the Journal checkbox. • To enable user data to be placed on the stripe group, select the User Data checkbox.
Chapter 6 Managing the File System Working With File Systems Figure 55 Complete File System Task Screen 15 Review your selections. Click Next to complete the task or Back to make changes. 16 After the status screen informs you that the file system was successfully added, click Next. Creating a File System From SNFS 6 An alternative way to create a file system is to do so from the SNFS home page.
Chapter 6 Managing the File System Working With File Systems 2. Modify the file system’s global settings. 3. Add disks to the file system. 4. Add stripe groups for the file system. 5. Make the file system. 6. Start the new file system. 7. Mount the new file system. 8. Add affinities to the new file system. Each of the above steps is explained in the following procedure. 1 From the SNFS home page, choose File System from the Config menu. The Configure File System screen appears.
Chapter 6 Managing the File System Working With File Systems 6 Add disks to the file system as explained in Adding Disks on page 109. 7 Configure stripe groups for the file system as explained in Adding a Stripe Group on page 114. Note: Make sure that each stripe group is associated with no more than one affinity when using disk-to-disk migration. 8 Make the file system as described in Making a File System on page 106.
Chapter 6 Managing the File System Working With File Systems • Modifying an Affinity on page 131 • Adding Disks on page 109 • Adding a Stripe Group on page 114 • Modifying a Stripe Group on page 117 4 Start the file system as described in Starting and Stopping the File System on page 107. 5 Mount the file system as described in Mounting or Unmounting a File System on page 108.
Chapter 6 Managing the File System Working With File Systems • Enable Distributed Lan Server on this machine: Select this option to let the machine on which the file system is located to act as a Distributed LAN server. (This option appears only for Linux machines.) If you no longer wish the machine to be a Distributed LAN server, deselect this option. Note: Deleting a File System 6 When you use this option to configure a machine as a Distributed LAN server, all available IPV4 addresses are used.
Chapter 6 Managing the File System Managing File System Operations Managing File System Operations This section describes tasks that can be performed on an individual basis when you administer your file system. Except where noted, tasks can be completed in any order, and do not require that other tasks be successfully completed.
Chapter 6 Managing the File System Managing File System Operations Figure 58 Label Disk Device Screen From this screen, you can perform these tasks: • Select Label Type - Specify VTOC or EFI label types for your disks. (The default is EFI labels.) EFI labels are required if you plan to create LUNs that are larger than 2TB. (For Solaris, EFI labels are also required for LUNs with a raw capacity greater than 1TB.) EFI labels will not work with the IRIX operating system.
Chapter 6 Managing the File System Managing File System Operations 2 From the Disk Devices list, select the device you want to label, unlabel, or probe, and then click Label. 6 Labeling a Device Use the following procedure to label a disk device. 1 Specify the label type by choosing VTOC or EFI at the Select Label Type field. 2 Click Label. A message window warns you that the device might have a file system on it, and that labeling the device will destroy any data.
Chapter 6 Managing the File System Managing File System Operations Figure 61 Data Loss Warning 5 Click OK to continue and label the device. The Label Disk Devices Status window appears. 6 Click Close when the status displays Success. The Label Disk Device screen now includes the label you created. Caution: Quantum recommends that you reboot nodes after you label or relabel a disk. Rebooting ensures that the system recognizes the labeled or relabeled disk.
Chapter 6 Managing the File System Managing File System Operations 2 Click OK to close the warning window and proceed, or click Cancel to abort the unlabeling process. If you click OK, a status window appears. 3 Click Close when the status displays Success. The Label Disk Device screen now shows the device with no label name. Note: If you decide later to make an unlabeled device usable by the StorNext File System, you must first relabel the device.
Chapter 6 Managing the File System Managing File System Operations Before making any changes to the file system’s configuration, carefully review the cvfs_config(4) man pages or the “CVFS Configuration File” help file. The following task describes how to modify global configuration settings. These settings affect all stripe groups in the file system. 1 From the SNFS home page, choose Globals from the Config menu. The Modify Global Settings screen appears.
Chapter 6 Managing the File System Managing File System Operations • File System Block Size: This value defines the granularity of the file system's allocation size. The default setting is 16,384. The block size must be specified in powers of 2. • Inode Cache Size: This value defines the number of inodes that can be cached in the SNFS server. The default setting for the cache size is 16, and the minimum is 8.
Chapter 6 Managing the File System Managing File System Operations • Windows Security: Enable this option (check the box) to allow all Windows clients to use Microsoft Windows native security. If this option is enabled, then a Windows administrator may set Windows security on all files and directories for any user or group defined on the local Windows client or Windows domain. • Use Physical Memory Only: When this option selected, the file system will use only physical memory, not swapped or paged.
Chapter 6 Managing the File System Managing File System Operations • Debug Log Settings: Settings to turn on debug functions for the file system server. The log information may be useful if a problem occurs. A Quantum Technical Assistance Center representative may ask for certain debug options to be activated to analyze a file system or hardware problem. • Disable Debugging: Disables detailed file system debug tracing. When debug tracing is enabled, file system performance could be significantly reduced.
Chapter 6 Managing the File System Managing File System Operations 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.
Chapter 6 Managing the File System Managing File System Operations Conditions to Make or Re-Make a File System 6 The following are reasons to make or re-make a file system. • Creating a new file system • Removing a stripe group from the file system • Removing a disk from a stripe group • Changing a stripe group's stripe breadth • Changing the sector count of a disk Making a File System 6 Use this procedure to make a file system. 1 From the SNFS home page, choose Make File Systems from the Admin menu.
Chapter 6 Managing the File System Managing File System Operations 3 Click OK. A second confirmation screen warns that all data will be lost on the selected file system. 4 Click OK. 5 After the status screen informs you that the task has completed successfully, click Close. Starting and Stopping the File System 6 This task enables you to start or stop a file system. You need to stop a file system if you want to take it out of service to make configuration changes or perform other administrative tasks.
Chapter 6 Managing the File System Managing File System Operations • The Start Stop File System Status screen appears. • Select a file system from the Active File Systems list and click Stop. • The Start Stop File System Status screen appears. 3 After the status screen informs you that task has successfully completed, click Close. Mounting or Unmounting a File System 6 This task enables you to mount or unmount a file system.
Chapter 6 Managing the File System Working With Disks 2 Do one of the following: • Select a file system from the Unmounted File Systems list and click Mount. The Mount File System Status screen appears. • Select a file system from the Mounted File Systems list and click Unmount. The Unmount File System Status screen appears. 3 After the status screen informs you that the task has successfully completed, click Close.
Chapter 6 Managing the File System Working With Disks 1 If the file system is mounted, unmount the file system as described in Mounting or Unmounting a File System on page 108. 2 If the file system is started, stop the file system as described in Starting and Stopping the File System on page 107. 3 From the SNFS home page, choose Disks from the Config menu. The Manage Disks screen appears.
Chapter 6 Managing the File System Working With Disks Figure 68 Add Disk Screen 5 Select from the Available Disks list the disk you want to add to the file system. You can select multiple disks by pressing the CTRL key and clicking the disk name. Click OK to continue. The Add Disk Status screen appears. 6 After the status screen indicates that the disks have been added, click Close. The Manage Disks screen (figure 67 on page 110) appears, and the disks list includes the disks you just added.
Chapter 6 Managing the File System Working With Disks Caution: Deleting a disk used in a stripe group results in a complete loss of user data and requires re-making the file system. For information on re-making the file system, refer to Making or Unmaking a File System on page 105. 1 From the SNFS home page, choose Disks from the Config menu. The Manage Disks screen (figure 67) appears. 2 Select from the File Systems drop-down menu the file system that contains the disk you want to delete.
Chapter 6 Managing the File System Working With Stripe Groups Note: For more information about using the snfsdefrag command, refer to the snfsdefrag(1) man pages. Working With Stripe Groups A stripe group is a logical disk volume in a file system that consists of one or more LUNs used to store metadata information, journaling information, and user data. Stripe groups are used to create logical volumes that can span multiple controllers on an array and even multiple arrays for even greater performance.
Chapter 6 Managing the File System Working With Stripe Groups transparently write those files to the desired disk type. This means you don't have to have two or more separate file systems (e.g., one for critical data and another for temporary data). Instead, you have a single namespace for simplified management. Working with a stripe group consists of these tasks: • Adding a Stripe Group • Modifying a Stripe Group • Deleting a Stripe Group Adding a Stripe Group 6 Use this procedure to add a stripe group.
Chapter 6 Managing the File System Working With Stripe Groups Figure 70 Add Stripe Group Screen 3 Enter the fields on the Add Stripe Group screen. • Name: The name of the new stripe group. • Breadth: The breadth size is the number of file system blocks the system reads/writes before moving to the next disk in the stripe group. This value should be optimized for the major application that uses the disks.
Chapter 6 Managing the File System Working With Stripe Groups 2) Select the file system in which the disks reside, and then click Add. 3) Add one or more disks. StorNext User’s Guide • Disks in Stripe Group: Disks associated with the new stripe group. • Available Affinities: Affinities associated with existing stripe groups that, if selected, would also apply to this stripe group. • Affinities in Stripe Group: Affinities associated with the new stripe group.
Chapter 6 Managing the File System Working With Stripe Groups • Non-realtime MB/sec (optional): The lower threshold (in MB per second) that is reserved for non-realtime applications. If both Non-realtime MB/sec and Non-realtime IO/sec Fields are selected, then the system uses the lesser of the two values. This is an optional setting and can be left blank. 4 Click OK. 5 After the status screen indicates that the new stripe group has been added, click Close.
Chapter 6 Managing the File System Working With Stripe Groups Figure 71 Modify Stripe Group Screen 5 Type valid values for the stripe group. • Stripe Group Name: The selected stripe group. • Stripe Breadth: The breadth size is the number of file system blocks the system reads/writes before moving to the next disk in the stripe group. This value should be optimized for the major application that uses the disks.
Chapter 6 Managing the File System Working With Stripe Groups 3) Add one or more disks. • Disks in Stripe Group: Disks associated with the stripe group. • Available Affinities: Affinities associated with existing stripe groups that, if selected, would also apply to this stripe group. • Affinities in Stripe Group: Affinities associated with the stripe group. • Read-only: Select this option to make the stripe group read only. • Status: The status of the stripe group, either online or offline.
Chapter 6 Managing the File System Working With Stripe Groups • Realtime MB/sec (optional): The number of megabytes per second that are available to real-time applications. This is an optional setting and can be left blank. • Non-realtime IO/sec (optional): The number of disk I/O operations per second that are available to non-realtime applications. This is an optional setting and can be left blank.
Chapter 6 Managing the File System Working With Affinities Working With Affinities An affinity is a label assigned to one or more stripe groups. An affinity enables you to direct data to its associated stripe groups. A file system can have one or more affinities associated with it. These associations, defined in stripe groups, are made with the affinity key to a directory or file.
Chapter 6 Managing the File System Working With Affinities Figure 72 Add Affinity Introduction Screen 2 Click Next to continue. The Add Affinity screen appears.
Chapter 6 Managing the File System Working With Affinities Figure 73 Add Affinity Screen 3 Select the file system to which you want to add the affinity. Enter a name for the affinity (up to eight characters long) that begins with a letter. Click Next to continue. The Select Directory screen appears.
Chapter 6 Managing the File System Working With Affinities Figure 74 Select Directory Screen 4 Specify the directory for the new affinity. You can enter a pathname directly in the field, or click Browse to select from a list of existing directories. If desired, you can also create a new directory after you click Browse. Click Next to continue. The Assign Affinity screen appears.
Chapter 6 Managing the File System Working With Affinities Figure 75 Assign Affinity Screen 5 Select from the displayed the list the stripe group to which you want to assign the new affinity. If none of the shown stripe groups are available, you must exit the procedure and create additional stripe groups before proceeding. Click Next to continue. The Exclusive Stripe Group screen appears.
Chapter 6 Managing the File System Working With Affinities Figure 76 Exclusive Stripe Group Screen 6 If desired, you can select a stripe group that will be used exclusively for the new affinity’s files. To make a stripe group exclusive, select the desired stripe group from the left column (Not Exclusive) and click the upper arrow (>) to move the stripe group to the Exclusive list.
Chapter 6 Managing the File System Working With Affinities Figure 77 Complete Add Affinity Task Screen 7 Click Next to continue. After the status screen informs you that the affinity was added successfully, click Close. Adding an Affinity Through SNFS 6 Alternatively you can use the following procedure to add an affinity to an existing file system through SNFS. 1 If the file system is mounted, unmount the file system as described in Mounting or Unmounting a File System on page 108.
Chapter 6 Managing the File System Working With Affinities Figure 78 Add, Modify, or Delete Affinities Screen 4 From the File Systems drop-down menu, select the file system to which you want to add the affinity, and then click Add. The Add Affinity screen appears. Figure 79 Add Affinity Screen 5 Select a Stripe Group with which to associate the affinity, and then type a name for the affinity in the Affinity Name Field. (Affinity names cannot be longer than eight characters.) Click OK to continue.
Chapter 6 Managing the File System Working With Affinities The following stripe groups cannot be selected: • An exclusive stripe group • A metadata stripe group • A journal stripe group • A stripe group on a managed file system with a configured affinity 6 After the Status screen informs you that the affinity was successfully added, click Close. The Add, Modify, or Delete Affinities screen (figure 78 on page 128) appears, showing in the Affinities list the new affinity you just added.
Chapter 6 Managing the File System Working With Affinities Figure 80 Set Affinity Screen 2 Select from the File Systems list the file system on which you want to set the new affinity. 3 Select from the Affinities list the affinity to set on the selected file system. 4 Click Apply to continue. The Set Affinity screen appears.
Chapter 6 Managing the File System Working With Affinities 5 On the Set Affinity screen, click Browse and select or create the directory on the file system to which you want to set the affinity. Click OK. 6 When the status screen informs you that the operation was completed successfully, click OK. Modifying an Affinity 6 Use this procedure to modify an affinity on a configured file system.
Chapter 6 Managing the File System Working With Affinities 9 After the status screen informs you that the affinity has been modified, click Close. The Add, Modify, or Delete Affinities screen (figure 78 on page 128) appears, showing the association you just created. 10 Start the file system as described in Making a File System on page 106. 11 Mount the file system as described in Mounting or Unmounting a File System on page 108.
Chapter 6 Managing the File System Performing a Metadata Dump 10 Mount the file system as described in Mounting or Unmounting a File System on page 108. File System Configuration Restrictions 6 When using affinities, the StorNext administrator must adhere to the file system configuration restrictions listed below to ensure that data management policies execute properly. These restrictions apply only to managed file systems, not to non-managed (SNFS-only) installations.
Chapter 6 Managing the File System Using the SNSM File System Functions 1 From the SNFS home page, choose Metadata Dump from the Admin menu. The Metadata Dump of File System screen appears. Figure 83 Metadata Dump of File System Screen 2 Select the file system on which to perform the metadata dump, and then click Apply. 3 After the Status Screen informs you that the metadata dump was performed successfully, click Close.
Chapter 6 Managing the File System Using the SNSM File System Functions • Retrieving a Directory • Freeing Disk Blocks • Moving Files to New Media • Modifying a File’s Attributes These functions are not available if you have only StorNext File System and not StorNext Storage Manager. Storing Files 6 Use this function to expedite storing files to media rather than waiting for data to be migrated automatically. 1 From the SNSM home page, choose Store from the File menu. The Store Files screen appears.
Chapter 6 Managing the File System Using the SNSM File System Functions • Click Browse to display the StorNext File Browser window. On this window locate and select the files you want to store to media, and then click OK. 3 If desired, click the Properties button to change the default parameters that are applied during file storage. The Optional Store Parameters screen appears. Figure 85 Optional Store Parameters Screen 4 On the Optional Store Parameters screen, enter values and then click Apply.
Chapter 6 Managing the File System Using the SNSM File System Functions 5 On the Store Files screen, click Apply to continue. 6 After the Status screen informs you that the operation was completed successfully, click OK. Changing a File Version 6 Use this function to find alternate versions of a specified file. 1 From the SNSM home page, choose Version from the File menu. The Change File Version screen appears.
Chapter 6 Managing the File System Using the SNSM File System Functions Recovering a File 6 This function allows you to recover a deleted file. Undeleted files are recovered in a truncated state. To return the file back to disk, you must use the Retrieve File function as described in Retrieving a File on page 140. 1 From the SNSM home page, choose Recover File from the File menu. The Recover Files screen appears.
Chapter 6 Managing the File System Using the SNSM File System Functions Figure 88 StorNext Recoverable Files Screen 4 Select from the list the files you want to undelete. To expedite file selection, you can use the Select All or Deselect All buttons. If the file list spans more than one screen page, click Next to view the next page, or Back to return to the previous page. When you are finished selecting files for recovery, click OK.
Chapter 6 Managing the File System Using the SNSM File System Functions 1 From the SNSM home page, choose Recover Directory from the File menu. The Recover Directory screen appears. Figure 89 Recover Directory Screen 2 Select from the Select File System dropdown list the file system to which you want to restore the deleted directory. 3 Select from the Select Directory list the directory you want to recover.
Chapter 6 Managing the File System Using the SNSM File System Functions Figure 90 Retrieve Files Screen 2 Do one of the following: • Enter in the Enter Individual Filename field the file you want to retrieve. You must enter the complete pathname. • Click Browse to display the StorNext File Browser window. On this window locate and select the files you want to store to media, and then click OK. On the Retrieve Files screen, verify that the files shown are the ones you want to retrieve.
Chapter 6 Managing the File System Using the SNSM File System Functions 1 From the SNSM home page, choose Retrieve Directory from the File menu. The Retrieve Directory screen appears. Figure 91 Retrieve Directory Screen 2 Do one of the following: • Enter in the Enter Directory field the directory from which you want to recursively retrieve files and sub-directories. You must enter the complete pathname. • Click Browse to display the Directory Browser window.
Chapter 6 Managing the File System Using the SNSM File System Functions 1 From the SNSM home page, choose Free Disk Blocks from the File menu. The Free Disk Blocks screen appears. Figure 92 Free Disk Blocks Screen 2 Do one of the following: • Enter in the Enter Individual Filename field the file you want to remove from disk. You must enter the file’s complete pathname. • Click Browse to display the StorNext File Browser window.
Chapter 6 Managing the File System Using the SNSM File System Functions Moving Files to New Media 6 This function enables you to move files from one piece of media to another. When you use this function, files on the original media are deleted. (That is, this is not a copy function that leaves files on the source media and places a copy on the destination media.) 1 From the SNSM home page, choose Move from the File menu. The Move Files to New Media screen appears.
Chapter 6 Managing the File System Using the SNSM File System Functions Modifying a File’s Attributes 6 With this function you can change a file’s attributes, including the associated policy class attributes and number of file copies to save on media during storage. 1 From the SNSM home page, choose Attributes from the File menu. The Modify File Attributes screen appears.
Chapter 6 Managing the File System Understanding Dynamic Resource Allocation 5 If the Stub File feature is enabled, indicate how StorNext determines the stub file size: • By Policy: Use the stub file size entered when the storage policy was created • User Set: Change the stub file size by entering the new size (in kilobytes) at this field 6 Click Apply to modify attributes for the selected files. 7 After the Status screen informs you that the operation was completed successfully, click OK.
Chapter 6 Managing the File System Understanding Dynamic Resource Allocation Note: About Stripe Group Movement 6 After expansion you must perform a metadata dump. The File Expansion Wizard includes an option that will do this for you automatically, but the process can take longer than if you do the metadump manually.
Chapter 6 Managing the File System Checking the File System Expansion and Movement Steps 6 Here are the steps required for expanding a file system and moving stripe groups: 1 Check the file system before you begin. (See Checking the File System on page 148.) 2 Expand the file system. (See Performing File System Expansion on page 150.) 3 Move data stripe groups or metadata/journal stripe groups. (See Performing Stripe Group Movement on page 157.) 4 Mark source stripe groups as down.
Chapter 6 Managing the File System Checking the File System Figure 95 Check File System Screen 2 Select from the File Systems list the file system you want to check. Only file systems eligible for File System Expansion or Stripe Group Movement are shown in the list. Next to the file system name, the file system’s current state is shown in parentheses: mounted or unmounted, and started or stopped.
Chapter 6 Managing the File System Performing File System Expansion 6 To view a status summary for any successfully run file system checks, click the Success or Failure indicator under the Status heading. Figure 96 Check File System Status Screen Performing File System Expansion In practical terms, expanding an existing file system means allocating additional storage to that file system.
Chapter 6 Managing the File System Performing File System Expansion 3. Add the new stripe group to an existing file system. After you perform these steps, StorNext automatically updates the available file system capacity and presents the expanded file system to the StorNext clients. Note: During File System Expansion the file system is shut down. After expansion you must perform a new metadata dump runs after the file system is updated.
Chapter 6 Managing the File System Performing File System Expansion Figure 97 File System Expansion Introduction Screen 2 Select from the list the file system on which you want to perform File System Expansion. Click Next to continue. 3 A message reminds you that you must check your file system before beginning the expansion process.
Chapter 6 Managing the File System Performing File System Expansion Do one of the following: • If you have not checked the selected file system, click Cancel and then run the file system check as described in Checking the File System on page 148. • If you have already checked the selected file system, click OK to proceed. The Data Stripe Group Selection screen appears. Figure 99 Data Stripe Group Selection Screen 4 The Data Stripe Group Selection screen shows all currently configured stripe groups.
Chapter 6 Managing the File System Performing File System Expansion Figure 100 Metadump Warning Note: If you proceed without selecting the Perform metadump option, you should manually perform a metadata dump after file system expansion is finished to make sure your backups do not fail. For information about performing a metadata dump, see Performing a Metadata Dump on page 133. 6 On the Data Stripe Group Selection screen, click Next to continue. The New Data Stripe Group screen appears.
Chapter 6 Managing the File System Performing File System Expansion Figure 101 New Data Stripe Group Screen 7 Enter values for the New Stripe Group screen. • Name field: The name of the stripe group. • Select disks list: The disks available to assign to the stripe group. You must select at least one disk for each stripe group. • Label Type: If you plan to create LUNs larger than 2TB, you must specify the EFI label type when configuring a file system.
Chapter 6 Managing the File System Performing File System Expansion For more information about 2TB LUN requirements, see the StorNext Installation Guide. • Label Help: Click this link to display guidelines for determining whether to select VTOC or EFI labels. (See figure 54 on page 89.) • Stripe breadth drop-down menu: The stripe breadth for the file system. The stripe breadth is the number of kilobytes (KB) that is read from or written to each disk in the stripe.
Chapter 6 Managing the File System Performing Stripe Group Movement 9 Click Next to complete the process. 10 After the status screen informs you that the expansion was completed successfully, click Finish to exit the wizard. Performing Stripe Group Movement The time it takes to complete the Stripe Group Movement process depends on the amount of data being moved between source and target stripe groups. When moving a data stripe group, the file system continues to run during the movement process.
Chapter 6 Managing the File System Performing Stripe Group Movement (StorNext has different mechanisms for moving data stripe groups versus metadata/journal stripe groups.) Note: Launching the Movement Wizard 6 StorNext User’s Guide During Stripe Group Movement, affinities are preserved when files are moved from one stripe group to another. Consequently, there must be sufficient space on one or more destination stripe groups for any affinities on the source stripe group.
Chapter 6 Managing the File System Performing Stripe Group Movement Figure 103 Move Stripe Group Screen 2 To update the percentage complete for a move in progress, click Refresh. To remove previously completed moves (with either a Success or Fail status,) click Clear. 3 To view details about either a previously completed move or a move in progress, click the link in the Status column. The status window for completed moves shows files skipped and files defragmented.
Chapter 6 Managing the File System Performing Stripe Group Movement Figure 104 Move Stripe Group Introduction Screen 5 Select the file system for which you want to move stripe groups. Click Next to continue. 6 A message reminds you that you must check your file system before beginning the movement process.
Chapter 6 Managing the File System Performing Stripe Group Movement Figure 105 Move Options Screen 7 Specify whether to move a data stripe group or a metadata or journal stripe group. (You cannot move a stripe group that contains both user data and metadata/journal data on the same LUN.) Click Next to continue. If you are migrating ONLY a metadata/journal stripe group, go to step 9—page 163. If you are migrating a data stripe group, the Data Stripe Group Move screen appears.
Chapter 6 Managing the File System Performing Stripe Group Movement Figure 106 Data Stripe Group Move Screen 8 Select the source stripe group from which data will be moved. The stripe group you select will be marked as read only, and data from the stripe group will be distributed among one or more available stripe groups. (This feature does not allow you to specify the destination stripe groups.
Chapter 6 Managing the File System Performing Stripe Group Movement Similarly, if StorNext determines that the available destination stripe groups are not large enough to accommodate the data on the source stripe group, you will receive a warning message and not be allowed to continue using the selected source stripe group. Figure 108 Destination Stripe Group Too Small Warning Click Next to continue. If you are migrating only data stripe groups, the Complete Stripe Group Move screen appears.
Chapter 6 Managing the File System Performing Stripe Group Movement Figure 110 Metadata/Journal Move Screen 11 Select from the displayed lists of available LUNs the source (from) LUN and the destination (to) LUN. Click Insert to continue. The LUN pair are displayed beneath the SOURCE>>DESTINATION heading. If you made a mistake during selection, you can clear the LUN pair by clicking Remove, and then repeat the selection. When you are ready to continue with the move, click Next.
Chapter 6 Managing the File System Performing Stripe Group Movement Figure 111 Complete Stripe Group Move Screen Note: The figure shows the Complete Stripe Group Move screen for a metadata stripe group move. The screen for a metadata/journal stripe group move looks similar. 12 On the Complete Stripe Group Move screen, verify the displayed information about the move and then click Next to continue. The Process Initiated status screen appears.
Chapter 6 Managing the File System Performing Stripe Group Movement Figure 112 Process Initiated Status Screen 13 After the status screen informs you that the move was initiated successfully, click Finish to exit the wizard. Completing Metadata Stripe Group Movement 6 After the move begins, follow these steps to complete the operation. 1 Check move status by clicking the move’s Status link on the Move Stripe Group screen (figure 103 on page 159).
Chapter 6 Managing the File System Performing Stripe Group Movement Figure 113 Stripe Group Move Status Screen 2 When the move status is Success, mark the source stripe group as “down” and then restart the file system. 3 If the status is Failed, click the link to determine the cause of failure. If desired, retry the move.
Chapter 6 Managing the File System Performing Stripe Group Movement Reusing LUNS in a Metadata Stripe Group After a Move 6 LUNs in the metadata stripe group used in a successful move can be reused immediately after the move. There is no need to rename LUNs, because during the move process StorNext automatically appends “.old” to the source’s LUN label name.
Chapter 7 7 Managing Libraries StorNext configures, allocates, and manages all components associated with libraries. Resources that can be used for libraries include a wide variety of storage drives and media. Once configured, StorNext performs automated and manual operations to ensure the libraries resources are operating at efficient levels and in stable states. StorNext also offers flexibility when maintaining or replacing library components by minimizing system downtime.
Chapter 7 Managing Libraries Adding a Library Adding a Library Use the procedure in this section to add libraries to StorNext. StorNext’s Storage Manager (SNSM) component supports three library types: • SCSI: A SCSI or fibre channel-attached library. • Network (ACSLS or DAS): A network-attached library. There are two types of network-attached library: ACSLS or DAS. • Vault: A library that stores media moved from a robotic library.
Chapter 7 Managing Libraries Adding a Library Figure 114 Library Introduction Screen 2 Click Next. The Library Type screen appears.
Chapter 7 Managing Libraries Adding a Library Figure 115 Library Type Screen 3 Select the type of library you have: SCSI, Network, or Vault. (If you select Network, choose ACSLS or DAS from the drop-down list.) 4 Click Next to continue.
Chapter 7 Managing Libraries Adding a Library Adding a SCSI Library 7 After you specify SCSI on the Library Type screen and then click Next, the Library Name screen appears. Figure 116 Library Name Screen (If you have no SCSI libraries configured, a message informs you that no SCSI devices were detected. If you receive this message, configure the library and devices before proceeding.
Chapter 7 Managing Libraries Adding a Library 1 On the Library Name screen, accept the default library name or type a name, and then click Next. The Media Types screen appears. Figure 117 Media Types Screen 2 Select a media type from the list, and then click Next. The SCSI Device screen appears.
Chapter 7 Managing Libraries Adding a Library Figure 118 SCSI Device Screen StorNext User’s Guide 175
Chapter 7 Managing Libraries Adding a Library 3 Select a SCSI device from the list and click Next. The Complete Add Library Task screen appears. Figure 119 Complete Add Library Task Screen 4 Review your selections. When finished, click Next to complete the task or Back to make changes. 5 After the status screen informs you that the library was successfully added, click Close.
Chapter 7 Managing Libraries Adding a Library Adding an ACSLS Network Library 7 After you select Network on the Library Type screen and then choose ACSLS from the drop-down list, the Library Name screen appears. Figure 120 ACSLS Library Name Screen 1 Enter the fields on the Library Name screen. • Library Name: The name of the library. This can be any name you choose. • Host Name: The actual host name or IP address of the ACSLS server. 2 Click Next to continue.
Chapter 7 Managing Libraries Adding a Library 5 After the status screen notifies you that the library was successfully added, click Close. Adding a DAS Network Library 7 After you select Network on the Library Introduction screen and then choose DAS from the drop-down list, the DAS Configuration screen appears.
Chapter 7 Managing Libraries Adding a Library Note: For more information about failover or dual aisle configurations, contact the Quantum Technical Assistance Center. Refer to Customer Assistance on page 322 for contact information. Adding a DAS Network Library with Failover 7 1 On the Library Name screen, enter valid values and click Next. Figure 122 DAS Library Name Screen StorNext User’s Guide • Library Name: The name of the library.
Chapter 7 Managing Libraries Adding a Library • Standby Server Client Name: Standby server client name configured on the network The Media Types screen appears. Figure 123 DAS Media Types Screen 2 Use the drop-down lists to map the mail boxes (EIF ports) to specific media, and then click Next. The Complete Add Library Task screen (figure 119 on page 176) appears. 3 Review your selections. Click Next to complete the task, or Back to make changes.
Chapter 7 Managing Libraries Adding a Library Adding a DAS Network Library with or without Dual Aisle Configuration 7 1 On the Library Name screen, enter valid values and click Next. Figure 124 DAS 2 Library Name Screen • Library Name: The name of the library. This can be any name you choose. • Host Name: The actual host name or IP address of the DAS server. • Client Name: The name of the client for the current configuration. The client name is queried by StorNext and automatically displayed.
Chapter 7 Managing Libraries Adding a Library 4 After a status screen informs you that the library was successfully added, click Close. Adding a Vault Library 7 After you select Vault on the Library Type screen, the Library Name screen appears. Figure 125 Vault Library Name Screen 1 Type a name for the library (or accept the displayed default name), and then click Next. The Complete Add Library Task screen (figure 119 on page 176) appears. 2 Review your selections.
Chapter 7 Managing Libraries Modifying a Library Modifying a Library This task describes how to modify a library by changing its media type. 1 From the SNSM home page, choose Library > Config Library from the Admin menu. The Configure Library screen appears. Figure 126 Configure Library Screen 2 In the Select Library list, select the library you want to modify, and then click Modify.
Chapter 7 Managing Libraries Deleting a Library Figure 127 Modify SCSI Library Screen 3 According to your needs, move media types from the Unconfigured media types list to the Configured media types list, or vice versa. To move media, select the desired media type and then click the right or left arrow to move the media to the opposite list.
Chapter 7 Managing Libraries Rescanning a Library • Delete ALL drives associated with the library as described in Deleting a Tape Drive on page 197. 1 From the SNSM home page, choose Library > Config Library from the Admin menu. The Configure Library screen (figure 126 on page 183) appears. 2 Select from the Select Library list the library you want to delete, and then click Delete. A message window prompts you to confirm that you want to delete the library. 3 Click OK to proceed.
Chapter 7 Managing Libraries Auditing a Library Auditing a Library Use this procedure to audit a library. An audit is a physical check of each library component to verify its integrity and make sure the database and library are synchronized. Quantum recommends that you audit the library after each restore. 1 From the SNSM home page, choose Library > Audit Library from the Admin menu. The Audit Library screen appears.
Chapter 7 Managing Libraries Changing the Library State 4 Click Apply. The library audit launches, and the Library Audit status screen appears. 5 After the status screen informs you that the library audit was successful, click Close. Changing the Library State This function allows you to change a library’s logical state to online or offline. Logical state means the library could be online, but StorNext treats it as offline. To physically take a SCSI library offline, use the library’s front panel.
Chapter 7 Managing Libraries Changing the Library State 3 Select the new state for the library you selected. 4 Click Apply to change the library’s state. 5 When the Status screen informs you that the library state was successfully changed, click OK. 6 If desired, repeat steps 2 - 5 to change the state for additional libraries.
Chapter 8 8 Managing Drives and Disks Tape drives provide I/O for a StorNext media library. For a detailed list of supported media for the current StorNext release, refer to the StorNext Release Notes.
Chapter 8 Managing Drives and Disks Working with Tape Drives Adding a Tape Drive 8 Use this procedure to add tape drives to your libraries. You can add any number of connected tape drives to the StorNext system. 1 From the StorNext home page, choose Add Tape Drive from the Config menu. (Alternatively, from the SNSM home page, you can choose Drive > Config from the Admin menu, and then click Add.
Chapter 8 Managing Drives and Disks Working with Tape Drives 2 Click Next to add a tape drive. The Associated Library screen appears. Figure 131 Associated Library Screen • Configured Libraries list: Select the configured library with which to associate the tape drives you are adding. • Fibre-Channel Attached Drives checkbox: Check this box if you have fibre channel-attached tape drives. If you check this box, the Match Devices with Slots screen appears. Go to Matching Devices with Slots on page 194.
Chapter 8 Managing Drives and Disks Working with Tape Drives 3 After you select a configured library on the Associated Library screen, click Next. The Hardware Devices screen appears. Figure 132 Hardware Devices Screen StorNext User’s Guide • Hardware Devices list: Select the hardware devices you want to add as drives.
Chapter 8 Managing Drives and Disks Working with Tape Drives 4 Click Next to continue. The Complete Add Drive Task screen appears. Figure 133 Complete Add Drive Task Screen 5 Review your selections. Click Next to complete the task or Back to make changes. 6 When the Status screen informs you that the tape drive was successfully added, click Next. The Tape Drive Introduction screen (figure 130 on page 190) appears. 7 Do one of the following: StorNext User’s Guide • Add more tape drives.
Chapter 8 Managing Drives and Disks Working with Tape Drives Matching Devices with Slots 8 When you select the Fibre-Channel Attached Drives checkbox on the Associated Library screen, the Match Devices with Slots screen appears. The system-specific information on this screen varies from configuration to configuration.
Chapter 8 Managing Drives and Disks Working with Tape Drives 1 If you need to see existing drive and slot mappings, click Show Mapping Help to display a list of current device mappings. Click Close when you are finished viewing the information on the Tape Drive Mapping Help screen. Figure 135 Tape Drive Mapping Help Screen Note: In some cases StorNext may not be able to determine the device to slot mapping. Limitations include ACSLS and DAS libraries.
Chapter 8 Managing Drives and Disks Working with Tape Drives Note: Modifying a Tape Drive 8 If you want to enable compression on some devices but not others in the Type>>Device>>Slot list, you must complete this procedure twice: once to enable compression on selected devices, and a second time to specify devices without compression. Use this procedure to modify configured tape drives. 1 From the SNSM home page, choose Drive > Config from the Admin menu. The Configure Drives screen appears.
Chapter 8 Managing Drives and Disks Working with Tape Drives Figure 137 Modify Drive Screen 3 Modify any of the following information: • Drive Name: The name of the modified drive. • Dismount Delay: Change the dismount delay time (in seconds). • Select New Drive Path: The drop-down menu displays available drive paths to which the drive can be changed. • Compression Enabled: Choose Yes to enable, or No to disable compression. 4 After making drive modifications, click Apply.
Chapter 8 Managing Drives and Disks Working with Tape Drives Figure 138 Delete Warning Window 3 Click OK to close the message window and proceed. 4 After the Status Screen informs you that the drive has been successfully deleted, click Close. Changing a Drive State 8 The drive state function allows you to change the logical (database) state to online or offline. 1 From the SNSM home page, choose Drive > Drive State from the Admin menu.
Chapter 8 Managing Drives and Disks Working with Tape Drives 4 After the Status Screen informs you that the drive’s status was successfully changed, click Close. The Change Drive State screen shows the changed state for the drive you selected. 5 If desired, repeat steps 2 - 4 to change the state for additional tape drives. Cleaning a Tape Drive 8 Use this procedure to manually clean a tape drive.
Chapter 8 Managing Drives and Disks Working with Drive Pools Working with Drive Pools Drive pools are groups of tape drives allocated for various administratordefined storage tasks. Drive pools enable you to delimit storage processes based on data type, performance, security, location, or all of these variables. Drive pools can reside in a single tape library or span multiple tape libraries.
Chapter 8 Managing Drives and Disks Working with Drive Pools Figure 141 Configure Drive Pools Screen 2 Click Add to add a new drive pool. The Add New Drive Pool screen appears. Figure 142 Add New Drive Pool Screen 3 Enter a name for the new drive pool in the Drive Pool Name field.
Chapter 8 Managing Drives and Disks Working with Drive Pools 4 Select from the Select Drive IDs list the drives you want to include in the new drive pool, and then click Apply. A message window warns you that continuing with the task restarts the Storage Manager. Figure 143 Warning Message Window 5 Click OK to close the message window and continue. 6 After the Status screen informs you that the drive pool was successfully added, click Close.
Chapter 8 Managing Drives and Disks Working with Drive Pools Figure 144 Modify Drive Pool Screen 3 Select from the Associated Drives list the drive you want to move to the Available Drives list, and then click Remove Left. The drive is removed from the Associated Drives list and appears in the Available Drives list. 4 If desired, you can also move drives from the Available Drives list to the Associated Drives list.
Chapter 8 Managing Drives and Disks Working with Drive Pools 7 After the status screen informs you that your drive pool modifications were successful, click Close. Deleting a Drive Pool 8 Use this procedure to delete a drive pool. You cannot delete a drive pool if there are drives currently associated with it. To disassociate drives from the drive pool, see Modifying a Drive Pool on page 202. Caution: At least one drive pool must be configured at all times. Do not delete the default drive pool.
Chapter 8 Managing Drives and Disks Managing Disk Space Managing Disk Space This function allows you to apply a storage policy or truncation policy to a file system, and to adjust other parameters that help you manage disk space. 1 From the SNSM home page, choose Disk Space from the Admin menu. The Manage Disk Space screen appears. Figure 147 Manage Disk Space Screen 2 Select from the File Systems list the file system that contains the disks whose space you want to manage.
Chapter 8 Managing Drives and Disks Changing Watermark Parameters • Stop at Occupied Disk Space: Specify the disk-full percentage at which the storage or truncation policy is no longer applied. • MINTIME Before File Migration: If you chose the Storage Policy option, enter the minimum amount of time (in minutes) before a file is migrated. • MINTIME Before File Truncation: If you chose the Truncation Policy option, enter the minimum amount of time (in days) before a file is truncated.
Chapter 8 Managing Drives and Disks Changing Watermark Parameters 1 From the SNSM home page, choose Watermark Parameters from the Admin menu. The Change Watermark Parameters screen appears. Figure 148 Change Watermark Parameters Screen 2 Select from the Managed File System(s) dropdown list the file system for which you want to set watermark parameters.
Chapter 9 9 Managing Media In StorNext, data is usually stored on tapes in a media library. For a detailed list of supported media, refer to the StorNext Release Notes. Managing tape media consists of the following tasks: • Adding Media to a Configured Library • Removing and Moving Media • Using the SNSM Media Functions Caution: If you are sharing a library between applications, refer to the StorNext Installation Guide.
Chapter 9 Managing Media Adding Media to a Configured Library 1 From the StorNext home page, choose Add Media from the Config menu. The Add Media - Introduction screen shows a list of current libraries, along with the number of media each library can hold.
Chapter 9 Managing Media Adding Media to a Configured Library 2 Click Next to add media to a configured library. The Associated Library screen appears.
Chapter 9 Managing Media Adding Media to a Configured Library 3 On the Associated Library screen, select a configured library to which you want to add media, and then click Next. The second Associated Library screen appears. Figure 151 Associated Library Screen 2 If you selected a media vault on the first Associated Library screen, go to Step 1—page 214. 4 On the second Associated Library screen, do one of the following: StorNext User’s Guide • Specify Mailbox and click Next.
Chapter 9 Managing Media Adding Media to a Configured Library 5 When you specify Mailbox on the Associated Library screen, the Select Mailbox screen appears. Figure 152 Select Mailbox Screen Select a mailbox and click Next.
Chapter 9 Managing Media Adding Media to a Configured Library 6 When the Complete Add Media Task screen appears, review your selections. Figure 153 Complete Add Media Task Screen Click Next to complete the task or click Back to make changes. 7 After a status screen informs you that media has been successfully added, click Finish.
Chapter 9 Managing Media Adding Media to a Configured Library Adding a Vault 9 Use this procedure to add a vault to the library. 1 When you select a media vault on the Associated Library screen, the Select Media Type screen appears.
Chapter 9 Managing Media Adding Media to a Configured Library 2 On the Select Media Type screen, select the type of media you want to add to the vault. The Add Media IDs screen appears. Figure 155 Add Media IDs Screen 3 On the Add Media IDs screen, do one of the following: StorNext User’s Guide • Enter the name for the new media in the Media Name field. Go to Step 5—page 216. • Select one or more previously entered media IDs from the list, and then click Next. Go to Step 6—page 216.
Chapter 9 Managing Media Adding Media to a Configured Library • Add multiple media labels by clicking the New Media button. The Create New Media ID screen appears. Figure 156 Create New Media ID Screen 4 On the Create New Media ID screen, perform the following steps: 1 Enter the new media label name. 2 Enter the number of media IDs you want to generate for the label. 3 Enter a starting value for the new media ID. 4 If you want to create additional media IDs, click Apply and repeat steps 1 through 3.
Chapter 9 Managing Media Removing and Moving Media Removing and Moving Media These procedures enable you to remove or move media from a library to a different library or vault while preserving the existing data. • Removing Media • Moving Media Removing Media 9 Use this procedure to remove blank media, backup tapes, or cleaning media from the StorNext system. 1 From the StorNext home page, choose Remove/Move Media from the Admin menu. The Remove or Move Media screen appears.
Chapter 9 Managing Media Removing and Moving Media 3 Select from the Select Library list the library from which to remove the media. If the library has more than one media type, specify the type of media you want to remove from the selected library. Click Next to continue. The Select Media screen appears. Figure 158 Select Media Screen 4 To remove individual media, enter the media name in the Enter Media field and click OK. The Complete Remove/Move Media Task screen appears. Go to Step 10—page 220.
Chapter 9 Managing Media Removing and Moving Media 5 To remove multiple media, click Browse. The StorNext Media Browser screen appears. Figure 159 StorNext Media Browser Screen 6 On the StorNext Media Browser screen, select the Media Class to remove: Blank, Cleaning, or Backup. The StorNext Media Browser screen displays in the Select Media field all the media associated with the class you have selected. The Current Media Class field shows the media class you just selected.
Chapter 9 Managing Media Removing and Moving Media 9 Select from the Media List the media you want to remove, and then click Next. The Complete Remove/Move Media Task screen appears. Figure 160 Complete Remove/ Move Media Task Screen 10 Review your selections and click Next to apply them or Back to make changes. The Remove/Move Media status screen appears.
Chapter 9 Managing Media Removing and Moving Media 11 After the status screen informs you that the media has been successfully removed, click Finish. The Library Operator Interface (LOI) screen appears. Figure 161 Library Operator Interface Screen 12 The name of the library on which the media resides is displayed. Click Eject Media. The Library Operator Interface screen updates and indicates the selected library. Available media operations for each library are shown.
Chapter 9 Managing Media Removing and Moving Media • Select All: Click this button to select all media in the Select Media list for removal • Deselect All: Click this button to deselect all media in the Select Media list • Details: Click this button to view information about selected media • Eject: Click this button to eject (remove) media from the library • Fail: Click this button to mark selected media as Failed • Close: Click this button to close the current window Note: All of the media op
Chapter 9 Managing Media Removing and Moving Media 6 Select a media class. The Select Media list is populated with all available media in the class you selected. 7 Select from the Select Media list the media you want to move, and then click OK. The Select Media screen reappears, showing your selection. 8 Click Next to continue. The Select Destination Library appears. Figure 163 Select Destination Library Screen 9 Select the destination library from the list, and then click Next.
Chapter 9 Managing Media Removing and Moving Media 11 After the status screen informs you that the task was completed successfully, click Finish. The Library Operator Interface (LOI) screen appears with the source library flagged. Figure 164 Library Operator Interface Screen 12 Eject the media from the source library, and then click the highlighted Eject Media button. The LOI Eject screen (figure 162 on page 221) appears. 13 Select the media to be moved, and then click Eject. Click Close to continue.
Chapter 9 Managing Media Using the SNSM Media Functions 14 Move the media to the destination library and click the highlighted Enter Media button. The LOI Enter screen appears. Figure 165 LOI Enter Screen 15 Click Eject to continue, and then click Close. The LOI screen reappears without flags or highlights. 16 Click Close to finish. Using the SNSM Media Functions The StorNext Storage Manager’s Media menu contains functions that enable you to accomplish the following tasks: • Moving Media Manually.
Chapter 9 Managing Media Using the SNSM Media Functions • Transcribing Media. • Changing Media Attributes. • Reclassifying a Media Class Grouping. • Cleaning Media. • Cancelling the Eject Media Process. These functions are not available if you have only StorNext File System and not StorNext Storage Manager. Moving Media Manually 9 Use this function to flag media you plan to move manually from the source library to a destination library.
Chapter 9 Managing Media Using the SNSM Media Functions Figure 166 Manually Move Media Screen 2 Select from the Source Archive dropdown list the source library that contains the media you want to move. 3 Click Browse when you are ready to flag specific media for moving manually. The Media Browser screen appears.
Chapter 9 Managing Media Using the SNSM Media Functions 4 On the Media Browser screen, select from the Select Media list the media you plan to move manually. If desired, you can reduce the number of entries in the media list by entering a filter in the Media Filter field. This field accepts the wildcard character (asterisk *). You can also select all media by clicking the Select All button. 5 Click OK after you are finished selecting media.
Chapter 9 Managing Media Using the SNSM Media Functions Figure 168 Mount Media Screen 2 Select from the Archive drop-down menu the archive that contains the media you want to mount. The screen updates to show available media in the archive you selected. 3 Select from the Media ID list the media you want to mount. 4 If desired, use the Filter field to narrow your search when looking for a specific media ID. For example, enter *01 and click the Filter button to find all media IDs ending in 01.
Chapter 9 Managing Media Using the SNSM Media Functions Figure 169 Dismount Media Screen 2 Select either a Media or Drive ID from the drop-down menu. Depending on which ID you selected, the information in the other field automatically populates. 3 Review your selections and click Apply. 4 After the Status screen informs you that the operation was successful, click Close. Removing Media From the Storage Manager 9 StorNext User’s Guide Use this function to remove media from the StorNext Storage Manager.
Chapter 9 Managing Media Using the SNSM Media Functions 1 From the SNSM home page, choose Remove from the Media menu. The Remove Media From SNSM screen appears. Figure 170 Remove Media From SNSM Screen 2 Select from the Select Media list the media you want to remove. To reduce the number of media shown, you can enter a search filter in the Enter Filter field. This field accepts the wildcard character (asterisk *). 3 Click Apply when you are ready to remove media.
Chapter 9 Managing Media Using the SNSM Media Functions 1 From the SNSM home page, choose Assign Policy from the Media menu. The Assign Policy screen appears. Figure 171 Assign Policy Screen 2 Select from the Select Media list the blank media you want to move. 3 Select from the Select Policy Classes list the policy class to which you want to move the blank media you selected. 4 Click Apply when you are ready to move the selected blank media.
Chapter 9 Managing Media Using the SNSM Media Functions 1 From the SNSM home page, choose Transcribe from the Media menu. The Transcribe Media screen appears. Figure 172 Transcribe Media Screen 2 Select from the Select Media to Transcribe list one or more media, and then click Apply. 3 After the status screen informs you that the media has been transcribed, click Close. If transcription or reclamation starts and all the drives are in use, SNSM prioritizes and queues the job.
Chapter 9 Managing Media Using the SNSM Media Functions Changing Media Attributes 9 This function allows you to change the current state of one or more pieces of media. You can change the state to one of the following: • Unsuspect: Indicates that the media is physically sound and not in a suspect (potentially damaged or unusable) condition. • Write Protect: Write protected media cannot be overwritten or have data added. • Write Unprotect: This media can be overwritten or have data added.
Chapter 9 Managing Media Using the SNSM Media Functions 5 When the Status screen informs you that the media statuses were successfully changed, click OK. Reclassifying a Media Class Grouping 9 A media class grouping is a media management tool that segregates media into classes. Membership in a media class grouping is exclusive, so media can belong to only one class grouping. Media class groupings are restricted to one type of media. Valid media types are Clean, Data, and Migrate.
Chapter 9 Managing Media Using the SNSM Media Functions 2 Select from the Source Media Class list the desired source media class, and then click Browse to select the media IDs you want to reclassify. The Media Class Browser window appears. Figure 175 Media Class Browser Window 3 Select one or more media from the Select Media list, and then click OK to return to the Reclassify Media screen. The IDs for the selected media are shown in the Entered Media IDs list.
Chapter 9 Managing Media Using the SNSM Media Functions Cleaning Media 9 This function allows you to clean a file system, policy class, or media. Periodic cleaning helps prevent inactive information from growing to an unmanageable size. When you run this function, the StorNext Storage Manager removes inactive files that have not been accessed since the specified endtime. This process does not affect current file versions on the media.
Chapter 9 Managing Media Using the SNSM Media Functions 3 Specify at the Endtime field an ending time for the cleaning process, using the format YYYY:MM:DD:hh:mm:ss. For example, enter 2007:12:06:10:08:00 for an endtime of 10:08 on December 6, 2007. 4 Click Apply to start the cleaning process. 5 When the Status screen informs you that the operation was completed successfully, click OK. Cancelling the Eject Media Process 9 Use this function to cancel the eject process for selected media.
Chapter 10 10 Managing Storage Disks StorNext provides the ability to configure storage disks that function and operate the same way as physical tape media. Storage disks are external devices on UNIX-based file systems that can be used for long term data storage. 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.
Chapter 10 Managing Storage Disks Storage Disk Deduplication • Use complete and physically dedicated file systems (snfs, local, nfs, or other,) for storage disk data, not shared file systems or file systems with linked directories. • If your file system includes storage disks and you accidentally fill it with unrelated user data (i.e., non-storage disk data,) call the Quantum Technical Assistance Center and ask for a procedure to clean up and transcribe data.
Chapter 10 Managing Storage Disks Adding a Storage Disk Adding a Storage Disk Storage disks are treated the same as media in the system. Before you configure a new storage disk, the disk you want to use must be in a file system that is already created and mounted. Note: When you are creating storage disks, exercise caution before enabling the deduplication feature. Once you create a dedup SDISK, you cannot change it to a non-enabled storage disk.
Chapter 10 Managing Storage Disks Adding a Storage Disk 2 Click Add. The Add Storage Disk - Introduction screen appears, listing any currently configured storage disks.
Chapter 10 Managing Storage Disks Adding a Storage Disk 3 Click Next. The Add Storage Disk screen appears. Figure 180 Add Storage Disk Screen 4 Enter the fields on the Add Storage Disk screen. StorNext User’s Guide • Storage Disk Name: Enter a name for the storage disk, or accept the displayed default name. • Enable Deduplication: Select this option if you want to enable deduplication and create a dedup SDISK.
Chapter 10 Managing Storage Disks Adding a Storage Disk • Copy # Used for all Policy Classes: Select the copy number (Copy 1, Copy 2, Copy 3, or Copy 4) for the new storage disk. This copy number will be used by all policy classes. Note: Only copies of the number you choose can be written to this disk. For example, if you select copy number 1, only files with that copy number can be written to the storage disk. 5 Click Next. The Complete Storage Disk screen appears.
Chapter 10 Managing Storage Disks Modifying a Storage Disk Modifying a Storage Disk Use this procedure to modify a previously configured storage disk. 1 From the SNSM home page, choose Storage Disk > Config from the Admin menu. The Configure Storage Disk screen (figure 178 on page 241) appears. 2 Select a storage disk from the Current Storage Disks list, and then click Modify. The Modify Storage Disk screen appears. Figure 182 Modify Storage Disk Screen Note: For a blank storage disks (i.e.
Chapter 10 Managing Storage Disks Deleting a Storage Disk • Mount Point: The file system mount point for the storage disk. You can change the mount point only on a blank or unused file system. To change the mount point, select an existing mount point from the drop-down list, and then click Browse. The directory changes in the Mount Point field. (You can modify this parameter only for an unused storage disk.
Chapter 10 Managing Storage Disks Changing a Storage Disk State Caution: All data on the storage disk will be removed when you continue, so proceed with extreme caution. There is no “undo” feature that will undelete the storage disk if you change your mind, so be absolutely certain you want to delete the storage disk before you continue. Figure 183 Delete Warning Message 3 Click OK. 4 After the Status screen informs you that the storage disk was successfully deleted, click Close.
Chapter 10 Managing Storage Disks Changing a Storage Disk State Figure 184 Change Storage Disk State Screen 2 Select the storage disk whose state you want to change. 3 Select the state (Online or Offline) to assign to the selected storage disk, and then click Apply. Note: The “Online Pending” state applies only to deduplicationenabled storage disks. This state means a verification process is currently in progress. When verification is complete, the status automatically changes to “Online.
Chapter 10 Managing Storage Disks Cleaning a Storage Disk Cleaning a Storage Disk The cleaning process scans the storage disk and removes inactive files that have not been accessed since the endtime, and orphaned file copies (i.e., archive copies on the file system disk,). Using this process helps prevent the inactive information from growing to an unmanageable size. This process does not affect current file versions on the media.
Chapter 10 Managing Storage Disks Cleaning a Storage Disk Note: StorNext User’s Guide When you clean a deduplication-enabled storage disk, blocklets are not immediately freed from the associated blockpool. The unused blocklets will be freed when the weekly clninfo schedule is run. If you want to immediately free blocklets, you can run the fsclean -b command from the command line.
Chapter 11 11 Data Migration Management This chapter describes how to use StorNext to manage data. This chapter covers these topics: • Policy Classes and Relationships • Adding a Storage Policy • Modifying a Policy Class • Deleting a Policy Class • Applying a Policy Class This chapter includes procedures executed from the command line. Before initially executing any StorNext command line programs, you must first source either the .profile or the .
Chapter 11 Data Migration Management Policy Classes and Relationships Policy Classes and Relationships A policy class defines how files will be managed in a directory and subdirectories.
Chapter 11 Data Migration Management Adding a Storage Policy remains on disk after data blocks are freed during policy management or space management. Disk-to-Disk Relocation11 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. You can perform this procedure only if you have the full StorNext suite. (Customers with StorNext File System only cannot perform this procedure.
Chapter 11 Data Migration Management Adding a Storage Policy Note: You cannot create a policy class when a client is NFS mounted to an active Stornext file system. When you create a policy class, the StorNext GUI executes the command fsaddrelation. The fsaddrelation command fails if the specified directory is not empty and the associated file system is busy. When a client is NFS mounted, the NFS daemon holds a reference in the directory. Consequently, the unmount fails, aborting the fsaddrelation process.
Chapter 11 Data Migration Management Adding a Storage Policy Figure 187 Policy Class and Directory Screen 3 Select any of the following options: StorNext User’s Guide • Enable Disk-to-Disk: Select this option to activate the Disk-toDisk Relocation feature. For more information about Disk-toDisk Relocation, see Disk-to-Disk Relocation on page 253.
Chapter 11 Data Migration Management Adding a Storage Policy 4 Click Browse. The Directory Browser window appears. Figure 188 Directory Browser Window 5 Select a directory that contains the files you want to migrate, and then click OK. The Policy Class and Directory screen (figure 187) reappears, showing the directory you specified. 6 Review your selections and click Next. If you enabled the disk-todisk relocation feature, the Relocation Policy Selection screen appears.
Chapter 11 Data Migration Management Adding a Storage Policy Figure 189 Relocation Policy Selection Screen 7 On the Relocation Policy screen, select from the first drop-down list the affinity from which to move your data. Select from the second drop-down list the affinity to which you want to move the data.
Chapter 11 Data Migration Management Adding a Storage Policy 8 Click Next to continue. The Store, Truncate, and Relocate Time screen appears.
Chapter 11 Data Migration Management Adding a Storage Policy • Stub File Size (Kbytes): The desired target size to allocate for the file stub. This is the readable portion of the file that remains after truncation when the Stub File feature is enabled. This option appears only when you selected the stub file option. After entering values, click Next to continue. The Number of File Copies and Media Type screen appears.
Chapter 11 Data Migration Management Adding a Storage Policy 9 Select up to four copies to store for each file, including the primary file (File Copy 1). Select the media type for each copy, and then click Next. The Complete Storage Policy Task screen appears Figure 192 Complete Storage Policy Task Screen 10 Review the information and click Next to continue, or Back to edit your choices. 11 After the Status screen informs you that the procedure completed successfully, click Close.
Chapter 11 Data Migration Management Adding a Storage Policy 1 From the SNSM home page, choose Policy Classes from the Admin menu. The Manage Policy Classes screen appears. Figure 193 Manage Policy Classes Screen 2 Click Add to continue. The Add Policy Class screen appears. Figure 194 Add Policy Class Screen 3 Enter in the Policy Class Name field the name of the new policy class.
Chapter 11 Data Migration Management Adding a Storage Policy 4 Click Properties to change the default parameters of the new policy class. The Modify Parameters screen appears.
Chapter 11 Data Migration Management Adding a Storage Policy 5 On the Modify Parameters screen, enter both the Standard Options and Advanced Options as desired. • File Copy 1, 2, 3, and 4: The copy number used when storing assigned media. The copy number assigned to the media determines which copy goes to the media. You must specify media for all copies used. You must use at least one copy (Copy 1), and can use up to four copies.
Chapter 11 Data Migration Management Adding a Storage Policy database stores data in files on the host computer, so the increase in database size translates to a corresponding increase in disk space requirements. The exact amount of space consumed (whether the feature is enabled or disabled) may vary. StorNext User’s Guide • Stub Files: Select this option to enable the Stub File feature. • Stub File Size: When the Stub File feature is enabled, specify the target size for the stub file in kilobytes.
Chapter 11 Data Migration Management Adding a Storage Policy • Enable Retrieve to Affinity: Enable this option if you want to restore to an alternative affinity. When enabled, this feature allows you to retrieve truncated files to a specified affinity that might be different from the affinity assigned during ingest. (StorNext supports up to two affinities.) For example, you could migrate files from A1 (affinity 1) to tape storage, but have the policy pull a file back to A2 (affinity 2) instead of to A1.
Chapter 11 Data Migration Management Adding a Storage Policy 2 Select the policy class for which you wish to create a relation point, and then click Add. The Add Relationship screen appears. Figure 197 Add Relationship Screen 3 Click Browse to view directories to which you can make the relationship. The Directory Browser window appears.
Chapter 11 Data Migration Management Modifying a Policy Class 4 Select from the list a directory to which to add the relationship directory. A second Directory Browser window appears, showing the directory you selected in the Current Directory field. 5 Click OK. The Add Relationship screen appears, showing the new directory. 6 Click Apply. 7 After the Status screen informs you that the operation completed successfully, click Close.
Chapter 11 Data Migration Management Deleting a Policy Class 1. Log on as root. 2. Change directories to the location where the relation resides. 3. Remove all files and directories. Use the following procedure to delete a policy class. 1 To remove the relations for the policy class, from the SNSM home page choose Relations from the Admin menu. The Manage Policy Class Relationships (figure 196) appears. 2 In the list, select a policy class and click Remove. The Remove Relationships for... screen appears.
Chapter 11 Data Migration Management Applying a Policy Class Applying a Policy Class After you have created at least one policy class, you can select that policy class and apply it immediately. 1 From the SNSM home page, choose Policy Classes from the Admin menu. The Manage Policy Classes screen (figure 193) appears. 2 Select from the Select Policy Class list the policy class you want to apply. 3 Click Run to apply the policy class immediately.
Chapter 12 12 StorNext Reports StorNext enables you to generate and view a number of reports that provide information about your StorNext system. These reports are selectable from the StorNext home page, the SNFS home page, and the SNSM home page. The following reports are available: • The Backup Information Report: Provides information about primary and secondary backups for the StorNext system.
Chapter 12 StorNext Reports The Backup Information Report • The Relation Information Report: Provides information about the directory-to-policy class relationships in the file system. • The Request Information Report: Provides information about requests, including the type of request, priority, and current status. • The Scheduler Information Report: Provides information about StorNext schedules. • The Storage Disk Information Report: Provides information about the configured storage disks on your system.
Chapter 12 StorNext Reports The Drive State Information Report • Status: The current status of backup: PASS, STORED, or NOT. (NOT means all copies of the backups were not stored to media.) • Media: The media ID on which the backup was stored Use the following procedure to run the Backup Information Report. 1 Choose Backups from the Reports menu. The Backup Information Report appears, showing information for the backups.
Chapter 12 StorNext Reports The Drive State Information Report StorNext User’s Guide • Tape Compression: Indicates whether tape compression is currently turned on or off • Associated Library: The name of the library associated with the drive • State: Indicates whether the drive is currently online or offline • Status: Indicates the drive’s current status, which is one of these conditions: • FREE: No medium is mounted • IN USE: Medium is in use • FAILED: Drive failed • DELAYED: Drive is in a
Chapter 12 StorNext Reports The Drive State Information Report Use the following procedure to run the Drive State Information Report. 1 Choose Drives from the Reports menu. The Drive States Report screen appears.
Chapter 12 StorNext Reports The File Information Report 2 Select from the drives list one or more drives to include in the report, and then click Apply. The Drive State Information Report appears with state information for the selected drives. Figure 202 Drive State Information Report 3 Click Close when you are finished viewing the report.
Chapter 12 StorNext Reports The File Information Report • Truncation Immediately After Store: Indicates whether files are truncated immediately after a store • File Location: The media on which the file is stored • Copies: The number of copies of the file • Affinity: The affinity with which the file is associated • Set Stub Size (KB): If the Stub File feature is enabled, this is the target size (in kilobytes) for the stub file • Actual Stub Length (KB): If the Stub File feature is enabled, this is the actu
Chapter 12 StorNext Reports The File Information Report • In the Enter Individual File field, type a file name. Proceed to Step 5—page 278. • Select multiple files from the Select Files list. (You can click the Select All button to select all files in the list, or click Deselect All to deselect all selected files.) Proceed to Step 5—page 278. • Click Browse to select files from a managed directory. 3 When you click Browse, the StorNext File Browser screen appears.
Chapter 12 StorNext Reports The Library Information Report 5 Click Apply to run the report. The File Information Report appears with information for the selected files. Figure 205 File Information Report 6 Click Close when you are finished viewing the report.
Chapter 12 StorNext Reports The Library Information Report • Import Media Class: The media type to import Use the following procedure to run the Library Information Report. 1 Choose Libraries from the Reports menu. The Libraries Report screen appears.
Chapter 12 StorNext Reports The Library Space Used Report 2 Select from the Library List one or more libraries on which to run the report, and then click Apply. The Library Information Report appears with information about the selected libraries. Figure 207 Library Information Report 3 Click Close when you are finished viewing the report. The Library Space Used Report The Library Space Used Report shows the amount (in gigabytes) of storage currently used by all configured libraries.
Chapter 12 StorNext Reports The Media Information Report Use the following procedure to run the Library Space Used Report. 1 Choose Library Space from the Reports menu. The Library Space Used Report appears. Figure 208 Library Space Used Report 2 Click Close when you are finished viewing the report. The Media Information Report The Media Information Report provides the following information: • Copy #: The number next to the media ID in the upper left corner that refers to the corresponding copy.
Chapter 12 StorNext Reports The Media Information Report • Media Class: The media class designated for the tape • Policy Class: Indicates whether a policy class is associated with the media • Last Access Time: The date and time when the media was last used • Media Status: Indicates media status: Available, Unavailable, or In Use • Write Protect: Indicates whether the media is write-protected • Formatted: Indicates whether the media is formatted • Import Date: The date the media was added to the library • E
Chapter 12 StorNext Reports The Media Information Report • Status: The file’s current status: Active or Inactive • Modify/Delete Date: The date the file was last modified or deleted Use the following procedure to run the Media Information Report. 1 Choose Media from the Reports menu. The Media Report screen appears.
Chapter 12 StorNext Reports The Media Information Report 3 When you click Browse, the Media Browser screen appears. Select from the View by: list a library or media class. Figure 210 Media Browser screen The selected library or media class appears in the Current Selection field, and the media associated with the selected library are shown in the Select Media list. 4 In the Select Media list, select one or more media, and then click OK.
Chapter 12 StorNext Reports The Media Information Report 5 Click Apply to continue. The Media Information Report appears.
Chapter 12 StorNext Reports The Policy Class Information Report 6 If desired, click the Show Details link to view detailed media information. The Detailed Media Information Report appears. Figure 212 Detailed Media Information Report 7 Click Close when you are finished viewing the report. The Policy Class Information Report The Policy Class Information Report provides the following information: • File Copy (1-4): The number of copies stored for each file.
Chapter 12 StorNext Reports The Policy Class Information Report • Truncate Immediately After Store: Indicates whether files truncate immediately after a store • Checksum Validation: If enabled, checksums are compared to retained values for the files retrieved by the corresponding policy class • Checksum Generation: If enabled, checksums are generated and retained in the database for files stored by the corresponding policy class • Minimum Set Store Size (1 to 999 in MB or GB): The minimum size that all val
Chapter 12 StorNext Reports The Policy Class Information Report The Schedules section of the report provides the following information about the schedule associated with the Policy Class: • Name: Name of the associated schedule • Run Days: The days on which the schedule is set to run • Start Time: The time when the schedule is set to begin running • Start Window: The timeframe within which the scheduler attempts to begin the process. (For example, 30 minutes.
Chapter 12 StorNext Reports The Policy Class Information Report Use the following procedure to run the Policy Classes report. 1 Choose Policy Classes from the Reports menu. The Policy Classes Report screen appears. Figure 213 Policy Classes Report Screen 2 Select from the Select Policy Class list one or more policy classes on which to run the report. 3 To also view media associated with these policy classes, select the Show Media option.
Chapter 12 StorNext Reports The Relation Information Report 4 Click Apply. The Policy Class Information Report appears. Figure 214 Policy Class Information Report 5 Click Close when you are finished viewing the report. The Relation Information Report The Relation Information Report shows the pathname of the selected directory and the corresponding policy class name for the directory. Use the following procedure to run the Directory/Policy Class Relationship report.
Chapter 12 StorNext Reports The Relation Information Report Figure 215 Directory/Policy Class Relationships Report Screen 2 Select from the Select Managed Directories list the directory on which the report is run, and then click Apply. The Relation Information Report appears.
Chapter 12 StorNext Reports The Request Information Report Figure 216 Relation Information Report 3 Click Close when you are finished viewing the report. The Request Information Report Use the following procedure to run the Requests report. 1 Choose Requests from the Reports menu. The Requests Report screen appears.
Chapter 12 StorNext Reports The Scheduler Information Report Figure 217 Request Report Screen 2 Select from the Request ID list one or more request IDs on which to run the report, and then click Apply. The Request Information Report appears. 3 Click Close when you are finished viewing the report.
Chapter 12 StorNext Reports The Scheduler Information Report • Window: If StorNext was down at the time of the scheduled event and is restarted during the window time period, the event is launched; otherwise it is skipped until the next scheduled time • Last Run: The time the schedule was last run Use the following procedure to run the Scheduler report. 1 Choose Scheduler from the Reports menu. The Scheduler Report screen appears.
Chapter 12 StorNext Reports The Storage Disk Information Report 2 Select one or more of the schedules on which to report, and then click Apply. The Scheduler Information Report appears. Figure 219 Scheduler Information Report 3 Click Close when you are finished viewing the report. The Storage Disk Information Report The Storage Disk Information Report provides the following information.
Chapter 12 StorNext Reports The Storage Disk Information Report • # of Streams: The number of streams that can simultaneously access the storage disk • Status: Shows if the storage disk is currently available or offline • Write Protected: Indicates whether the storage disk is write protected • Last Access Time: The date and time the storage disk was last accessed • # Files: The number of files on the storage disk • Space Used: The amount of space consumed on the storage disk • Space Remain: The amount of s
Chapter 12 StorNext Reports The Storage Disk Information Report Figure 220 Storage Disk Report Screen 2 Select the disks on which to run the report and click Apply. The Storage Disk Information Report appears. Note: StorNext User’s Guide If you enable the Show Files on Storage Disk option, the report could be very large and take a long time to run, depending on the number of files on the storage disk.
Chapter 12 StorNext Reports The Directory Affinity Report Figure 221 Storage Disk Information Report 3 Click Close when you are finished viewing the report. The Directory Affinity Report Use the following procedure to run the Affinities report. 1 Choose SNFS > Affinities from the Reports menu. The Affinities Report screen appears.
Chapter 12 StorNext Reports The Directory Affinity Report Figure 222 Affinities Report Screen 2 Do one of the following: StorNext User’s Guide • In the Select Individual Directory text box, type the full path of the directory on which the to run the report. Proceed to Step 4. • Click Browse to select a directory. The Directory Browser screen appears.
Chapter 12 StorNext Reports The Directory Affinity Report Figure 223 Directory Browser Screen 3 On the Directory Browser screen, select the directories on which to run the report. 4 Click Apply. The Directory Affinity Information report appears. Figure 224 Directory Affinity Report 5 Click Close when you are finished viewing the report.
Chapter 12 StorNext Reports The File System Statistics Report The File System Statistics Report The File System Statistics Report provides the following information: • Creation Date: The date and time when the file system was created • # Active SAN Clients: The number of SAN client machines associated with the file system • File System Block Size: The file system’s block size • Message Buffer Size: The size of the file system message buffer • # Disk Devices: The number of disk devices on the file system •
Chapter 12 StorNext Reports The File System Statistics Report Use the following procedure to run the File System report. 1 Choose SNFS > Systems from the Reports menu. The File System Report screen appears.
Chapter 12 StorNext Reports The Stripe Group Statistics Report 2 In the Active File Systems list, select one or more active file systems on which to run the report, and then click Apply. The File System Statistics Report appears, showing statistical data for the selected file systems. Figure 226 File System Statistics Report 3 Click Close when you are finished viewing the report.
Chapter 12 StorNext Reports The Stripe Group Statistics Report • Disks in Group: The list of disks assigned to the stripe group Use the following procedure to run the Stripe Groups report. 1 Choose SNFS > Stripe Groups from the Reports menu. The Stripe Groups Report screen appears. Figure 227 Stripe Groups Report Screen 2 Select from the Active File Systems menu the file system containing the stripe group for which to create the report.
Chapter 12 StorNext Reports The File System Client Report 3 In the Stripe Groups list, select one or more stripe groups on which to run the report, and then click Apply. The Stripe Group Statistics Report appears. Figure 228 Stripe Group Statistics Report 4 Click Close when you are finished viewing the report. The File System Client Report The File System Statistics Report provides the following information: • File System: The name of the file system supporting the clients.
Chapter 12 StorNext Reports The File System Client Report • Distributed LAN Servers: The names of the distributed LAN servers. • Distributed LAN Clients: The names of distributed LAN clients. • LAN Servers: The name of the distributed LAN server for which the subsequent details apply. • Listening IP:Port: The IP address and port number through which the distributed LAN server communicates with StorNext. • TCP Window Size: The TCP window size (in KB) used by the distributed LAN server.
Chapter 12 StorNext Reports The File System Client Report Figure 229 File System Client Report Screen 2 Select from the Active File Systems list one or more file systems to include in the report. Click Apply to continue. The File System Client Report appears.
Chapter 12 StorNext Reports The File System LAN Client Report Figure 230 File System Client Report 3 Click Close when you are finished viewing the report. The File System LAN Client Report The File System LAN Client Report provides the following information: • File System Name: The name of the file system that supports the indicated distributed LAN server. • Distributed LAN Server Name: The name of the distributed LAN server on the indicated file system.
Chapter 12 StorNext Reports The File System LAN Client Report • Read: The speed at which the distributed LAN client is currently reading data. • Write: The speed at which the distributed LAN client is currently writing data. Use the following procedure to run the Distributed LAN Client Performance Report. 1 Choose SNFS > LAN Client Performance from the Reports menu. The File System Distributed LAN Client Statistics Report screen appears.
Chapter 12 StorNext Reports The File System LAN Client Report Figure 232 File System LAN Client Report 3 If desired, click Refresh to manually update (refresh) the report data. You can also use the Auto Refresh Rate field to specify one of these automatic refresh intervals: • No Refresh • 5 seconds • 10 seconds • 30 seconds • 1 minute • 5 minutes 4 Click Close when you are finished viewing the report.
Chapter 13 13 Service Management This chapter describes how to use the StorNext Service Management tools to run a health check on your system, create a log that captures the current state of your system, or check current system status.
Chapter 13 Service Management Using Health Check • Drive: Verify that all configured drives are online • Media: Verify that there are enough media available for all policies to store all file copies, and that SNSM media are configured correctly • Policies: Verify that SNSM is keeping up with file system events and store candidate processing Running a Health Check 13 Use the following procedure to run a health check.
Chapter 13 Service Management Using Health Check 1 Select a health check from the Health Check Tests screen. 2 Click History. The Health Check History screen appears. Figure 234 Health Check History Screen 3 Do one of the following: • Select a specific report to view and click Details. • Click the Pass or Fail link in the Results column. Proceed to Viewing the Health Check Results on page 314. 4 When you click Details on the Health Check History screen, the Health Check Results screen appears.
Chapter 13 Service Management Using Health Check Figure 235 Health Check Results Screen 5 Click Back to view more archives, or close the window when finished. Viewing the Health Check Results 13 When viewing the Health Check Tests or the History screen, you can check the details of the Last Status of a particular health check. The following example shows how to run the last status check from the Health Check Tests screen. 1 From the StorNext home page, choose Health Check from the Service menu.
Chapter 13 Service Management Using State Capture Using State Capture The StorNext State Capture tool enables you to create a log that captures the current state of your system. This log assists Quantum support personnel analyze and debug some problems in the storage system. When you use the State Capture tool, StorNext creates a log file named using the format snapshot-machinehostnameYYYYMMDDHHMMSS.tar.gz.
Chapter 13 Service Management Using State Capture 2 Click Capture. The Capture State Status window is shown. 3 When the Status window informs you that the capture was successful, click Close. Downloading a Previous System Capture 13 After you have created at least one system capture, you can select and download one of those .tar.gz files to view. 1 From the StorNext home page, choose State Capture from the Service menu.
Chapter 13 Service Management Using the System Status Tool Deleting a Previous System Capture 13 When you are finished viewing and analyzing a capture file, you can delete an unwanted file. 1 From the StorNext home page, choose Capture State from the Service menu. The Capture System State screen shows a list of capture files stored in the directory /usr/adic/www/logs/capture_state. 2 Locate the capture file you want to delete, and then click the radio button beside the filename. 3 Click Delete.
Chapter 13 Service Management Using the System Status Tool Figure 238 Service - System Status Screen The Service - System Status screen contains the following information: StorNext User’s Guide • Total Number of Tickets: The number of RAS tickets the system has generated • Ticket: The RAS ticket number, displayed in the order in which it was created • State: The ticket’s current status: OPEN or CLOSED • Priority: The ticket’s priority based on system impact: HIGH, MEDIUM, or LOW • Last Update:
Chapter 13 Service Management Using the System Status Tool • Refresh: Click this button to refresh the display window 2 Highlight the ticket you wish to view, and then click Details. The RAS Ticket Details screen appears.
Chapter 13 Service Management Using the System Status Tool StorNext User’s Guide • Opened: The date and time the ticket was created • Status: The current status of the ticket: OPEN or CLOSED • Priority: The ticket’s priority based on system impact: HIGH, MEDIUM, and LOW • Summaries and Descriptions: Detailed information about the ticket, including a Recommended Actions link to help you correct the fault or condition • Analysis: If desired, enter information about the fault or condition, such as a
Chapter 13 Service Management Using the System Status Tool 3 When you click the View Recommended Actions link on the RAS Ticket Details screen, the Recommended Actions screen appears. This screen provides information and steps to correct the condition or fault that generated the RAS ticket. Follow the instructions on the Recommended Actions screen to correct the condition or fault. Figure 240 Recommended Actions Screen 4 Click the Close Window link at the bottom of the Recommended Actions screen.
Chapter 14 14 Customer Assistance More information about this product is available on the Quantum Service and Support website at www.quantum.com/ServiceandSupport. The Quantum Service and Support website contains a collection of information, including answers to frequently asked questions (FAQs). You can also access software, firmware, and drivers through this site.
Glossary A Affinity : An association between a relation point in the file system and a stripe group. It allows the user to direct data to specific primary disks by writing to the affinities associated relation point. C The operation of logically removing old file versions from a piece of media. This is a database operation that removes knowledge of managed files that have been updated or removed. A piece of media that contains nothing but removed files will not be considered blank until it is cleaned.
Graphical User Interface. G GUI M Managed Directory A directory that has a policy class relationship. Managed File System A file system that enables automatic data movement managed by StorNext Storage Manager between the primary disk and secondary storage (either disk or tape). MediaClass A grouping of media used for storing or retrieving data. Media Storage Manager (MSM) The Media Storage Manager is responsible for controlling media and archives.
Retrieve The process of retrieving data for a file from secondary storage (either disk or tape). S RHAS Red Hat Advanced Server RHEL Red Hat Enterprise Linux SCSI Small Computer System Interface. The interface that is used to talk to most hardware devices such as tape and libraries. StorNext A scalable, high performance, data management solution that ensures the long-term safety and recoverability of data in SAN environments, while optimizing the use of storage resources.
U Undelete The process of returning a file from the Trash can to its original location on disk. This can be done only if the Trash can is enabled. Unmanaged File System A file system that does not have archive capability controlled by SNSM.
Appendix A Operating Guidelines A This appendix contains information pertinent to operating StorNext, as well as some operating guidelines and limitations you should consider. The Reserved Space Parameter As of StorNext 3.0, the method of accounting for reserved space has changed. The MaxMBPerClientReserve parameter from the StorNext file system configuration file (/usr/cvfs/config/*.cfg) has been deprecated. All values except 0 are ignored for this parameter.
The Reserved Space Parameter • Yes - (Default) The MDC reserves enough disk space so that delayed allocations can be converted to real allocations (even when the MDC is restarted and the client is not). The MDC reserves a minimum of about 4GB for each stripe group and up to 280MBs per actively writing client for each stripe group. Note: The amount of reserved space is usually less than 280MB per client. Reserved space is calculated as 110% of the buffer cache size of each particular client.
Distributed LAN Server/Client Network and Memory Tuning Distributed LAN Server/Client Network and Memory Tuning Using the Distributed LAN Server and Client feature places significant additional demands on network capacity and system memory.
Distributed LAN Server/Client Network and Memory Tuning This may reduce the amount of packet loss. However, some Ethernet switches are unable to accommodate true GigE bandwidth, especially when multiple ports are transmitting data at the same time. • Linux Network Drivers. For best performance and compatibility, update Intel e1000 drivers to the latest version. In some cases, enabling TCP offload can cause issues. (Identify these issues by examining netstat -s output for bad segments.
Distributed LAN Server/Client Network and Memory Tuning * transfer buffer count * transfer buffer size) For example, suppose a Windows Distributed LAN Server is serving four file systems to 64 clients each using two NICs for data traffic. Also assume the server uses the defaults of sixteen transfer buffers and 256K per buffer. (On Windows, you can view and adjust the transfer buffer settings using the Client Configuration tool’s Distributed LAN tab.
Configuring LDAP * transfer buffer size) For example, consider a Linux Distributed LAN Server that has two NICs used for Distributed LAN traffic, serves four file systems, and uses the default eight server buffers and 256K per buffer. (See the dpserver and sndpscfg man pages for information about viewing and modifying Distributed LAN buffer settings on Linux.) For this case: Required memory = 1GB + (4 * 2 * 8 * 256K) = 1040MB Note: This example results in a memory requirement of less than 2GB.
Configuring LDAP UNIX File and Directory Modes 1 Note: Compatible Active Directory servers include Windows 2003 Server SP1 (with the Windows Services for Unix 3.5 extended LDAP schema applied,) and Windows 2003 Server R2. Note: Compatible Active Directory servers include Windows 2003 Server SP1 (with the Windows Services for Unix 3.5 extended LDAP schema applied,) and Windows 2003 Server R2.
Setting Up Restrictive ACLs Navigating to the Authentication tab of the Client Configuration Windows utility gives the administrator the ability to disable the NIS/PCNFSD mapping on a client-by-client basis by selecting Use Active Directory. The domain server must be at least Windows 2003 or above to support RFC 2307 mapping.
Event Handles for fsm.exe on a Windows Metadata Server Event Handles for fsm.exe on a Windows Metadata Server The metadata server (FSM) has many data structures that are used internally. Each of the data structures has some locks (pthread_mutex_lock). Each lock is initialized as “uninitialized.” The first time the lock is used, a small amount of memory and an event (i.e., handle) are allocated. The memory and event/handle are retained by the system until the data structure is destroyed.
FSBlockSize, Metadata Disk Size, and JournalSize Settings Values less than 16K are not recommended in most scenarios because startup and failover time may be adversely impacted. Setting FsBlockSize (FSB) to higher values is important for multi terabyte file systems for optimal startup and failover time. Note: This is particularly true for slow CPU clock speed metadata servers such as Sparc.
Allowance for Special Characters The best rule of thumb is to use a 16K FsBlockSize unless other requirements such as directory ratio dictate otherwise. This setting is not adjustable after initial file system creation, so it is very important to give it careful consideration during initial configuration. Example: FsBlockSize 16K 1 JournalSize Setting The optimal settings for JournalSize are in the range between 16M and 64M, depending on the FsBlockSize.
Disk Naming Requirements Beginning with StorNext 3.1.2, the GUI has been modified to handle all known issues with file names containing these non-standard characters. Still, Quantum strongly recommends against deliberately using these characters in filenames. If the GUI encounters a filename containing a “less-than-32” ASCII character, the character is rendered in the display as in the following examples: • A horizontal tab is shown as “__0x09__”. • A line feed is shown as “__0x0A__”.
General Operating Guidelines and Limitations Table 1 Operating Guidelines and Limitations Operating System / Affected Component Description HA configurations In HA (high availability) configurations, do not run adic_control start on the standby server. Doing so may start StorNext Storage Manager components on the standby server which are already running on the primary server, and may result in database corruption. IRIX As of release 3.
General Operating Guidelines and Limitations Operating System / Affected Component Linux Description StorNext does not support the use of loopback IP addresses other than 127.0.0.1. SUSE Enterprise Linux 10 systems sometimes have an entry for 127.0.0.2 in the /etc/hosts file. This causes various FSM operations to fail with the error “Not Local.
General Operating Guidelines and Limitations Operating System / Affected Component All UNIX and Linux Description The swapon command does not work on StorNext file systems. The Linux/ Unix swapon command is used to specify devices on which paging and swapping take place. If swapon is run on a StorNext file system, the command fails with an invalid argument error.
General Operating Guidelines and Limitations Operating System / Affected Component Windows Description On Windows systems, StorNext may log error messages after reboot if it tries to start before some other services. For example, if the network is not yet available, a StorNext client cannot contact a StorNext server and posts an error in the logs. (The client will continue to retry the connection until it is successful.
General Operating Guidelines and Limitations Operating System / Affected Component Windows Description If you are using the StorNext client software with Windows Server 2003, Windows XP, or Windows Vista, turn off the Recycle Bin in the StorNext file systems mapped on the Windows machine, so the file systems will work properly. You must disable the Recycle Bin for the directory on which a StorNext file system is mounted. You must also be sure to disable the Recycle Bin on directories you have remapped.
General Operating Guidelines and Limitations Operating System / Affected Component All Description To avoid parser errors, do not use “up” or “down” when naming items in the configuration file. This applies especially to naming affinities or any other string-type keyword. StorNext file systems cannot be smaller than 5GB.
General Operating Guidelines and Limitations Operating System / Affected Component All Description Affinity names cannot be longer than eight characters. StorNext truncates affinity names after the eighth character, so if you have two or more affinities whose first eight characters are identical, StorNext considers them the same affinity. For example, if you have affinities called “affdata01” and “affdata02,” StorNext sees them both as “affdata0” and treats them as the same affinity.
General Operating Guidelines and Limitations Operating System / Affected Component All Description In StorNext 3.0, the default buffer cache settings have been modified. Previously, all reads/writes that were 64K or smaller went through the buffer cache while larger I/O requests went direct. In StorNext 3.0, read/writes that are 1MB or smaller go through the buffer cache, while larger I/O requests go direct. The new buffer cache settings may change the I/O behavior of some applications.
General Operating Guidelines and Limitations Operating System / Affected Component All Description As a result of log rolling changes in StorNext 3.0, logs are now rolled every 6 hours. For each log, 28 instances (7 days of logs) are retained. Log instances are retained in the same directory as the original log. All log files which are rolled are affected by this change, including TSM logs (tac_00, bp_*.log, hist_01, etc.), MSM logs (tac_00, hist_01, etc.), and any other components configured for rolling.
General Operating Guidelines and Limitations Operating System / Affected Component All Description As of SNFS 2.7, a change was made to the way that the Reserved Extents performance feature affects free space reporting. In the previous release, SNFS would reserve a certain amount of disk space which would cause applications to receive an out of space error before the disk capacity reached 100%. In the current release, this reserved space is treated as allocated space.
Appendix B HA Failover B StorNext is designed to be a resilient data management solution. StorNext supports operation in degraded mode and provides functionality to guarantee data protection in the event of a storage device failure or total site outage. For certain environments though, additional protection is required to deliver a higher level of availability. To meet these demands, StorNext includes MetaData Controller (MDC) failover.
shuts down a degraded MDC and then reboots it so that, on recovery, it becomes the standby MDC in the event future MDC failover is required. While other methods of failover are available, such as quorums, STONITH is the only widely acknowledged method of reliable failover control - especially for software that runs on multiple operating systems.
Appendix C Using The Command Line Interface C Quantum recommends using the GUI to complete most StorNext tasks, but there may be situations where you need to use the command line interface instead.
Labeling Disk Devices Labeling Disk Devices Each drive used by SNFS must be labeled. A new drive only needs to be labeled one time. A drive can be labeled from any StorNext server or client that has a Fibre Channel (FC) connection to the drive. Use this procedure to label a disk device using CLI. Caution: The process of disk labeling re-partitions the drives. If you select an incorrect drive, you may lose data. Also, it’s a good practice to save a copy of your labels file.
Modifying Global Settings The created file displays an entry for disks located by the /usr/cvfs/ bin/cvlabel command. CvfsDisk_UNKNOWN /dev/sdb # host 4 lun 1 sectors 639570752 ... CvfsDisk_UNKNOWN /dev/sdc # host 4 lun 2 sectors 639570752 ... CvfsDisk_UNKNOWN /dev/sdd # host 4 lun 3 sectors 639570752 ... Caution: Identify any drives that already contain a recognized Volume Type. Do not write a label to these drives or you may lose data.
Modifying Global Settings For most of these parameters, the only thing necessary for the modified parameter to take effect is to restart the File System Manager (FSM). However, the following parameters require that the file system be fully re-initialized (which will result in data loss,) before they take effect: • FSBlockSize • WindowsSecurity If a parameter change requires file system re-initialization, the system notifies the administrator in the system log.
Making a File System 4 Make the appropriate edits to the configuration file. 5 Restart the file system.
Starting and Stopping SNFS 2 Make sure you are the root user by typing the following: cd / 3 Unmount the system by typing the following: umount where the is where you have mounted the SNFS. For example: umount /stornext/snfs1 4 Stop the system by typing the following: /usr/cvfs/bin/cvadmin snadmin> stop where the is the name of the file system to be stopped.
Unmounting or Mounting a File System /usr/cvfs/bin/cvadmin snadmin> select snadmin> stop Unmounting or Mounting a File System To unmount a file system using the CLI, follow these steps: 1 Change the login user to root. Type: cd / 2 Unmount the system. Type: umount where the is where you are mounting the SNFS. For example: umount /stornext/snfs1 To mount a file system using the CLI, follow these steps: 1 Change the login user to root.
Creating a File System Server Creating a File System Server The follow procedure describes how to create a file system server using the CLI. Before initially executing any SNFS command line programs, you are required to source either the .profile or the .cshrc file. This updates the user environment with the SNFS environment variables. • If you are running sh, ksh, or bash, type: . /usr/adic/.profile • For all other shells, type: source /usr/adic/.
Creating a File System Server 4 Label the FC drives by typing the following: /usr/cvfs/bin/cvlabel /user/cvfs/config/cvlabels 5 Copy the example file system configuration file to the config directory by typing the following: cp /usr/cvfs/examples/example.cfg /usr/cvfs/config/ .cfg 6 Edit the StorNext configuration file you just created to include the desired settings, disks, and stripe groups.
Adding a File System Client 16 Restart the file system. Type: /usr/cvfs/bin/cvadmin snadmin> start snadmin> activate snadmin> select snadmin> show snadmin> who snadmin> quit 17 Mount the system by typing the following: mount -t cvfs For example: mount -t cvfs snfs1 /stornext/snfs1 Adding a File System Client Use this procedure to add a file system client using the CLI.
Configuring a Stripe Group Configuring a Stripe Group Following is an example of a stripe group configuration in a file system configuration file. You can use a text editor to modify any of these variables. The values shown might not be representative of typical definitions.
Adding an Affinity Adding an Affinity This procedure lets you set stripe group affinities for assigning file locations to a specific file system stripe group. All subsequent allocations to a file that have been assigned a valid stripe group affinity will occur on the specified stripe group. Affinities may also be assigned to files and directories using the cvaffinity command. For more information about the cvaffinity command, refer to the CLI Reference Guide.
Adding an Affinity 4 Locate the stripe group section and select the stripe group to which you want to add the affinity.
Creating a Disk-to-Disk Policy Class Affinity data1aff StripeBreadth 512 Node CvfsDisk2 0 Node CvfsDisk3 1 6 Save and close the configuration file.
Creating a Disk-to-Disk Policy Class source /usr/adic/.cshrc Use the fsaddclass command to create a new policy class by typing the following: /usr/adic/TSM/exec/fsaddclass -a -i For example: /usr/adic/TSM/exec/fsaddclass dtdclass1 -a Aff1 Aff2 -i 1 The list of affinities includes the same affinities that were defined through the GUI.
Enabling Stub File Support You can also use metacharacters when defining the file name parameter. For example: /usr/adic/TSM/exec/fsrelocate -a Aff2 /stornext/snfs1/relocate/* Enabling Stub File Support The following file system commands have been enhanced to support StorNext’s Stub File feature: • fsaddclass • fsmodclass • fschfiat • fschdiat Specifically, a -S stubsize option has been added to each command. This option allows you to specify the desired file stub size in kilobytes.
Managing Storage Disks with Deduplication Enabled Managing Storage Disks with Deduplication Enabled Quantum recommends using the StorNext GUI to manage the storage disk deduplication feature, but you can use the CLI to add, modify, or delete storage disks with deduplication enabled (Dedup Sdisk). Adding a Dedup Sdisk 3 The fsdiskcfg command now includes a -b option to indicate that the storage disk uses blockletized storage to store data.
Managing Storage Disks with Deduplication Enabled Obtaining Dedup Sdisk Information 3 You can obtain information for a dedup sdisk by running the fsmedinfo command on the dedup sdisk.
Obtaining Distributed LAN Client Information Obtaining Distributed LAN Client Information If your StorNext configuration includes distributed LAN clients, you can obtain information through three commands supported by the cvadmin command: • proxy • proxy long • proxy who The proxy Command 3 Use the proxy command to display information about the distributed LAN servers for the file system. In particular, the IP address and port number on which the distributed LAN server is listening is shown.
Using the Dynamic Resource Allocation Feature The proxy who Command 3 Use the proxy who command to display the active disk distributed LAN connections for the specified host, which can be either a disk distributed LAN server or client. Output also includes average I/O statistics for each connection. The syntax for this command is proxy who hostname.
Using the Dynamic Resource Allocation Feature Caution: Checking the File System 3 Before you use a Dynamic Resource Allocation feature, Quantum strongly recommends running the cvfsck command on the file system you will be using. This step could take a considerable amount of time to complete, but your file system should be in good condition before you attempt to expand it or move stripe groups.
Using the Dynamic Resource Allocation Feature 6 Run the cvupdatefs command. 7 Restart the FSM. Adding and Moving a Data Stripe Group 3 New functionality has been added to the snfsdefrag utility to support operations on multiple stripe groups. Note: During Stripe Group Movement, affinities are preserved when files are moved from one stripe group to another.
Using the Dynamic Resource Allocation Feature 8 Run snfsdefrag -G -m 0 -r /filesystemroot where is the zero-based number of the source stripe group from which the move starts, and filesystemroot is the file name of the file system tree’s root. You can specify multiple -G options to use multiple source stripe groups. 9 Verify that no data remains on the original stripe groups. 10 Edit the file system configuration to mark the old stripe groups as “Down.” 11 Stop the FSM. 12 Restart the FSM.
Using the Dynamic Resource Allocation Feature Caution: The metadata/journal stripe group you want to move cannot contain data. Sndiskmove treats metadata and journal stripe groups the same way, so it doesn’t matter whether the stripe group you want to move is a metadata stripe group, a journal stripe group, or a combined metadata and journal stripe group. The only caveat is that stripe groups used for movement cannot contain data.
Specifying an Alternate Retrieval Location For example: source-LUN-label-name (the original stripe group name) becomes source-LUN-label-name.old destination-LUN-label-name (the new stripe group name) becomes source-LUN-label-name (the same name as the original stripe group) Note: When you run sndiskmove, it could take a considerable amount of time to copy the data between disks, depending on disk size and performance.
Appendix D RAS Messages D RAS messages appear when StorNext encounters an error condition. The RAS window shows symptoms of the condition, plus workarounds you can try to resolve the condition before calling the Quantum Technical Assistance Center. This appendix shows the different RAS messages you might see.
Media and Drive RAS Messages Figure 1 No Media Found RAS StorNext User’s Guide 377
Media and Drive RAS Messages Figure 2 Possible Drive/Media Mount Discrepancy RAS StorNext User’s Guide 378
Media and Drive RAS Messages Figure 3 Tape Drive Alerts RAS part 1 StorNext User’s Guide 379
Media and Drive RAS Messages Figure 4 Tape Drive Alerts RAS part 2 StorNext User’s Guide 380
Media and Drive RAS Messages Figure 5 Tape Drive Alerts RAS part 3 StorNext User’s Guide 381
Media and Drive RAS Messages Figure 6 Drive Reported Drive Error RAS StorNext User’s Guide 382
Media and Drive RAS Messages Figure 7 Cleaning of Drive Failed RAS Figure 8 Wrong Firmware Level/Invalid Drive Type RAS StorNext User’s Guide 383
Media and Drive RAS Messages Figure 9 Drive Removed RAS Figure 10 Tape Drive Configuration Failed RAS StorNext User’s Guide 384
Media and Drive RAS Messages Figure 11 Tape Drive Reported Media Error RAS Figure 12 Cleaning Media Expired RAS StorNext User’s Guide 385
Media and Drive RAS Messages Figure 13 No Cleaning Media Available RAS Figure 14 Media Suspect Threshold Count Exceeded RAS StorNext User’s Guide 386
Media and Drive RAS Messages Figure 15 Media Format Failure RAS StorNext User’s Guide 387
Media and Drive RAS Messages Figure 16 Invalid Media Label Detected RAS StorNext User’s Guide 388
Media and Drive RAS Messages Figure 17 Media Not Found RAS Figure 18 Duplicate Physical Media Found RAS StorNext User’s Guide 389
SNFS RAS Messages Figure 19 Storage Disk Taken Offline RAS SNFS RAS Messages This section describes RAS messages that might appear as a result of a file system-related error condition, such as an I/O error or a missing LUN.
SNFS RAS Messages Figure 20 Configuration Not Supported RAS Figure 21 Label Validation Failure RAS StorNext User’s Guide 391
SNFS RAS Messages Figure 22 Connection Rejected RAS Figure 23 File System Failover RAS StorNext User’s Guide 392
SNFS RAS Messages Figure 24 I/O Error RAS Figure 25 Journaling Error Detected RAS StorNext User’s Guide 393
SNFS RAS Messages Figure 26 SNFS License Required RAS Figure 27 SNFS License Failure RAS StorNext User’s Guide 394
SNFS RAS Messages Figure 28 LUN Mapping Changed RAS Figure 29 Communication Failure RAS StorNext User’s Guide 395
SNFS RAS Messages Figure 30 Metadata Inconsistency Detected RAS Figure 31 Bad File System Metadata Dump RAS StorNext User’s Guide 396
SNFS RAS Messages Figure 32 Metadata Dump Failure RAS Figure 33 File System or Metadata Capacity Warning RAS StorNext User’s Guide 397
SNFS RAS Messages Figure 34 File Processing Failure RAS Figure 35 Missing LUNs RAS StorNext User’s Guide 398
SNFS RAS Messages Figure 36 Disk Space Allocation Failure RAS Figure 37 System Resource Failure RAS StorNext User’s Guide 399
SNFS RAS Messages Figure 38 Affinity Configuration Violations RAS StorNext User’s Guide 400
SNFS RAS Messages Figure 39 Quota Limit or Fragmentation Warnings RAS Figure 40 Shutdown Error RAS StorNext User’s Guide 401
Other RAS Messages Figure 41 Initialization Failure RAS Other RAS Messages This section describes RAS messages that might appear as a result of an error condition that is not related to media or the file system.
Other RAS Messages Figure 42 Checksum Error RAS StorNext User’s Guide 403
Other RAS Messages Figure 43 Troubleshooting the StorNext Software RAS StorNext User’s Guide 404
Other RAS Messages Figure 44 Software Resource Violations RAS StorNext User’s Guide 405
Other RAS Messages Figure 45 Closing Service Tickets RAS StorNext User’s Guide 406
Other RAS Messages Figure 46 Analyzing Service Tickets RAS StorNext User’s Guide 407
Other RAS Messages Figure 47 Viewing Service Tickets RAS Figure 48 Vault Failure RAS StorNext User’s Guide 408
Other RAS Messages Figure 49 Robotics - Not Ready RAS StorNext User’s Guide 409
Other RAS Messages Figure 50 Robotics - Move Failure RAS StorNext User’s Guide 410
Other RAS Messages Figure 51 Robotics - Wrong Firmware Level/Invalid Library Type RAS StorNext User’s Guide 411
Other RAS Messages Figure 52 Backup Failed RAS StorNext User’s Guide 412
Other RAS Messages Figure 53 Backup Errors RAS StorNext User’s Guide 413
Other RAS Messages Figure 54 Configuration Violations RAS StorNext User’s Guide 414
Other RAS Messages Figure 55 Invalid Configuration RAS part 1 StorNext User’s Guide 415
Other RAS Messages Figure 56 Invalid Configuration RAS part 2 Figure 57 Downloading a System State Capture RAS StorNext User’s Guide 416
Other RAS Messages Figure 58 Capturing a System State RAS StorNext User’s Guide 417
