HP StoreEver Data Verification (CVTL) Support anual QSTAR AS HP CVTL SUPPORT ANUAL Revision History Date Revision number Comments November 23, 2014 1.0 Initial version February 8, 2015 1.1 Added SL 6480 support Added drive assessment support Table of Contents QSTAR AS HP CVTL SUPPORT ANUAL... 1 INTRODUCTION... 2 INTEGRATION WITH QSTAR AS... 2 CONFIGURATION REQUIREENTS... 4 SUPPORTED PLATFORS... 4 CONFIGURE CVTL SUPPORT IN LINUX AND UNIX... 4 CONFIGURE CVTL SUPPORT IN WINDOWS... 4 EAIL NOTIFICATION IN WINDOWS... 7 ANUAL EDIA HEALTH VERIFICATION... 8 AUTOATIC EDIA VERIFICATION... 10 DISPLAYING EDIA HEALTH VERIFICATION RESULTS... 11 EDIA HEALTH DATABASE BACKUP... 14 EDIA VERIFICATION SCHEDULING... 14 PROCESSING EDIA COPY ACTIONS AND SYSTE RESOURCES... 14 DRIVE ASSESSENT TEST... 15 Drive assessment execution test using command line interface... 15 Drive assessment test execution using Windows GUI... 17 FEATURES ADDED... 19 APPENDIX A: CVTL CONFIGURATION FILE... 20 APPENDIX B. CVTLCD UTILITY OPTIONS... 21 cvtlcmd usage statement... 21 APPENDIX C. CVTL ESSAGE CODES AND QSTAR AS ACTIONS... 23 APPENDIX D. E-AIL NOTIFICATION SAPLES... 28 Page 1 of 20
HP StoreEver Data Verification (CVTL) Support anual INTRODUCTION This document provides information for QStar Archive anager (AS) users to configure and manage QStar AS support for HP StoreEver Data Verification (Command View Tape Library - CVTL) services. The HP CVTL services provide possibility to verify HP tape media (using HP LTO Ultrium drives) in order to make sure that stored data is accessible. http://www8.hp.com/us/en/products/storage-software/product-detail.html?oid=438305 INTEGRATION WITH QSTAR AS The QStar AS software provides possibility to store user s archive data to tape using several tape formats. Once files are stored on the tape they reside there until requested by the user. From this point of view the data is kept on the tape for long time periods (tens of years) and ideally, the user has tools to verify that tape media is still accessible and data can be retrieved from the media reliably. The CVTL provides exactly this possibility. The media is submitted to the CVTL software and verified for media health. If media is found not to be 100% healthy the QStar AS software may take steps to copy data from media to another one in order to extend data life beyond the life of the physical media. Page 2 of 20
HP StoreEver Data Verification (CVTL) Support anual Figure 1. CVTL components. There are several QStar AS subsystems engaged in the media verification process. 1. Tape library configuration subsystem. This subsystem provides possibility to define network connectivity parameters to CVTL and to physical HP library. In addition the various verification scheduling parameters can be defined through this configuration subsystem. 2. QStar AS scheduling subsystem. This subsystem provides scheduling of the utility which actually executes requests to the CVTL services. 3. The CLI utility to perform manual media verification. 4. The GUI pages to manage display of the verification results. There are differences in how to manage CVTL support in QStar AS related to the operating system platform. In Windows all tasks can be performed through Windows QStar AS Administrator GUI pages. In UNIX systems the preference is to use Command Line Interface utilities. The same CLI utilities can be used to manage Windows CVTL support and that allows to use those CLI utilities in Windows scripting and other languages such as PHP or Perl. Page 3 of 20
HP StoreEver Data Verification (CVTL) Support anual CONFIGURATION REQUIREENTS A license for HP StoreEver Data Verification CVTL v3.9.x or higher must be purchased from HP for a determined number of tape media. User needs to know several parameters of the CVTL service and tape library in order to successfully complete configuration process. In particular, user needs to know: IP address of the CVTL system Network port of the CVTL system User name for CVTL system Password for CVTL system IP address of the supported (by CVTL system) tape library controller. Password for the library (required for the SL 6480 libraries only) This information cannot be discovered and needs to be retrieved from the IT administrator who installed CVTL software. SUPPORTED PLATFORS The CVTL verification is supported for the following platforms: Windows 64 bit 2012, 2008 Linux RedHat V6.x and Ubuntu 14.04. The builds for other Linux platforms may be provided on request. Solaris 10 and Solaris 11 AIX 6.1 and 7.1 CONFIGURE CVTL SUPPORT IN LINUX AND UNIX CVTL configuration is performed through XL file for Linux, Unix and Windows. The file location is /opt/qstar/vl/files/ext_lib_config/ext_lib_config/library_name.xml. Here the library_name is the QStar AS library name configured during SCSI configuration time. For example: jb.xml. The configuration file is processed by the CVTL file editing utility qac. For example, if CVTL enabled tape library is called jb the qac command shall be called as follows: qac c jb The manual editing of the configuration file is discouraged. During initial library configuration in Linux/UNIX (see INSTALL script) once tape library is defined and it is of the type supported by CVTL (ESL G3 or SL 6480) the qac utility is started automatically. CONFIGURE CVTL SUPPORT IN WINDOWS Page 4 of 20
HP StoreEver Data Verification (CVTL) Support anual If QStar AS Windows GUI discovers that particular library (using Vendor and Product ID strings of the library from SCSI INQUIRY CDB) potentially may support CVTL, the library configuration page will provide button [HP CVTL]. That signals to the user that CVTL may be configured for this library. Figure 2. QStar AS configuration page CVTL indicator. Once [HP CVTL] button is clicked the pop-up page will provide possibility to define CVTL and library parameters and define default verification schedule, if HP StoreEver Data Verification has been licensed by HP. Please execute CVTL configuration when QStar AS servers are running. Page 5 of 20
HP StoreEver Data Verification (CVTL) Support anual Figure 3. CVTL configuration parameters. Complete CVTL parameter definition by clicking Save and Exit buttons. After this CVTL verification schedule should be defined. Default is to start CVTL operations is once in an hour: Figure 4. Configuring CVTL schedule. Once CVTL parameters configuration is done the actual verification may be initiated. Scheduled CVTL job may be checked and edited on the Delayed Jobs page of QStar GUI Page 6 of 20
HP StoreEver Data Verification (CVTL) Support anual Figure 5. CVTL verification job EAIL NOTIFICATION IN WINDOWS To enable email notification please set to true email_notification parameter in CVTL configuration file. That will enable e-mail operations in CVTL subsystem. The e-mail is actually sent by QStar AS software which needs to be configured in Windows QStar AS GUI. Page 7 of 20
HP StoreEver Data Verification (CVTL) Support anual Figure 6. E-mail notification configuration in Windows In Linux and other UNIX systems please check QStar AS documentation for instructions how to configure e-mail for particular platform. In essence there are several e-mail processing scripts in /opt/qstar/install directory (send_notification, send_collapsed_notification) which needs to be edited and adjusted for particular UNIX system and e-mail client installed. ANUAL EDIA HEALTH VERIFICATION QStar AS uses a specific drive mode for media health verification. This mode of operation was selected because QStar AS controls all tape drives and media in any library partition and needs to coordinate media verification process with regular QStar AS operations, such as data writes and reads. The command line utility cvtlcmd allows to initiate manual media verification and is used to perform scheduled verification operations. In order to manually initiate particular media verification, user should select tape drive to be used. For verification process the tape drive needs to be empty and can be determined by executing command jbstatus d library_name For example: jbstatus -d jb Drive Drive Drive Drive 1: lto3-r lto4-rw lto5-rw online full loaded slot 1a 2: lto3-r lto4-rw lto5-rw online empty loaded slot 33a 3: lto3-r lto4-rw lto5-rw online empty 4: lto3-r lto4-rw lto5-rw online empty Page 8 of 20
HP StoreEver Data Verification (CVTL) Support anual In this particular case the drives 3 and 4 are good candidates to be used for media health verification. Assuming that drive 4 is selected, the manual media verification can be started using following command: cvtlcmd l jb s 6 d 4 t q where: -l jb specify library name -s 6 specify library slot number to verify -d 4 specify drive number to be used -t q specify verification type, in this case quick verification. For example: cvtlcmd -l j b s 5 d 3 t q Result: OK : [Authentication Successful] Result: OK : [DV service started] Start DV Engine library serial number [2U31310037] at IP [10.12.1.24] totalaggregatedlicenses : [500] totalaggregatedavailablelicenses : [379] controlpanelentry 1: availablelicenses : [379] dvenginestate : [Running] libodel : [ESL G3] libsn : [2U31310037] totaldrives : [104] totallicenses : [500] totalailslots : [12] totalslots : [12] defaultverificationtype : [Quick] libfirmware : [680H.GS24401] defaultverificationtype : [Quick] Setting library [jb] drive [3] and slot [5] to offline. Result: OK : [] edia verification [jb:5 on drive 3 Quick] started Time: 0. Status [2042] [PREPARE] Time: 4. Status [2043] [OVETODRIVE] Time: 17. Status [2044] [TEST] Time: 120. Status [2044] [TEST] Time: 180. Status [2044] [TEST] Time: 239. Status [2045] [OVEBACK] Time: 240. Status [2045] [OVEBACK] Time: 253. Status [2046] [COPLETED] Test is not running anymore Drive unloaded after 0 seconds Setting library [jb] drive [3] and slot [5] back online. Result: for [jb(esl G3 2U31310037)] (barcode EU8353L5): Number of entries [1] page [1] page_size [1] total_pages [110] total_results [110] Test Name : [LTO Data Assessment Test] timestamp : [1411576298231] Wed Sep 24 11:31:38 2014 Drive Serial Number : [HU1118GD06] edia barcode : [EU8353L5] Library Serial Number : [2U31310037] Verification Type : [Quick] Library Tape Format : [LTO-5] Read B : [38912.0] readarginpercentage : [100] Page 9 of 20
HP StoreEver Data Verification (CVTL) Support anual readargin : [Great margin] Test Run time : [1:56] Test Result : [Test Passed] logicalserialnumber : [82C6C2A00D] message : [The test has completed successfully and detailed analysis of the data on tape shows that it is GOOD.] message code : [1018] To start verification from Windows GUI right click on the proper slot on the Statistics page of the QStar interface: Figure 7. Verification manual start from GUI This will create job that will start on the top of the minute. Job execution status can be verified on the Delayed Jobs page. AUTOATIC EDIA VERIFICATION To perform scheduled media verification user shall schedule cvtlcmd execution using vlsched utility (UNIX, Windows) or GUI page for Windows. First, please make sure that CVTL utility execution is not already scheduled and remove such job if it is. Use vlqlist utility or GUI page Delayed Jobs to clean up previous schedules. The recommended scheduling period for CVTL utility is one hour. In this case CVTL utility will be started at specified minute of the hour and perform several verification tasks before actually requesting CVTL to execute operation: 1. If QStar AS is running. 2. If there are storage libraries supported by CVTL (HP G3, SL 6480 etc). 3. If there are free drives to use. 4. If the blackout-times to run CVTL are passed. Essentially cvtlcmd utility will start verification in the background if all other media related operations are not running and blackout time is not active. Page 10 of 20
HP StoreEver Data Verification (CVTL) Support anual For example, the following command line will create a job cvtl to be executed on 25-th minute of every hour to start media verification of the media in the library jb in automatic mode. vlsched -p /opt/qstar/emg/bin/cvtlcmd -s "25 */1 * * *" -j cvtl "\-l jb -f" Once started the cvtlcmd utility will check QStar AS database to select media for which verification is due and start CVTL operation. Once verification is completed, the next media will be selected until all scheduled for verification media are verified. The verification results are saved in QStar AS media health database (which contains CVTL and other media health information). Each instance of media health verification will result in a separate file and those files constitute media health database. The media database files are located in directory /opt/qstar/vl/files/media_statistics in UNIX systems or C:\QStar\vl\files\media_statistics directory in Windows. For each media known to the QStar AS there is directory created using media barcode and serial number of the media. For example following directory is created for media with barcode EU7605L5, vendor HP and serial number 1161155585: bc_eu7605l5_sn_hp1161155585 The directory contains series of XL files where media health information is accumulated. User may view XL files but should not modify them in order to prevent errors during file processing by cvtlcmd and other utilities. To change schedule (or reschedule) of automatic media verification using QStar GUI please use Delayed Jobs page. Figure 8. Automatic media verification using CVTL schedule. The result of this configuration will be the same as that configured using command line utility vlsched above. It will create job cvtl to be executed on 25-th minute of every hour to start media verification of the media in the library jb in automatic mode If there are day times when verification should not be executed, those times shall be configured using CVTL support configuration tools (see sections Configure CVTL support ). User essentially can black-out certain time periods to prevent CVTL operations to take place. The scheduled cvtlcmd operations will still be started at every schedules interval and they will be stopped immediately if a time is blacked-out. DISPLAYING EDIA HEALTH VERIFICATION RESULTS The media health verification results can be displayed using Windows QStar AS GUI. To display verification please select media of interest as this is shown on Figure 7 and use popup menu or edia Health button. Last or current verification logs is available from Verification Report menu item Page 11 of 20
HP StoreEver Data Verification (CVTL) Support anual Figure 9. QStar AS media verification report All verification results as a chart are available from edia Health button or menu item. Page 12 of 20
HP StoreEver Data Verification (CVTL) Support anual Figure 10. CVTL processing results for selected media In UNIX systems the data base files can be printed for analysis using following command: /opt/qstar/qscsi/bin/qscsicmd media_health_info -i /opt/qstar/vl/files/media_statistics/bc_eu8351l5_sn_hp1201184847/stat.xml This command produces output where CVTL related information is at the end. Time stamp: [Wed Sep 24 03:40:24 2014] (1411548024) Last erase time: [Sat Sep 6 09:05:06 2014] (1410012306) Library name: [jb] Drive number [4] Slot number [1a] Drive serial number: [82C6C2A013] Inquiry Id: [HP Ultrium 5-SCSI I6FW] Device type: [1] Tape edia Id: [HP1201184847]. CVTL: test_result [1] Passed Last quick time: [Wed Sep 24 03:40:24 2014] (1411548024) Last moderate time: [Wed Sep 24 03:40:24 2014] (1411548024) Last full time: [Thu Sep 18 11:11:36 2014] (1411056696) The CVTL requires certain amount of data to be written to the media for verification to succeed. The message returned by CVTL in this case looks like following: There is insufficient data on the tape for data verification which required a minimum sample size of 19GB for LTO-3, 30GB for LTO- 4, 38GB for LTO-5 and 39GB for LTO6. These are the NATIVE data sizes (after compression) which may vary from the reported data on the tape. In the case of partitioned tapes, the test required the same minimum data in every partition to be tested. Page 13 of 20
HP StoreEver Data Verification (CVTL) Support anual The QStar AS tracks the media status and if media does not have required written capacity (essentially if media is listed as erased in QStar AS database) the cvtlcmd utility will not attempt to load that media for verification. The message returned by automatic verification procedure will be as follows: slot xxx SKIP (Surface ERASED) where xxx is a slot number in the storage library. EDIA HEALTH DATABASE BACKUP edia health database provides valuable information related to the history of the media and its health over longer periods of time. It very well could be that several computers will be replaced but tape media will stay the same for long periods of time. Therefore it is recommended to backup media health database and restore it to the same location if QStar AS is reinstalled on different computer or QStar AS installation is lost due to a disk crash, or other catastrophy Following directories shall be backed-up: In Linux: /opt/qstar/vl/files/media_statistics In Windows: C:\QStar\vl\files\media_statistics The CVTL configuration files may also be backed-up, but after their recovery the configuration needs to be verified because CVTL location may be changed. EDIA VERIFICATION SCHEDULING Here are HP recommendations on the default frequency for verification. There are two use cases for the tapes. Tape could be in an offline vault or in a library. It is assumed that the tape is always stored in a temperature controlled environment. Case 1. If the tape is in library. The recommended frequency is as follows: 1. Run three tests in a year. i.e., test should be run every 4 months. 2. Quick test should be run 2 times and the third time should alternate between oderate and full. 3. Hence the tape will be verified with moderate and full test every alternate year. Case 2. If the tape is in vault. It is advised to run the full test every 2 years to have a piece of mind. Obviously user may use own judgment and change verification periods accordingly based on media usage and resource availability. PROCESSING EDIA COPY ACTIONS AND SYSTE RESOURCES If media health analysis requires media copy the resource availability should be taken into account. To copy media at least two compatible drives are needed and the media copy may take up to 8 hours to complete. If system experience heavy load conditions the immediate scheduling of the copy may add additional load and cause normal operations to delay even more. Page 14 of 20
HP StoreEver Data Verification (CVTL) Support anual The solution is to start automatic media copy only when there are at least 2 free drives and number of the drives in the system is at least 4, although higher numbers (8+) are ideal. In other cases the volume media copy request shall be queued into QStar AS Console where system administrator may schedule the copy job for particular time or manage it otherwise (for example delete). DRIVE ASSESSENT TEST Starting from CVTL Version:3.9.01 there is a possibility to verify drive health. The drive assessment test should be executed when media verification tests return error and there is a suspicion that media is healthy but error may be caused by the faulty drive. The drive assessment test should be executed using known-to-be-good media. The recommendation is to keep in known library slots a set of good media (preferable HP-branded) and use then only for drive assessment tests. The drive assessment test are not executed or scheduled on periodic basis. It is up to the system administrator to ton drive assessment tests as needed. QStar AS will verify that media selected for the drive assessment test is listed as erased in storage library database. If media is not in erased status it is recommended to perform media refresh to make sure media can be overwritten. NOTE: drive assessment test destroys all data on the media! Please take any necessary precautions to avoid data loss because of media reshuffling in the tape library after library doors are open or service operations performed. The system administrator shall determine beforehand drive number and slot number with erased media which will be used for verification. Drive assessment execution test using command line interface The drive assessment test can be started in interactive or command mode using cvtlcmd utility. Assumptions: The drive number to be verified: 3 The library name is: esl The media slot number: 61 1. ake sure the media in slot 61 is erased : a. vllsdev esl 61 b. vllsdev esl 61 61a: erased 2.499 TiB Tape 2. To execute drive assessment test in interactive mode: a. Start cvtlcmd utility: b. cvtlcmd l esl NOTE: The list of API calls is omitted. The user responses are in blue. Authorized for 1806 minutes Enter command to execute: 16 1 - use drives from DV Partition (without specifying drive serial number) 2 - use drives from DV Partition (specify drive serial number) 3 - use specific drive in current library Please enter request type [3]: 3 1 - Quick 2 - oderate 3 - Full Page 15 of 20
HP StoreEver Data Verification (CVTL) Support anual 4 - Default 5 - Drive Assessment Please enter verification type [1]: 5 Please enter media slot number in the library 'esl': 61 Using media [61], barcode [AAX559L6] which is marked as 'erased'. WARNING: edia content fill be *** destroyed ***! Are you sure? [y/n]: y 3 drives found (for slot type lto6) Drive [1]: lto3-r lto4-rw lto5-rw online empty Drive [2]: lto3-r lto4-rw lto5-rw online empty Drive [3]: lto4-r lto5-rw lto6-rw online full loaded slot 61a Please enter drive number in the library 'esl' [0]: 3 Setting library [esl] drive [3] and slot [61] to offline. Result: OK : 2020 [Queued for verification] edia verification [esl:61 on drive 3 DriveAssessment] started At this point user may select option 99 to monitor process of the drive verification. The estimated time for LTO-6 drive is about 1180 seconds (about 20 minutes). 3. To start drive assessment test in command mode (user needs to make sure that slot number contains media which is is really erased ): a. cvtlcmd -l esl -s 61 -t t -d 3 This operation mode is provided for usage in scripts and assumes that media is erased. The utility nevertheless will verify that media is actually erased and will request confirmation. If media turns-out to be used in some of the QStar AS sets the following messages will be printed: Refusing to run drive verification test on [Belongs to Set] media, slot [20], barcode [ABG947L6]! Please select erased media for drive verification test because the media content will be *** destroyed ***! Please select media which is known to be good (or at least new). In case of errors please use HP-branded media to perform drive verification. End data verification: 02/02/2015 16:37:46 Error on exit: [edium is incompatible with destination] Once drive assessment test is finished user may request drive verification results using options 28 or 29. The typical response is in the following format: [ 1]: Test Name : [LTO Drive Assessment Test] [ 1]: timestamp : [1422913850031] on Feb 2 15:50:50 2015 [ 1]: Drive Serial Number : [HU1247T9TW] [ 1]: edia barcode : [AAX559L6] [ 1]: Library Serial Number : [2U31310037] [ 1]: Verification Type : [] [ 1]: Library Tape Format : [LTO-6] [ 1]: Read B : [] [ 1]: readarginpercentage : [] [ 1]: readargin : [] [ 1]: Test Run Time : [18:19] [ 1]: Test Result : [Test Passed] [ 1]: logicalserialnumber : [] Page 16 of 20
HP StoreEver Data Verification (CVTL) Support anual [ 1]: message : [The LTO Drive Assessment Test has checked the history and operation of the selected drive, and the test has PASSED and the drive is GOOD.] [ 1]: message code : [1043] The actual result is listed in the message line. Drive assessment test execution using Windows GUI To start drive assessment test from Windows GUI right click on the proper drive of interest on the Statistics page of the QStar interface and click Drive verification item: Figure 11. Drive assessment test start from GUI This will display media selection dialog (see Figure 12). Only erase media which is writable on the selected drive type will be offered for the test. User should select one of erased media in the list and click OK. Before sending job to server, GUI will display the same warning message as described above for CLI command. Page 17 of 20
HP StoreEver Data Verification (CVTL) Support anual Figure 12. edia selection for drive verification Once drive verification started and job log file created on QStar log directory, Progress Report menu item becomes enabled for this drive and execution results may be viewed in the same manner as this is for media verification. The progress report is accumulated over several drive test runs and contains plain text file which can be viewed by standard Windows utilities. It contains protocol of assessment test execution and result as shown in Figure 13. Page 18 of 20
HP StoreEver Data Verification (CVTL) Support anual Figure 13. An example of the drive assessment test progress report. FEATURES ADDED The first version of CVTL support in QStar AS was implemented in QStar AS version 6.1.0.4451. Following new features and changes were added starting from build 6.1.0.4552. Page 19 of 20
HP StoreEver Data Verification (CVTL) Support anual 1. SL6480 library support. 2. Drive load counts are taken into account to select drive for testing. The drive with less media mount/unmount count will be selected first. 3. Barcode for UNKNOWN surface is stored in QStar DB. This improves media tracking possibilities. 4. Status verifying is displayed for surface under testing in Online media page and vllsdev command output. This provides possibility to monitor current status of the CVTL activity. 5. Following media status will prevent CVTL verification: a. edia is loaded in the drive b. edia is not accessible (media which is reported not accessible by the changer READ ELEENT STATUS CDB) c. edia open by QStar AS for read/write operations d. edia marked as bad 6. Added log message to syslog and email notification to return exported medium for verification. 7. If blackout period is encountered the cvtlcmd utility exits immediately. 8. Added possibility to open all log files in QStar AS log directory. 9. Drive health assessment test. APPENDIX A: CVTL CONFIGURATION FILE The default CVTL configuration file is created from template located in the directory /opt/qstar/vl/files/ext_lib_config/templates/health_check_configuration_template.xml. In Windows the configuration files are located in directory C:\QStar\vl\files\ ext_lib_config\templates\health_check_configuration_template.xml. For each storage library defined in the QStar AS configuration the new configuration file is created and it can be edited using GUI (CVTL) button for the CVTL enabled libraries or CLI utility qac. The particular files for the library configuration are located in directory /opt/qstar/vl/files/ext_lib_config/ext_lib_config/and files are called library_name.xml where library_name is the configured storage library name. It is discouraged to edit those files manually. Page 20 of 20
HP StoreEver Data Verification (CVTL) Support anual APPENDIX B. CVTLCD UTILITY OPTIONS The cvtlcmd utility may be executed in interactive mode or automatically depending on the specified options. In automatic mode cvtlcmd essentially will select media to be verified depending on the history of the verification and configuration parameters. The utility will select a free drive to be used for verification and will obey black-out periods specified in the configuration file. The drive and media status will be declared as offline and will stay offline until the test is finished (or timeout is reached). In interactive mode utility may be used to perform ad-hoc verification of some media (specified by the slot number in the library or by the barcode). The utility also provides possibility to execute specific requests to the CVTL service, like retrieve all information from the CVTL database related to particular media, start/stop verification engine, check licenses, etc. The interactive mode is targeted for troubleshooting and development/debug purposed rather than for the end-user. It requires certain familiarity with CVTL API (documentation and architecture). The CVTL support requires special CVTL Licensing option. The demo license includes such option. The cvtlcmd in interactive mode uses configuration file and therefore immediately connects to the CVTL engine and tape library. If some configuration parameters are incorrect the connection will fail. The menu items in cvtlcmd utility using interactive mode corresponds to the CVTL API call numbers as they are stated in CVTL documentation. There are 26 CVTL API calls and correspondingly 26 menu items. The cvtlcmd provides additional menu item numbered as 30 which does not correspond directly to CVTL API call. The menu tem 30 is used to monitor active test execution started in current cvtdcmd session. The verification progress will be printed on the screen and at the end of the test the media and drive will be declared available for QStar AS (offline status will be changed to online). cvtlcmd usage statement cvtlcmd CVTL license: Enabled Please specify CVTL-enabled library name QStar AS media health check subsystem: HP CVTL data verification utility Usage: cvtlcmd -l library [options] -l library - Specify library name to use for testing Where main options are following: -s slot_num - library slot to verify -b barcode - barcode of the media to verify -d drive_num - drive to verify (default: get free drive) -D drive_sn - drive serial number to get results assessment test -t q m f d t - verification type (q -quick, m - moderate, f -full, d default, t drive assessment test) -f - automatically locate media for verification and save statistics -F - suppress verification and just list of media to be verified -T q m f - save default verification type (q -quick, m - moderate, f -full) -A - abort running test on library slot (-s) or barcode of the media (-b) -S - get status of the data verification for cartridge -c - forced copy after data verification (if -s or -b) -I - Ignore blackout period settings. Optional: Page 21 of 20
HP StoreEver Data Verification (CVTL) Support anual -v - verbose -P per_page - number of results per page (for interactive mode) -p page - result page number to retrieve -a - request new values for per_page and page The utility will be executed in non-interactive mode if one of the following options will be specified: -s -b -f -T -d Page 22 of 20
HP StoreEver Data Verification (CVTL) Support anual APPENDIX C. CVTL ESSAGE CODES AND QSTAR AS ACTIONS The CVTL media verification result is processed by QStar AS and following actions are taken (see first column of the table): - anual action required. QStar AS will send e-mail and log event related to those codes and will expect administrator to correct situation. For example, install license, specify correct IP addresses, clean drives, etc. R - Repeat. QStar code will attempt to repeat operation on the different drive immediately or during next execution cycle. The number of repeat actions are limited to the number of available drives. If verification is still in error the manual action is declared. F - Failed. The media which returned those codes will be declared as "Failed" and configured actions will be executed. G - Good. Event is logged, saved into data base and no special with such media will be executed. In some cases (like insufficient data written) there is nothing to do except to wait for more data to be written. arg - arginal media health. Actions assigned to arginal tapes will be executed as configured by the administrator. Type essage code essage text There was a problem in unloading the tape. Please remove the media 1000 from the drive. There was a problem in loading the tape. Please try this tape with another 1001 drive. If the error persists, it may indicate that there is a problem with the media. Drive has failed to reset from read in encryption mode. HP recommends performing a drive assessment test to verify correct drive operation and 1002 then to repeat the data verification test. If the error persists, HP recommends that you copy the data to another tape An abort request was received while verifying encrypted data. The drive 1003 has been reset to stop the verify read encryption function. Data Verification for encrypted data has encountered a problem while verifying the data. It does not necessarily mean that data is bad. HP 1004 recommends performing a drive assessment test to verify correct drive operation and then to repeat the data verification test. If the error persists, HP recommends that you copy the information to another tape Data Verification for encrypted data has encountered a problem while initiating the data verification. HP recommends performing a drive 1005 assessment test to verify correct drive operation and then to repeat the data verification test. If the error persists, HP recommends that you copy the data to another tape Drive has failed to set to read in encryption mode. HP recommends performing a drive assessment test to verify correct drive operation and 1006 then to repeat the data verification test. If the error persists, HP recommends that you copy the data to another tape Drive has failed to set to read in encryption mode as keys could not be 1007 retrieved. (Drive is FIPS enabled, could not verify data) Page 23 of 20
HP StoreEver Data Verification (CVTL) Support anual arg R R G R R arg arg G G 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 The firmware version is not supported for running test on encrypted tapes. Refer CVTL user guide for the minimum supported firmware version. Please update the drive firmware and re-run the test. This tape has failed in a mode that indicates the tape life may have been exceeded. HP recommends minimizing the usage of this tape to prevent further tape degradation. Copy this data to another tape at the earliest opportunity. For best results use a LTO-6 tape drive for performing the copy. An error occurred after reading %s. The drive failed to read data from the cartridge. It does not necessarily mean that data is bad. HP recommends performing a drive assessment test to verify correct drive operation and then to repeat the data verification test. If the error persists, HP recommends that you copy the data to another tape An error occurred after reading %s. edia is not available to perform data verification. This may indicate that the media is pulled out during data verification. Please load the media and rerun the test The cartridge appears to be uninitialized. There is no data available to read. The drive is no longer available. This may happen if the device is power cycled or connection to the device is lost. Please check the drive connection and try again. Drive is reporting not ready status. HP recommends performing a drive assessment test to verify correct drive operation and then to repeat the data verification test. If the error persists, HP recommends that you copy the information to another tape The drive is currently reporting that it is attempting to load a data cartridge, but this has not completed within the allowed time limit of the test. Please check the drive, and try to reload the data cartridge before re-running the test. The test has finished checking the quality of the data on tape ($g_cartridgesn) but not all of it is above recommended threshold of HP for full read-back confidence. The data is still readable but we recommended to migrate the data to a different tape to prevent any potential data retrieval issues in the future. The test has finished checking the quality of the data on tape ($g_cartridgesn) but not all of it is above recommended threshold of HP for full read-back confidence. The data is still readable but we recommend to migrate the data to a different tape to prevent any potential data retrieval issues in the future. The test has completed successfully and detailed analysis of the data on tape shows that it is GOOD. There was a problem trying to access the tape s cartridge memory. This could be due to a faulty tape or an unsuccessful tape load. It does not necessarily mean there is anything wrong with the data. Please try reloading the tape or try with a different drive. If the error persists, HP recommends that you copy the data to another tape Analysis of tape ($g_cartridgesn) indicates that the EOD information in the cartridge memory is invalid. Valid EOD is a pre-requisite for running data verification. This indicates an interrupted backup or archive, but it should still be possible to recover the data from the tape. HP recommends that you copy the data to another tape. There is insufficient data on the tape to test. Please load the data cartridge with minimum data (19GB for LTO-3, 30GB for LTO-4, 38GB for LTO-5, 39GB for LTO-6) and re-run the test. Page 24 of 20
HP StoreEver Data Verification (CVTL) Support anual The firmware version is not supported for running test on partitioned 1022 tapes. Refer CVTL user guide for the minimum supported firmware version. Please update the drive firmware and re-run the test. G There is insufficient data on the tape for data verification which required a minimum sample size of 19GB for LTO-3, 30GB for LTO-4, 38GB for LTO- 1023 5 and 39GB for LTO6. These are the NATIVE data sizes (after compression) which may vary from the reported data on the tape. In the case of partitioned tapes, the test required the same minimum data in every partition to be tested. R An error occurred while locating the desired test start position. HP 1024 recommends performing a drive assessment test to verify correct drive operation and then to repeat the data verification test. If the error persists HP recommends that you copy the information to another tape There was a problem trying to access the tape s cartridge memory. This could be due to a faulty tape or an unsuccessful tape load. It does not 1025 necessarily mean there is anything wrong with the data. Please try reloading the tape or try with a different drive. If the error persists, HP recommends that you copy the data to another tape The test requires a tape to be loaded prior to it being run. Please load the 1026 tape to be verified and re-run the test. The firmware version is not supported for this test. Refer CVTL user guide 1027 for the minimum supported firmware version. Please update the drive firmware and re-run the test. 1028 DV Service(s) are not responding. R 1029 Test Aborted 1030 Please check if all the CVTL Services are running and network connection to the library or drive is intact while test is in progress. This can also happen if the network connection was momentarily broken. HP Recommends you to rerun the test after performing these checks. 1031 Error occurred during use of Data Verification license. 1032 No license available for consumption 1033 All Data Verification licenses are consumed. Data Verification license is needed to perform Data Verification test on new cartridge.ï ½To install a license, return to the Command View TL Launcher and then click the Licensing tab. R 1034 An error occurred during data verification test. 1035 Test could not be executed as Drive IP Address for {drivesn} is not available. Request you to look into the Network configuration for this library. arg 1036 This tape has failed in a mode that indicates the tape life may have been exceeded. HP recommends minimizing the usage of this tape to prevent further tape degradation. Copy this data to another tape at the earliest opportunity. 1037 Unable to move tape to the drive. Ensure connectivity to library is not lost, Also for SL6480 libraries make sure it is authenticated in control panel. R We cannot run Data Assessment Test on this media at this moment as it 1038 is in a Host Drive, please requeue after sometime. R This tape is incompatible with the (currently present) drives in DV 1039 Partition ovement of tapes in user partition to DV partition is not supported in 1040 SL6480 Page 25 of 20
HP StoreEver Data Verification (CVTL) Support anual Tape is marked for Drive Assessment Test. And if you want to run a Data 1041 Assessment Test on this tape, then please unmark the tape in the Test Setup page. Unable to move the tape from drive to a empty slot. Ensure there are sufficient empty slots available in the partition and connectivity to library 1042 is not lost. Use Library anagement console to move tape out of the drive and restart the service from control panel. Also for SL6480 libraries make sure it is authenticated in control panel. G The LTO Drive Assessment Test has checked The history and operation of 1043 The selected Drive, and The Test has PASSED and The Drive is GOOD. 1044 There was a problem whilst Locating to correct position on the cartridge. 1045 There is currently no data cartridge loaded in the drive. The test requires the data cartridge to have been loaded prior to running the test. Please load the required data cartridge and re-run the test. 1046 This test requires that the Removable Storage service is not running. Please stop RS (Computer anagement/services and Applications/Services)and then re-run the test. 1047 This test requires writing onto a tape. Any data on this tape will be destroyed. Please load a writable tape, set the Allow Overwrite test option to TRUE, and then re-run the test. 1048 This test does not support using partitioned tapes. Please re-run the test using a tape which is not partitioned. 1049 The cartridge currently loaded in the drive is a WOR cartridge. This test cannot be performed on a WOR cartridge. Please replace the cartridge with a normal data cartridge and re-run the test. 1050 The cartridge currently loaded in the drive is write-protected. This test cannot be performed on a write protected cartridge. Please replace the cartridge with a writeable data cartridge and re-run the test. 1051 The cartridge currently loaded in the drive is showing too much usage for the specified limits of this test. Please replace the cartridge with a newer cartridge and re-run the test. 1052 This test does not support using LTO4 tape to test LTO5 drives in ESL G3 with current drive firmware. A future release of drive firmware will allow this combination. For now, please use LTO5 tape to test this drive. 1053 The cartridge currently loaded in the drive is not writeable in this generation of drive. This test cannot be performed on a read only cartridge. Please replace the cartridge with a writeable data cartridge and re-run the test. 1054 The LTO Drive Assessment Test has checked the history and operation of the selected drive, and the drive firmware needs updated. Please update the drive firmware and then re-run the test. 1055 The LTO Drive Assessment Test has checked the history and operation of the selected drive, and Problems have been reported in the Historical Analysis of your drive. The drive is no longer recommended for use. Please contact HP support for further assistance. 1056 The LTO Drive Assessment Test has checked the history and operation of the selected drive, and Problems have been reported. Also, the drive is currently requesting cleaning. Please clean the drive with a cleaning tape and re-run the test. The LTO Drive Assessment Test has checked the history and operation of the selected drive, and Problems have been reported. The drive is no longer recommended for use. Please contact hp support for further 1057 assistance. Page 26 of 20
HP StoreEver Data Verification (CVTL) Support anual The LTO Drive Assessment Test has checked the history and operation of the selected drive, and Problems have been reported. The test tape used was not HP-branded tape. HP-branded tape is preferred for this test, so if 1058 possible please re-run the test using HP-branded tape. The drive is no longer available. This may happen if the device is power cycled or connection to the device is lost. Please check the connection 1059 and try again. The drive is currently reporting that it is attempting to load a data cartridge, but this has not completed within the allowed time limit of the test. Please check the drive, and try to reload the data cartridge before rerunning 1060 the test. 1061 The Test Unit Ready (TUR) command failed: "TUP Information". 1999 Default Code Page 27 of 20
HP StoreEver Data Verification (CVTL) Support anual APPENDIX D. E-AIL NOTIFICATION SAPLES In case of good media following e-mail will be sent (if configured) 10/16/2014 10:04:18.387062 INFO HEALTH: Tape media health test result using HP CVTL method. [jb:4] barcode [EU8354L5] drive number [1] drive serial number [82C6C2A001] Action [Good] Verification Type [Quick] Test run [5:36] Read argin [Great margin 55%] Result [Test Passed] Code [1018] essage: [The test has completed successfully and detailed analysis of the data on tape shows that it is GOOD.] ---------------------------------------------------------------- This test result was produced using known bad media. 10/17/2014 05:17:00.819322 CRIT HEALTH: Tape media health test result using HP CVTL method. [jb:32] barcode [BOI406L5] drive number [1] drive serial number [82C6C2A001] Action [Failed] Verification Type [Quick] Test run [8:25] Read argin [N/A 0%] Result [Test Failed] Code [1010] essage: [There was an error after reading 15 GB. The drive failed to read data from the cartridge. It does not necessarily mean that data is bad. HP recommends performing a drive assessment test to verify correct drive operation and then to repeat the data verification test. If the error persists, HP recommends that you copy the data to another tape.] ------------------------------------------------------------------ This result was received when library IP was configured incorrectly 10/17/2014 05:56:31.521026 INFO HEALTH: Tape media health test result using HP CVTL method. [jb:5] barcode [EU8353L5] drive number [1] drive serial number [82C6C2A001] Action [anual] Verification Type [Quick] Test run [0] Read argin [N/A 0%] Result [Test Incomplete] Code [1037] essage: [Unable to move tape to the drive. Ensure connectivity to library is not lost, Also for SL6480 libraries make sure it is authenticated in control panel.] ------------------------------------------------------------------ 10/17/2014 06:11:29.978690 INFO HEALTH: Tape media health test result using HP CVTL method. [jb:5] barcode [EU8353L5] drive number [1] drive serial number [82C6C2A001] Action [Good] Verification Type [Quick] Test run [9:30] Read argin [Great margin 100%] Page 28 of 20
HP StoreEver Data Verification (CVTL) Support anual Result [Test Passed] Code [1018] essage: [The test has completed successfully and detailed analysis of the data on tape shows that it is GOOD.] ------------------------------------------------------------------ Insufficient data to verify media health 10/17/2014 06:46:05.113909 INFO HEALTH: Tape media health test result using HP CVTL method. [jb:6] barcode [EU6274L5] drive number [1] drive serial number [82C6C2A001] Action [Good] Verification Type [Quick] Test run [9:42] Read argin [N/A 0%] Result [Test Incomplete] Code [1023] essage: [There is insufficient data on the tape for data verification which required a minimum sample size of 19GB for LTO-3, 30GB for LTO-4, 38GB for LTO-5 and 39GB for LTO6. These are the NATIVE data sizes (after compression) which may vary from the reported data on the tape. In the case of partitioned tapes, the test required the same minimum data in every partition to be tested.] Page 29 of 20