User's Manual

HP StorageWorks File System Extender Software user guide 163
• Due to an underlying omniORB/CORBA limitation, the upper limit on the number of entries in the file
list (set of files to be recalled) is 26000.
Efficient recall invocation
The fsefile command provides options that are used to efficiently recall sets of files from FSE media.
fsefile reads list of files to be recalled either from the file specified on the command line or from
standard input. Each entry should be specified on its own line, and can include path relative to the mount
point directory of the HSM file system.
You need to use the following command line to trigger an efficient recall of set of files:
Notes
• If you omit the option InputFile, fsefile reads the list of files for recall from standard input.
• If you specify the option --utf8, fsefile treats the file list to be in the UTF-8 format instead of
plain ASCII (more specifically, the codeset of the terminal where it is run).
You can also pipe the output of another command to fsefile. Note that in this case, the file list can only
be in plain ASCII format:
TIP: For a smaller set of files efficient recall can also be triggered using the command
fsefile --recall FileName..., where FileName... is a list of filenames, separated by spaces.
For more information on the fsefile command, see the FSE CLI reference.
Logging file recalls
Successfully recalled files are logged into the HSM file system log file, hsmfs_PartitionName.log.
Example excerpt from the HSM file system log file
From this excerpt, the following information can be acquired:
• The recall process for a local HSM file system has successfully recalled four files: 512MBa, 512MBb,
512MBc, and 512MBd.
• The file 512MBc was migrated in three chunks, therefore three recall jobs needed to be created for
recalling it. Their job IDs were 20050830000005, 20050829000006, and 20050830000051.
Files that failed to be recalled are logged into the FSE error log file, error.log, with a single failure
indicator in the FSE event log file, fse.log.
fsefile --recall --if [InputFile] [--utf8]
Command | fsefile --recall --if
[2005/08/29 13:41:37, 0xc98bf7a90000000c, 2, 0, "512MBa"] Recalled. (
20050829000002, 0, 536870912 ).
[2005/08/29 15:36:46, 0xc98bf7aa0000000d, 3, 0, "512MBb"] Recalled. (
20050829000006, 0, 505282127 ), ( 20050829000006, 505282127, 31588785 ).
[2005/08/30 09:52:04, 0xc98bf7aa0000000d, 3, 0, "512MBb"] Recalled. (
20050830000005, 0, 413007439 ), ( 20050830000005, 413007439, 123863473 ).
[2005/08/30 12:57:09, 0xc98bf7aa0000000d, 3, 0, "512MBb"] Recalled. (
20050830000051, 0, 406421071 ), ( 20050830000051, 406421071, 6586368 ), (
20050830000051, 413007439, 123863473 ).
[2005/09/02 13:18:03, 0xc98bf7ab0000000e, 4, 0, "512MBc"] Recalled. (
20050902000005, 0, 536870912 ).
[2005/09/02 13:18:38, 0xc98bf7ac0000000f, 5, 0, "512MBd"] Recalled. (
20050902000005, 0, 473693775 ), ( 20050902000005, 473693775, 63177137 ).