User manual QUANTUM LTFS

[. . . ] Quantum LTFS (Linear Tape File System) User Guide Introduction 3 Features . 4 Linux: Installation and configuration 5 Downloading and Installing Quantum LTFS . 7 Mac OS X: Installation and configuration 7 Downloading and installing Quantum LTFS . 8 Using Quantum LTFS 8 How to use LTFS . [. . . ] The binary RPM will place three executables in /usr/local/bin/ (ltfs, mkltfs, ltfsck) and a number of dynamic libraries in /usr/local/lib/ (or /usr/local/lib64) and also in a new subdirectory /usr/local/lib/ltfs/ (or /usr/local/lib64/ltfs/). See Using Quantum LTFS on page 8 for the next steps. 6 Linux: Installation and configuration Quantum LTFS (Linear Tape File System) User Guide 6-67105-01 Rev B December 2010 To uninstall LTFS If at a later date you want to uninstall LTFS from your system, use the following command: $ rpm e qtmltfs Mac OS X: Installation and configuration When using Quantum LTFS with Quantum LTO-5 tape drives, the following components are required: · A drive firmware revision that supports dual partitioning · The software package that contains the "run-time" executable · The MacFUSE kernel module · The ICU package (provided) Note: Quantum LTFS will check and tell you if your tape drive firmware needs updating. Downloading and installing Quantum LTFS To download and install Quantum LTFS with precompiled binaries: 1 Before starting to install and use LTFS, you must ensure that the MacFUSE module version 2. 0. 3, 2 is present and loaded. Linux example - $ mkltfs d /dev/st0 f Mac OSx example: $ mfltks d 0 f 8 Using Quantum LTFS Quantum LTFS (Linear Tape File System) User Guide 6-67105-01 Rev B December 2010 mkltfs Options ­d, ­device=<name> Tape device (required). For Linux use the device name such as /dev/ st0. For MacOS X, use the instance number of the tape drive, assigned sequentially by the system starting from 0. ­b, ­blocksize=<value> Number of bytes per block written to tape (defaults to 524288 i. e. Quantum recommends that you do not change this from its default value to avoid problems with interchange. Tape serial number (6 alphanumeric ASCII characters) Tape volume name (empty by default) Rules for files that should go to the index partition. Multiple rules are interpreted as an 'AND' operator. Their syntax is as follows: -size=NUM filters files smaller than NUM. Accepts 'K', 'M' & 'G' suffixes -name=STR filters files whose name matches the expression STR. ­s, ­tapeserial=<id> ­n, ­volumename=<name> ­r, ­rules=<rule[, rule]> ­o, ­nooverride ­q, ­quiet ­f, ­force ­t, ­trace ­h, ­help Disallow mount-time data placement policy changes Suppress progress information and general messages Force reformat of existing LTFS volume (normally prevented) Enable function call tracing (only useful for debugging) This help. 3 Mount the formatted tape cartridge $ mkdir /mnt/lto5 $ ltfs /mnt/lto5 Note: Some operating systems require creating each folder or subfolder in separate commands. For example: $ mkdir /mnt $ cd /mnt $ mkdir lto5 $ cd lto5 Using Quantum LTFS 9 Quantum LTFS (Linear Tape File System) User Guide 6-67105-01 Rev B December 2010 ltfs Options: Tape device (required if not using the default device: /dev/ st0 for Linux, 0 for Mac OS) LTFS work directory (default: /tmp/ltfs/) Enable function call tracing (only useful for debugging) Advanced help, including standard FUSE options Output version information and exit Display this help and exit Set file permissions (octal) Set file owner Set file group Run in foreground ­o devname=<dev> ­o work_directory=<dir> ­o trace ­a ­V, ­version ­h, ­help ­o umask=M ­o uid=N ­o gid=N ­f 4 Write files to the LTFS volume. For example: $ cp r /root /mnt/lto5/ 5 Unmount the tape cartridge. This flushes the data buffer of the file system to the tape cartridge, and prepares for eject. $ umount /mnt/lto5 or $ fusermount u /mnt/lto5 Note: fusermount is only available on Linux. Note: The umount (or fusermount) command will return immediately, but the drive may still be busy writing cached data to tape. Do not attempt to remove the tape cartridge, power down the system or tape drive, or delete the folder where the LTFS volume is mounted, until all tape activity has finished. Check the front panel LEDs and wait for them to stop flashing. Attempting these actions before tape activity has finished may cause corruption of the tape format. Usage details File permissions The Quantum LTFS application manages a common set of file permissions for all files and users; file and directory ownership is not recorded to tape media. The only permission that is tracked is write-protect information. Files or directories that are write-protected will have permission bits set to 555; write-enabled files 10 Using Quantum LTFS Quantum LTFS (Linear Tape File System) User Guide 6-67105-01 Rev B December 2010 and directories have permission set to 777. By default the user and group information is set to that of the current user; this can be overridden by use of the -o uid and -o gid options to the LTFS application. File types The Quantum LTFS application does not support the creation of symbolic links or hard links within the tape file system. Attempting to create a link or copy a link to tape will result in a "Function not implemented" error. If using the cp command to copy to tape, the '-L' option may be helpful to follow symlinks. [. . . ] Q: Why doesn't Quantum LTFS work with my LTO­4 or earlier drives? Frequently asked questions 13 Quantum LTFS (Linear Tape File System) User Guide 6-67105-01 Rev B December 2010 A: Quantum LTFS relies on a drive feature called partitioning, which was added to the LTO­5 format. It is not part of the LTO­4 or earlier tape formats and they cannot be used. Q: Can I use LTO­4 media in my LTO­5 drive?A: The LTO­5 drives can load, read and write LTO­4 media, but the LTO­4 format does not support partitioning. [. . . ]