Using The Server_archive Utility On Vnx

Transcript

EMC® VNX™ Series Release 7.0 Using the server_archive Utility on VNX P/N 300-011-831 REV A01 EMC Corporation Corporate Headquarters: Hopkinton, MA 01748-9103 1-508-435-1000 www.EMC.com Copyright © 1998 - 2011 EMC Corporation. All rights reserved. Published February 2011 EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS." EMC CORPORATION MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license. For the most up-to-date regulatory document for your product line, go to the Technical Documentation and Advisories section on EMC Powerlink. For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com. All other trademarks used herein are the property of their respective owners. Corporate Headquarters: Hopkinton, MA 01748-9103 2 Using the server_archive Utility on VNX 7.0 Contents Preface.....................................................................................................5 Chapter 1: Introduction...........................................................................9 System requirements.............................................................................................10 Restrictions.............................................................................................................10 Cautions..................................................................................................................10 User interface choices...........................................................................................10 Related information..............................................................................................11 Chapter 2: Concepts.............................................................................13 Backup data flow...................................................................................................14 Chapter 3: Managing............................................................................15 Prerequisite.............................................................................................................16 Configure a VNX NS series Data Mover..................................................16 Perform backups with server_archive................................................................17 Obtain device names...................................................................................17 Copy a file system from directory to directory.......................................18 Back up with CIFS extended attributes....................................................19 Restore with CIFS extended attributes.....................................................19 Archive files by using server_archive................................................................20 Specify emctar as the backup type (Optional)........................................20 Archive data files.........................................................................................20 List archived files.........................................................................................21 Restore a file.................................................................................................21 Rewind a tape..............................................................................................22 Migrate files from an external source.................................................................22 Using the server_archive Utility on VNX 7.0 3 Contents Archive by using relative path..................................................................23 Restore by using relative path...................................................................23 Archive by using absolute path.................................................................24 Restore by using absolute path.................................................................24 Chapter 4: Troubleshooting..................................................................25 EMC E-Lab Interoperability Navigator..............................................................26 Error messages.......................................................................................................26 EMC Training and Professional Services...........................................................26 Glossary..................................................................................................29 Index.......................................................................................................31 4 Using the server_archive Utility on VNX 7.0 Preface As part of an effort to improve and enhance the performance and capabilities of its product lines, EMC periodically releases revisions of its hardware and software. Therefore, some functions described in this document may not be supported by all versions of the software or hardware currently in use. For the most up-to-date information on product features, refer to your product release notes. If a product does not function properly or does not function as described in this document, please contact your EMC representative. Using the server_archive Utility on VNX 7.0 5 Preface Special notice conventions EMC uses the following conventions for special notices: CAUTION: A caution contains information essential to avoid data loss or damage to the system or equipment. Important: An important note contains information essential to operation of the software. Note: A note presents information that is important, but not hazard-related. Hint: A note that provides suggested advice to users, often involving follow-on activity for a particular action. Where to get help EMC support, product, and licensing information can be obtained as follows: Product information — For documentation, release notes, software updates, or for information about EMC products, licensing, and service, go to the EMC Online Support website (registration required) at http://Support.EMC.com. Troubleshooting — Go to the EMC Online Support website. After logging in, locate the applicable Support by Product page. Technical support — For technical support and service requests, go to EMC Customer Service on the EMC Online Support website. After logging in, locate the applicable Support by Product page, and choose either Live Chat or Create a service request. To open a service request through EMC Online Support, you must have a valid support agreement. Contact your EMC sales representative for details about obtaining a valid support agreement or with questions about your account. Note: Do not request a specific support representative unless one has already been assigned to your particular system problem. Your comments Your suggestions will help us continue to improve the accuracy, organization, and overall quality of the user publications. Please send your opinion of this document to: 6 Using the server_archive Utility on VNX 7.0 Preface [email protected] Using the server_archive Utility on VNX 7.0 7 Preface 8 Using the server_archive Utility on VNX 7.0 1 Introduction You can use the EMC VNX server_archive command as a backup utility to perform manual local backups and restores, to copy a file system from one Data Mover to another, and to test that tape drives are properly connected. As a backup option, server_archive is for low-capacity backups. When using server_archive, the backup data does not have to travel over the network. User interface choices on page 10 provides more details. This document is part of the VNX information set and is intended for system administrators responsible for backing up file systems to a tape device. Topics included are: ◆ ◆ ◆ ◆ ◆ System requirements on page 10 Restrictions on page 10 Cautions on page 10 User interface choices on page 10 Related information on page 11 Using the server_archive Utility on VNX 7.0 9 Introduction System requirements Table 1 on page 2 describes the EMC® VNX™ software, hardware, network, and storage configurations required for using server_archive as described in this document. Table 1. System requirements Software VNX version 7.0 Hardware VNX with an attached tape device Network No particular requirements Storage Local tape drive Restrictions These restrictions apply to performing backups with the server_archive utility: ◆ Scheduling, cataloging, and TLUs are not supported. ◆ An NS series VNX requires a media interface adapter (MIA) for device connection to the AUX-0 port. Your EMC Customer Support Representative can help you install the MIA. ◆ server_archive is not compatible with the virtual tape library unit (VTLU) feature. Cautions If any of this information is unclear, contact your EMC Customer Support Representative for assistance. CAUTION: When copying files, the destination directory must exist and not be one of the file operands or a member of a file hierarchy rooted at one of the file operands. The result of a copy is unpredictable under these conditions. User interface choices This document describes how to configure and perform manual backups by using the command line interface (CLI). You cannot use other VNX management applications to perform manual backups with server_archive. 10 Using the server_archive Utility on VNX 7.0 Introduction Related information For specific information related to the features and functionality described in this document: ◆ Configuring NDMP Backups on VNX ◆ EMC VNX Command Line Interface Reference for File ◆ Parameters Guide for VNX for File EMC VNX documentation on the EMC Online Support website The complete set of EMC VNX series customer publications is available on the EMC Online Support website. To search for technical documentation, go to http://Support.EMC.com. After logging in to the website, click the VNX Support by Product page to locate information for the specific feature required. VNX wizards Unisphere software provides wizards for performing setup and configuration tasks. The Unisphere online help provides more details on the wizards. Related information 11 Introduction 12 Using the server_archive Utility on VNX 7.0 2 Concepts You manually execute local backups through the server_archive command at the Control Station or through a workstation with a Telnet connection. The server_archive utility consists of numerous backup and restore options. VNX for File Man Pages and the EMC VNX Command Line Interface Reference for File provide a complete explanation of server_archive options. The server_archive command uses PAX and standard UNIX tape formats, such as tar and cpio. It also offers NFS, CIFS, and multiprotocol (NFS and CIFS) support. Topics included are: ◆ Backup data flow on page 14 Using the server_archive Utility on VNX 7.0 13 Concepts Backup data flow When performing a manual backup, the data or file system you want to back up flows directly from the system to the Data Mover to the tape drive, as shown in Figure 1 on page 14. Data does not travel across the network. Tape drives are attached directly to the Data Movers by means of a SCSI connection. Scheduling, cataloging, and TLUs are not supported. To perform tape operations, such as rewinding and unloading, execute VNX’s server_mt command. Figure 1. Manual local backup 14 Using the server_archive Utility on VNX 7.0 3 Managing Topics included are: ◆ ◆ ◆ ◆ Prerequisite on page 16 Perform backups with server_archive on page 17 Archive files by using server_archive on page 20 Migrate files from an external source on page 22 Using the server_archive Utility on VNX 7.0 15 Managing Prerequisite If you have Celerra Network Server version 5.3 or earlier or if the auto-negotiation feature fails, perform the prerequisite task described in Configure a VNX NS series Data Mover on page 16. Configure a VNX NS series Data Mover For Celerra Network Server version 5.4 and later, you do not have to configure the Data Mover before backing up the data to a locally attached tape drive. The hardware autodetects and configures for arbitrated loop or switched fabric connections. Further, you do not have to specify the tape backup link speed. By default, the speed will be auto-negotiated to the highest mutually acceptable link speed. Follow this procedure if the auto-negotiation fails and you need to configure the link speed manually: Note: NS series VNXs require an MIA for device connection to the AUX-0 port. Your EMC Customer Support Representative can assist in installing the MIA. 1. Specify a tape backup link speed on an NS series VNX Data Mover attached to a tape drive by using this command syntax: $ server_param -facility PAX -modify linx_speed_aux0 -value where: = name of the Data Mover = 0x1000 (to set tape backup link speed to 4Gb/s), 0x2000 (to accommodate a 2Gb Fibre Channel-Arbitrated Loop interface), 0x4000 (to accommodate an LC optical 1Gb interface) or 0x8000 (to detect the link speed from the controller) Example: To set the tape backup link speed to accommodate a 1Gb interface on server2, type: $ server_param server_2 -facility PAX -modify linx_speed_aux0 -value 0x4000 Note: Parameter and facility names are case-sensitive. Output: server_2 : done 2. Reboot the Data Mover for the parameter to take effect by using this command syntax: $ server_cpu -reboot -monitor now where: 16 Using the server_archive Utility on VNX 7.0 Managing = name of the Data Mover Example: To reboot server_2, type: $ server_cpu server_2 -reboot -monitor now Perform backups with server_archive The tasks to perform backups by using the server_archive command are: ◆ Obtain device names on page 17 ◆ Copy a file system from directory to directory on page 18 ◆ Back up with CIFS extended attributes on page 19 ◆ Restore with CIFS extended attributes on page 19 Obtain device names Action To obtain device names used in the server_archive command syntax, use this command syntax: $ server_devconfig -list -scsi -nondisks where: = name of the Data Mover where the backup device is attached Example: To list the nondisk SCSI devices on server_2, type: $ server_devconfig server_2 -list -scsi -nondisks Output The output looks similar to: name tape1 scsi device table addr type info c1t4l0 tape QUANTUM DLT7000 245Fq_ Perform backups with server_archive 17 Managing Note VNX addresses a tape device component (device name) as follows: where: = chain number of the controller = SCSI ID (target) of the controller = logical unit number (LUN) of the controller For example: c1t4l0 Use the -e option to specify the name of a tape device managed by the Control Station, which takes the form of tape1. Copy a file system from directory to directory You can copy files from one directory to another within a Data Mover by using the -r -w option of the server_archive command. Action To copy a file system to a new directory, use this command syntax: $ server_archive -r -w / / where: = name of the Data Mover from which you are copying data = location of the directory you are copying = location where you are copying the directory Example: To copy /dir1 to /dir2 on server_2, type: $ server_archive server_2 -r -w /dir1 /dir2 Output server_2 : done 18 Using the server_archive Utility on VNX 7.0 Managing Back up with CIFS extended attributes Action To back up a file with CIFS extended attributes, use this command syntax: $ server_archive -w -f /dev/ -J / where: = name of the Data Mover = name of the device to which you want to back up data = name of the directory you want to back up Example: To back up the dir1 file system on server_2, type: $ server_archive server_2 -w -f /dev/c1t4l0 -J /dir1 Output server_2 : done Restore with CIFS extended attributes Action To restore a file system with CIFS extended attributes, use this command syntax: $ server_archive -r -f /dev/ -J / where: = name of the Data Mover = name of the device from which you want to restore data = name of the directory you want to restore Example: To restore the dir1 file system on server_2, type: $ server_archive server_2 -r -f /dev/c1t4l0 -J /dir1 Output server_2 : done Perform backups with server_archive 19 Managing Archive files by using server_archive The tasks to archive files by using server_archive are: ◆ Specify emctar as the backup type (Optional) on page 20 ◆ Archive data files on page 20 ◆ List archived files on page 21 ◆ Restore a file on page 21 ◆ Rewind a tape on page 22 Specify emctar as the backup type (Optional) Using the emctar format can improve backup performance. This format allows archiving to a file greater than 8 GB. Action To specify emctar as the backup type, use this command syntax: $ server_archive -w -x emctar where: = the name of the Data Mover Example: To specify emctar as the type of backup, type: $ server_archive server_2 -w -x emctar Output None Archive data files Action To archive data files to tape or to verify that a tape drive is working, use this command syntax: $ server_archive -w -f /dev/ -x emctar -v where: = internal Data Mover name = device name for the tape drive 20 Using the server_archive Utility on VNX 7.0 Managing Action = path to where you want to archive data Example: To archive data files, type: $ server_archive server_2 -w -f /dev/c1t4l0 -v -x emctar /backup/test Output None List archived files Action To list the data files archived to a tape drive, use this command syntax: $ server_archive -f /dev/ -v where: = internal Data Mover name = name of the device (tape drive) where the data was backed up Example: To list in verbose mode the data files archived, type: $ server_archive server_2 -f /dev/c1t4l0 -v Output None Restore a file Action To extract a file from the tape drive for file restoration, use this command syntax: $ server_archive -r -f /dev/ where: = internal Data Mover name = name of the device (tape drive) where the file to be restored is available = name of the file Example: To restore file1, type: Archive files by using server_archive 21 Managing Action $ server_archive server_2 -r -f /dev/c1t4l0 file1 Output None Rewind a tape Action To rewind a tape, use this command syntax: $ server_mt -f rewind where: = internal Data Mover name = device name of the tape drive Example: To rewind a tape, type: $ server_mt server_2 -f c1t4l0 rewind Output None Migrate files from an external source This section describes the procedures to migrate files from an external source to a tape, and then to VNX. Before performing these procedures, attach a tape drive to the Data Mover that will back up the files. The server_archive command supports several tape formats, such as tar and cpio. Use one of these formats to back up data from an external computer to a tape and to restore the data from the tape to the system. In the example in Archive by using absolute path on page 24, the tar archive command is executed from the external computer. You can perform an archive from an external source by using: 22 ◆ Archive by using relative path on page 23 ◆ Restore by using relative path on page 23 ◆ Archive by using absolute path on page 24 ◆ Restore by using absolute path on page 24 Using the server_archive Utility on VNX 7.0 Managing Archive by using relative path Follow these steps: 1. Change to the directory that you want to archive by using this command syntax: $ cd where: = name of the directory to be archived 2. To start the archive, type: $ tar cvf /dev/rmt/0 Restore by using relative path Action To restore an archive performed by using a relative path, use this command syntax: $ server_archive -r -f /dev/ -s,^,/, where: = internal Data Mover name = tape device name = path of the new archive location Example: To restore an archive to /backupnew, type: $ server_archive server_2 -r -f /dev/c1t4l0 -s,^,/backupnew, Output None Migrate files from an external source 23 Managing Archive by using absolute path Action To archive a file that uses an absolute path, use this command syntax: $ tar cvf /dev/rmt/0 / where: = path where you want to archive the file Example: To archive a file to /backup1, type: $ tar cvf /dev/rmt/0 /backup1 Note: If you do not want to use verbose mode, omit the v in the tar command line. Output None Restore by using absolute path Action To restore an archive performed by using an absolute path, use this command syntax: $ server_archive -r -f /dev/ -s,^/,/, where: = internal Data Mover name = tape device name = path of the archive you are restoring = path to where you want to restore the archive Example: To restore an archive from /backupold to /backupnew, type: $ server_archive server_2 -r -f /dev/c1t4l0 -s,^/backupold,/backupnew, Output None 24 Using the server_archive Utility on VNX 7.0 4 Troubleshooting As part of an effort to continuously improve and enhance the performance and capabilities of its product lines, EMC periodically releases new versions of its hardware and software. Therefore, some functions described in this document may not be supported by all versions of the software or hardware currently in use. For the most up-to-date information on product features, refer to your product release notes. If a product does not function properly or does not function as described in this document, please contact your EMC Customer Support Representative. Topics included are: ◆ ◆ ◆ EMC E-Lab Interoperability Navigator on page 26 Error messages on page 26 EMC Training and Professional Services on page 26 Using the server_archive Utility on VNX 7.0 25 Troubleshooting EMC E-Lab Interoperability Navigator The EMC E-Lab™ Interoperability Navigator is a searchable, web-based application that provides access to EMC interoperability support matrices. It is available at http://Support.EMC.com. After logging in to the EMC Online Support website, locate the applicable Support by Product page, find Tools, and click E-Lab Interoperability Navigator. Error messages All event, alert, and status messages provide detailed information and recommended actions to help you troubleshoot the situation. To view message details, use any of these methods: ◆ Unisphere software: • ◆ CLI: • ◆ Type nas_message -info , where is the message identification number. Celerra Error Messages Guide: • ◆ Right-click an event, alert, or status message and select to view Event Details, Alert Details, or Status Details. Use this guide to locate information about messages that are in the earlier-release message format. EMC Online Support: • Use the text from the error message's brief description or the message's ID to search the Knowledgebase on the EMC Online Support website. After logging in to EMC Online Support, locate the applicable Support by Product page, and search for the error message. EMC Training and Professional Services EMC Customer Education courses help you learn how EMC storage products work together within your environment to maximize your entire infrastructure investment. EMC Customer Education features online and hands-on training in state-of-the-art labs conveniently located throughout the world. EMC customer training courses are developed and delivered by EMC experts. Go to the EMC Online Support website at http://Support.EMC.com for course and registration information. 26 Using the server_archive Utility on VNX 7.0 Troubleshooting EMC Professional Services can help you implement your VNX series efficiently. Consultants evaluate your business, IT processes, and technology, and recommend ways that you can leverage your information for the most benefit. From business plan to implementation, you get the experience and expertise that you need without straining your IT staff or hiring and training new personnel. Contact your EMC Customer Support Representative for more information. EMC Training and Professional Services 27 Troubleshooting 28 Using the server_archive Utility on VNX 7.0 Glossary L local backup Procedure that backs up a file system, or incremental changes to a file system from a Data Mover to a locally attached TLU. See also automated backup and restore. M manual local backup On VNX for file, a procedure in which an operator enters commands manually or by using a script. During the backup operation, a single Data Mover or multiple Data Movers in parallel are backed up fully or incrementally to one or more locally attached tape drives. Each Data Mover requires its own tape drive, attached to one of the Data Mover’s SCSI or Fibre Channel ports. Data goes directly to VNX for file's attached tape drive, and does not traverse the network. Also called simple local backup. P Portable Archive Interchange (PAX) VNX for file archive protocol that works with standard UNIX tape formats and provides file-level backup and recovery operations. Using the server_archive Utility on VNX 7.0 29 Glossary 30 Using the server_archive Utility on VNX 7.0 Index A archived files listing 21 restoring 21 archiving data files 20 from external source absolute path 24 relative path 23 to tape 22 using emctar 20 B backup data flow 14 type, emctar 20 with CIFS extended attributes 19 C cautions, for using server_archive 10 commands server_mt 14 server_param 16 configuring Data Movers 16 device names, obtainingobtaining device namesdiscovering devices, from VNX 17 E EMC E-Lab Navigator 26 emctar backup type 20 error messages 26 I Information, related 11 L listing archived files 21 M manual local backup illustration 14 manually restoring files 21 messages, error 26 D Data Movers configuring 16 rebooting 16 Using the server_archive Utility on VNX 7.0 31 Index migrating filesexternal source, migrating from 22 N restoring (continued) with CIFS extended attributes 19 restrictions, for using server_archive 10 rewinding a tape 14, 22 NS series configuration 16 S O overview, of manual local backups 9 P parameters, configuring 16 R rebooting Data Movers 16 restoring archived files using absolute path 24 using relative path 23 files 21 32 Using the server_archive Utility on VNX 7.0 server_archive concepts 13 server_mt command 14, 22 server_param command 16 specifying emctar as the backup type 20 system requirements 10 T tape archiving to 22 rewinding 22 V VNX NS series configuring 16