IBM TS2340 User Guide
IBM TS2340 - System Storage Tape Drive Model L4X Manual
 |
UPC - 883436006873
View all IBM TS2340 manuals
Add to My Manuals
Save this manual to your list of manuals |
IBM TS2340 manual content summary:
- IBM TS2340 | User Guide - Page 1
IBM Tape Device Drivers Installation and User's Guide GC27-2130-08 - IBM TS2340 | User Guide - Page 2
- IBM TS2340 | User Guide - Page 3
IBM Tape Device Drivers Installation and User's Guide GC27-2130-08 - IBM TS2340 | User Guide - Page 4
-2130-02 v IBM Tape Device Drivers Installation and User's Guide, GC27-2130-01. v IBM Tape Device Drivers Installation and User's Guide, GC27-2130-00. v IBM TotalStorage and System Storage Tape Device Drivers Installation and User's Guide, GC35-0154-17. v IBM Ultrium Device Drivers Installation and - IBM TS2340 | User Guide - Page 5
. 26 Tape Drive, Media, and Device Driver Parameters 28 Special Files 34 Persistent Naming Support 36 Control Path Failover Support for Tape Libraries . . 37 Data Path Failover and Load Balancing Support for Tape Drives 39 System-Managed Encryption 41 Problem Determination 43 Tape Drive Service - IBM TS2340 | User Guide - Page 6
- Tape Utility Program (IBMtapeutil) 385 Solaris System - Tape Utility Program (tapeutil) 397 Microsoft Windows System - Utility Program (ntutil 406 Tru64 System - RAS Utility Program (IBMrasutil) 425 Notices 427 Trademarks 428 Index 429 iv IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 7
205 50. 3494/SMC Library Data Flow 209 © Copyright IBM Corp. 2007, 2009 51. LIBSMC and OS Components 210 52. Data Flow for AIX 3494 Enterprise Tape Library Driver 212 53. SMIT Main Menu 216 54. SMIT Devices Menu 216 55. SMIT Tape Drive Menu 217 56. Tape Drive Type Menu 217 57 - IBM TS2340 | User Guide - Page 8
| 102. Tape Drive Commands 329 | 103. Command Parameters 329 | 104. Command Parameter Results 330 105. Linux Command Line Help Display . . . . 386 106. Example of Base Mode 408 107. Example of Library Mode 409 108. Symbolic Values 423 vi IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 9
89 28. IBM SCSI Tape/Medium Changer Special 15. Troubleshooting (Problems and Solutions) 91 Files for Solaris 147 16. Components Created During lin_tape 29. Tracing Facility 157 Installation 97 30. Definitions of Abort Codes 284 17. Components Created During IBMtapeutil | 31. Supported - IBM TS2340 | User Guide - Page 10
viii IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 11
Tape Drive Models T800 and T800F Setup, Operator, and Service Guide, GC26-7697 IBM LTO Ultrium 3-H Tape Drive The following publications relate to the IBM LTO Ultrium 3-H Tape Drive: v IBM LTO Ultrium 3-H Tape Drive Setup, Operator, and Service Guide, SC23-5231 IBM System Storage TS2230 Tape Drive - IBM TS2340 | User Guide - Page 12
the IBM System Storage TS2340 Tape Drive [also known as IBM LTO4 (TS2340)]: v IBM System Storage TS2340 Tape Drive Models L43/S43 Setup, Operator, and Service Guide, GC27-2103 v IBM System Storage TS2340 Tape Drive Models L43/S43 Quick Reference Card, GC27-2104 IBM System Storage TS3500 Tape Library - IBM TS2340 | User Guide - Page 13
Tape Library: v IBM System Storage TS3100 Tape Library and TS3200 Tape Library Setup, Operator, and Service Guide, GA32-0454 v IBM System Storage TS3100 Tape Library and TS3200 Tape Library Installation Quick Reference, GA32-0456 v IBM System Storage TS3100 Tape Library and TS3200 Tape Library SCSI - IBM TS2340 | User Guide - Page 14
3583 Tape Library (also known as IBM TotalStorage Ultrium Scalable Tape Library 3583) The following publications relate to the IBM TotalStorage Ultrium Scalable Tape Library: v IBM 3583 Tape Library Setup and Operator Guide, GA32-0411 v IBM 3583 Tape Library Service Guide, GA32-0425 v IBM Storage - IBM TS2340 | User Guide - Page 15
to the IBM 7334 8mm Tape Library: v 7334 Model 410 8mm Tape Library Setup and Operator Guide, SA26-2009 v 7334 Model 410 8mm Tape Library Service Guide, SY32-0412 IBM 7336 4mm Tape Library The following publication relates to the IBM 7336 4mm Tape Library: v IBM 7336 4mm Tape Library Model 205 - IBM TS2340 | User Guide - Page 16
to SGI systems: http://www.sgi.com Other Publications IBM Storage Area Network Data Gateway Installation and User's Guide, SC26-7304 Additional Information The following publication contains additional information related to the IBM tape drive, medium changer, and library device drivers: v American - IBM TS2340 | User Guide - Page 17
Instructions This Tape Device Drivers Installation and User's Guide contains different sections for each type of operating system/platform; for example, AIX®, Tru64, HP-UX, Linux, Sun Solaris, Windows; and a separate section on these operating systems for the 3494 Enterprise Tape Library the manual, - IBM TS2340 | User Guide - Page 18
xvi IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 19
all devices are supported on all operating systems. Refer to the specific operating system chapters for details on device support. Purpose The IBM tape and medium changer device drivers are designed specifically to take advantage of the features provided by the IBM tape drives and medium changer - IBM TS2340 | User Guide - Page 20
System Storage dd000004 Figure 1. Current Attachment Array 1 Open Systems Server 2 IBM Virtualization Engine TS7520/TS7530 3 IBM Virtualization Engine TS7650 4 IBM TS2230/TS2240 Ultrium 3/4 Half-High Tape Drive 5 IBM TS2340 (or 3580) Ultrium 3/4 Full-High Tape Drive 6 IBM TS1120/TS1130 Tape Drive - IBM TS2340 | User Guide - Page 21
to backup and restore open systems applications. This model incorporates the Linear Tape Open (LTO) IBM Ultrium 3 Half-High Tape Drive. It is available with a Small Computer Systems Interface (SCSI) or with a Serial Attached SCSI (SAS) interface. The drive has a native storage capacity of 400 GB per - IBM TS2340 | User Guide - Page 22
and data governance and regulatory compliance. The TS1130 tape drive offers high-performance flexible data storage with support for data encryption. IBM System Storage TS3200 Tape Library The IBM System Storage TS3200 Tape Library Express Model offers high capacity and performance technology for the - IBM TS2340 | User Guide - Page 23
Storage TS3500 Tape Library is a highly scalable, automated tape library combining IBM automation technology for midrange to enterprise open systems environments. The TS3500 Tape Library supports logical partitioning and can house both IBM LTO Ultrium and IBM TotalStorage Enterprise 3592 Tape Drives - IBM TS2340 | User Guide - Page 24
storage activities. IBM TotalStorage Ultrium External Tape Drive 3580 The IBM TotalStorage Ultrium External Tape Drive 3580 is a stand alone, large capacity, high performance tape drive that adheres to the Linear Tape Open (LTO) specifications and supports the IBM Ultrium format tape. The drive - IBM TS2340 | User Guide - Page 25
drivers control both the Magstar MP tape drives and the robotic cartridge handling mechanism in these tape libraries that instructs the robot to mount and demount the cartridges. IBM Virtualization Engine TS7510 The IBM Virtualization Engine TS7510 product delivers and increased level of storage - IBM TS2340 | User Guide - Page 26
the robotic cartridge handling mechanism in these tape libraries that instructs the robot to mount and demount the cartridges. Access to the tape drives within these libraries is through the native operating system AIX Tape Device Driver. 8 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 27
service and documentation for this software, refer to Appendix A, "Accessing Documentation and Software Online," on page 341. Table 2. Supported Hardware by Operating System DEVICE IBM LTO Ultrium Tape Drive IBM System Storage TS1120/ TS1130 Tape Drive Model E05/E06 IBM System Storage TS2230 Tape - IBM TS2340 | User Guide - Page 28
Supported Hardware by Operating System (continued) DEVICE Linux Intel® and AIX HP-UX AMD System System Solaris Tru64 Opteron p z® Processors Models Models IBM System X X X X X Storage (not TS2340 Tape HP-UX Drive 11.0) IBM System X X X X X X Storage TS3100 Tape Library - IBM TS2340 | User Guide - Page 29
Device Driver Features Table 2. Supported Hardware by Operating System (continued) DEVICE Linux Intel® and AIX HP-UX AMD System System Solaris Tru64 Opteron p z® Processors Models Models IBM X X X X X X X TotalStorage Enterprise Tape System 3590, Models E11, E1A, H11, H1A IBM - IBM TS2340 | User Guide - Page 30
Device Driver Features Table 2. Supported Hardware by Operating System (continued) DEVICE Linux Intel® and AIX HP-UX AMD System System Solaris Tru64 Opteron p z® Processors Models Models IBM 7332 X 4mm Tape Cartridge Autoloader Model 005, 110, 220 IBM 7334 X 8mm Tape Library Model - IBM TS2340 | User Guide - Page 31
systems connected to tape drives while CPF is an automatic failover support for the transfer of commands to move tape Drive (DPF) Fabric X Library (CPF) Drive X Drive Library Controller Drive X Virtual Tape Library is severed and a permanent path error occurs. If however the failure was - IBM TS2340 | User Guide - Page 32
Path Failover Dual HBA (DPF and CPF) Single-Port Drive X Fabric Figure 4. Multiple HBA and single ports Drive Library Drive Drive Library Controller Virtual Tape Library a2500256 14 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 33
progress when the path error occurred. Sometimes manual failover may require operator intervention to reset the drive because a SCSI Reservation could still exist on the failing HBA path. When the path failover support is enabled on all logical devices, the device driver configures them internally - IBM TS2340 | User Guide - Page 34
tape libraries and Data Path Failover (DPF) for tape drives. In order to use path failover support, some devices require feature codes as listed in Table 3. Table 3. Supported Devices and Feature Codes Supported Tape Library Feature Code ) 16 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 35
in the IBM encryption-capable TS1120 and Ultrium LTO4 (Fibre Channel or SAS) tape drives that support encryption. If system-managed or library-managed encryption is used, the Transparent LTO Encryption feature code is required for the library with Ultrium LTO4 tape drives. This feature code is not - IBM TS2340 | User Guide - Page 36
Ultrium LTO4 drives - Tape drive code updates Application-Managed Tape Encryption Setup Tasks Any task not identified as an IBM service task is the responsibility of the customer. 1. Install, cable, and configure the encryption-capable tape drive (refer your IBM System Storage Tape Drive or Library - IBM TS2340 | User Guide - Page 37
to the IBM System Storage Encryption Key Manager Introduction, Planning, and User Guide) v Encryption configuration features: - Encryption Key Manager (EKM) - Tape drive code updates and Transparent LTO Encryption feature code for libraries with Ultrium LTO4 drives - Tape system library code updates - IBM TS2340 | User Guide - Page 38
, # ekmtest 10 fe80::207:30ee:edcb:d05d 8050 # # The Encryption Key Server address and port can be a local loop back # address . # Up to 16 server address and port entries are supported if there are multiple # TCP/IP connections to the same IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 39
the IBM System Storage Encryption Key Manager Introduction, Planning, and User Guide) v Encryption configuration features: - Encryption Key Manager (EKM) - Tape system library code updates and Transparent LTO Encryption feature code for libraries with Ultrium LTO4 drives. - Tape drive code updates - IBM TS2340 | User Guide - Page 40
.software.ibm.com/storage/devdrvr/sample_code. Feature Codes (Encryption) In order to use system-managed and library-managed encryption, the Transparent LTO Encryption feature codes listed in Table 5 are required for the associated IBM tape libraries with Ultrium LTO4 tape drives. If the drives in - IBM TS2340 | User Guide - Page 41
Primary and Alternate Devices 41 System-Managed Encryption 41 Device Driver Configuration 41 Querying Tape Drive Configuration . . . . . 42 Testing Data Encryption Configuration and Connectivity 42 Error Logging 42 Field Support Information 42 Problem Determination 43 Using the Dump - IBM TS2340 | User Guide - Page 42
Hardware Requirements The following hardware is supported by the Atape device driver: v One or more of the following IBM RS/6000® or System p (also known as pSeries) SCSI host bus adapters for libraries containing Ultrium tape drives: - PCI-X DDR Dual -x4 SAS Adapter (FC 5900 and FC 5912) - PCI Dual - IBM TS2340 | User Guide - Page 43
Universal Differential Ultra SCSI Adapter v For 733x devices, refer to the specific product document for hardware attachment requirements. v The IBM TotalStorage Enterprise Tape System 3590 Model E and Model H Tape Drives with Fibre Channel Attachment, is supported with the System p (also known as - IBM TS2340 | User Guide - Page 44
AIX Device Driver (Atape) - TS3400 (3577) Library - TS3500 (3584) Library - Ultrium TD4 LTO drives - TS3100 (3573-L2U) Library - TS3200 (3573-L4U) Library - TS3500 (3584) Library - Ultrium TD3 LTO drives - TS3100 (3573-L2U) Library - TS3200 (3573-L4U) Library - TS3500 (3584) Library Note: Using a - IBM TS2340 | User Guide - Page 45
powered up. If you are attaching an IBM TotalStorage Enterprise Tape System 3590 Model E or Model H Tape Drive with the Fibre Channel Attachment, make sure . Note: If the tape device was configured previously by another SCSI device driver, such as OST (Other SCSI Tape), issue the following command - IBM TS2340 | User Guide - Page 46
or using the following installp command: installp -u Atape.driver Tape Drive, Media, and Device Driver Parameters This chapter describes the parameters that control the operating modes of the AIX Enhanced Tape and Medium Changer Device Driver. 28 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 47
the IBM 3583 Ultrium Scalable Tape Library with more than one IBM 3580 Ultrium Tape Drive installed. Note: The autoloading feature is supported only on the following device types and configurations: v IBM 3490E Models C11, C22, E01, E11, F01, and F11 v IBM TotalStorage Enterprise Tape System 3590 - IBM TS2340 | User Guide - Page 48
operates when the ACF on the IBM TotalStorage Enterprise Tape System 3590, the IBM Magstar MP tape device, or the IBM 3490E Model Fxx is set to Random mode. If this parameter is set to On and the ACF is in Random mode, the device driver emulates an autoloading tape drive. When an unload command is - IBM TS2340 | User Guide - Page 49
Enterprise Tape System 3590. If a tape is loaded and the IBM 3590 cannot read the positioning information from the tape, the device driver is notified when the first command is sent to the tape drive. If this parameter is set to On, the device fails the command and returns a media error to - IBM TS2340 | User Guide - Page 50
, the new logical name parameter is cleared. There is no installation default value for this parameter. Read Error Recovery Time This parameter controls the read error recovery time for the IBM TotalStorage Enterprise Tape System 3590. If this parameter is set to On, the recovery time for read - IBM TS2340 | User Guide - Page 51
parameter sets the capacity or logical length of the current tape on IBM TotalStorage Enterprise Tape System 3590, IBM TotalStorage Enterprise Tape System 3592, or Magstar MP tape subsystems. By reducing the capacity of the tape, the tape drive can access data faster at the expense of data capacity - IBM TS2340 | User Guide - Page 52
If a tape drive has a SCSI medium changer device attached, then all operations (including the medium changer operations) are supported through the interface to the rmt* special file. For detailed information, refer to Table 6 on page 35. 34 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 53
system calls return the requested number of bytes. This file can be used for application development or debugging problems. 6. The rmt*.smc file can be opened independently of the other tape special files. Special Files for Medium Changer Devices After the driver used for a SCSI medium changer - IBM TS2340 | User Guide - Page 54
could change when the system is rebooted. For applications that need a consistent naming convention for all attached devices, this is accomplished with persistent naming support by defining a unique logical name (other than the AIX default names) that are associated with the specific SCSI ID, LUN ID - IBM TS2340 | User Guide - Page 55
at the SCSI ID and LUN ID, it remains in the defined state and is not configured for use, but the next rmt-2 tape drive configures Support for Tape Libraries Note: The library control path failover feature code must be installed prior to enabling the path failover support in the Atape device driver - IBM TS2340 | User Guide - Page 56
support. Note: Display the primary and alternate path configuration for any device using tape diagnostic and utility functions, refer to Chapter 10, "IBM Tape Diagnostic Tool (ITDT)," on page 259 or "AIX System - Tape Utility Program (tapeutil)" on page 362. 38 IBM Tape Device Drivers Installation - IBM TS2340 | User Guide - Page 57
if you are running the latest drive code on Ultrium-3 and Ultrium-4 drives. 3. This function is not supported for devices that are attached through an IBM San Data Gateway or on the IBM Virtualization Engine TS7510. 4. The AIX operating system only supports a static configuration of devices, which - IBM TS2340 | User Guide - Page 58
30-68-01-PRI IBM 3590 Tape Drive and Medium Changer (FCP) The labeling of a logical device as either a primary or alternate path is for information only, in order to: 1. Be able to identify the actual number of physical devices configured on the system and a specific logical device associated with - IBM TS2340 | User Guide - Page 59
to unconfigure and reconfigure physical devices on the system when device connections or addressing changes are made. System-Managed Encryption Device Driver Configuration System-Managed Encryption can be set on a specific tape drive using the standard SMIT panels to Change/Show Characteristics - IBM TS2340 | User Guide - Page 60
0000 0000 0000 0000 0000 Field Support Information When encryption failures require field support and/or development analysis the following data should be provided for a problem on a specific tape drive from the machine (rmt1 for example) for the device driver. Tape drive dumps and EKM server logs - IBM TS2340 | User Guide - Page 61
to determine if the device driver and the tape device are functioning correctly. The standard AIX interface is provided for problem determination. Using the Dump Support Dump support is provided through the dump entry point in the driver. Refer to appropriate AIX manuals for a description of how to - IBM TS2340 | User Guide - Page 62
SCSI-2 ANSI specification, contains all pages the device supports. Page 0x00 is followed by all pages specified in page 0x00. The format of each following page is defined in the SCSI specification and the device manual. Tape Log Utility A tape log utility is installed with the tapelog device driver - IBM TS2340 | User Guide - Page 63
and has a SCSI-2 Reserve active v EIO - Unknown I/O failure occurred Error Logging The device driver provides logging to the AIX system error log for various errors. The error log can be viewed for specific devices using the Error Log Analysis utility provided with the tape drive service aids. Refer - IBM TS2340 | User Guide - Page 64
reference manual for the format of this entry. All other error log entries CDB) bb SCSI target address xx Unused or reserved cc Start of CDB, cc is the operation code (byte 0) SCSI BUS RESET - Adapter indicated SCSI bus has been reset. 46 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 65
sense data from the device. Refer to the appropriate device reference manual for the specific format and content of these bytes. Automatic Dump Facility The device driver provides an automatic dump facility for devices that support reading a dump and indicating when a dump is available in device - IBM TS2340 | User Guide - Page 66
driver can be called using the interactive interface of the tape utility program and selecting Tape Drive Service Aids under General Commands or using the Service Aid Subcommands in the command-line interface of the tape utility program. 48 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 67
"IBM Tape Diagnostic Tool (ITDT)," on page 259 or "AIX System - Tape Utility Program (tapeutil)" on page 362. Details of Tape Service Aids The following service aid utilities are installed with the device driver: v Force Microcode Dump v Read Dump v Microcode Load v Error Log Analysis v Reset Drive - IBM TS2340 | User Guide - Page 68
analyzes the system error log entries for a specific tape drive and can be used for problem determination. The type of error, the SCSI command, and the sense data (if applicable) are displayed for each entry in the error log (one screen at a time). To access this utility: 1. Open the Service Aids - IBM TS2340 | User Guide - Page 69
AIX Device Driver (Atape) Reset Drive This utility resets the tape drive. To access this utility: 1. Open the Service Aids window. 2. Select Reset Drive from the IBM Tape Drive Service Aids window, then press Enter. 3. Select the device from the IBM IBMTape Drive Selection window, then press Enter. - IBM TS2340 | User Guide - Page 70
8. Error Description Information Configuration Device parameters Error log. Call hardware support if errors are found for TAPE_ERR* or SCSI* error labels. Driver version Command lscfg -v lsattr -E -l rmtN errpt -a lslpp -l Atape.driver 52 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 71
AIX Device Driver (Atape) Table 8. Error Description (continued) Information Command Device microcode level (may not apply to all tapeutil -f /dev/rmtN reqsense devices) Trace of failing command Refer to "Trace Facility" on page 47 Chapter 3. AIX Tape and Medium Changer Device Driver 53 - IBM TS2340 | User Guide - Page 72
AIX Device Driver (Atape) 54 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 73
support for IBM tape drives and medium changer devices. For tape diagnostic and utility functions refer to Chapter 10, "IBM Tape Diagnostic Tool (ITDT)," on page 259 or "HP-UX System - Tape Utility Program (tapeutil)" on page 375. Purpose This device driver product provides SCSI-3 attachment - IBM TS2340 | User Guide - Page 74
ATDD Device Driver SCSI or Fibre Channel Adapter Device Driver Figure 9. Data Flow for HP-UX Device Driver (ATDD) IBM Tape Subsystem a250104 Product Requirements The following hardware and software components are required and supported by the IBM Tape and Medium Changer Device Driver for HP - IBM TS2340 | User Guide - Page 75
can be found at the following site: http://www-01.ibm.com/servers/storage/support/config/ess/index.jsp Software Requirements The following software is required and supported by ATDD: v HP-UX operating system version 10.20, 11.0, 11i v1, 11i v2, and 11i v3. v SCSI and FC Host Bus Adapter (HBA - IBM TS2340 | User Guide - Page 76
and SCSI specific operations. It allows HP-UX applications to access and control the features and attributes of IBM SCSI tape subsystems programmatically. For programming information, refer to the IBM Tape Device Drivers Programming Reference, GA32-0566. Installation and Configuration Instructions - IBM TS2340 | User Guide - Page 77
the Drive Configuration File, (Optional) If you are not using the standard device driver defaults, you must create a configuration file that directs the device driver on how to customize driver behavior for particular IBM TotalStorage and System Storage devices. If all Chapter 4. HP-UX Tape and - IBM TS2340 | User Guide - Page 78
do not use the device driver configuration defaults. If you do not need to create a Drive Configuration File, skip to the instructions in "Power Off the Tape Drives" on page 61. If you do need to create a Drive Configuration File, consult the following instructions. The configuration file is named - IBM TS2340 | User Guide - Page 79
tape devices attached, four ATDD_HWPATH entries are required in the configuration file. Create the Device Specific tape device, check the /etc/rc.log for errors and correct the problem. Power Off the Tape Drives When the ATDD software is initially installed, it attaches itself to all tape drives - IBM TS2340 | User Guide - Page 80
HP-UX swinstall command. If the target root file system is the primary, the ATDD software is configured automatically upon installation. If the target is an alternate root file system, then the ATDD software is not configured automatically. 62 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 81
file system with the swverify command as follows: # swverify atdd After the installation is completed, run the ioscan command to list the tape drives found: # ioscan -fknC tape Class I H/W Path Driver S/W State H/W Type Description tape 0 0/3/0/0.5.0 atdd CLAIMED DEVICE IBM 03590E11 - IBM TS2340 | User Guide - Page 82
By default, ATDD automatically configures all supported IBM tape drives that are attached and powered on when the ATDD package is installed. The ACDD driver does not configure IBM Medium Changer devices by default. To configure all IBM Medium Changer devices on the system during the install of ATDD - IBM TS2340 | User Guide - Page 83
. To attach a selected IBM tape device with a particular driver, run the system ioscan command to force a non-ATDD/ACDD driver to bind an IBM tape device, and then reboot the system. For example, to force bind the IBM 3592E05 tape drive with the HP native tape driver estape, perform these steps - IBM TS2340 | User Guide - Page 84
) for HP Precision Bus (HP-PB) systems. Preinstallation Considerations Make sure your system is ready to install ATDD before you begin. Follow these steps to perform the install: 1. Copy the software from the distribution medium to the depot. 66 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 85
Driver (ATDD) 2. Check the README file and verify that your system is configured appropriately for installing ATDD. 3. Ensure that the tape drives future mount point, but it often causes an error with NFS mounted file systems. This error can be overridden using '-x' to set the mount_all_filesystems - IBM TS2340 | User Guide - Page 86
stand alone tape drives (Models B00 and C00) and library models with one or two tape drives. Models B01, B02, B11, B12, C01, C02, C11, and C12 support a 20 cartridge, random access cartridge loader and are known as library units. To control the operation of the library mechanism, SCSI Medium Changer - IBM TS2340 | User Guide - Page 87
is a member by sending SCSI Medium Changer commands to LUN 1 of the drive port. The 3575 Model L06 supports one logical library. The other 3575 tape libraries (Models L12, L18, L24, and L32) can support two or three logical libraries depending on the specific model. The first drive in each logical - IBM TS2340 | User Guide - Page 88
1) HWPATH=adapterpath.drivetargetaddress.0 (drive n) The drive hardware paths for an IBM Ultrium 3583 Tape Library with a drive at SCSI ID 3 and SCSI ID 5 are: 1/8/0/0.3.0 1/8/0/0.5.0 Determine the Drive Hardware Paths for IBM 3580 Ultrium Tape Drive, IBM Ultrium Tape Libraries with Fibre Channel - IBM TS2340 | User Guide - Page 89
and two 3580 SCSI Tape Drives at target 0, LUN 2 and 3 (index=4 and 5). Create the Hardware Path Entry: You must tell the driver which hardware path drive (LUN 0), and one is needed for the ACF (LUN 1). At least one hardware path entry is required in the configuration file. Create the Device Specific - IBM TS2340 | User Guide - Page 90
configuration parameters. Note: If you experience difficulties with your tape device, check the /etc/rc.log for errors and correct the problem. Power Off the Tape Drives When the ATDD software is initially installed , it attaches itself to all tape drives that are in the CLAIMED state as shown by - IBM TS2340 | User Guide - Page 91
README file lists the system configuration requirements, including required system software patches and required tape related firmware versions. The file drives are powered on, the ATDD software can be installed to the root file system using the HP-UX swinstall command. If the target root file system - IBM TS2340 | User Guide - Page 92
Device Using the Currently Installed ATDD To add an IBM tape device using the currently installed ATDD, perform the following steps: 1. Modify the /stand/system file, adding a stanza in the form of: driver 56/48.3.0 atdd with the adapter/drive path for your device. 2. Modify /etc/rc.config.d/atdd - IBM TS2340 | User Guide - Page 93
is not recommended unless instructed to do so. The ATDD is shipped with default values that allow the most reliable execution across various device types. Device-Specific Parameters Some of the configuration parameters are device-specific, while others are driver-specific. Table 9 on page 76 - IBM TS2340 | User Guide - Page 94
drive) v 1=On (use compression at drive, Error Number return for Logical Value returned for writes past EOM, 28 by End Of Tape Supported in HP-UX 11i default) v3 only. v 1=On (split the blocksize less than 256 kb during the read or write) 76 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 95
=1 BLOCKSIZE=0 COMPRESSION=1 BUFFERING=1 REWIND_IMMEDIATE=0 TRAILER=1 SCALING=0 WRITEPROTECT=0 ERRNO_LEOT=28 WFM_IMMEDIATE=0 RESERVE=1 PRE_V3_COMPAT=0 To display a specific parameter, run #atdd_cfg -d special_file -o parameter For example, Chapter 4. HP-UX Tape and Medium Changer Device Driver 77 - IBM TS2340 | User Guide - Page 96
drive using Persistent Reserve In and Out commands, the user can set the value of atdd_reserve_type to 3. The default value for the tunable: 1 - Reserve(6) command; 2 - Reserve(10) command (Unsupported); 3 - Persistent Reserve In/Out commands 78 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 97
Manager) tool. Special Files For each drive configured by ATDD, twelve or thirteen special files are created: twelve special files are generated for a 3590 with ACF set to Manual, Automatic, System, Accumulate, Random, or Library mode. A thirteenth special file is created for independent - IBM TS2340 | User Guide - Page 98
Naming Support Persistent naming support is used to ensure that attached devices are always configured with the same logical name across system reboots. For this purpose, the HP-UX tape driver creates an additional set of device special files with a prefix of "s" for the configured tape drives in - IBM TS2340 | User Guide - Page 99
HP-UX Device Driver (ATDD) Control Path Failover Support for Tape Libraries Notes: 1. The library control path failover feature code must be installed prior to enabling the path failover support in the HP-UX ATDD device driver. Refer to "Automatic Failover" on page 12 for what feature code may be - IBM TS2340 | User Guide - Page 100
. The commands to enable and disable primary and alternate paths are tape diagnostic and utility functions. Note: See Chapter 10, "IBM Tape Diagnostic Tool (ITDT)," on page 259 or "HP-UX System - Tape Utility Program (tapeutil)" on page 375 82 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 101
Data Path Failover is supported for 3592 tape drives on HP-UX 11.0, 11i v1, v2 and v3, and for Ultrium-3 and Ultrium-4 drives on HP-UX 11i v1, v2 and v3. Configuring and Unconfiguring Path Failover Support Path failover support is turned on automatically when the device driver is installed. However - IBM TS2340 | User Guide - Page 102
for that medium changer. The other logical paths that ATDD attached for the same tape drive are configured as alternate paths. The device driver supports up to 16 physical paths for a single device. In HP-UX 11i v3, the HP-UX system always pickups a best path for ATDD to open so the primary path is - IBM TS2340 | User Guide - Page 103
Chapter 10, "IBM Tape Diagnostic Tool (ITDT)," on page 259 or "HP-UX System - Tape Utility Program (tapeutil)" on page 375 Problem Determination A set of tools is provided with the device driver to determine if the device driver and the tape device are functioning correctly. Error Logging Read the - IBM TS2340 | User Guide - Page 104
. The utility traces can be started at any time before an operation on a tape device. The default debug level is 0x00001003, which shows driver configuration and per instance drive attribute configuration and errors. You can increase the amount of debug information displayed by enabling more trace - IBM TS2340 | User Guide - Page 105
device config routines 0x00001000 Trace SCSI level stuff 0x00004000 Configuration driver provides a log daemon (atdd_d) facility for the Enterprise Tape System 359x to automatically store drive dumps, to retrieve and store SIM/MIM (Service and Media Information Messages) data, and to log error - IBM TS2340 | User Guide - Page 106
4. View the atdd_d.log, which provides information about the daemon start time, message type (1 for the drive dump, 2 for SIM/MIM data, and 3 for Error message), time stamp, H/W path, and size. Refer to an example in Figure 10 on page 89. 88 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 107
Problems and Solutions Table 14 describes problems and possible solutions for errors you may encounter with the DLKM driver. Table 14. Problems, Reasons, and Solutions Problem Reason and Solution The system try to install it again. Chapter 4. HP-UX Tape and Medium Changer Device Driver 89 - IBM TS2340 | User Guide - Page 108
to read data times out and returns an error and the system log has the following messages: A SCSI command timed out and was aborted. Note: page 91 describes problems and possible solutions for errors you may encounter with the static driver. 90 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 109
1: atdd_cfg -s SILI 1 An attempt to read data times out and returns an error. The system log has the following messages: A SCSI command timed out and was aborted. scsi3: ....date code... scsi3: ....timestamp... Check that the FORCE_NARROW parameter is valid for this device by executing - IBM TS2340 | User Guide - Page 110
HP-UX Device Driver (ATDD) 92 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 111
99 Configuring Tape and Medium Changer Devices on Intel-Compatible Systems 99 Configuring Tape and Medium Changer Devices on IBM System p Models 100 Configuring Tape and Medium Changer Devices on IBM System z Models 100 Uninstall Procedure 102 Tape Drive, Media, and Device Driver Parameters 102 - IBM TS2340 | User Guide - Page 112
information on supported hardware and software configurations for lin_tape is in the README files. The most current information is found in the README files on the IBM Device Drivers FTP site, which is located at: ftp://ftp.software.ibm.com/storage/devdrvr/Linux Information specific to certain - IBM TS2340 | User Guide - Page 113
device driver running Linux on System z in 31-bit or 64-bit: v IBM System z 800 (z800) or 900 (z900) models v IBM System z 890 (z890) or 990 (z990) models v IBM System z9® models One or more of the following host bus adapters with Fibre Channel Protocol support: v FICON® Express card (feature - IBM TS2340 | User Guide - Page 114
Software Requirements for IBM System z Models The lin_tape device driver supports the following Linux distribution for Linux on System z 31-bit and 64-bit: v Red Hat Enterprise Linux v SUSE LINUX Enterprise Server Installation and Configuration Instructions The lin_tape device driver for Linux is - IBM TS2340 | User Guide - Page 115
Description /lib/modules/(Your system's kernel name)/kernel/drivers/scsi/lin_tape.ko Device driver module for current kernel the OpenFCP adapter device driver zfcp is loaded in the kernel. Please refer to the section "Configuring Tape and Medium Changer Devices on IBM System z Models" on page 100 - IBM TS2340 | User Guide - Page 116
tape devices that use the lin_tape device driver must be closed and cannot be in use when lin_tape is uninstalled. Querying the Installed Package The query is supported for the lin_tape device driver installed, or replaced: >rpm -qs lin_tape 98 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 117
If your system is attached to an IBM 3583 Tape Library with the integrated router, before installing the Qlogic driver, set IBM Storage Area Network Data Gateway Installation and User's Guide. You can download the guide from the Web at: http://www.storage.ibm.com/hardsoft/products/sangateway/support - IBM TS2340 | User Guide - Page 118
as pSeries) system. For instructions on how to configure the Emulex device driver, refer to the lin_tape_359X_pSeries.ReadMe at ftp://ftp.software.ibm.com/storage/devdrvr/Linux. Configuring Tape and Medium Changer Devices on IBM System z Models The fibre channel topology supported for System z is - IBM TS2340 | User Guide - Page 119
. If you physically attach a tape device on the switch and zfcp is already loaded, you do not need to reboot the Linux system in order to add this entry in the /proc/scsi/scsi file. The zfcp device driver provides an ″add_map″ proc system entry under the directory /proc/scsi/zfcp to allow you to - IBM TS2340 | User Guide - Page 120
see all of the attached tape devices in /proc/scsi/scsi, you have successfully attached those devices to your system. Next you may install the lin_tape device driver. Refer to the ""Installation Procedure" on page 97″ section in this chapter for the instructions on how to install lin_tape. Uninstall - IBM TS2340 | User Guide - Page 121
or logical length of the current tape. By reducing the capacity of the tape, the tape drive can access data faster at the expense of data capacity. Capacity Scaling is not supported currently but might be supported in future releases of lin_tape. Density Code This parameter is the density setting - IBM TS2340 | User Guide - Page 122
. Only the SCSI mode is supported by lin_tape. When a forward or backward space record operation is issued to the driver and a filemark is encountered, the device driver returns -1 and the errno variable is set to input/output error (EIO). On the forward space operation, the tape is left-positioned - IBM TS2340 | User Guide - Page 123
chapter for details. This capacity is not applicable to IBM Ultrium tape drives. Logging (Volume Logging) This parameter turns the volume information logging On or Off. With the lin_tape version 1.2.2 and later, the lin_tape device driver provides this support. It is set to On by default. If logging - IBM TS2340 | User Guide - Page 124
tape diagnostic and utility functions. In lin_tape driver with level 3.0.5 or higher and the open source driver lin_tape, the maximum transfer length is defined as the minimum length that the host bus adapter and the tape drive can support . 106 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 125
such as IBMtape0. For tape drives with attached medium changer IBM TotalStorage Tape Devices Special File Name /dev/IBMTape* /dev/IBMTape*n Rewind on Close YES NO Special Files for the Medium Changer Device After the driver term IBMchanger is used for a SCSI medium changer device. The IBMchanger - IBM TS2340 | User Guide - Page 126
) Control Path Failover Support for Tape Libraries Note: The library control path failover feature code must be installed prior to enabling control path failover support in the Linux lin_tape device driver. Refer to "Automatic Failover" on page 12 to determine which feature code is required for your - IBM TS2340 | User Guide - Page 127
and utility functions, refer to Chapter 10, "IBM Tape Diagnostic Tool (ITDT)," on page 259 or "Linux System - Tape Utility Program (IBMtapeutil)" on page 385. Disable and Enable Primary and Alternate Paths Once you load the lin_tape device driver with the alternate_pathing parameter to be ON, by - IBM TS2340 | User Guide - Page 128
driver from the memory If you have IBM 3592 tape drives, add the following line in your /etc/modules.conf file for 2.4 kernels or /etc/modprobe.conf.local file for 2.6 kernels: options lin_tape alternate_pathing=1 If you have IBM LTO tape drives, the library needs to have path failover feature code - IBM TS2340 | User Guide - Page 129
driver supports scsi/IBMtape file, as explained in section "Primary and Alternate Paths." Note: Display the primary and alternate path configuration for any device using tape diagnostic and utility functions, refer to Chapter 10, "IBM Tape Diagnostic Tool (ITDT)," on page 259 or "Linux System - Tape - IBM TS2340 | User Guide - Page 130
IBMtape module. For example, in the /etc/modprobe.conf (for Red Hat) or /etc/modprobe.conf.local (for SUSE) file, add the following line for LTO library's path failover: 112 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 131
default values for the parameters. v The default value for default_sys_encryption_proxy is 1. This value causes the device driver to handle encryption key requests, if the drive is set up for system-managed encryption. This value should not need to be Chapter 5. Linux Tape and Medium Changer Device - IBM TS2340 | User Guide - Page 132
Drive Configuration There is an IBMtapeutil command to query the encryption settings of a tape drive. The IBMtapeutil command is menu option 57, "Query Encryption Status". Note: This is performed using tape diagnostic and utility functions. 114 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 133
following errors, then the remaining tests are not run. Perform the recommended problem determination to resolve the problem: v "Invalid argument or Operation not supported on device" System encryption is not configured for the tape drive in the device driver. Use SMIT to set system encryption to - IBM TS2340 | User Guide - Page 134
System-Managed Encryption Problem Determination A set of tools is provided with the device driver to determine if the device driver and the tape device are functioning correctly. Configure and Run lin_taped Daemon Starting with lin_tape version 1.2.5, the lin_tape device driver provides an error - IBM TS2340 | User Guide - Page 135
instructions in the lin_taped.conf file for details. Whenever the lin_taped daemon is running, error logging is enabled if tracing is enabled. Following is an example an error log record: IBMtape0---E0001 Tue Sep 10 14:04:57 2002 Scsi Path : 03 00 00 00 CDB Command : 01 00 00 00 00 00 Status Code - IBM TS2340 | User Guide - Page 136
are kept on your system: v lin_tapeMaxLogSenseFiles which can drive dump is obtained, it is written to a new file. The IBM service organization may request that you forward drive dumps to them for analysis. The drive drive dumps are produced. 118 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 137
drive dumps, and auto-retrieving SIM/MIM data. You may selectively enable/disable them through the IBMtapeutil Query/Set Tape Parameters operation or through an application program which uses the STIOC_SETP ioctl. These settings persist until the device driver is restarted, or the host system - IBM TS2340 | User Guide - Page 138
if a SCSI Persistent Reservation is active on the target tape drive and, if it is, will get the reserving host initiator WWPN (World Wide Port Name). If successful, the device driver will post the message lin_tape: reserve held by xxxxxxxx 120 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 139
TS7510 Installation and Planning Guide at: http://www-03.ibm.com/ systems/storage/index/tape.html Details of Tape Drive Service Aids The following service aid utilities are available through the utility program IBMtapeutil installed with the lin_tape device driver. v Force Microcode Dump v Read - IBM TS2340 | User Guide - Page 140
Linux Device Driver (lin_tape) 122 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 141
of the IBM SCSI Tape and Medium Changer Device Driver for Solaris, also known as IBMtape. Purpose This device driver product provides attachment for IBM Magnetic Tape and Library System products to Sun Microsystems SPARC Servers running the Solaris operating system. It is designed specifically to - IBM TS2340 | User Guide - Page 142
PCI-Express SAS HBA (SG-XPCIE8SAS-E-Z) v The IBM 2108-G07 (IBM SAN Data Gateway) and IBM 2108-R03 (IBM SAN Data Gateway Router) can be used to attach SCSI models of the IBM 357x, 3590, and VTS of products with any of the supported FC-AL host bus adapters. 124 IBM Tape Device Drivers Installation - IBM TS2340 | User Guide - Page 143
VTS models B10, B20 X X X IBM Enterprise Tape Drive 3590, Models B11, B1A, E11, and E1A IBM Magstar MP 3570 Tape Subsystem Model C IBM Magstar MP 3575 Tape Library Dataserver IBM TotalStorage Virtual Tape Server (Models B10, B18, and B20) Chapter 6. Solaris Tape and Medium Changer Device Driver - IBM TS2340 | User Guide - Page 144
operating system Version 10 on x64 servers. v SCSI Host Bus Adapter (HBA) driver as supplied by the HBA manufacturer. Refer to the manufacturer's documentation for the SCSI adapter driver to determine which adapter driver is required. Installation and Configuration Instructions IBM SCSI Tape Drive - IBM TS2340 | User Guide - Page 145
sys/st.h Tape drive API header file /usr/include/sys/svc.h Service aid API header file /usr/include/sys/oldtape.h Compatibility API header However, the Solaris operating system includes a SCSI tape device driver named st, which claims any SCSI-compliant tape drive that it detects, including - IBM TS2340 | User Guide - Page 146
installation. For example, suppose an installation has only an IBMtape-owned device installed at SCSI address 8. The device consists of both a tape drive and SCSI medium changer. The tape drive is accessed as /dev/rmt/2st, and the medium 128 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 147
and disk devices, follow the suppliers' instructions to disable its access to all SCSI tape devices. b. If the system has a mixture of IBMtape-owned devices and other tape drives, follow these steps to configure st and other non-IBM SCSI tape device drivers so that they control a range of target - IBM TS2340 | User Guide - Page 148
: add_drv -m '* 0666 bin bin' IBMtape ## If problems persist, contact your IBM service representative. pkgadd: ERROR: postinstall script did not complete successfully ... Later, after you have cabled IBM drives to the system and restarted, the driver attaches normally. If the distribution medium is - IBM TS2340 | User Guide - Page 149
, refer to the appropriate IBM hardware reference for any special instructions about addressing. Then set the address and record the device type, SCSI address, and LUN. For example, suppose an installation has only IBMtape-owned devices attached. An IBM device with tape drive and medium changer is - IBM TS2340 | User Guide - Page 150
devices that are owned by st or another supplier's driver, readdress the tape drives now. 1) For each device to be owned by st or another SCSI tape device driver, refer to the manufacturer's hardware reference for any special instructions about readdressing. Then readdress each device to an address - IBM TS2340 | User Guide - Page 151
Solaris Device Driver (IBMtape) For example, suppose an installation previously had two non-IBM devices owned by st at SCSI addresses 2 and-8. An IBM device with tape drive and medium changer is added. To prevent conflicts between IBMtape and st, the non-IBM devices are all placed at addresses in - IBM TS2340 | User Guide - Page 152
running /opt/IBMtape/tapelist -l. Configuring IBM tape devices with Sun FC and SAS HBAs To configure an IBM tape device with a Sun FC HBA, complete the following steps: 1. Attach the IBM tape devices on the host. 2. Install the appropriate patch for the Sun HBA driver. 3. Run # cfgadm -al to display - IBM TS2340 | User Guide - Page 153
-TD2 is the product ID of the IBM LTO2 drive. The following entry is added in the file for the IBM LTO2 drive: IBMtape "scsiclass,01.vIBM.pULT3580-TD2" The following is a list of the entries for the supported IBM tape devices. For the tape drives: IBMtape "scsiclass,01.vIBM.pULT3580-TD1" IBMtape - IBM TS2340 | User Guide - Page 154
, which have their own node name, virtual network interface, and storage assignment. The IBMtape driver supports the Solaris Zones environment. To install IBMtape on the system with the virtualized zones, run the pkgadd system command from the global zone: #pkgadd -G -d IBMtape.x.x.x.x The IBMtape - IBM TS2340 | User Guide - Page 155
Device Driver (IBMtape) -a Dynamically adds IBM tape devices to each non-global zone without additional arguments zonename inst#_1 inst#_2 inst#_3 ... Dynamically sets IBM tape devices not greater than 7 in a non-global zone zonename all Dynamically sets all IBM tape devices on the system in - IBM TS2340 | User Guide - Page 156
500507630019F016 500507630059F016 Do you wish to continue to add the devices? [y/n]: n # The ztapelist command also allows the user to remove all or some assigned tape devices from the non-global zone, as shown in the following example: 138 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 157
to support SCSI targets that are controlled by IBMtape. Refer to "Preventing Conflicts with Other Device Drivers" on page 127 for more information about multiple driver access to a device. Attention: Failure to prevent more than one device driver from operating the same tape drive may cause system - IBM TS2340 | User Guide - Page 158
IBM TotalStorage and System Storage Tape Device Drivers: Programming Reference for more information about changing configuration parameters under program control. IBMtape.conf contains one stanza for each SCSI every possible SCSI target and LUN combination supported by IBM tape systems. The - IBM TS2340 | User Guide - Page 159
=0 #buffering=1 #immediate=0 #trailer=0 #sili=0; class="scsi" The remaining five configuration parameters specifically affect the behavior of the IBM device or devices associated with that stanza (target and LUN). All of these parameters are specific to tape drive device operation only and have no - IBM TS2340 | User Guide - Page 160
IBM SCSI Tape and Medium Changer Device Driver for Solaris must be stopped in order for the removal procedure to complete successfully. Use the pkgrm command to remove the IBMtape package from the system. % /usr/sbin/pkgrm IBMtape Adding or Removing Devices To add support for a new IBM tape system - IBM TS2340 | User Guide - Page 161
long for LTO drive, 12-characters long for 359x drive and 16-characters long for changer. The serial number can be found running the following command: /opt/IBMtape/tapelist -l 2. Re-install IBMtape driver or reboot the system to allow IBMtape update the configuration. Chapter 6. Solaris Tape and - IBM TS2340 | User Guide - Page 162
the HBA list. The instance number of the particular HBA assigned by the Solaris system. The HBA driver name with IBM tape drive attachment. The number of IBM tape drives attached on the HBA. The number of IBM tape drives currently using the HBA. A string indicating the HBA device path in the device - IBM TS2340 | User Guide - Page 163
command for a single IBM tape subsystem. This listing is system dependent, so entries vary slightly in format, depending on the operating system and SCSI adapter support. There may also be entries included for other devices that are not supported by the IBMtape device driver. lrwxrwxrwx root other - IBM TS2340 | User Guide - Page 164
established to support I/O for an IBM SCSI tape system. The attachment path of the device special files spans from the system board, through the S-bus, to the Sun F/W SCSI adapter (supported by the QLGC, isp SCSI adapter device driver), to the IBM device at SCSI target 2 and LUN 0 (supported by the - IBM TS2340 | User Guide - Page 165
is created only for IBM tape systems that provide medium changer capability. For IBM tape libraries and autoloaders, the smc special file is the only file created because the IBMtape device driver supports only the medium changer portion and does not support the tape drive portion of these devices - IBM TS2340 | User Guide - Page 166
.tab system file for the persistent name binding and reloading the IBMtape driver as follows: 1. Before the persistent name binding, make sure that the IBM tape devices are configured at the different target and LUN addresses if the devices are attached on more than one HBA. The Ultrium-3 tape drive - IBM TS2340 | User Guide - Page 167
automatically by default when the IBMtape device driver is installed on Solaris system. The Solaris IBMtape device driver provides a driver configuration parameter failover for you to enable or disable the library control path failover support. To enable the CPF support for all of the paths, no any - IBM TS2340 | User Guide - Page 168
page 259 or "Solaris System - Tape Utility Program (tapeutil)" on page 397. Data Path Failover and Load Balancing Support for Tape Drives Note: The tape drive failover feature code must be installed prior to enabling the DPF for IBM Ultrium tape drive in the Solaris IBMtape device driver. Refer to - IBM TS2340 | User Guide - Page 169
space " ". The IBMtape driver supports up to 36 dpf keys. b. DPF keys do not need to be added in IBMtape.conf if you are running the latest drive code on Ultrium-3 and Ultrium-4 drives. 4. Stop the TMD (tape monitor daemon) running on the system and unload the IBMtape driver module from the current - IBM TS2340 | User Guide - Page 170
the primary and alternate path configuration for any device using tape diagnostic and utility functions, refer to Chapter 10, "IBM Tape Diagnostic Tool (ITDT)," on page 259 or "Solaris System - Tape Utility Program (tapeutil)" on page 397. 152 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 171
paths. Note: See Chapter 10, "IBM Tape Diagnostic Tool (ITDT)," on page 259 or "Solaris System - Tape Utility Program (tapeutil)" on page 397 System-Managed Encryption Device Driver Configuration System-Managed Encryption can be set on global or a specific tape drive in IBMtape.conf in /usr/kernel - IBM TS2340 | User Guide - Page 172
Solaris System-Managed Encryption To disable SME in a particular target: name=″IBMtape″ class=″scsi″ target=0 lun=0 block_size=0 buffering=1 immediate=0 trailer=0 sili=0 sys_encryption_proxy=0; Querying Tape Drive Configuration There is a tapeutil command available for encryption to query tape drive - IBM TS2340 | User Guide - Page 173
of the following errors, then the remaining tests are not run. Perform the recommended problem determination to resolve the problem: 1. "Invalid argument or Operation not supported on device" - System encryption is not configured for the tape drive in the device driver. Set sys_encryption_write to - IBM TS2340 | User Guide - Page 174
do not match your specific output. The fields indicate the ID, load address, size, major number, and revision for the IBMtape device driver and vary from machine to machine Installation Problems If you are experiencing problems with installation of the IBM SCSI Tape and Medium Changer Device - IBM TS2340 | User Guide - Page 175
running instance of the tape monitor daemon. -r Restart the tape monitor daemon and reload all configuration settings. -d Turn on drive error diagnostic retrieval and storage. This option is enabled by default. -D Turn off drive error diagnostic retrieval and storage. -p Specify an - IBM TS2340 | User Guide - Page 176
system error system restart. The following shows trace level 2 output, with system date and time stamps removed. Device instance 390 is opened on the first line. The device minor number 12450 is decoded and shows that the SCSI that a tape drive (drv IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 177
Driver (IBMtape) Finally, the sense data for device instance 230, a tape drive, occurred during a test unit ready and indicates that no tape is loaded in the drive 292 /etc/path_to_inst "/pci@6,4000/scsi@2,1/IBMtape@2,0" 292 "IBMtape" 2. IBM trace level in /etc/system or by running the adb system - IBM TS2340 | User Guide - Page 178
IBM service representative. iostat Command IBMtape driver supports the iostat system command, which reports I/O statistics for the supported tape drives in IBMtape.4.1.2.7 and later versions. Refer to man (1M) iostat for the command usage. 160 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 179
device has been opened it will log a reservation conflict in the Solaris system log of /var/adm/messages. Prior to logging the error the device driver will issue a Persistent Reserve In command to determine if a SCSI Persistent Reservation is active on the reserving host to get the reserving host - IBM TS2340 | User Guide - Page 180
Solaris Device Driver (IBMtape) 162 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 181
Failover Support Querying Primary and Alternate Path Configuration Checking Disablement of Data Path Failover Setting System-Managed Encryption Device Driver Configuration Configuration File Querying Tape Drive Configuration Settings . Problem Determination Windows NT Instructions Windows - IBM TS2340 | User Guide - Page 182
The most current information on supported hardware and software configurations for the Windows tape and medium changer device driver can be found in the README files on the IBM Device Drivers FTP site, which is located at ftp://ftp.software.ibm.com/storage/devdrvr/Windows. Hardware Requirements One - IBM TS2340 | User Guide - Page 183
storage configuration interoperability. It strongly recommends that your implementation plan includes provisions for separating disk and tape workloads. Software Requirements The software requirements are supported: v SCSi or FC adapter device driver v Microsoft Windows NT Version 4.0 with Service - IBM TS2340 | User Guide - Page 184
as Administrator. 2. Download the appropriate driver from the IBM Device Drivers FTP site, which is located at ftp://ftp.software.ibm.com/storage/devdrvr/Windows/ WinNT. v For TotalStorage or Magstar tape devices, select IBMMag.WinNT.exe v For Ultrium tape devices, select IBMUltrium.WinNT.exe 3. Go - IBM TS2340 | User Guide - Page 185
to install. The Documentation component copies the PDF version of the Installation and User's Guide and the Programming Reference to your hard drive. The Device Driver System Files component copies all the files needed for device driver support to the system directory. 5. After you have completed - IBM TS2340 | User Guide - Page 186
. If the TotalStorage/Magstar or Ultrium tape or changer device was already powered On and attached to the system during boot up, the devices should appear in the box, and Windows NT should start to generate the driver list. Refer to Figure 18. Figure 18. Creating Driver List If Microsoft Windows NT - IBM TS2340 | User Guide - Page 187
have more than one IBM TotalStorage/Magstar or Ultrium device attached on the same host system, the operating system prompts multiple times for the same driver. Cancel the multiple driver installation requests. Figure 20. Install Driver Menu - Select Cancel. Click Drivers, then click Add.... Refer - IBM TS2340 | User Guide - Page 188
Driver System Files component, click Have Disk, then enter the directory where your device driver setup file (IBMUltrium.inf or IBMMagstar.inf) is located in the box labeled Copy manufacturer's files from:. You can also Browse... to select the directory. Refer to Figure 22 on page 171. 170 IBM Tape - IBM TS2340 | User Guide - Page 189
to Figure 23 on page 172. Note: If you are using both a tape drive and a medium changer (as you would find in a tape library, for example), select one of the IBM Tape Libraries. This installs drivers for both the medium changer and the tape drives. Chapter 7. Windows Tape and Medium Changer Device - IBM TS2340 | User Guide - Page 190
system to start the drivers. Removal Procedure The Windows NT tape and medium changer device drivers manage all TotalStorage/Magstar or Ultrium devices and changers exclusively. If you use applications that have their own device drivers that access TotalStorage/Magstar, 172 IBM Tape Device Drivers - IBM TS2340 | User Guide - Page 191
and configuring those other applications. 1. Log on as Administrator. 2. Click Start, move to Settings, then click Control Panel. 3. Double-click Tape Devices. 4. Click the Drivers tab. 5. Highlight the IBM tape device, then click Remove. When you see the message Are you sure you want to remove this - IBM TS2340 | User Guide - Page 192
Windows Device Driver Figure 26. Control Panel Selection 7. Highlight the IBM tape device driver, then click Add/Remove.... Refer to Figure 27 on page 175. 174 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 193
Windows Device Driver Figure 27. Add/Remove Programs Properties 8. Select the Remove option, then follow the InstallShield Wizard to uninstall the drivers. Chapter 7. Windows Tape and Medium Changer Device Driver 175 - IBM TS2340 | User Guide - Page 194
components, such as the Installation and User's Guide and Device Driver Depot. 9. Click Next >. 10. Shut down and reboot the system. Manual Starting and Stopping Procedures The TotalStorage/Magstar or Ultrium device and medium changer drivers support being stopped and started without a reboot. If - IBM TS2340 | User Guide - Page 195
Server 2003, and Windows Server 2008 Instructions This section describes how to install, remove, and uninstall the Windows tape and medium changer device drivers on Windows 2000, Windows Server 2003, and Windows Server 2008. Note: The last driver level to include support for Windows 2000 is V6 - IBM TS2340 | User Guide - Page 196
the appropriate driver from a subdirectory of: ftp://ftp.software.ibm.com/storage/devdrvr/Windows Drivers for Windows 2000 are in the Win2000 subdirectory. Drivers for Windows Server 2003 are in the Win2003 subdirectory. Drivers for Windows 178 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 197
open handles from the host to a drive to exist at the same time, as is required by applications such as Microsoft Removable Storage Manager (RSM). The necessary .sys files for correct driver operation are installed, and all IBM devices are associated with the driver. Refer to Figure 30. Figure 30 - IBM TS2340 | User Guide - Page 198
you click the Always trust software box. 8. To verify that the tape and medium changer devices and drivers are installed correctly, follow the instructions in Appendix B, "Verifying Proper Attachment of Your Devices," on page 343. 180 IBM Tape Device Drivers Installation and User's Guide a250215 - IBM TS2340 | User Guide - Page 199
the .zip file. If you desire to remove these files, you need to delete them manually. 3. Reboot the system. Persistent Naming Support on Windows Server 2003 and Windows Server 2008 The Windows tape driver has an option for enabling device object names that persist across reboots of the operating - IBM TS2340 | User Guide - Page 200
or Windows Server 2008: [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ibmcg2kx] "FailoverDisabled"=dword:00000001 This indicates that CPF has been disabled in the driver. This setting only takes effect after your system is rebooted. 182 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 201
modifying the registry. 1. Open the reg folder of the driver package. 2. Double click DisableDPF.reg or EnableDPF.reg. 3. Reboot the system. This is necessary for any registry modification to take effect. For LTO generation 3 or lower, for tape drives that require a data path license key on the host - IBM TS2340 | User Guide - Page 202
″sys_encryption_write″ registry options under the device driver key, found at: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\ibmtp2k3 When this option is chosen, the settings established for all drives are overridden by the serial-number specific settings described the previous paragraph. If - IBM TS2340 | User Guide - Page 203
example of the output when the drive is configured for system-managed encryption, with encryption turned on: Encryption capable: True Encryption method: System Managed (2) Encryption state: On (1) Problem Determination There is a debug version of the device driver that can be used if you encounter - IBM TS2340 | User Guide - Page 204
DbgPrint messages. 10. Start the Windows device driver. Refer to "Manual Starting and Stopping Procedures" on page 176 for details on starting the driver. Registry variable HKEY_LOCAL_MACHINE/SYSTEM/CurrentControlSet/Services/ (Magstar or Ultrium)/MsgLevel determines how many messages are issued by - IBM TS2340 | User Guide - Page 205
of the file already there. 5. Reboot the system. 6. Start the debugger to capture the DbgPrint messages. 7. Issue the commands to the driver. You should see debug statements printed to the debugger window. Windows 2008 Instructions 1. Quiesce all activity on the tape and medium changer. 2. Exit all - IBM TS2340 | User Guide - Page 206
WWPN will not be logged to prevent multiple entries in the error log until either the reserving host WWPN is different than the one initially logged or the device driver has reserved the device and then another reservation conflict occurs. 188 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 207
following hardware is supported by the Tru64 Native Tape and Medium Changer driver: v One or more of the following IBM tape and medium changer device: - IBM Ultrium LTO1 tape drive - IBM System Storage TS3500, 3581 and 3583 Tape Libraries - IBM TotalStorage Enterprise Tape Drive 3590, Model E11 or - IBM TS2340 | User Guide - Page 208
and man pages. 9. Issue the /sbin/ddr_config -c /etc/ddr.base command to compile and link the new entry to the driver module. 10. The native driver creates device special files based on the information given in the ddr.dbase file. 190 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 209
tape Name = "IBM" "03590E1A" #Vendor ID and Product ID # PARAMETERS: TypeSubClass MaxTransferSize ReadyTimeSeconds CMD_PreventAllow CMD_ExtReserveRelease = rdat = 0x0ffffff #(16M-1) = 45 = supported = supported Output for Tru64 Device Driver and IBM 3590 Tape Drive Chapter 8. Tru64 Device - IBM TS2340 | User Guide - Page 210
192 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 211
254 Installation Instructions 255 Purpose The IBM 3494 Library device driver is a device driver providing attachment for the IBM TotalStorage 3494 Enterprise Automated Tape Library and IBM TotalStorage Virtual Tape Server (VTS) to a server. The programs described in this chapter support the 3494 - IBM TS2340 | User Guide - Page 212
the MTIOCLEW library system call) as specified in the IBM Tape Device Drivers: Programming Reference, GA32-0566. Refer to "MTEVENT Program" on page 205. The mtlib program provides an interface to the physical tape drives and volumes within a 3494 Tape Library and also to the virtual tape drives and - IBM TS2340 | User Guide - Page 213
Enterprise Tape Library Support The mtlib program has the following flags: Flag Description -f[filename] Device special file for the drive, for example, /dev/rmt0 (AIX), /dev/rmt/0st (Sun), /dev/rmt/0m (HP), /dev/IBMtape0 (Linux), \\.\tape0 (Windows) -x[number] Device number of the drive, for - IBM TS2340 | User Guide - Page 214
3494 Enterprise Tape Library Support X Remove the device category assignment Note: Valid combinations are OG, OA ] Number of categories to reserve -A Query library addresses and status. -? Help text Note: The -l argument is required. 196 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 215
3494 Enterprise Tape Library Support The report in Figure 35 was produced by: mtlib -l /dev/lmcp0 -f /dev/rmt5 -qD (for AIX physical library) mtlib -l /dev/lmcp0/vts1 -f /dev/rmt5 -qD (for AIX VTS library 1) mtlib -1 libmgrc7 -f /dev/rmt/5st -qD (for Sun) mtlib -1 libmgrc7 -f /dev/rmt/5m -qD (for HP - IBM TS2340 | User Guide - Page 216
40 was produced by: mtlib -l /dev/lmcp0 -D (for AIX physical library) mtlib -l /dev/lmcp0/vts1 -D (for AIX VTS library 1) mtlib -l libmgrc7 -D (for Sun, HP, Linux, SGI, Tru64, and Windows) Refer to also the tapeutil subcommand mtdevice. 198 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 217
3494 Enterprise Tape Library Support 0, 00515820 003490C2A00 1, 00515821 003490C2A01 Figure 40. Tape Library Device Number The report in Figure 41 was produced by: mtlib -l /dev/lmcp0 -DE (for AIX physical library) mtlib -l /dev/lmcp0/vts1 -DE (for AIX VTS library 1) mtlib -1 libmgrc7 -DE (for Sun, - IBM TS2340 | User Guide - Page 218
available. library facilities.........00 bulk input capacity........0 bulk input empty cells.....0 bulk output capacity.......0 bulk output empty cells....0 avail 3490 cleaner cycles..0 avail 3590 cleaner cycles..91 Figure 42. Library Data 200 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 219
(for AIX VTS library 1) mtlib -l libmgrc7 -qS (for Sun, HP, Linux, SGI, Tru64, and Windows) Statistical Data: hour index...........10 machine type.........003494 model number.........L10 manufacturer.........IBM plant 13 sequence number......000000010491 drives 6 mounted drives.......1 max mounted - IBM TS2340 | User Guide - Page 220
No volume class........3590 1/2 inch cartridge tape volume type.........HPCT 320m nominal length Note: All available records are produced as output per request. Fewer records are shown here for the sake of brevity. Figure 44. Inventory Query 202 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 221
3494 Enterprise Tape Library Support The report in Figure 45 was produced by: mtlib -l /dev/lmcp0 -qC -sFF00 -v (for AIX physical library) mtlib -l /dev/lmcp0/vts1 -qC -sFF00 -v (for AIX VTS library 1) mtlib -l libmgrc7 -qC -sFF00 -v (for Sun, HP, Linux, SGI, Tru64, and Windows) Performing Query - IBM TS2340 | User Guide - Page 222
-qA -h roadster (for Sun, HP, Linux, SGI, Tru64, and Windows) Category Attribute List: sequence number............10491 system token roadster category 0101 -- name: SCRATCH category 0102 -- name: WORKING Figure 48. Category Attribute List 204 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 223
not supplied, then no timeout is performed. Library Driver Information The lmcpd communicates to the tape library through symbolic names defined in the /etc/ibmatl.conf file. One or more symbolic names can be configured for each tape library online to the system. A symbolic name is used to perform - IBM TS2340 | User Guide - Page 224
request notification of all Library Manager events. Refer to the IBM Tape Device Drivers: Programming Reference for more information. Synchronous and Asynchronous Operations Two types of library operations are supported: synchronous and asynchronous. The Library Manager responds to the synchronous - IBM TS2340 | User Guide - Page 225
The device driver supports the IBM TotalStorage Virtual Tape Server (VTS) subsystem attachment with a 3494 Enterprise Tape Library on AIX, HP-UX, Windows, and Sun/Solaris systems. An attached VTS subsystem provides virtual tape drives that are accessible with the VTS SCSI attachment feature - IBM TS2340 | User Guide - Page 226
3494 Tape Library, where: 3494 lib is a library configured in the /etc/ibmat1.conf file. Issuing a Query Inventory command to 3494 lib/vts1 returns the logical volumes in the first VTS subsystem attached to the 3494 Enterprise Tape Library. 208 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 227
Device Driver Adapter Device Driver Library Tape Drive Application LIBIBM.O Object Module LMCPD LIBSMC SMC Device Driver Figure 50. 3494/SMC Library Data Flow TCP/IP Adapter Device Driver 3494 Library Manager SCSI Medium Changer a28t1001 Chapter 9. 3494 Enterprise Tape Library Support - IBM TS2340 | User Guide - Page 228
that can be assigned by an application and operations that can specify a category only rather than a specific volume. SCSI Medium Changers do not provide a similar function. All volumes in an SMC library are category 0000, the NULL category. 210 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 229
Library Operations The 3494 library performs libraries perform these operations synchronously and do not support operation on an SMC library is still synchronous and can continue while the library is demounting the volume. a SCSI 3584 library versus information from the library also vary in the - IBM TS2340 | User Guide - Page 230
the Daemon" on page 214. A typical environment for the AIX 3494 Enterprise Library Driver is an RS/6000 or System p (also known as pSeries) server on a local area network (LAN) with SCSI- or fibre-attached tape drives providing backup and restore functions. Data Flow The software described in this - IBM TS2340 | User Guide - Page 231
or Ethernet Adapter support in an RS/6000 or pSeries workstation attached to the Library Manager - LAN cabling (as required) v IBM System Storage TS1120 Tape Drive Model EO5 v IBM Virtualization Engine TS7510 Software Requirements The following software is required for the library driver: v AIX 5L - IBM TS2340 | User Guide - Page 232
all 3490E or 3590 tape drives in the 3494 Tape Library. Refer to "Configuring the Library Manager Control Point" on page 215 for instructions. Defining Tape Libraries to the Daemon After the software is installed and the desired tape libraries are connected to the system, the /etc/ibmatl.conf - IBM TS2340 | User Guide - Page 233
Point After the driver is installed, a tape library is connected to the workstation, and the serial port is configured, you can configure the instances of the LMCP. Perform the following procedure to define and configure the LMCP: 1. Enter the following command: smit The system management interface - IBM TS2340 | User Guide - Page 234
Tape Library Driver System Management Move cursor to desired item and press Enter. Software Installation and Maintenance Devices Physical & Logical Storage Security & Users Diskless Workstation Management & Installation Communications Applications and Services Spooler (Print Jobs) Problem - IBM TS2340 | User Guide - Page 235
Tape Library Driver Tape Drive Move cursor to desired item and press Enter. List All Defined Tape Drives List All Supported Tape Drives Add a Tape Drive Change / Show Characteristics of a Tape Drive Remove a Tape Drive Configure a Defined Tape Drive Generate Error Report Trace a Tape Drive - IBM TS2340 | User Guide - Page 236
of Library Manager control points to the system. Loading the Daemon The lmcpd is loaded during the system initialization. During the initial installation of the driver, you must load the daemon manually using the following command: 218 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 237
for problem determination. Error Logging The driver provides logging to the system error log for various errors. View the error log using the smit or the errpt command. The error templates follow the same form as the default AIX error log entries. Chapter 9. 3494 Enterprise Tape Library Support 219 - IBM TS2340 | User Guide - Page 238
> -d (trace all libraries defined in /etc/ibmatl.conf) (name of library) (delete all log files; requires root authority) Examples: trcatl -a >/tmp/trace-out trcatl -l libmgrc7 Note: The -a argument takes precedence over the -l argument. 220 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 239
necessary to drive the 3494 Tape Library. However, the product does not consist of a device driver in the true sense of the term. That is, it is not an extension of the operating system kernel, such as a SCSI tape device driver. A typical environment for the HP-UX Automated Tape Library Driver is - IBM TS2340 | User Guide - Page 240
driver: v 3494 Enterprise Tape Library with 3590 drives in HP-UX 11.0, 11i v1 and v2 and 3592 drives in 11.0, 11i v1, v2 and v3. v IBM Virtualization Engine TS7510 and TS7520 in HP-UX 11.0, 11i v1 and v2 v Enterprise Model B10, B18, and B20 Virtual Tape Server (direct attached only) v One of the - IBM TS2340 | User Guide - Page 241
supported by the library driver: IBM Tivoli Distributed Storage Manager for HP-UX Installation Instructions This chapter describes how to install, configure, and uninstall the HP-UX Automated Tape Library Support for the 3494 Enterprise Tape Library. The IBM Tape Library driver and error messages, - IBM TS2340 | User Guide - Page 242
swinstall -p lmcpd (preview option) # swinstall lmcpd Use swlist to list the software installed on the default root file system as follows: # swlist lmcpd Verify correct installation to the default root file system with the swverify command: 224 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 243
Tape Library Driver # swverify lmcpd Connecting the IBM TotalStorage 3494 Enterprise Automated Tape Library You Library Device to LMCPD After the software is installed and all desired tape libraries are connected to the system, the /etc/ibmatl.conf file must be edited to define the library - IBM TS2340 | User Guide - Page 244
14 Adding or Deleting Entries in the Library Device You can add or delete from the root file system enter: # swremove Problem Determination A set of tools is provided with the software to determine if the lmcpd is functioning correctly. 226 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 245
HP-UX 3494 Enterprise Tape Library Driver Error Logging The lmcpd uses the syslog facility to log the errors. Errors are logged according to the /etc/syslog.conf file. The lmcpd uses the daemon facility for logging errors. Only errors are logged with this facility. For more information about using - IBM TS2340 | User Guide - Page 246
necessary to drive the 3494 Tape Library. However, the product does not include a device driver in the true sense of the term. That is, it is not an extension of the operating system kernel, such as a tape device driver. A typical environment for the Linux Automated Tape Library Driver is a Linux - IBM TS2340 | User Guide - Page 247
are required and supported by IBM. Hardware Requirements The following hardware is required for the library driver: v IBM TotalStorage 3494 Enterprise Tape Library with IBM 3590 and 3592 drives with the Fibre Channel Attachment v IBM System Storage TS1120 Tape Drive v IBM Virtualization Engine - IBM TS2340 | User Guide - Page 248
Linux 3494 Enterprise Tape Library Driver To obtain the most current service and documentation for this software, refer to Appendix A, "Accessing Documentation and Software Online," on page 341. Installation and Configuration Instructions The IBM Tape Library driver for Linux, (ibmatl), is supplied - IBM TS2340 | User Guide - Page 249
Linux 3494 Enterprise Tape Library Driver TCP/IP, ensure that your machine has access to the Library Manager on the 3494 Tape Library. Use the ping utility to verify that you have network connectivity to the Library Manager. Consult your network administrator if you need help with this task. - IBM TS2340 | User Guide - Page 250
the files that make up the ibmatl fileset. It is best to use the rpm -e command or the uninstall script. Note: Halt all library activity before starting the uninstall procedure. For the rpm package, run the command rpm -e: rpm -evv ibmatl 232 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 251
3494 Enterprise Tape Library Driver If more than one level of ibmatl exists on the system, explicitly specify the level to remove it. rpm -evv ibmatl-5.0.7.0 Problem Determination A set of tools is provided with the software to determine if the ibmatl is functioning correctly. Error Logging The - IBM TS2340 | User Guide - Page 252
necessary to drive the Tape Library. However, the product does not consist of a device driver in the true sense of the term. That is, it is not an extension of the operating system kernel, such as a SCSI tape device driver. A typical environment for the IBM Sun Automated Tape Library Driver is - IBM TS2340 | User Guide - Page 253
The following hardware is supported by the library driver: v 3494 Enterprise Tape Library with SCSI-attached 3490E (Model C1A or C2A), 3590 and 3592 drives v IBM System Storage TS1120 Tape Drive v IBM Virtualization Engine TS7510 v IBM TotalStorage Virtual Tape Server (Models B10, B18, and B20 - IBM TS2340 | User Guide - Page 254
supported by the library driver: IBM Tivoli Distributed Storage Manager for Solaris Installation Instructions The IBM Tape Library driver for Solaris is installed using the standard Sun package facility. The IBM Tape Library Driver system. 236 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 255
administrator if you need help with this task. Identify the hostname of your workstation to the Enterprise Library Manager by following the instructions in the IBM TotalStorage Enterprise Automated Tape Library Operator Guide, in the Add LAN Host section. Configuring the Serial Port After the 3494 - IBM TS2340 | User Guide - Page 256
UNIX kill command (kill -kill ) to kill the lmcpd process, then enter the /etc/lmcpd command to start the daemon again. Ensure that the library activity on all of the libraries is completed before restarting the lmcpd. 238 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 257
Enterprise Tape Library Driver Uninstall Procedure Halt all library activity before starting the uninstall procedure. Kill the lmcpd daemon if it is currently executing. Enter the following command to uninstall the library support from your workstation: /usr/sbin/pkgrm lmcpd Problem Determination - IBM TS2340 | User Guide - Page 258
environment for the Windows Automated Tape Library Service is a workstation running Microsoft Windows operating system that acts as a data server on a network with SCSI tape devices providing backup or restore and data server functions. The IBM Automated Tape Library service is provided in the - IBM TS2340 | User Guide - Page 259
supported by IBM. Hardware Requirements The following hardware is required for the library driver: v 3494 Enterprise Tape Library with Enterprise Tape System 3590 and 3592 drives v IBM System Storage TS1120 Tape Drive v IBM Virtualization Engine TS7510 v IBM TotalStorage Virtual Tape Server (Models - IBM TS2340 | User Guide - Page 260
Tape Device Driver or the ADSM/TSM Device Driver for Microsoft Windows NT if using ADSM/TSM To obtain the most current service and documentation for this software, refer to Appendix A, "Accessing Documentation and Software Online," on page 341. Installation Instructions The IBM Tape Library service - IBM TS2340 | User Guide - Page 261
Enterprise Library Service the screen stops on a window entitled Welcome to the IBM Automated Tape Library Setup Program. Follow the instructions on Windows/system32 for an x86 system or /Windows/SysWOW64 for i64 or x64 systems. Connecting the 3494 Enterprise Tape Library Use a LAN connection (either - IBM TS2340 | User Guide - Page 262
by following the instructions in the IBM TotalStorage Enterprise Automated Tape Library Operator Guide, in the Add LAN Host section. Defining the Symbolic Name to the Service After the software is installed and all of the desired tape libraries are connected to the system, the c:\winnt\ibmatl - IBM TS2340 | User Guide - Page 263
services that use the IBM Automated Tape Library Service are stopped. 4. Ensure that the IBM Automated Tape Library Service is system is started, Microsoft Windows NT tries (unsuccessfully) to start the service again. To resolve this situation, you must reinstall the service Tape Library Support 245 - IBM TS2340 | User Guide - Page 264
Library Service 11. For Windows NT, click Cancel on the Add/Remove Programs Properties window. For Windows 2000 and 2003, close the Add/Remove Programs Properties window. For Windows 2008, close the Programs and Features window. Problem out 246 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 265
necessary to drive the 3494 Tape Library. However, the product does not include a device driver in the true sense of the term. That is, it is not an extension of the operating system kernel, such as a tape device driver. A typical environment for the Tru64 Automated Tape Library Driver is a Tru64 - IBM TS2340 | User Guide - Page 266
hardware and software components are required and supported by IBM. Hardware Requirements The following hardware is supported by and required for the library driver: v IBM TotalStorage 3494 Enterprise Tape Library with IBM 3590 Model E1A or H1A drives with Fibre Channel interface. v One of the - IBM TS2340 | User Guide - Page 267
TRU64 Enterprise Tape Library Driver Installation and Configuration Instructions The IBM Tape Library driver for Tru64, (ibmatl), is a 64- documentation appropriate to the LAN support you are using. The following files are installed on your system: /etc/lmcpd (library manager control point daemon) / - IBM TS2340 | User Guide - Page 268
libraries is completed before restarting the lmcpd. Updating Procedure To update the ibmatl kit, remove the old version existing in the system first and them update it. Issue the command to check which version of ibmatl is installed: setld -l 250 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 269
the files of a specific subset. The fverify , it is normal to encounter verification errors on the file checksum and size. manually. Problem Determination A set of tools is provided with the software to determine if the ibmatl is functioning correctly. Chapter 9. 3494 Enterprise Tape Library Support - IBM TS2340 | User Guide - Page 270
> -d (trace all libraries defined in /etc/ibmatl.conf) (name of library) (delete all log files; requires root authority) Examples: trcatl -a >/tmp/trace-out trcatl -l libmgrc7 Note: The -a argument takes precedence over the -l argument. 252 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 271
SCSI attached tape devices providing backup and restore functions for network attached clients. The daemon, specifically known to the SGI IRIX system as the IBM Library other library control operations. Refer to "SGI IRIX 3494 Enterprise Tape Library Driver in the IBM Tape Device Drivers: - IBM TS2340 | User Guide - Page 272
and hardware are required to use this product. Hardware Requirements The following hardware is required for the library driver: v 3494 Enterprise Tape Library with 3590 Model B1A, E1A, or H1A tape drives v One of the following options depending on which connection (RS-232 or LAN) is required for the - IBM TS2340 | User Guide - Page 273
driver for the 3590 Tape Drive is provided by SGI. Installation Instructions The 3494 Enterprise Tape Library Daemon for SGI IRIX can be installed by either using the swmgr program menus or the inst command. Installation Procedure The LAN or TTY support existing IBM Automated Tape Library software - IBM TS2340 | User Guide - Page 274
following the instructions in the IBM TotalStorage Enterprise Automated Tape Library Operator Guide, in the Add LAN Host section. Configuring the Serial Port After the 3494 Tape Library is connected to the workstation, you must configure the serial port to which it is connected. Use System Manager - IBM TS2340 | User Guide - Page 275
Tape Library Driver Defining the Library Device to the lmcpd After the 3494 Enterprise Tape Library Daemon for SGI IRIX is installed, configure the attached Tape Libraries and start the daemon. Define the library a name by which the library manager identifies the host system. This identifier has a - IBM TS2340 | User Guide - Page 276
trace all libraries defined in /etc/ibmatl.conf) -l (name of library) -d (delete all log files; requires root authority) Examples: trcatl -a >/tmp/trace-out trcatl -l libmgrc7 Note: The -a argument takes precedence over the -l argument. 258 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 277
All Supported Operating Systems . . . . . 273 Standard Edition - Start Menu Commands . . . 274 Standard Edition - Scan Menu Commands. . . . 274 Scan 276 Test 277 Dump 279 Firmware Update 280 Encryption 283 Full Write 285 Tape Usage 286 Other 287 System Test 287 Library Self-Test 289 Manual - IBM TS2340 | User Guide - Page 278
321 Firmware Update 322 Encryption 323 Full Write 324 Tape Usage 326 System Test 326 | Library Diagnostic Self-Test 327 | Manual Inspection Record for the following: - Microsoft Windows operating systems - Linux operating systems 260 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 279
Verify tape drive compression v Measure system performance v Retrieve and display cartridge usage information v Verify the encryption environment This test is used to verify if data on the cartridge was actually written encrypted. v Scan the system to discover all supported tape and library devices - IBM TS2340 | User Guide - Page 280
One option to access ITDT is through the ftp web site: ftp://ftp.software.ibm.com/ storage/ITDT/Current/. You can also navigate to the ITDT Web page: 1. Go to the Tape Support page: http://www.ibm.com/systems/support/storage/ tape. 2. Under Product: select your product. 3. On the right side, click - IBM TS2340 | User Guide - Page 281
4) v IBM Ultrium Tape Drives T800/F, T800V, T1600/F v IBM System Storage 3588/TS1030 model F3A and F3B Tape Drive v IBM System Storage 3588/TS1040 model F4A Tape Drive v IBM System Storage 3580 Half Height/TS2230 and TS2240 Tape Drive Express v IBM System Storage TS2340 Tape Drive Express v IBM 3592 - IBM TS2340 | User Guide - Page 282
has no effect on the [U] Tapeutil option commands; they will still use the IBM Tape Device Driver if it is installed. In a System Managed Encryption setup, the [E] Encryption test will always exit with NO DRIVER SPECIAL FILE when ITDT-SE is started with -force-generic-dd. Installing ITDT-SE on - IBM TS2340 | User Guide - Page 283
click the Next button. Figure 68. License screen 4. Enter your i5/OS system hostname or IP address and administrator credentials. Start the installation by pressing the Install button. Click the Done button when the installation is complete. Chapter 10. IBM Tape Diagnostic Tool (ITDT) 265 a2500247 - IBM TS2340 | User Guide - Page 284
a2500248 IBM Tape Diagnostic Tool Note: The user name should be QSECOFR. Figure 69. Machine credentials screen Figure 70. Installation progress screen 266 IBM Tape Device Drivers Installation and User's Guide a2500249 - IBM TS2340 | User Guide - Page 285
: itdtinst Standard Edition - Initial Startup This section describes the startup procedures for the Standard Edition of ITDT in various operating systems. Starting ITDT-SE on Solaris Operating Systems 1. If the IBM Tape Device Driver is not used or not installed, then configure the sgen - IBM TS2340 | User Guide - Page 286
(HBAs), special handling is required. Attached devices need to be configured with their WWPN in the sgen.conf file. This task needs to be done manually, it is not performed by using the sgen_solaris_conf.sh script. 268 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 287
files, dump files and log files after running tests Starting ITDT-SE on i5/OS Operating Systems To use ITDT-SE to update firmware or pull dumps from a Tape Drive inside a Tape Library, make sure the drives are varied online in STANDALONE MODE by performing the following steps: 1. Issue the command - IBM TS2340 | User Guide - Page 288
Edition - Known Issues and Limitations This section describes the known issues and limitations of the ITDT-SE program. AIX Operating Systems The following are the known scan limitations: v Only devices that have the device state ″available″. 270 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 289
to make the library reappear in the device list. Linux Operating Systems ITDT-SE on Linux requires glibc 2.2.5 or later. Note: On a SLES9 s390x (64bit) configuration, you may experience a SCSI CMD TIMEOUT when running the [T] option while using the IBM Tape Device Driver. For SUSE SLES9 - IBM TS2340 | User Guide - Page 290
support autoloaders and libraries. Media changers and media changer operations are not supported with this release of ITDT-SE. To test a tape drive inside a library, the cartridge must be imported manually before starting the Device Test. 272 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 291
as all the underlying operations require the IBM Tape Device Driver to be installed. FC 5912 SAS HBA support is only for Power6 and V6R1 configurations attached to LTO Gen 4 HH tape drives (No support for LTO 3 HH SAS). All Supported Operating Systems This section describes the known issues and - IBM TS2340 | User Guide - Page 292
IBM Tape Diagnostic Tool Standard Edition - Start Menu Commands After program startup, ITDT-SE displays the start screen menu. Figure 72. Start Screen Menu The following commands are available on the start screen menu: v S - Scan for tape drives IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 293
on page 279 v F - "Firmware Update" on page 280 v E - "Encryption" on page 283 v W - "Full Write" on page 285 v U - "Tape Usage" on page 286 v O - "Other" on page 287 Figure 74. More Scan Options v Y - "System Test" on page 287 v L - "Library Self-Test" on page 289 v I - "Manual Inspect" on page 289 - IBM TS2340 | User Guide - Page 294
IBM Tape Diagnostic Tool Scan The Scan function [S] is used to discover all supported tape and library devices that are attached to the computer system so SCSI/FCP ID and LUN) along with product data (Model name, Unit Serial number, Microcode revision). For drives that are attached to a library, - IBM TS2340 | User Guide - Page 295
drives will be detected. v Solaris, when no IBM tape device driver is in use: - Ensure that sgen is correctly configured: file /kernel/drv/sgen.conf is correctly configured (see "Starting ITDT-SE on Solaris Operating Systems device. To test tape drives within a library, the library must be in - IBM TS2340 | User Guide - Page 296
IBM Tape Diagnostic Tool If no cartridge is inserted, ITDT-SE prompts to insert a cartridge. Either insert Medium 2. [Medium Qualification] - only if the previous step indicated this requirement 3. Load/Unload Cycles ( 2 ) 4. POST A 278 IBM Tape Device Drivers Installation and User's Guide a2500235 - IBM TS2340 | User Guide - Page 297
test result and failure information in the code field. The screen also shows the output files that were generated during the test run. The files may be requested by the IBM Support Center. If you want to use is performed (it takes less than 1 minute). Chapter 10. IBM Tape Diagnostic Tool (ITDT) 279 - IBM TS2340 | User Guide - Page 298
of tape drives and tape libraries. See "Supported Equipment" on page 263 for a list of supported products. Note: See "3576/TS3310 Tape Library" on page 273 for more information on how to update the firmware on a 3576/TS3310 Tape Library. 280 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 299
a2500251 IBM Tape Diagnostic Tool Figure 80. Firmware Update screen The following site is available for the latest firmware files: http://www.ibm.com/systems/support/storage/tape Download the files to the ITDT-SE input subdirectory that was created during the installation. The following are - IBM TS2340 | User Guide - Page 300
firmware to update the drive. 8. After completion, the Status field on the bottom right side indicates PASSED if the firmware was updated successfully and FAILED otherwise. Type R and press the Enter key to return to the Device List. 282 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 301
data cartridge must be used. The Encryption function is supported for the following encryption environments: v System Managed: IBM tape device driver must be installed and in use by ITDT to read decrypted data v Library Managed v Application Managed: Only raw encrypted data will be read (result file - IBM TS2340 | User Guide - Page 302
ABORT CODE ROOT CAUSE LOCATE FAILED Start position as requested by the user could not be reached | MEDIUM NOT ENCRYPTED ITDT detected medium as non-encrypted NO DRIVER SPECIAL FILE System-Managed environment, but generic device file is used instead of IBM device driver special file DRIVE - IBM TS2340 | User Guide - Page 303
IBM Tape Diagnostic Tool Table 30. Definitions of Abort Codes (continued) ABORT CODE ROOT CAUSE END OF DATA End of data encountered before the given amount of data could be read READ FAILED ENCRYPTION ERROR INVALID PARAMETER User entered data length of 0kB If you want to use other ITDT-SE - IBM TS2340 | User Guide - Page 304
to option 4 the device list; otherwise, type Q followed by the Enter key to exit the program. 2 1 Figure 83. Full Write Results Tape Usage The Tape Usage [U] function retrieves statistical data and error counters from a cartridge. 286 IBM Tape Device Drivers Installation and User's Guide a2500243 - IBM TS2340 | User Guide - Page 305
different block sizes to find the ideal block size for the system configuration. The System Test only runs on tape drives, not on autoloaders or libraries. To perform a System Test on tape drives within a library, the library must be in online mode. Chapter 10. IBM Tape Diagnostic Tool (ITDT) 287 - IBM TS2340 | User Guide - Page 306
. Note: It may take some time until the System Test actually stops. If you want to use other ITDT-SE functions, type R followed by the Enter key to return to the device list; otherwise press Q followed by the Enter key to exit the program. 288 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 307
have a technical problem which can not be determined by ITDT-SE. If a tape drive cannot be identified using a device scan, the user can manually create a test record for the drive. The system prompts for the user to run the SCSI/FC Wrap test for the drive (see the service manual for the drive). The - IBM TS2340 | User Guide - Page 308
Supp (Support)" on page 294 v "[38] Test Encryp. Path (Test Encryption Key Path/Setup)" on page 295 v "[50] Element Information" on page 295 v "[51] Position to Element" on page 295 v "[52] Element Inventory" on page 295 v "[53] Exchange Medium" on page 296 290 IBM Tape Device Drivers Installation - IBM TS2340 | User Guide - Page 309
page 296 v "[70] Dump/Force Dump/Dump" on page 297 v "[71] Firmware Update" on page 297 [1] Open a Device When you select the Open a Device select the Inquiry command [3]: 1. You are prompted for page code. 2. ITDT then displays a decoded format of a hexadecimal IBM Tape Diagnostic Tool (ITDT) 291 - IBM TS2340 | User Guide - Page 310
IBM Tape Diagnostic Tool [8] Log Sense When you select the Log Sense command [8]: 1. You are prompted for Log Sense Page. 2. ITDT 1. You are prompted for the number of records to space backward. 2. ITDT issues (extrinsic) ioctl command. 292 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 311
command [28], ITDT issues the (extrinsic) ioctl command. [29] Load Tape When you select the Load Tape command [29], ITDT issues the load tape command. [30] Unload Tape When you select the Unload Tape command [30], ITDT issues the unload tape command. Chapter 10. IBM Tape Diagnostic Tool (ITDT) 293 - IBM TS2340 | User Guide - Page 312
is more than 1 character long. Eight is the limit of the characters on a display screen. [37] Report Density Supp (Support) When you select the Report Density Support command [37]: 1. ITDT prints report status text for all supported media. 294 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 313
Setup command [38]: Note: Not supported for the HP-UX operating system. 1. ITDT prints status message that server configuration and connections are tested 2. ITDT issues the Encryption Diagnostics ioctl command, Ping Diag 3. ITDT prints number of servers available or error message 4. ITDT issues the - IBM TS2340 | User Guide - Page 314
available drives and error message and exit. 4. ITDT issues the READ_CARTRIDGE_LOCATION ioctl command. 5. ITDT issues the Element Info ioctl command. 6. ITDT verifies that the address range is valid; otherwise print error message and exit. 296 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 315
the firmware on a 3576/TS3310 Tape Library. The following site is available for the latest firmware files: http://www.ibm.com/storage/lto. | Standard Edition - Tapeutil Scripting Commands | Scripting has been enabled with the 4.0 release of ITDT SE. ITDT-SE provides | backward compatibility for - IBM TS2340 | User Guide - Page 316
abbreviations will be supported with | Tape commands are: | v "append" on page 302 | v "bsf" on page 302 | v "bsr" on page 303 | v "density" on page 303 | v "display" on page 303 | v "erase" on page 303 | v "fsf" on page 303) 298 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 317
v "ekmtest" on page 309 | v "encryption" on page 310 | v "ucode" on page 310 | allow | (Deprecated: unlock, -o rem) Allow medium removal for tape or changer devices | (unlock door). The counter command for this is prevent. | Parameters: | None | Supported platforms: All | devinfo - IBM TS2340 | User Guide - Page 318
counter command for this is allow. | Parameters: | None | Supported platforms: All | print | This subcommand prints the associated text to standard output. It can be used at | any time to display the progress of the subcommands. 300 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 319
the IBM | device driver. | Parameters: | None | Supported platforms: Supported platforms: All | reserve | (Deprecated: -o res) This subcommand explicitly reserves a device by issuing the | SCSI Reserve command. | Parameters: | None | Supported platforms: All Chapter 10. IBM Tape - IBM TS2340 | User Guide - Page 320
, but on Windows this open mode is not supported by the | IBM Tape Device Driver. On HP-UX this open mode is re-mapped to r/w by the | IBM Tape Device Driver. | bsf | (Deprecated: -o bsf) This subcommand backward spaces Count filemarks. The tape | is positioned on the beginning of the last - IBM TS2340 | User Guide - Page 321
: All | density | (Deprecated: -o gdn / -o rds) This subcommand issues the SCSI Report Density | Support command for all supported media and for the current media loaded in the | drive, and displays the results. If the drive is not loaded, the current media density | is not reported - IBM TS2340 | User Guide - Page 322
-o parms / status / -o gpa) Get and show drive, media and driver | parameters. | Parameters: | None | Supported platforms: All | load | (Deprecated: -o lod) This subcommand issues a SCSI Load command to load a | tape. subcommand loops all subsequent subcommands continuously or a number - IBM TS2340 | User Guide - Page 323
blocks, and a repetition of 1. | Parameters: | rwtest [-b Blocksize] [-c Count] [-r Repetition] | Supported platforms: All | seod | (Deprecated: -o eod) Spaces to end of data on the tape. | Parameters: | None | Supported platforms: All Chapter 10. IBM Tape Diagnostic Tool (ITDT) 305 - IBM TS2340 | User Guide - Page 324
(=percentage) | v 1 (SCSI) and 2 (AIX) for tape position is set to the Blockid. Otherwise, if the Blockid parameter is | omitted, the tape position is set to the last position saved using the qrypos | subcommand. | Parameters: 306 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 325
IBM Tape Diagnostic Tool | setpos [Blockid] | Supported platforms: All | sync | (Deprecated: -o syn) This subcommand will synchronize buffers/flush the tape | buffers to tape. | Parameters: | None | Supported platforms: All | unload | (Deprecated: -o off / offline / rewoffl) This - IBM TS2340 | User Guide - Page 326
the optional parameters Slot and Count issues the SCSI Read Element Status | to the device for a specific starting Slot address and optionally the Count specifies Parameters: | exchange Source Dest1 Dest2 | Supported platforms: All 308 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 327
-SE naming | convention (serialnumber.a.gz and serialnumber.b.gz). | Parameters: | None | Supported platforms: All | ekmtest | Test encryption key path/setup. | Parameters: | None | Supported platforms: AIX, Linux, Solaris, Windows Chapter 10. IBM Tape Diagnostic Tool (ITDT) 309 - IBM TS2340 | User Guide - Page 328
IBM Tape Diagnostic Tool | encryption | Query tape drive encryption settings and display the encryption state. | Parameters: | None | Supported | v qrysense | v retension / -o ret | v sdp | v setblk | v status / -o gds 310 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 329
IBM Tape Diagnostic Tool | The Medium Changer subcommands are: | v devids / -o dvc | v mount | v unmount / demount | The Service Aid -t1|2 (logical, physical) is not supported. | 17. density - output all information on all platforms Chapter 10. IBM Tape Diagnostic Tool (ITDT) 311 - IBM TS2340 | User Guide - Page 330
Red Hat Enterprise Linux 4 and 5 (RHEL4, RHEL5) is not supported. Install one of the following supported JREs before launching the ITDT Installer: v Java 1.4.2 SR3 by IBM Corporation and higher v Java 1.4.2_10 by Sun Microsystems and higher 312 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 331
IBM Tape Diagnostic Tool On RHEL4, RHEL5 and other Linux systems where none of the supported JREs is available in the 4 and 5 and SuSE Enterprise Linux 10 invoking the online help may cause an error message ″Problems opening link / Unable to open web browser on {0}″ to appear. Workarounds are to - IBM TS2340 | User Guide - Page 332
-GE is not supported with the 3576/TS3310 | tape library. Update the Firmware using the 3576/TS3310 Web User Interface. | 3494 Tape Library | Drives in a 3494 tape library or an STK silo library are supported, only the Test | option won't work due to device-specific restrictions for handling - IBM TS2340 | User Guide - Page 333
IBM Tape Diagnostic Tool The User Settings dialog appears the first time the program is run, allowing the entry of user specifications: user Log Level should not be changed unless requested to do so by the IBM Support Center. It is strongly recommended that this information be provided to allow for - IBM TS2340 | User Guide - Page 334
a2500239 IBM Tape Diagnostic Tool The ITDT-GE interface contains the following: | 1 2 3 4 | | Figure 88. Graphical Edition Interface | v Main Menu -GE operations. The following toolbar buttons for the device operations are available: 316 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 335
: v "Scan" on page 318 v "Test" on page 319 v "Dump" on page 321 v "Firmware Update" on page 322 v "Encryption" on page 323 v "Full Write" on page 324 v "Tape Usage" on page 326 v "System Test" on page 326 v "Library Diagnostic Self-Test" on page 327 Chapter 10. IBM Tape Diagnostic Tool (ITDT) 317 - IBM TS2340 | User Guide - Page 336
a2500240 IBM Tape Diagnostic Tool Scan Figure 91. Scan Function The scan function is used to discover all supported tape and library devices that are attached to the computer system so that they can for test. Only one device can be selected. 318 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 337
that a new or rarely used cartridge is used. Scaled (capacity-reduced) cartridges should not be used to test the device. To test tape drives within a library, the library must be in online mode. After selecting the device you want to test, start the Test function selecting the Test menu item. The - IBM TS2340 | User Guide - Page 338
a2500242 IBM Tape Diagnostic Tool 1 Figure 93. Test Results Note: Information can be found in the .txt/.blz files. See the log POST A During POST A stopping the test is not allowed. 5. Performance Test 6. Unmount Medium 7. Get FSC 8. Get Logs 320 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 339
Dump IBM Tape Diagnostic Tool a2500224 Figure 94. Dump Menu After selecting the device you want to dump, start the Dump function by selecting Dump -> Dump from the actions toolbar. When the dump process is performed on a tape library or autoloader other than the 3584/TS3500, the Dump function - IBM TS2340 | User Guide - Page 340
263 for a list of supported products. Note: See "3576/TS3310 Tape Library" on page 273 for more information on how to update the firmware on a 3576/TS3310 Tape Library. The following site is available for the latest firmware files: http://www.ibm.com/storage/lto To do a Firmware Update perform the - IBM TS2340 | User Guide - Page 341
a2500226 IBM Tape Diagnostic Tool Note: If ITDT-GE detects a FIPS-certified drive firmware, it displays a warning dialog. Before continuing, ensure that you use a FIPS-certified firmware to update the drive. Encryption Figure 96. Encryption Function Note: Note that the test shown on the graphic - IBM TS2340 | User Guide - Page 342
system does not appear to be able to compress data on the cartridge, check your device driver and software settings to see if they disable compression. To perform a full write on tape drives within a library, the library 97 on page 325): 324 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 343
and the maximum block size supported by the system (maximum possible value is 512 | KB). Select the appropriate value for your system. a2500228 Figure 98. Transfer area. If an error occurred during the full write, data is only written partially. Chapter 10. IBM Tape Diagnostic Tool (ITDT) 325 - IBM TS2340 | User Guide - Page 344
size for the system configuration. The System Test only runs on tape drives, not on autoloaders or libraries. To perform a System Test on tape drives within a library, the library must be in cartridge, it displays the following message: 326 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 345
not on tape drives. | After selecting the device you want to test, start the Library Self-Test function by | selecting Test -> Library Diagnostic Self-Test from the actions toolbar. | At the end of the test, the results are displayed in the Status Information area. | Manual Inspection Record - IBM TS2340 | User Guide - Page 346
IBM Tape Diagnostic Tool | If a tape drive cannot be identified using a device scan, the user can manually | create a test record for the drive. The system prompts for the user to run the | SCSI/FC Wrap test for the drive (see the service manual for the drive). The results | of the wrap test - IBM TS2340 | User Guide - Page 347
box appears that allows the selection of a command: | a2500259 | | Figure 102. Tape Drive Commands | After the command is selected, an area appears where command parameters can be entered: | a2500260 | | Figure 103. Command Parameters | Chapter 10. IBM Tape Diagnostic Tool (ITDT) 329 - IBM TS2340 | User Guide - Page 348
IBM Tape Diagnostic Tool When the user presses the "Execute" button, the "Results" Log Sense" on page 332 v "Mode Sense" on page 332 v "Query Driver Version" on page 332 v "Display All Paths" on page 332 The tape drive specific commands are: v "Rewind" on page 333 v "Forward Space Filemarks" on page - IBM TS2340 | User Guide - Page 349
on page 332 v "Report Density Support" on page 337 v "Test Encryption Path" on page 338 The tape library specific commands are: v "Element Information" on on page 339 The service aid commands which are found under both menus are: v "Dump/Force Dump/Dump" on page 339 v "Firmware Update" on page 340 - IBM TS2340 | User Guide - Page 350
, in the Page-Code field. | 2. ITDT driver version. 2. ITDT prints driver version. Display All Paths When you select the Display All Paths command: 1. ITDT issues an ioctl command. 2. ITDT outputs decoded path information for all paths. 332 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 351
IBM Tape Diagnostic Tool Rewind When you select the Rewind command, ITDT issues the ioctl rewind command for the device. Forward Space . 8. If number of bytes written is different from requested bytes to write, stop (go to Step 19 on page 334). Chapter 10. IBM Tape Diagnostic Tool (ITDT) 333 - IBM TS2340 | User Guide - Page 352
written. 12. Prints amount of data to read. 13. Issues read command. 14. If read error occurred or number of bytes read is different from requested number of bytes to read, go to Step Only steps: 1. Issues a Read Position. 2. Sets block size. 334 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 353
a file to tape. 2. You are prompted for the source file name. 3. Prints the file name to be opened. 4. Opens the file (r/o with large file support). 5. Issues file. 9. Writes to tape, stop if data count written is not equal to data count requested. Chapter 10. IBM Tape Diagnostic Tool (ITDT) 335 - IBM TS2340 | User Guide - Page 354
1. ITDT displays changeable parameters. Note: The list of changeable parameters are operating system specific. 2. Select from the list of parameters that can be changed by clicking on You are prompted for block id in decimal or hexadecimal. 336 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 355
IBM Tape Diagnostic Tool 9. ITDT prints summary. 10. ITDT issues the Set Position ioctl command. 11. Repeat steps 2 through 5. Query Encryption Status When you select the Query Encryption Status command: 1. ITDT issues Get Encryption State ioctl command. 2. ITDT displays encryption settings (Drive - IBM TS2340 | User Guide - Page 356
IBM Tape Diagnostic Tool Test Encryption Path When you select the Test Encryption Path command: Note: Not supported for the HP-UX operating system. 1. ITDT prints status message that server configuration and connections are tested. 2. ITDT issues the Encryption Diagnostics ioctl command, Ping Diag. - IBM TS2340 | User Guide - Page 357
If no drive is present, ITDT prints NO DRIVE PRESENT - and exits. 3. ITDT prints information for all drives. Read Cartridge ; print error message and exit. 8. ITDT issues the READ_CARTRIDGE_LOCATION ioctl command. 9. ITDT prints decoded storage element information IBM Tape Diagnostic Tool (ITDT) 339 - IBM TS2340 | User Guide - Page 358
. | Note: See "3576/TS3310 Tape Library" on page 314 for more information on how | to update the firmware on a 3576/TS3310 Tape Library. The following site is available for the latest firmware files: http://www.ibm.com/ storage/lto. 340 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 359
current version of the IBM Tape Device Drivers: Installation and User's Guide. The IBM_Tape_Driver_PROGREF.pdf file contains the current version of the IBM Tape Device Drivers: Programming Reference. Device and Library Drivers for each supported platform can be found beneath /storage/devdrvr/ in the - IBM TS2340 | User Guide - Page 360
EM64T Notes: 1. dist indicates a Linux distribution. arch indicates a machine architecture (for example, i386, ia64, s390). 2. The n.n.n. or n.n.n.n strings are replaced with digits on the FTP site to reflect the version of each driver. 342 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 361
. 6. If there are device drivers being used by your device other than the ones documented in this manual, disable the other device drivers, and install or enable the drivers documented in this manual. 7. Follow the subsequent instructions for your host system. © Copyright IBM Corp. 2007, 2009 343 - IBM TS2340 | User Guide - Page 362
(Device Info). 7. Enter 5 (Inquiry). Specify 0 when prompted for an inquiry page. This concludes a very basic test of the device, SCSI connection, and the device driver. You may stop the test here or continue to perform a more complete test. 344 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 363
Your Devices 8. Enter 6 (Test Unit Ready) until no error occurs. 9. Enter 18 (Initialize Element Status). 10. Enter (Quit Program). 3494 Enterprise Tape Library Attachment Test The following procedure tests the attachment of a 3494 Enterprise Tape Library to an AIX system. The procedure assumes that - IBM TS2340 | User Guide - Page 364
attachment of a tape device to an HP-UX system. The procedure assumes that your device is attached at /dev/rmt/0m. When you are told to enter information, press the Enter key after following the instruction. When the utility displays information, use the appropriate hardware manual to verify that - IBM TS2340 | User Guide - Page 365
HP-UX - Verifying Proper Attachment of Your Devices 3494 Enterprise Tape Library Attachment Test The following procedure tests the attachment of a 3494 Enterprise Tape Library to an HP-UX system. The procedure assumes that your device is defined in /etc/ibmatl.conf as L3494. 1. Bring up a shell - IBM TS2340 | User Guide - Page 366
following command to verify if your host system has recognized all the attached IBM tape and medium changer devices after you installed the lin_tape device driver: cat /proc/scsi/scsi You can follow the instructions below to test the attachment. Tape Device Attachment Test The following procedure - IBM TS2340 | User Guide - Page 367
inquiry page. This concludes a very basic test of the device, SCSI connection, and the device driver. You may stop the test here or continue to perform a 3494 Enterprise Tape Library Attachment Test The following procedure tests the attachment of a 3494 Enterprise Tape Library to a Linux system. The - IBM TS2340 | User Guide - Page 368
the attachment of a tape device to a Sun Solaris system. The procedure assumes that your device is attached at /dev/rmt/0st. When you are told to enter information, press Enter after following the instruction. When the utility displays information, use the appropriate hardware manual to verify that - IBM TS2340 | User Guide - Page 369
Solaris - Verifying Proper Attachment of Your Devices 3494 Enterprise Tape Library Attachment Test The following procedure tests the attachment of a 3494 Enterprise Tape Library to a Sun Solaris system. The procedure assumes that your device is defined in /etc/ibmatl.conf as L3494. 1. Bring up a - IBM TS2340 | User Guide - Page 370
tests the attachment of an autochanger device to a Windows NT system. The procedure assumes that your device is attached at lb1.0.0.1 and that the tape device is attached at tape0. You also need a cartridge in at least one of the slots. 352 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 371
following the instruction. When the utility displays information, use the appropriate hardware manual to verify driver. You may stop the test here or continue to perform a more complete test. 9. Enter 39 (test unit ready) until no error occurs. Each time you are prompted with a Drive=0, Library - IBM TS2340 | User Guide - Page 372
attachment of a tape device to a Tru64 system. The procedure assumes that your device is attached at /dev/ntape/tape0. When you are asked to enter information, press the Enter key after following the instructions. When the utility displays information, use the appropriate hardware manual to verify - IBM TS2340 | User Guide - Page 373
Tru64 - Verifying Proper Attachment of Your Devices 3494 Enterprise Tape Library Attachment Test The following procedure tests the attachment of a 3494 Enterprise Tape Library to a Tru64 system. The procedure assumes that your device is defined in /etc/ibmatl.conf as L3494. 1. Open a window. 2. - IBM TS2340 | User Guide - Page 374
tests the attachment of a 3494 Enterprise Tape Library to a SGI/IRIX system. The procedure assumes that your device is defined in /etc/ibmatl.conf as L3494. 1. Bring up a shell prompt. 2. Enter mtlib -l L3494 -qI 3. Enter mtlib -l L3494 -qL 356 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 375
for specific instructions on querying your microcode level. If your device is connected to a host system that has device or library support, you can also query the last four digits of the current level of microcode using software, refer to Chapter 10, "IBM Tape Diagnostic Tool (ITDT)," on page - IBM TS2340 | User Guide - Page 376
and that the drive at tape0 is being updated. The name of the file containing the microcode must have the fmr extension. 1. Open a Windows command shell window. 2. Change to the c:\mydata directory. 3. Enter ntutil. 4. Select 1 (Manual test). 358 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 377
on the IBM Tape Drive 5. Enter 20 (open). 6. Enter 1 (Read/Write). 7. Enter 6 (test unit ready) until no error occurs. 8. Enter 82 (Update Code). 9. Enter d0i9_430. 10. Enter 21 (close). 11. Enter 99 (return to main menu). 12. Enter 9 (Exit ntutil). Note: See Microsoft Windows System for information - IBM TS2340 | User Guide - Page 378
Managing Microcode on the IBM Tape Drive 360 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 379
Note: The functions and capabilities of the tape utility program are now performed by the IBM Tape Diagnostic Tool (ITDT). For ITDT support please refer to "Supported Systems" on page 262. Table 33. Tape Utility Program Documentation Operating System Tape Utility Program Command and Location AIX - IBM TS2340 | User Guide - Page 380
library devices. It can be used only for the medium changer functions on the IBM 7331, 7336, and 7337. The data path is supported by the AIX base device driver and utilities, such as tctl and mt. Interactive Interface The interactive interface of the tape except for the tape drive service aids). To - IBM TS2340 | User Guide - Page 381
general subcommands are available for the tape and medium changer devices. checkpath: This subcommand issues a SCSI Inquiry command to the device on subcommand is used to disable the device driver from using either the primary SCSI path or the alternate SCSI path to a device. This subcommand is - IBM TS2340 | User Guide - Page 382
SCSI IDs, and the status of the SCSI paths for the primary path and all alternate paths that are configured. The output from this subcommand is similar to the qrypath subcommand, except more than one alternate path is supported to the device. 364 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 383
Tape Utility Program (tapeutil) resetpath: This subcommand is used to enable the device driver to use both the primary SCSI path or the alternate SCSI optional parameters Slot and Count issues the SCSI Read Element Status to the device for a specific starting Slot address and optionally the Count - IBM TS2340 | User Guide - Page 384
the SCSI tape from the drive to the specified slot or the first empty one if the slot is omitted. The tape is rewound and unloaded automatically from the drive first when this command is issued to the tape device special file. For example: 366 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 385
Backup large.tar (requires multiple tapes) using autoload feature tapeutil -f/ SCSI Report Density command for all supported media and for the current media loaded in the drive, and displays the results. If the drive is not loaded, the current media density is not reported and a Drive Not Ready error - IBM TS2340 | User Guide - Page 386
the SCSI Prevent Allow Medium Removal command to the device to prevent medium removal by an operator until the allow subcommand is issued or the device is reset. qrypart: This subcommand queries and displays tape partitioning information. 368 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 387
was written correctly diff myfile.tar temp.tar read -d Destination [-c Count]: This subcommand reads a file, or a specified number of records, from the tape to the destination file name specified with the -d flag. If the optional count parameter is used, only the number of records specified with - IBM TS2340 | User Guide - Page 388
. dump [Filename]: This subcommand forces a dump on the tape device and stores the dump in the specified Filename or, if Filename is omitted, in the system /var/adm/ras directory. The device driver stores up to three dump files in this 370 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 389
SCSI command to force a dump on the tape drive. The dump can be read using the readdump subcommand. readbufferid ″id″ [Filename]: This subcommand reads a specific is the IBM TotalStorage Enterprise Tape System 3590 with an Automatic Cartridge Facility (ACF) or the IBM Magstar MP 3570 library, the ACF - IBM TS2340 | User Guide - Page 390
is set to no, then the tape drive "Encryption State" is Off. >tapeutil -f/dev/rmt1 encryption Getting drive encryption settings... Encryption settings: Drive Encryption Capable.... Yes Encryption Method........... System Encryption State On 372 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 391
code 0 Running full drive to server encryption test... Test complete, completion code 0 > If the first server test fails with one of the following errors, then the remaining tests are not run. Perform the following recommended problem determination steps to resolve the problem: Appendix D. Tape - IBM TS2340 | User Guide - Page 392
argument or Operation not supported on device" - System encryption is not configured for the tape drive in the device driver. Use SMIT to set system encryption to "yes" for the tape drive. If system encryption can not be set then the tape drive is not encryption capable. 2. "Can't assign requested - IBM TS2340 | User Guide - Page 393
System - Tape Utility Program (tapeutil) This chapter describes how to install, uninstall and use the IBM HP-UX Tape Each step may produce useful information and error messages, so it is a good supported by IBM and Install tapeutil Installing the product manually requires the three steps detailed in - IBM TS2340 | User Guide - Page 394
file lists the system configuration requirements, including required system software patches and required tape related firmware versions. The system: # swlist -a state tapeutil To determine the version of tapeutil stored in the default depot: 376 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 395
called tapeutil is provided with the IBM Tape and Medium Changer Device Driver for HP-UX and installed in the /usr/bin directory. The tapeutil program fulfills several purposes: v The program provides the following service aids for IBM tape systems: - Query Device Type/Verify Device Attachment - IBM TS2340 | User Guide - Page 396
SCSI Commands Test Unit Ready tapeutil -f f -o tur [-w w] [-v] Inquiry/Inquiry Page tapeutil -f f -o inq [-w w] [-v] [-t t] [-x x] Request Sense tapeutil -f f -o req [-w w] [-v] Log Sense Page tapeutil -f f -o log [-w w] [-v] [-x x] 378 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 397
Element Status Range commands are not supported by IBM TotalStorage and System Storage tape devices. CPF Commands Display Paths Enable Path Disable Path tapeutil -f f -o phs[-v] tapeutil -f f -o ena -p path [-v] tapeutil -f f -o dis -p path [-v] Tape Drive Commands Read tapeutil -f f -o rea - IBM TS2340 | User Guide - Page 398
tapeutil -?) displays the usage help information. Flag Description The supported flags, their meanings, their associated operations, and their acceptable ) {device specific, determine range from Element Info} -t Type of Parameter Value 380 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 399
msg2} v (inq) {0=standard data, 1=page code} v {0=mt mode, 1=st mode} -v data transferred during a single SCSI read or write command is IBM Tape Device Drivers Programming Reference, GA32-0566. 3. All media types for the 3590 tape drive support capacity scaling. Capacity scaling is only supported - IBM TS2340 | User Guide - Page 400
Tape Utility Program (tapeutil) Warning: The drive is currently using FIPS code. Do you want to continue with downloading new drive code? [y/n]: Enter n to exit without downloading new code; otherwise, enter y to continue with the download code 32 to the tape drive (16) for TotalStorage 3590: IBM Tape Drives - IBM TS2340 | User Guide - Page 401
HP-UX - Tape Utility Program (tapeutil) Where: Xchng is the logical name of any device. This command shows specific information for and Alternate Paths (Control Path Failover) When you load the ATDD device driver with the alternate_pathing parameter set to ON, by default, all the available paths - IBM TS2340 | User Guide - Page 402
HP-UX - Tape Utility Program (tapeutil) # tapeutil -f /dev/rmt/Xm -p /dev/rmt/Xm.altpath -o dis -v 2. To make sure the path is labeled a disabled state, run the following command: # tapeutil -f /dev/rmt/Xm -o ena -p /dev/rmt/Xm.altpath -v 384 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 403
source code for the IBMtapeutil program contains a sample of the interface to the device driver and the ioctl commands supported by the device driver. IBMtapeutil.c may be found in the tar file IBMtapeutil.x.x.x.tar on the device driver down load ftp site: ftp://ftp.software.ibm.com/storage/devdrvr - IBM TS2340 | User Guide - Page 404
encryption tape drive), a ″function not implemented″ error is returned. This subcommand is only available in IBMtapeutil version 1.2.0 or higher, and the lin_tape device driver, version 1.4.1 or higher, on libraries that have the Control Path Failover feature enabled. 386 IBM Tape Device Drivers - IBM TS2340 | User Guide - Page 405
Tape Utility Program (IBMtapeutil) inquiry [Page]: This subcommand issues the SCSI Inquiry command to the device for either standard inquiry data, when no page parameter is specified, or for a specific , and the lin_tape device driver, version 1.4.1 or higher, on libraries that have the Control Path - IBM TS2340 | User Guide - Page 406
filemark. The tape is positioned on the last block of the previous file. An optional count can be specified. The default is 1. fsr [Count]: This subcommand forward spaces count records. An optional count can be specified. The default is 1. 388 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 407
when an Enterprise Tape System 3590 is installed in a 3494 Enterprise Tape Library. offline, rewoffl, and unload: These subcommands rewind and unload the tape. parms: This subcommand issues the STIOCQRYP ioctl command and displays the current tape drive, media, and device driver parameters. Then the - IBM TS2340 | User Guide - Page 408
set to the Blockid. Otherwise, if the Blockid parameter is omitted, the tape position is set to the last position saved using the qrypos subcommand. The Blockid can be specified in decimal or in hexidecimal (with a leading ″x″). For example: 390 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 409
tape drive door. write -s Source: This subcommand writes the source file specified with the -s flag on the tape. For example: # backup myfile.tar to tape specified, an error message is SCSI Initialize Element Status command to the device. The Address and Count parameters are not supported for IBM - IBM TS2340 | User Guide - Page 410
drive to slot address 4 (tape is already unloaded) IBMtapeutil -f /dev/IBMchanger0 unmount 4 # Unload tape and move to the first empty slot IBMtapeutil -f /dev/IBMchanger0 unmount Service Aid Subcommands The following service aid subcommands are available for the devices. 392 IBM Tape Device Drivers - IBM TS2340 | User Guide - Page 411
If the Enterprise Tape System 3590 tape subsystem has an ACF installed, the ACF mode can be queried by the IBMtapeutil application using the Query/Set Parameters option in the window. This parameter is currently not supported for IBM Ultrium devices. Block Size and SCSI Transfer Size The minimum - IBM TS2340 | User Guide - Page 412
on page 392. For information on using tape drive service aids with the IBM Virtualization Engine TS7510, please refer to the IBM System Storage Virtualization Engine TS7510 Installation and Planning Guide at: http://www-03.ibm.com/systems/storage/index/tape.html. Create Special Files The interactive - IBM TS2340 | User Guide - Page 413
Tape Utility Program (IBMtapeutil) Disable and Enable Primary and Alternate Paths (Control Path Failover) Once you load the lin_tape device driver ″disabled″) Correspondingly, in the /proc/scsi/IBMchanger file, the disabled path is listed device) This command shows specific information for the primary - IBM TS2340 | User Guide - Page 414
-f /dev/IBMtapex path (to make sure the path is labeled as "disabled") Correspondingly, in the /proc/scsi/IBMtape file, the disabled path is listed as ″Disabled″ under the ″FO Path″ column. To enable a number of the path you want to enable) 396 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 415
Program called tapeutil is provided with the IBM SCSI Tape and Medium Changer Device Driver for Solaris and is installed in the /opt/IBMtape directory as part of the IBMtape package. The program provides the following service aids for IBM tape subsystems. v Download Device Microcode v Force Device - IBM TS2340 | User Guide - Page 416
Drive Commands Read tapeutil -f f -o rea [-w w] [-v] -b b -n n -m m Write tapeutil -f f -o wri [-w w] [-v] -b b -n n -m m [-r r] [-z z] Write File Mark tapeutil -f f -o eof [-w w] [-v] -c c Erase Tape tapeutil -f f -o era [-w w] [-v] 398 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 417
Tape Forward -?) displays the usage help information. Flag Description The supported flags, their meanings, their associated operations, and their fsr, bsf, bsr) {0-65535} -d Destination Address (mov) {device specific, determine range from Element Info} -f Device Special File Name (always - IBM TS2340 | User Guide - Page 418
- Tape Utility Program (tapeutil) -r Random Seed (wri) {0-65535} -s Source Address (mov, pos) {device specific, determine size of one buffer of data transferred during a single SCSI read or write command is determined by the product of IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 419
and is always 100%. Downloading Device Microcode The IBM tape drives support downloading a new microcode image from the host system by way of the SCSI bus. To download microcode to these devices, perform the following steps: v Verify that the IBM tape system is powered On and online. v Verify that - IBM TS2340 | User Guide - Page 420
enter y to continue with the download code procedure. Forcing and Storing Device Diagnostic Dump The IBM tape drives support forcing a diagnostic dump and storing that dump to a mounted tape cartridge or to a host system file through the SCSI bus. To store a diagnostic dump on these devices - IBM TS2340 | User Guide - Page 421
in the path entry in the IBMtape.conf file. For example, name="IBMtape" class="scsi" target=3 lun=1 failover=0; 2. Stop the TMD (tape monitor daemon) running on the system and unload the IBMtape driver module from the current kernel: # /opt/IBMtape/tmd -s # /usr/sbin/rem_drv IBMtape 3. Reload the - IBM TS2340 | User Guide - Page 422
, path type and so on. It also indicates how many paths are configured for the device, and which path is the current active path. 404 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 423
off in the path entry in IBMtape.conf file. For example, name="IBMtape" class="scsi" target=3 lun=0 dpf_support=0; 2. Stop the TMD (tape monitor daemon) running on the system and unload the IBMtape driver module from the current kernel: # /opt/IBMtape/tmd -s # /usr/sbin/rem_drv IBMtape 3. Reload the - IBM TS2340 | User Guide - Page 424
problems v Determine which devices are recognized by the device and changer drivers v Force a drive dump v Load new microcode on your drive or changer device v Send SCSI commands to drives and changers v Receive the status of SCSI commands v Obtain sense data for SCSI commands that encounter errors - IBM TS2340 | User Guide - Page 425
-f flag, it defaults to interactive (or manual) mode. This mode allows a developer to supports open, close, read, and write, plus medium changer commands such as read element status and move media. Note: On Microsoft Windows 200x platforms, library functions are available if the Removable Storage - IBM TS2340 | User Guide - Page 426
Example of Base Mode Library mode (LUN 0 specified by the tape-path-special-file-name, for example, tape0, and LUN 1 specified by the changer-path-special-file-name, for example, lb0.1.2.3, are accessed) is shown in Figure 107 on page 409. 408 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 427
. Open a SCSI device by issuing option 20 (Open) from library mode as shown previously. The device names can be obtained using command 88 (List registered devices) also shown previously. Tape device names have the format tapeN, where N is a digit, such as 0, 1, and so on. If the device driver is - IBM TS2340 | User Guide - Page 428
v Symbols v System v Type Each type of statement is described in the following section. Command Device driver function is exercised comments and are ignored. Supported Command Text Fields The command text specifies the tape operation to perform. IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 429
between TESTMSG and T E S T unless the Manual mode display message was used previously, in which calls the device driver ReadFile entry point. It attempts to read from the tape device special file for tape and medium changer device identifiers: "HARDWARE\\DEVICEMAP\\Scsi\\Scsi Port W\\Scsi Bus - IBM TS2340 | User Guide - Page 430
: SYNTAX: get_last_sense for example, get_last_sense FUNCTION Tested: This command calls the device driver DeviceIoControl entry point with an operation of OBTAIN_SENSE. This displays the last sense data returned by a sense command. 412 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 431
Inquiry page 0 is supported. load (3590 System Mode and Ultrium devices): SYNTAX: load for example, load FUNCTION Tested: This command calls the device driver PrepareTape entry point with an operation of TAPE_LOAD. It attempts to load the tape media into the drive of the tape device special file - IBM TS2340 | User Guide - Page 432
. This reads the log sense page specified by the page code and displays the data. The page_code (xx) is two supported values) daddr = decimal destination address (moving to) for example, move_medium stype = 2 saddr = 1 dtype = 4 daddr = 0 414 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 433
-file-name> RW RO where RW means read/write RO means read only The tape-special-file-name is in the form of tapen, and n is a numeric value from 0...x, the value is assigned by the device driver during the boot process and can be found using the interactive modes option 50 poll - IBM TS2340 | User Guide - Page 434
key: HARDWARE\\DEVICEMAP\\Scsi\\Scsi Port W\\Scsi Bus X\\Target Id Y\\ Logical Unit Id Z for devices supported by the Windows tape and medium changer device drivers. This command then or to a dump0000.dmp default file. Dump_name must be 416 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 435
is detected. All the data read, regardless of error, is saved in the file specified. If there is no data on the tape, the command fails, and no data is saved a library. If this command is successful, the information returned is displayed. For Windows NT, refer to the appropriate hardware manuals for - IBM TS2340 | User Guide - Page 436
the drive, Empty driver SetTapePosition entry point with an operation of TAPE_REWIND. It attempts to rewind the tape device special file opened previously. Status is presented when the rewind is complete. set_device_parameters (compression): 418 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 437
to the appropriate hardware reference manual for details on Associative and This command calls the device driver SetTapePosition entry point with an tape device special file opened previously. test_unit_ready: SYNTAX: test_unit_ready n for example, test_unit_ready 1 FUNCTION Tested: Appendix D. Tape - IBM TS2340 | User Guide - Page 438
the command to the drive. Specify 1 to send the command to the changer. unload: SYNTAX: unload for example, unload FUNCTION Tested: This command calls the device driver PrepareTape entry point Data can be a decimal value from 0-4294967295. 420 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 439
driver WriteTapemark entry point with an operation of TAPE_FILEMARKS and a count of n. It attempts to write n filemarks on the tape media. Supported where: rc = return code from the last command. err = Operating System GetLastError () value for the ntutil ends by returning an error at the end of - IBM TS2340 | User Guide - Page 440
that require manual intervention. delay system Text following the word system is passed to the system for execution. The syntax for the system statement is: system operation for example, system error or error number) that can be used for err. 422 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 441
(ntutil) | Symbolic Error | NT/Win2000| Symbolic Error |NT/Win2000 | | | Error # | | Error # | | ERROR_SUCCESS | 313 | | | | DD_SOURCE_EMPTY | 314 | | | | DD_DESTINATION_FULL | 315 | | | Figure 108. Symbolic Values Appendix D. Tape Utility Programs 423 - IBM TS2340 | User Guide - Page 442
been enabled in the device driver and display the primary and alternate paths, you may use the Windows utility program ntutil. Open a tape library from ntutil library mode, choose option "get changer YES PRIMARY YES PRIMARY YES YES PRIMARY 424 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 443
following IBM devices are supported: v IBM Ultrium LTO1 tape drive inIBM System Storage TS3500, 3581 and 3583 Tape Libraries v IBM TotalStorage Enterprise 3590 Tape Drive Models E11 or H11 (Rack Mount with ACF) v IBM TotalStorage Enterprise 3590 Tape Drive Models E1A or H1A (3494 Tape Library Models - IBM TS2340 | User Guide - Page 444
3. If only the -f option is issued, the program queries and displays the Model Name, Serial Number and the Firmware level of the device. 4. If the -f option is not issued, the . For example: IBMrasutil -f /dev/ntape/tape7 -M 2360.bin 426 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 445
publication at any time without notice. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. | The ITDT-SE and ITDT-GE software uses Henry Spencer's regular expression | library that is subject to the following - IBM TS2340 | User Guide - Page 446
IBM IBMLink Magstar Micro Channel Netfinity POWER5 ProtecTIER pSeries RS/6000 S/390 StorageSmart System i® System p System Storage System x System ). Other company, product, and service names may be trademarks or service marks of others. 428 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 447
Before Calling Support 52 common utilities 52 data path 51 Tape Drive, Media, and Device Driver Parameters 28 AIX 3494 Enterprise Tape Library Installation Instructions 213 Configuring Library Manager Control Point 215 configuring the 3490E or Enterprise Tape System 3590 tape drive 214 configuring - IBM TS2340 | User Guide - Page 448
Problem Determination 226 daemon trace facility 227 error logging 227 HP-UX microcode 358, 375 HP-UX System testing 346 3494 Enterprise tape library attachment test 347 autochanger device attachment test 346 tape device attachment test 346 430 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 449
xiii IBM 7332 Model 220 External 4mm Tape Autoloader xiii IBM 7334 8mm Tape Library xiii IBM 7336 4mm Tape Library xiii IBM TotalStorage Enterprise Tape System 3590 xiii IBM TotalStorage UltraScalable Tape Library 3584 x IBM TotalStorage Ultrium External Tape Drive 3580 xi IBM TotalStorage Ultrium - IBM TS2340 | User Guide - Page 450
tape library attachment test 351 autochanger device attachment test 350 tape device attachment test 350 Solaris System-Managed Encryption System-Managed Encryption 153 StorageSmart by IBM Ultrium device drivers Attachment to open systems servers Ultrium Products 6 Sun Solaris microcode 358 Supported - IBM TS2340 | User Guide - Page 451
Driver Management installation overview 165 installation procedure 166 manual starting and stopping procedures 176 removal procedure 172 Installation and Configuration Instructions Adding or Removing Devices 165 Product Requirements 165 Windows System-Managed Encryption System-Managed Encryption - IBM TS2340 | User Guide - Page 452
434 IBM Tape Device Drivers Installation and User's Guide - IBM TS2340 | User Guide - Page 453
Readers' Comments - We'd Like to Hear from You IBM Tape Device Drivers Installation and User's Guide Publication No. GC27-2130-08 We appreciate your comments about this publication. Please comment on specific errors or omissions, accuracy, organization, subject matter, or completeness of this book. - IBM TS2340 | User Guide - Page 454
YORK POSTAGE WILL BE PAID BY ADDRESSEE International Business Machines Corporation Information Development Department GZW 9000 South Rita Road Tucson, Arizona 85775-4401 Fold and Tape Please do not staple Fold and Tape GC27-2130-08 Cut or Fold Along Line - IBM TS2340 | User Guide - Page 455
- IBM TS2340 | User Guide - Page 456
Printed in USA GC27-2130-08 - IBM TS2340 | User Guide - Page 457
Spine information: IBM Tape Device Drivers IBM Tape Device Drivers Installation and User's Guide
-
1 -
2 -
3 -
4 -
5 -
6 -
7 -
8
-
9
-
10
-
11
-
12
-
13
-
14
-
15
-
16
-
17
-
18
-
19
-
20
-
21
-
22
-
23
-
24
-
25
-
26
-
27
-
28
-
29
-
30
-
31
-
32
-
33
-
34
-
35
-
36
-
37
-
38
-
39
-
40
-
41
-
42
-
43
-
44
-
45
-
46
-
47
-
48
-
49
-
50
-
51
-
52
-
53
-
54
-
55
-
56
-
57
-
58
-
59
-
60
-
61
-
62
-
63
-
64
-
65
-
66
-
67
-
68
-
69
-
70
-
71
-
72
-
73
-
74
-
75
-
76
-
77
-
78
-
79
-
80
-
81
-
82
-
83
-
84
-
85
-
86
-
87
-
88
-
89
-
90
-
91
-
92
-
93
-
94
-
95
-
96
-
97
-
98
-
99
-
100
-
101
-
102
-
103
-
104
-
105
-
106
-
107
-
108
-
109
-
110
-
111
-
112
-
113
-
114
-
115
-
116
-
117
-
118
-
119
-
120
-
121
-
122
-
123
-
124
-
125
-
126
-
127
-
128
-
129
-
130
-
131
-
132
-
133
-
134
-
135
-
136
-
137
-
138
-
139
-
140
-
141
-
142
-
143
-
144
-
145
-
146
-
147
-
148
-
149
-
150
-
151
-
152
-
153
-
154
-
155
-
156
-
157
-
158
-
159
-
160
-
161
-
162
-
163
-
164
-
165
-
166
-
167
-
168
-
169
-
170
-
171
-
172
-
173
-
174
-
175
-
176
-
177
-
178
-
179
-
180
-
181
-
182
-
183
-
184
-
185
-
186
-
187
-
188
-
189
-
190
-
191
-
192
-
193
-
194
-
195
-
196
-
197
-
198
-
199
-
200
-
201
-
202
-
203
-
204
-
205
-
206
-
207
-
208
-
209
-
210
-
211
-
212
-
213
-
214
-
215
-
216
-
217
-
218
-
219
-
220
-
221
-
222
-
223
-
224
-
225
-
226
-
227
-
228
-
229
-
230
-
231
-
232
-
233
-
234
-
235
-
236
-
237
-
238
-
239
-
240
-
241
-
242
-
243
-
244
-
245
-
246
-
247
-
248
-
249
-
250
-
251
-
252
-
253
-
254
-
255
-
256
-
257
-
258
-
259
-
260
-
261
-
262
-
263
-
264
-
265
-
266
-
267
-
268
-
269
-
270
-
271
-
272
-
273
-
274
-
275
-
276
-
277
-
278
-
279
-
280
-
281
-
282
-
283
-
284
-
285
-
286
-
287
-
288
-
289
-
290
-
291
-
292
-
293
-
294
-
295
-
296
-
297
-
298
-
299
-
300
-
301
-
302
-
303
-
304
-
305
-
306
-
307
-
308
-
309
-
310
-
311
-
312
-
313
-
314
-
315
-
316
-
317
-
318
-
319
-
320
-
321
-
322
-
323
-
324
-
325
-
326
-
327
-
328
-
329
-
330
-
331
-
332
-
333
-
334
-
335
-
336
-
337
-
338
-
339
-
340
-
341
-
342
-
343
-
344
-
345
-
346
-
347
-
348
-
349
-
350
-
351
-
352
-
353
-
354
-
355
-
356
-
357
-
358
-
359
-
360
-
361
-
362
-
363
-
364
-
365
-
366
-
367
-
368
-
369
-
370
-
371
-
372
-
373
-
374
-
375
-
376
-
377
-
378
-
379
-
380
-
381
-
382
-
383
-
384
-
385
-
386
-
387
-
388
-
389
-
390
-
391
-
392
-
393
-
394
-
395
-
396
-
397
-
398
-
399
-
400
-
401
-
402
-
403
-
404
-
405
-
406
-
407
-
408
-
409
-
410
-
411
-
412
-
413
-
414
-
415
-
416
-
417
-
418
-
419
-
420
-
421
-
422
-
423
-
424
-
425
-
426
-
427
-
428
-
429
-
430
-
431
-
432
-
433
-
434
-
435
-
436
-
437
-
438
-
439
-
440
-
441
-
442
-
443
-
444
-
445
-
446
-
447
-
448
-
449
-
450
-
451
-
452
-
453
-
454
-
455
-
456
-
457
 |
 |
IBM Tape Device Drivers
Installation and User’s Guide
GC27-2130-08
±²³