pmdk-convert man page

pmdk-convert — upgrade pool files layout version

Synopsis

$ pmdk-convert <file>

Description

The pmdk-convert performs a conversion of the specified pool to the newest layout supported by this tool. Currently only libpmemobj(7) pools are supported.

The conversion process is not fail-safe - power interruption may damage the pool. It is advised to have a backup of the pool before conversion.

This tool doesn't support remote replicas. Before a conversion all remote replicas have to be removed from the pool by pmempool transform command.

Options

-V, --version

Display version information and exit.

-h, --help

Display help and the list of supported layouts and corresponding PMDK versions.

-f, --from=pmdk-version

Convert from specified PMDK version. This option is exclusive with -F option.

-F, --from-layout=version

Convert from specified layout version. This option is exclusive with -f option.

-t, --to=version

convert to specified PMDK version. This option is exclusive with -T option.

-T, --to-layout=version

Convert to specified layout version. This option is exclusive with -t option.

-X, --force-yes=[question] reply positively to specified question possible questions: - fail-safety - 1.2-pmemmutex

Example

$ pmempool convert pool.obj

Updates pool.obj to the latest layout version.

$ pmempool convert pool.obj --from=1.2 --to=1.4

Updates pool.obj from PMDK 1.2 to PMDK 1.4

See Also

pmempool(1), libpmemblk(7), libpmemlog(7), libpmemobj(7), libpmempool(7) and <http://pmem.io>

Referenced By

pmempool-convert(1).

2019-01-30 PMDK - pmem Tools version 1.5 PMDK Programmer's Manual