6.1 HP IBRIX X9000 Network Storage System CLI Reference (TA768-96057, June 2012)
ibrix_reten_adm
Manages retained and WORM files in a file system or directory enabled for data retention.
IMPORTANT: Do not use the ibrix_reten_adm command on a file system that is not enabled
for data retention.
Description
Use the ibrix_reten_adm command to manipulate WORM and retained files. You can perform
the following tasks:
• Add or remove a legal hold on a WORM or retained file. While the hold is in effect, the file
cannot be deleted, even if the expiration period has expired.
• Reset the expiration time for a file, in effect increasing or decreasing the expiration period.
• Remove the retention period for retained files.
• Delete retained files administratively, regardless of whether the retention period has expired.
• List the retention attributes for files in the file system.
• Upgrade a file system to enable autocommit.
NOTE: A file system or directory enabled for data retention can contain normal files. These files
are created read-only or read-write, and can be modified or deleted at any time. A checksum is
not calculated for normal files and they are not managed by data retention.
Specifying path lists
In the commands, the -P PATHLIST option specifies the files that are to be affected by the
command. The following rules apply when specifying path lists:
• A path list can contain one or more entries, separated by commas.
• Each entry can be a fully-qualified path, such as /myfs1/here/a.txt. An entry can also
be relative to the file system mount point. For example, if myfs1 is mounted at /myfs1, the
path here/a.txt is a valid entry.
• A relative path cannot begin with a slash (/). Relative paths are always relative to the mount
point; they cannot be relative to the user’s current directory, unlike other UNIX commands.
• A directory cannot be specified in a path list. Directories themselves have no retention settings,
and the command returns an error message if a directory is entered.
To apply an action to all files in a directory, you need to specify the paths to the files. You can use
wildcards in the pathnames, such as /my/path/*,/my/path/.??*. The command does not
apply the action recursively; you need to enter subdirectories.
To apply a command to all files in all subdirectories of the tree, you can wrap the
ibrix_reten_adm command in a find script (or other similar script) that calls the command
for every directory in the tree. For example, the following command sets a legal hold on all files
in the specified directory:
find /myfs1/here/usr_local_src/matplotlib-1.0.0/agg24 -type d -exec
ibrix_reten_adm -h -f myfs1 -P {}/* \;
The following script includes files beginning with a dot, such as .this. (This includes file uploaded
to the file system, not file system files such as the .archiving tree.)
find /myfs1/here/usr_local_src/matplotlib-1.0.0/agg24 -type d -exec
ibrix_reten_adm -h -f myfs1 -P {}/*,{}/.??* \;
ibrix_reten_adm 125