Using The Celerra Server_archive Utility

Transcript

Using the Celerra server_archive Utility P/N 300-004-182 Rev A03 Version 5.6.48 June 2010 Contents Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 Cautions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 User interface choices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 Related information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 Concepts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 Backup data flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 Managing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Perform backups with server_archive . . . . . . . . . . . . . . . . . . . . . . . . .7 Archive files by using server_archive . . . . . . . . . . . . . . . . . . . . . . . . .9 Migrate files from an external source . . . . . . . . . . . . . . . . . . . . . . . . .12 Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 Where to get help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 E-Lab Interoperability Navigator . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 Error messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 EMC Training and Professional Services . . . . . . . . . . . . . . . . . . . . . .15 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17 1 of 18 2 of 18 Version 5.6.48 Using the Celerra server_archive Utility Introduction You can use the EMC® Celerra® Network Server 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 4 provides more details. This document is part of the Celerra Network Server information set and is intended for system administrators responsible for backing up file systems to a tape device. System requirements Table 1 on page 3 describes the Celerra Network Server software, hardware, network, and storage configurations required for using server_archive as described in this document. Table 1 System requirements Software Celerra Network Server version 5.6.48 Hardware Celerra Network Server 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: ◆ ◆ ◆ Using the Celerra server_archive Utility Scheduling, cataloging, and TLUs are not supported. An NS series Celerra Network Server 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. Version 5.6.48 3 of 18 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 Celerra management applications to perform manual backups with server_archive. Terminology local backup: Procedure that backs up a copy of a file system or incremental changes to a file system from a Data Mover to a locally attached tape library unit (TLU). See also automated backup and restore. manual local backup: On a Celerra system, a procedure in which an operator enters commands manually or 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 the Celerra system’s attached tape drive, and does not traverse the network. Also called simple local backup. Portable Archive Interchange (PAX): Celerra Network Server archive protocol that works with standard UNIX tape formats and provides file-level backup and recovery operations. Related information For specific information related to the features and functionality described in this document: ◆ Configuring NDMP Backups on Celerra ◆ Celerra Network Server Command Reference Manual ◆ Celerra Network Server Parameters Guide The Celerra Network Server Documentation CD, supplied with your Celerra Network Server and also available on Powerlink®, provides general information on other EMC Celerra publications. 4 of 18 Version 5.6.48 Using the Celerra server_archive Utility 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. The Celerra man pages and the Celerra Network Server Command Reference Manual provide a complete explanation of server_archive options. The server_archive uses PAX and standard UNIX tape formats, such as tar and cpio. It also offers NFS, CIFS, and multiprotocol (NFS and CIFS) support. Backup data flow When performing a manual backup, the data or file system you want to back up flows directly from the storage system to the Data Mover to the tape drive, as shown in Figure 1 on page 5. 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, you execute Celerra Network Server’s server_mt command. SB15 SB13 SB9 SB7 SB11 Backup data Backup data SB1 SB3 SB5 SB8 SB0 SB2 SB4 SB6 SB10 SB12 SB14 Celerra PS0 PS1 PS2 PS3 PS4 SMB0 SMB1 Storage system Data Mover Tape drive CNS-000736 Figure 1 Manual local backup Using the Celerra server_archive Utility Version 5.6.48 5 of 18 Managing The tasks to perform manual backups by using the server_archive command are: ◆ "Perform backups with server_archive" on page 7 ◆ "Archive files by using server_archive" on page 9 ◆ "Migrate files from an external source" on page 12 Note: If you are have Celerra Network Server version 5.3 or earlier or if the autonegotiation feature fails, perform the prerequisite task described in "Configure a Celerra NS series Data Mover" on page 6. Configure a Celerra 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 autonegotiated to the highest mutually acceptable link speed. Follow this procedure if the autonegotiation fails and you need to configure the link speed manually. Note: NS series Celerra Network Servers require an MIA for device connection to the AUX0 port. Your EMC Customer Support Representative can assist in installing the MIA. Step 1. Action Specify a tape backup link speed on an NS series Celerra Network Server 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 4 Gb/s), 0x2000 (to accommodate a 2 Gb Fibre Channel-Arbitrated Loop interface), 0x4000 (to accommodate an LC optical 1 Gb interface) or 0x8000 (to detect the link speed from the controller) Example: To set the tape backup link speed to accommodate a 1 Gb 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 6 of 18 Version 5.6.48 Using the Celerra server_archive Utility Step 2. Action Reboot the Data Mover for the parameter to take effect by using this command syntax: $ server_cpu -reboot -monitor now where: = 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 7 ◆ "Copy a file system from directory to directory" on page 8 ◆ "Back up with CIFS extended attributes" on page 9 ◆ "Restore with CIFS extended attributes" on page 9 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: scsi device table name addr type tape1 c1t4l0 tape info QUANTUM DLT7000 245Fq_ Note The Celerra Network Server 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. Using the Celerra server_archive Utility Version 5.6.48 7 of 18 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 Copy a file system with CIFS extended attributes Use the -J option of the server_archive command to include the CIFS extended attributes when copying a file system from one directory to another. Action To copy a file system with CIFS extended attributes to a new directory, use this command syntax: $ server_archive -r -w -J / / 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 including the CIFS extended attributes, type: $ server_archive server_2 -r -w -J /dir1 /dir2 Output server_2 : done 8 of 18 Version 5.6.48 Using the Celerra server_archive Utility 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 Archive files by using server_archive The tasks to archive files by using server_archive are: ◆ "(Optional) Specify emctar as the backup type" on page 10 ◆ "Archive data files" on page 10 ◆ "List archived files" on page 11 ◆ "Restore a file" on page 11 ◆ "Rewind a tape" on page 11 Using the Celerra server_archive Utility Version 5.6.48 9 of 18 (Optional) Specify emctar as the backup type 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 = 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 10 of 18 Version 5.6.48 Using the Celerra server_archive Utility 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: $ 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 Using the Celerra server_archive Utility Version 5.6.48 11 of 18 Migrate files from an external source This section describes the procedures to migrate files from an external source to a tape, and then to the Celerra Network Server. 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 Celerra Network Server. In the example in "Archive using absolute path" on page 13, the tar archive command is executed from the external computer. You can perform an archive from an external source by using: ◆ Relative path ◆ Absolute path Archive using relative path Step 1. Action Change to the directory that you want to archive by using this command syntax: $ cd where: = name of the directory to be archived 2. Type the archive command: $ tar cvf /dev/rmt/0 Restore using relative path Action To restore an archive performed 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 12 of 18 Version 5.6.48 Using the Celerra server_archive Utility Archive 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 using absolute path Action To restore an archive performed 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 Using the Celerra server_archive Utility Version 5.6.48 13 of 18 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, contact your EMC Customer Support Representative. Where to get help Product information – For documentation, release notes, software updates, or for information about EMC products, licensing, and service, go to the EMC Powerlink website (registration required) at http://Powerlink.EMC.com. Troubleshooting – For troubleshooting information, go to Powerlink, search for Celerra Tools, and select Celerra Troubleshooting from the navigation panel on the left. Technical support – For technical support, go to Powerlink and choose Support. On the Support page, you can access Support Forums, request a product enhancement, talk directly to an EMC representative, or open a service request. To open a service request, you must have a valid support agreement. Please contact you EMC sales representative for details about obtaining a valid support agreement or to answer any questions about your account. Note: Do not request a specific support representative unless one has already been assigned to your particular system problem. Problem Resolution Roadmap for Celerra contains additional information about using Powerlink and resolving problems. E-Lab Interoperability Navigator The EMC E-LabTM Interoperability Navigator is a searchable, web-based application that provides access to EMC interoperability support matrices. It is available on the EMC Powerlink® at http://Powerlink.EMC.com. After logging in to Powerlink, go to Support > Interoperability and Product Lifecycle Information > E-Lab Interoperability Navigator. 14 of 18 Version 5.6.48 Using the Celerra server_archive Utility Error messages As of version 5.6, all new event, alert, and status messages provide detailed information and recommended actions to help you troubleshoot the situation. To view message details, use any of the these methods: ◆ Celerra Manager: • Right-click an event, alert, or status message and select to view Event Details, Alert Details, or Status Details. ◆ Celerra CLI: • Type nas_message -info , where MessageID is the message identification number. ◆ Celerra Network Server Error Messages Guide: • Use this guide to locate information about messages that are in the earlierrelease message format. ◆ Powerlink: • Use the text from the error message’s brief description or the message’s ID to search the Knowledgebase on Powerlink. After logging in to Powerlink, go to Support > Knowledgebase Search > Support Solutions Search. EMC Training and Professional Services EMC Customer Education courses help you learn how EMC storage products work together within your environment in order 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 EMC Powerlink at http://Powerlink.EMC.com for course and registration information. EMC Professional Services can help you implement your Celerra Network Server efficiently. Consultants evaluate your business, IT processes, and technology and recommend ways you can leverage your information for the most benefit. From business plan to implementation, you get the experience and expertise you need, without straining your IT staff or hiring and training new personnel. Contact your EMC representative for more information. Using the Celerra server_archive Utility Version 5.6.48 15 of 18 16 of 18 Version 5.6.48 Using the Celerra server_archive Utility Index A archived files listing 11 restoring 11 archiving data files 10 from external source absolute path 13 relative path 12 to tape 12 using emctar 10 B backup data flow 5 type, emctar 10 with CIFS extended attributes 9 C cautions, for using server_archive 4 Celerra NS series configuring 6 media interface adapter for 6 commands server_mt 5 server_param 6 configuring Data Movers 6 D Data Movers configuring 6 rebooting 7 device names, obtaining 7 discovering devices, from Celerra 7 migrating files 12 N NS series configuration 6 O obtaining device names 7 overview, of manual local backups 3 P parameters, configuring 6 R rebooting Data Movers 7 restoring archived files using absolute path 13 using relative path 12 files 11 with CIFS extended attributes 9 restrictions, for using server_archive 3 rewinding a tape 5, 11 S server_archive concepts 5 server_mt command 5, 11 server_param command 6 specifying emctar as the backup type 10 system requirements 3 T tape archiving to 12 rewinding 11 E emctar backup type 10 external source, migrating from 12 I Information, related 4 L listing archived files 11 local backup, defined 4 M manual local backup defined 4 illustration 5 manually restoring files 11 media interface adapter, for Celerra NS series 6 Using the Celerra server_archive Utility Version 5.6.48 17 of 18 About this document As part of its effort to continuously improve and enhance the performance and capabilities of the Celerra Network Server product line, EMC periodically releases new versions of Celerra hardware and software. Therefore, some functions described in this document may not be supported by all versions of Celerra software or hardware presently in use. For the most up-to-date information on product features, see your product release notes. If your Celerra system does not offer a function described in this document, contact your EMC Customer Support Representative for a hardware upgrade or software update. Comments and suggestions about documentation Your suggestions will help us improve the accuracy, organization, and overall quality of the user documentation. Send a message to [email protected] with your opinions of this document. Copyright © 1998-2010 EMC Corporation. All rights reserved. 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. 18 of 18 Version 5.6.48