6.5 HP StoreAll OS CLI Reference Guide

ibrix_reten_adm
The ibrix_reten_adm command does the following:
• Manages retained and WORM files in a file system or directory enabled for data retention.
• Enables data retention features for file systems created with StoreAll version 6.0 or earlier.
IMPORTANT: Do not use the ibrix_reten_adm command on a post-6.1.1 file system that is
not enabled for data retention, except in the case of upgrading a pre-6.1.1 file system as described
in Upgrade a pre–6.1.1 file system for data retention features: (page 177).
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 created with StoreAll version 6.0 or earlier to enable data retention
features.
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 /ibrixFS/mydir -type d -exec ibrix_reten_adm -h -f ibrixFS -P {}/*
\;
176 StoreAll commands