6.5 HP StoreAll OS CLI Reference Guide

Restrictions for rename options
For file systems that were created in a release earlier than 6.0 but have not been upgraded, StoreAll
software can preserve all name space data in snapshots but cannot preserve file data for objects
(files). To help prevent “hybrid snap trees,” in which a snap tree contains objects with the old
format, restrictions have been implemented on rename operations. The following restrictions apply
to hybrid file systems:
• Only directories created in version 6.0 or later can become snap tree roots.
• If the old directory is not in a snap tree and the new directory is in a snap tree, rename is
allowed only if the object being renamed is snapable (that is, it has the new inode format).
The following restrictions apply to both hybrid file systems and pure 6.x file systems:
• A snap tree root cannot be renamed. Also, the path to a snap tree root cannot be changed.
• Rename is allowed when neither the old directory or the new directory are in snap trees.
• Rename is allowed when the old directory and the new directory are in the same snap tree.
Rename is not allowed when the directories are in different snap trees.
These restrictions are intended to prevent hybrid snap trees containing files with the old format.
However, hybrid snap trees can still occur when a directory having the new format is populated,
using rename, with old format objects and that directory is then made into a snap tree root or is
renamed into a snap tree. The StoreAll software does not prevent this situation because it could
take a prohibitively long amount of time to perform a complete scan for old objects in the sub tree
being moved if the new sub tree was sufficiently large.
Options
DescriptionOption
Specifies a path to one or more files. The path can be either absolute or relative to the mountpoint
of the file system.
-P
Removes the retention time for one or more files.-c
Deletes retained files.-d
Resets the expiration time for retained files.-e expire_time
Specifies a file system.-fFSNAME
Sets a legal hold on retained or WORM files.-h
Lists retention attributes for files.-l
Removes a legal hold on retained or WORM files.-r
Upgrades a mounted file system created with StoreAll version 6.0 or earlier to enable data
retention features.
-u
Shows the usage for this command.-?
178 StoreAll commands