samunhold - Releases SANergy file holds
The samunhold command can be used to release SANergy file
holds. These holds can be detected when attempts are made
to unmount a file system with the umount(1M) command. If
holds are present, the umount(1M) command generates log
messages such as the following:
Inode XXXX: held by SAN, refcnt = N
SANergy File Sharing uses the following two types of leases,
both of which require holds:
o Read leases, which typically expire within a few seconds.
o Write leases, which can extend for as long as an hour.
It is preferable to allow SANergy File Sharing to clean up
the leases, but in an emergency, or in case of a SANergy
File Sharing system failure, the administrator can use the
samunhold command to avoid a reboot.
The samunhold command should only be run when SANergy File
Sharing has held inodes and is preventing a file system from
being unmounted. Prior to executing this command, the
administrator should ensure the following:
o There are no SANergy applications running on any client,
possibly including the server itself.
o The file system in question is not fused on any SANergy
o The file system is not NFS mounted.
The samunhold command releases all held inodes (files) on
the file system whose root directory is the named mntpoint
argument. The samunhold command must be run as root.
The following example shows the samunhold command:
bilbo# samunhold /sam1
bilbo# umount /sam1