NAME
SYNOPSIS
DESCRIPTION
EXAMPLES
SEE ALSO
pmempool-transform - Modify internal structure of a pool set.
pmempool transform [options] <poolset_file_src> <poolset_file_dst>
NOTICE: The libpmemblk and libpmemlog libraries are deprecated since PMDK 1.13.0 release.
The pmempool transform command modifies internal structure of a pool set
defined by the poolset_file_src
file, according to a structure described in
the poolset_file_dst
file.
The following operations are supported:
adding replicas - one or more new replicas can be added and synchronized with other replicas in the pool set,
removing replicas - one or more replicas can be removed from the pool set ,
adding or removing pool set options.
Only one of the above operations can be performed at a time.
Currently adding and removing replicas are allowed only for pmemobj pools (see libpmemobj(7)).
The poolset_file_src argument provides the source pool set to be changed.
The poolset_file_dst argument points to the target pool set.
-d, --dry-run
Enable dry run mode. In this mode no changes are applied, only check for viability of the operation is performed.
-v, --verbose
Increase verbosity level.
-h, --help
Display help message and exit.
Let files /path/poolset_file_src
and /path/poolset_file_dst
have the
following contents:
PMEMPOOLSET
20M /0/partfile1
20M /0/partfile2
25M /0/partfile3
REPLICA
40M /1/partfile1
20M /1/partfile2
PMEMPOOLSET
20M /0/partfile1
20M /0/partfile2
25M /0/partfile3
REPLICA
40M /1/partfile1
20M /1/partfile2
REPLICA
50M /2/partfile1
20M /2/partfile2
Then, the command
pmempool transform /path/poolset_file_src /path/poolset_file_dst
adds a replica to the pool set. All other replicas remain unchanged and the size of the pool remains 60M.
Let files /path/poolset_file_src
and /path/poolset_file_dst
have the
following contents:
PMEMPOOLSET
20M /0/partfile1
20M /0/partfile2
25M /0/partfile3
REPLICA
40M /1/partfile1
20M /1/partfile2
PMEMPOOLSET
20M /0/partfile1
20M /0/partfile2
25M /0/partfile3
Then
pmempool_transform /path/poolset_file_src /path/poolset_file_dst
deletes the second replica from the pool set. The first replica remains unchanged and the size of the pool is still 60M.
pmempool(1), libpmemblk(7), libpmemlog(7), libpmempool(7) and https://pmem.io
The contents of this web site and the associated GitHub repositories are BSD-licensed open source.