HP StorageWorks File Migration Agent V2.1 administrator guide (T4274-96105, October 2006)

72 Operating
Synopsis
Description
The ACTIVATE command sets the file ID in the metadata to fit the current ID of the file. This function needs
to be called whenever the file ID of the file changes. This function is usually required after a restore of
metadata.
Possible use of the ACTIVATE command is after a restore with a third-party backup software or to move
FMA metadata from one computer to another.
Do not try to activate files that have an unknown status.
The ACTIVATE command with the option --off is used for disabling files. This function is required when
files need to be relocated on FMA managed volumes.
Disabling files ensures that no entry is written to FMA’s garbage collection container when files are
deleted. As a result, the corresponding archive copy will not be deleted during an FMA cleanup run.
Recall operations are rejected on “disabled” files.
Options
FMACLI Act[ivate] [--help | -h]
[{--logfile | -L} <logfile>
[--log-info-messages | -V]]
[--verbose | -v]
[<file>] | [{--filelist] | -f} <filelist>]
[{--recursive | -r} <path>]
[--oem-file-format | --unicode-file-format |
--ansi-file-format | --utf8-file-format]
[{--minimum-file-size | -S} <n>b|k|m|g]
[{--minimum-access-time | -A} <n>d|h|m|s]
[{--minimum-write-time | -W} <n>d|h|m|s]
[--exclude-system]
[--exclude-hidden]
[--exclude-read-only]
[--exclude-archive]
[--exclude-compressed]
[--off]
[-F <outlist>]
Table 14 ACTIVATE command options
Options Description
--help Displays the online help for the ACTIVATE command.
-h
--logfile <logfile> Specifies a log file.
The log file must be specified with a fully qualified path. Log files are
created with the following (fixed) policies:
• Maximum size is 4 MB. If the files grows bigger than 4 MB, the file
is switched.
• Old log files are named as logfile.nnn, where the lowest
number contains the youngest file:
logfile.log -> logfile.000 -> logfile.001 -> ...
-L <logfile>
--log-info-message Write informational messages to log file. This option is meaningful only
in combination with the -L / --logfile option.
(Default: only errors are written to log)
-V