NAME

samltfs - Manages Linear Tape File System media

SYNOPSIS

samltfs subcommand media [ … ]

AVAILABILITY

SUNWsamfs

DESCRIPTION

The Oracle HSM samltfs command provides a means to access the contents and manage Linear Tape File System (LTFS) media.

SUBCOMMANDS

attach LTFS_media target_directory

A copy of all the file system meta-data for the specified LTFS media is attached, i.e., mapped, into the specified directory. The directory must be empty and reside on an Oracle HSM file system. The files created in the file system that are associated with a corresponding file residing on the LTFS media. The contents of the media source files are not copied to the target file system. Rather, they are staged from the source to the target as needed.

To attach the LTO tape ISR104 to an Oracle HSM filesystem mounted on ∕samfs1, the following commands would be used:

      mkdir ∕samfs1∕dir1
      chmed -l li.ISR104
      chmed +NL li.ISR104
      samltfs attach li.ISR104 ∕samfs1∕dir1

ingest LTFS_media target_directory

The ingest command is similar to the attach command. It attaches all of the files in the specified LTFS media to an empty directory residing on an Oracle HSM file system. However, after the contents of the LTFS media are attached, the contents of those files is immediately scheduled to be staged onto the Oracle HSM file system.

To ingest the LTO tape ISR107 to an Oracle HSM filesystem mounted on ∕samfs1, the following commands would be used:

mkdir ∕samfs1∕dir2
      chmed -l li.ISR107
      chmed +NL li.ISR107
      samltfs ingest li.ISR107 ∕samfs1∕dir2

load LTFS_media

This subcommand is used to have Oracle HSM load the specified LTFS media on a drive and mount its contents as a file system. The customer accesses the file system using the LTFS mount point suppiled in defaults.conf file.

While the load subcommand can be used to examine the contents LTFS media, it is more efficient tape drive utilization to use the attach subcommand to copy the media's meta-data to a scratch Oracle HSM file system. The media's meta-data can then be examined, moved, or deleted as needed without utilizing a tape drive.

unload LTFS_media

The file system for the specified LTFS media is unmounted from the operating system and the media is unloaded from the drive and returned to the library.

mkltfs LTFS_media

The mkltfs subcommand is used to format a volume for use with LTFS. It loads the specified LTFS media on to drive and uses the LTFS command with the same name to partition the volume and write the file system meta-data.

To mark LTO tape SQL519 as LTFS media, the following commands would be used:

chmed -l li.SQL519
      chmed +N li.SQL519
      samltfs mkltfs li.SQL519

unltfs LTFS_media

If at some time the specified media is to be used for a different purpose, the unltfs subcommand can be used. It requests that Oracle HSM mount the media in a drive and then executes the LTFS utility with the same name. The utility erases the media's meta-data and removes the partitions. The customer is issued a prompt to confirm the actions.

To change Titanium LTFS tape SQT203 to Oracle HSM usage, execute the following:

samltfs unltfs ti.SQT203
      chmed -N ti.SQT203
      tplabel -vsn SQT203 -new ti.SQT203

ltfsck LTFS_media

Everytime LTFS media is mounted onto the system, a consistency check is performed. If problems with the media are suspected, this subcommand can be used to check the media and return it to a consistent state. It uses the LTFS media with the same name. The command is executed without any options. If additional options are needed, the media should be loaded into an unavailable drive and execute the command with the necessary options.

status

Show the LTFS configuration and status information.

OPTIONS

Except for the status command, all samltfs subcommands require the first position parameter specify the LTFS media. LTFS media is identified by a tuple consisting of the Oracle HSM media type and the volume's serial number joined a dot (.). For example, a LTO volume with a serial number of SQL519 would be specified as li.SQL519.

As discussed in ltfs (7), LTFS media is indicated in the catalog by the following attributes: the media is unlabeled, it is marked as both non-SAM, and ltfs. The LTFS media for samltfs subcommands must match these attributes. The mkltfs subcommand does not require the ltfs attribute to be set and will set it after the media is formatted. Likewise, the unltfs subcommand will clear the ltfs attribute after the file system meta-data has been removed.

FILES

∕etc∕opt∕SUNWsamfs∕defaults.conf: Contains the LTFS configuration.
∕var∕tmp∕samltfs∕mtype.vsn.log: Contains the LTFS program output.