Mounting a library by using the `ltfs` or `ltfs.exe` command

How to mount tape media by using the ltfs or ltfs.exe command and the options that can be specified with them.

For more information about mounting a library on a Linux system, see Mounting a library on a Linux system.. For more information about mounting a library on a Windows system, see Starting Spectrum Archive and mounting a library on a Windows system.

Table 1. Command line entries for mounting a library
Operating system	Command line entry
Linux	`$ ltfs -o changer_devname=/dev/IBMchanger0 /mnt/ltfs`
Windows	`ltfs.exe -o changer_devname=6.0.0.1 Q`

For Linux users: When on-disk metadata storage is enabled, only root users can mount the tape libraries.

Command options for `ltfs` or `ltfs.exe`

-a

Advanced help, including standard FUSE options.

-h, --help

Display this help and exit.

-o changer_devname=<dev>

Changer device.

-o device_list

Show available tape devices.

-o fulltrace

Enable full call tracing.

-o nostrict_drive

Mount any supported generation of medium for the drive (default). For example, an LTO 6 drive mounts both LTO 5 and LTO 6 media.

-o quiet

Disable informational messages.

-o release_device

Clear device reservation (specify with -o changer_devname).

-o scsi_append_only_mode=off

Disable data-safe mode (default: enabled).

-o scsi_append_only_mode=on

Enable data-safe mode (default).

-o scsi_lbprotect=off

Disable logical block protection (LBP) for all tape drives in the tape library (default).

-o scsi_lbprotect=on

Enable LBP for all tape drives in the tape library (default: disabled).

-o six_char_folder

Use six characters for the directory name for each cartridge (default: disabled).

-o strict_drive

Mount only corresponding generation of medium with the tape drive (default: disabled). For example, an LTO 6 drive mounts LTO 6 media only.

-o symlink_type=live

Live link mode. (For more information, see Enabling symbolic links.)

-o symlink_type=posix

Standard symbolic link (default).

-o sync_type=<type>

Specify sync type (default: time@5) time@5; <type> must be specified as follows:

time@min: Spectrum Archive Library Edition attempts to write an index every min minutes; min must be a decimal number from 1 to 153722867280912930 (default: min=5).; It is equivalent to -o sync_type=unmount when 0 is specified.
close: Spectrum Archive Library Edition attempts to write an index when a file is closed.
unmount: Spectrum Archive Library Edition attempts to write an index when a file is unmounted.

-o trace

Enable diagnostic output (same as verbose=3).

-o syslogtrace

Enable diagnostic output to stderr and syslog (same as verbose=303).

-o work_directory=<dir>

Spectrum Archive work directory. (The default directory on Linux is /var/lib/ltfs. The default directory on Windows is %TEMP%\ltfs.)

The work directory requires that the user has write permission. For Linux users, refer to the topic Mounting a library on a Linux system.

-o verbose=<num>

Override output verbosity directly. Specify the verbose level of stderror output with the digits in the tens place and ones place. Specify the verbose level of syslog output with the digit in the hundreds place. The verbose level of stderror must be equal to or greater than the verbose level of syslog. Otherwise, Spectrum Archive sets the verbose level of syslog to the verbose level of stderror automatically (default: 2).

Possible verbose level values are 1, 2, or 3:

1: Warning only
2: Info
3: Debug

For example, setting verbose=303 enables diagnostic output to stderr and syslog.

-V, --version

Output version information and exit.

FUSE options (Linux only)

-o gid=N: Set file group.
-o noforget: Option for FUSE to support NFS.
-o uid=N: Set the file owner.
-o umask=M: Set file permissions (octal).

Spectrum Archive Library Edition library options

-o library_cache: Use and create caches from the medium auxiliary memory (MAM), index, and labels (default).
-o nolibrary_cache: Disable the use and creation of caches from the MAM, index, and labels.
-o volser_only_folder: Exclude volume name from the top-level folder name.
-o novolser_only_folder: Include volume name in the top-level folder name (default).
-o run_inventory: Run a full inventory to create the Spectrum Archive Library Edition namespace.
Note: Some time is required to complete this command.

Spectrum Archive Library Edition administration interface option

-o admin_port=<num>: TCP/IP port on which to listen for connections (default: 7600).

Mounting Spectrum Archive Library Edition by a user other than root (Linux only)

To mount Spectrum Archive Library Edition by a normal user, check for the following conditions:

The user has write permission for the work directory (default: /var/lib/ltfs).
The user has write permission for the mount point.
The file mode /usr/bin/fusermount is set to chmod 4755.

Mounting Spectrum Archive Library Edition to have another user access the file system (Linux only)

Use the ltfs command to mount the tape library to the file system to allow a user other than the normal user access to it. For more information, see Mounting a library on a Linux system.

Note: Each cartridge in the library is inventoried and accessible as part of the file system as a subdirectory under the root mount point.

Mounting a library by using the ltfs or ltfs.exe command

Command options for ltfs or ltfs.exe