gfrep -H hostfile [-vm] gfarm-URL...
gfrep -P host-pair-file [-vm] gfarm-URL...
gfrep -d destination-node [-s source-node] [-I file-section] [-vm] gfarm-URL...
gfrep [-D destination-domainname] [-S source-domainname | -s source-node] [-N num-of-replicas] [-v] gfarm-URL...
gfrep creates replicas of Gfarm files specified by the Gfarm-URL.
If the Gfarm-URL parameter is a directory, it will be copied recursively.
-D destination-domainnameSpecifies the domain name of destination filesystem nodes to which
replicas will be copied.
This option is used alone, or with the -S
or -s option.
If neither this nor the -d option is specified,
replicas may be copied to any of the hosts registered in the metadata.
Please refer to the description of the -N option for details.
-d destination-nodeSpecifies one destination filesystem node where replicas
will be copied.
This option is used alone, or with the -s
option.
If neither this nor the -D option is specified,
replicas may be copied to any of the hosts registered in the metadata.
-H hostfileSpecifies a file which describes hostnames of destination filesystem nodes on which the replica will be made. The hostfile consists of a filesystem node name on each line. If the number of nodes listed in the hostfile is less than the total number of file fragments, it is treated as if the node names are specified repeatedly.
if ``-'' is specified, standard input is used to read the host list.
-I file-sectionSpecifies a file section name to be copied.
Currently, this option can be specified only with the -d
option.
It is possible to omit this option.
-mLets gfrep command do a migrate/move, instead of doing replication. Currently, this works only with the -H, -P and -d options.
-N num-of-replicasSpecifies the required number of file replicas, counting already
existing ones.
If there are a sufficient number of replicas in the destination nodes,
neither any copying nor any removal will be done.
This option is used alone, or with the -D,
-S or -s option.
If this option is not specified, -N 1 is assumed.
The source nodes specified by the -S
or -s option are excluded from the destination nodes.
In other words, it's guaranteed that the number of replicas on
hosts, except those specified by the -S or -s
option, are the same or more than the number specified by the
-N option.
However, when the destination is a subset of the source,
i.e. when the exclusion makes the destination an empty set,
this exclusion is not applied.
For example, if gfrep is executed with the
``-N 3 -S subdomain.example.org -D example.org'' option,
it's guaranteed that there are at least 3 replicas in the hosts belonging
to example.org, excepting subdomain.example.org.
-P host-pair-fileSpecifies a file which describes hostname pairs of source nodes and destination nodes. The host-pair-file consists of a pair of a source node name and a destination node name in this order on each line. The replica will be copied to the destination node, only if it exists on the source node of the pair.
-S source-domainnameSpecifies the domain name of source filesystem nodes where replicas
will be copied from.
This option is used alone, or with the -D
option.
If neither this nor the -s option is specified,
the source nodes will be selected from all nodes.
The hosts specified by this option will be excluded from
the destination nodes.
Please refer to the description of the -N option for details.
-s source-nodeSpecifies a source filesystem node where replicas
will be copied from.
This option is used alone, or with the -D
or -d option.
If neither this nor the -s option is specified,
the source nodes will be selected from all nodes.
The host specified by this option will be excluded from
the destination nodes.
Please refer to the description of the -N option for details.
-vDisplays verbose output.
-?Displays a list of command options.