User manual QUANTUM 6464215011 2 2

[. . . ] Installing a DLT, SDLT, VS, LTO, or DAT Tape Drive Into a Linux Operating System Purpose Scope Conventions Used in This Guide Reference Documents Setting Up Communication with the Tape Drives 5 5 5 6 7 Before Installing the Tape Drive. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Installing the Tape Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Verifying the st Module is Loaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Verifying Communication with the Tape Drives 9 Displaying the Kernel Initialization Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Reviewing the Kernel Initialization Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Identifying the Tape Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 What To Do if Device Information is Missing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Obtaining Device Information Using /proc/scsi/scsi 10 What is the /proc File System?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Viewing /proc Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Document 6464215-01 Rev. B, January 2006 1 Installing a DLT, SDLT, VS, LTO, or DAT Tape Drive Into a Linux Operating System Document 6464215-01 Rev. B January 2006 Accessing Devices Using /dev/st* Device Nodes 11 Generating a List of Device Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Reviewing the List of Device Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 What To Do if a Device Node is Missing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Interpreting the Device Node File Listing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Identifying Device Nodes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Identifying Device Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Creating Device Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Creating Auto-Rewind Device Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Creating No-Rewind Device Nodes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 mt-st Linux RPM Package 17 Verifying mt-st is Installed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Installing mt-st . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 mt Tape Device Tool stinit and stinit. def 17 18 Tape Device and Parameter Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Identifying Tape Devices and Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Common Tape Device Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Common Parameter Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 mtx Tape Library Tool 20 Verifying mtx is Installed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Installing mtx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Appendix A ­ Tape Drive and Cartridge Compatibility 22 Tape Drive and Cartridge Compatibility ­ DLT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Tape Drive and Cartridge Compatibility ­ SDLT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Tape Drive and Cartridge Compatibility ­ VS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Tape Drive and Cartridge Compatibility ­ LTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Tape Drive and Cartridge Compatibility ­ DDS/DAT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Contents 2 Installing a DLT, SDLT, VS, LTO, or DAT Tape Drive Into a Linux Operating System Document 6464215-01 Rev. B January 2006 Appendix B ­ Linux Reference Documentation Appendix C ­ Sample stinit. def Definitions File 25 26 Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Sample File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Appendix D ­ Troubleshooting 31 Contents 3 Installing a DLT, SDLT, VS, LTO, or DAT Tape Drive Into a Linux Operating System Document 6464215-01 Rev. [. . . ] This is also the actual file name. (n)st identifies the device node as either auto-rewind or no-rewind as a numeric character; a represents an alpha character. In the example: follows: · st identifies the device node as auto-rewind. See Creating Auto-Rewind Device Nodes on page 16 for more information. · nst identifies the device node as no-rewind. See Creating No-Rewind Device Nodes on page 16 for more information. n (the numeric character) identifies the tape device. "0" identifies the first device; "1" identifies the second device; "2" identifies the third device, and so forth. See Identifying Device Nodes for more information. a (the alpha character) identifies the mode. (No alpha character means (n)st0* mode 1. ) See Identifying Device Modes for a list of modes. Identifying Device Nodes 0 Linux supports up to 32 tape devices [(n)st0* through (n)st31*). Device nodes are numbered consecutively beginning with 0. Each operating system presets a certain number of device nodes as follows. You may add more manually if needed (up to 32 total). The following table shows two examples: Operating System RHEL3 SuSE9 Preset Device Nodes (n)st0* through (n)st31* (n)st0* through (n)st7* Accessing Devices Using /dev/st* Device Nodes 14 Installing a DLT, SDLT, VS, LTO, or DAT Tape Drive Into a Linux Operating System 6464215-01, Rev B January 2006 Identifying Device Modes 0 Each node has four modes. Both the auto-rewind and no-rewind functions use the same modes. Auto-Rewind Node (example)a st0 st0l st0m st0a Mode 1 2 3 4 No-Rewind Node (example) nst0 nst0l nst0m nst0a Alpha Character Identification no character lowercase l lowercase m lowercase a a. The "0" in this table is an example representing the device. In actual practice, this numeric character may be any number from 0 to 31 depending on the node. Creating Device Nodes0 This section shows each stinit mode and its corresponding device node identification parameters. The next two sections -- Creating Auto-Rewind Device Nodes and Creating No-Rewind Device Nodes -- show examples of the codes you use to create device nodes. The following table shows the numbering you use to identify the first tape device in each mode. To identify a second tape device, increment the tape device number and minor number by one, and so on for each successive tape device. You can have up to 32 tape devices per mode. Tape Device Number for first tape device (increment by one for each successive device) 0 0 0 0 0 0 0 0 Mode Mode 1 (Auto-Rewind) Mode 2 (Auto-Rewind) Mode 3 (Auto-Rewind) Mode 4 (Auto-Rewind) Mode 1 (No-Rewind) Mode 2 (No-Rewind) Mode 3 (No-Rewind) Mode 4 (No-Rewind) Alpha Character Mode Identifier none lowercase l lowercase m lowercase a none lowercase l lowercase m lowercase a Minor Number of first tape device (increment by one for each successive device) 0 32 64 96 128 160 192 224 Accessing Devices Using /dev/st* Device Nodes 15 Installing a DLT, SDLT, VS, LTO, or DAT Tape Drive Into a Linux Operating System 6464215-01, Rev B January 2006 Creating Auto-Rewind Device Nodes 0 Use the mknod commands as shown in the following table to create autorewind device nodes. [. . . ] Use these tables to determine which cartridges to use in your tape drive. 0 Tape Drive and Cartridge Compatibility ­ DLT 0 Drive Type DLT 2000 DLT 2500 DLT 2700 DLT 2000XT DLT 2500XT DLT 2700XT DLT 4000 DLT 4500 DLT 4700 DLT 7000 DLT 8000 Tape Cartridge DLTtape III (CompacTapeTM III) DLTtape IIIXT (CompacTape III XT) 10/20 GB 10/20 GB (read only) 15/30 GB 10/20 GB (read only) 15/30 GB (read only) 20/40 GB 10/20 GB (read only) 15/30 GB (read only) 20/40 GB (read only) 35/70 GB 10/20 GB (read only) 15/30 GB (read only) 20/40 GB (read only) 35/70 GB (read only) 40/80 GB N/A N/A N/A DLTtape IV (CompacTape IV) Cleaning Tape III Cleaning Tape IV 20 uses N/A 20 uses N/A 20 uses N/A 20 uses 20 uses 20 uses 20 uses Appendix A ­ Tape Drive and Cartridge Compatibility 22 Installing a DLT, SDLT, VS, LTO, or DAT Tape Drive Into a Linux Operating System 6464215-01, Rev B January 2006 Tape Drive and Cartridge Compatibility ­ SDLT 0 Drive Type Tape Cartridge DLTtape IV (CompacTape IV) SDLT 220 20/40 GB (read only) 35/70 GB (read only) 40/80 GB (read only) 110/220 GB N/A N/A N/A 20 uses SDLT 320 20/40 GB (read only) 35/70 GB (read only) 40/80 GB (read only) 110/220 GB 160/320 GB N/A N/A N/A 20 uses SDLT 600 N/A 110/220 GB (read only) Super DLTtape I Super DLTtape II DLTtape VS1 Cleaning Tape III SDLT Cleaning Tape 160/320 GB (read only) 300/600 GB 80/160 GB (read only) N/A 20 uses Tape Drive and Cartridge Compatibility ­ VS 0 Drive Type Tape Cartridge DLTtape IV (CompacTape IV) DLTtape VS1 DLTtape IV Cleaning Tape VS160 Cleaning Tape DLT1 VS80 VS160 DLT-V4 40/80 GB N/A 20 uses N/A 40/80 GB N/A 20 uses N/A 40/80 GB (read only) 80/160 GB N/A 20 uses 40/80 GB (read only) 80/160 GB (read only) 160/320 GB N/A 20 uses Appendix A ­ Tape Drive and Cartridge Compatibility 23 Installing a DLT, SDLT, VS, LTO, or DAT Tape Drive Into a Linux Operating System 6464215-01, Rev B January 2006 Tape Drive and Cartridge Compatibility ­ LTO 0 Drive Type Tape Cartridge Ultrium 1 Ultrium 2 Ultrium 3 Ultrium Cleaning Tape LTO-1 LTO-2 LTO-3 100/200 N/A N/A 20 uses 100/200 (read only) 200/400 N/A 20 uses 100/200 (read only) 200/400 (read only) 400/800 20 uses Tape Drive and Cartridge Compatibility ­ DDS/DAT 0 Drive Type Tape Cartridge DDS2 DDS3 DDS4 DAT 72 Cleaning Tape DDS3 4/8 12/24 N/A N/A 40 uses DDS4/SP40 4/8 12/24 20/40 N/A 40 uses DAT 72 N/A 12/24 20/40 36/72 40 uses Appendix A ­ Tape Drive and Cartridge Compatibility 24 Installing a DLT, SDLT, VS, LTO, or DAT Tape Drive Into a Linux Operating System 6464215-01, Rev B January 2006 Appendix B ­ Linux Reference Documentation For further information about the topics discussed in this guide, refer to the following documentation: · · · · · · · · stinit(8) man page /usr/share/doc/mt-st-<version>/stinit. def. examples st(4) man page dmesg(8) man page /usr/src/linux-<kernel revision>/Documentation/devices. txt /usr/src/linux-<kernel revision>/drivers/scsi/README. st mt(1) man page mtx(1) man page 0 Appendix B ­ Linux Reference Documentation 25 Installing a DLT, SDLT, VS, LTO, or DAT Tape Drive Into a Linux Operating System 6464215-01, Rev B January 2006 Appendix C ­ Sample stinit. def Definitions File 0 This section provides a sample stinit. def definitions file. You must set up your stinit. def file if you have not done so already. Recommendations 0 This sample contains Quantum's recommendations for setting up your stinit. def file. You may use the information provided here (you can copy and paste the information directly into your stinit. def file or enter it manually). You may modify this information as needed. [. . . ]