1PMEMPOOL-SYNC(1)           PMDK Programmer's Manual           PMEMPOOL-SYNC(1)
2
3
4

NAME

6       pmempool-sync -- Synchronize replicas or their parts within a pool set.
7

SYNOPSIS

9              pmempool sync [options] <poolset_file>
10
11       NOTE: Only the pool set file used to create the pool should be used for
12       syncing the pool.
13

DESCRIPTION

15       The pmempool sync command synchronizes data between replicas  within  a
16       pool set.  It checks if metadata of all replicas in a pool set are con‐
17       sistent, i.e.  all parts are healthy, and if any of them  is  not,  the
18       corrupted  or missing parts are recreated and filled with data from one
19       of the healthy replicas.  Currently synchronizing data is allowed  only
20       for pmemobj pools (see libpmemobj(7)).
21
22       If  a  pool  set  has  the option SINGLEHDR or NOHDRS (see poolset(5)),
23       pmempool sync command has limited capability of checking its  metadata.
24       This  is  due  to limited or no, respectively, internal metadata at the
25       beginning of pool set parts in every replica when either of the options
26       is used.  In that cases, only missing parts or the ones which cannot be
27       opened are recreated.
28
29   Available options:
30       -d, --dry-run
31              Enable dry run mode.  In this mode no changes are applied,  only
32              check for viability of synchronization.
33
34       -v, --verbose
35              Increase verbosity level.
36
37       -h, --help
38              Display help message and exit.
39

SEE ALSO

41       pmempool(1),    libpmemblk(7),    libpmemlog(7),   libpmempool(7)   and
42       <http://pmem.io>
43
44
45
46PMDK - pmem Tools version 1.3     2018-03-13                  PMEMPOOL-SYNC(1)
Impressum