Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

vfs_tsmsm (8)

Name

vfs_tsmsm - VFS module for handling offline files with Tivoli Storage Manager Space Management

Synopsis

vfs objects = tsmsm

Description

System Administration tools                                       VFS_TSMSM(8)



NAME
       vfs_tsmsm - VFS module for handling offline files with Tivoli Storage
       Manager Space Management

SYNOPSIS
       vfs objects = tsmsm

DESCRIPTION
       This VFS module is part of the samba(7) suite.

       The tsmsm VFS module is an extension for handling offline files with
       Tivoli Storage Manager Space Management.

       It tries to avoid calling expensive DMAPI calls with some heuristics
       based on the fact that number of blocks reported of a file multiplied
       by 512 will be bigger than 'online ratio' of actual size for online
       (non-migrated) files. If heuristic check fails, the module calls DMAPI
       and asks for a specific attribute which is present for offline
       (migrated) files. If this attribute presents, the file is considered
       offline.

       This module is not stackable.

OPTIONS
       tsmsm:hsm script = [ path to hsm script ]
           hsm script should point to a shell script which accepts two
           arguments: operation and filepath. the tsmsm module only uses
           "offline" for operation to set the file under filepath offline.

       tsmsm:online ratio = [ number ]
           Ratio to check reported size against actual file size. The default
           value is 0.5.

       tsmsm:dmapi attribute = [ attribute-name ]
           Name of a DMAPI attribute that is present when a file is offline.
           The default is "IBMobj" (which is what GPFS uses).

       tsmsm:dmapi value = [ value for the DMAPI attribute ]
           Value that the DMAPI attribute should have for the file to be
           considered offline. The default is empty (no value required).

EXAMPLES
       A GPFS mount with TSM support can be exported via Samba as follows:

                   [gpfs_tsm_share]
                vfs objects = tsmsm gpfs
                path = /test/gpfs_mount

VERSION
       This man page is part of version 4.9.3 of the Samba suite.

AUTHOR
       The original Samba software and related utilities were created by
       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
       Source project similar to the way the Linux kernel is developed.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | service/network/samba |
       +---------------+-----------------------+
       |Stability      | Volatile              |
       +---------------+-----------------------+
NOTES
       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       https://download.samba.org/pub/samba/stable/samba-4.9.3.tar.gz

       Further information about this software can be found on the open source
       community website at http://www.samba.org/.



Samba 4.9.3                       01/24/2019                      VFS_TSMSM(8)