Man Linux
rpmemd current master
rpmemd version 1.3
rpmemd version 1.2
rpmemd version 1.1

rpmemd - NVML man page

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
CONFIGURATION FILES
EXAMPLE
DEFAULT CONFIGURATION
PERSISTENCY METHODS
SEE ALSO

NAME

rpmemd – librpmem target node process (EXPERIMENTAL)

SYNOPSIS

$ rpmemd [--help] [--version] [<args>]

DESCRIPTION

The rpmemd process is executed on target node by librpmem library over ssh(1) and facilitates access to persistent memory over RDMA. The rpmemd should not be run manually under normal conditions.

OPTIONS

Command line options overwrite the default rpmemd configuration, the global configuration file and the user configuration file.

-V, --version

Displays rpmemd version and exits.

-h, --help

Prints synopsis and list of parameters and exits.

-c, --config <path>

Custom configuration file location. If the custom configuration file is provided others are omitted. See CONFIGURATION FILES section for details.

All options described in CONFIGURATION FILES section are common for both the configuration file and the command line - the equivalent of the following line in the config file:

option = value

is

--option value

in the command line.

The following command line options: –persist-apm, –persist-general and –use-syslog should not be followed by any value. Presence of each of them in the command line turns on an appropriate option. See CONFIGURATION FILES section for details.

-r, --remove <poolset>

Remove a pool described by given pool set file descriptor. It is interpreted as a path to the pool set file relative to the pool set directory.

-f, --force

Ignore errors when removing a pool file using –remove option.

CONFIGURATION FILES

The rpmemd searches for the configuration files with following priorities:

The rpmemd can also read configuration from the custom configuration file provided using –config command line option. See OPTIONS section for details.

The default configuration is described in the DEFAULT CONFIGURATION section.

The configuration file is a plain text file. Each line of the configuration file can store only one configuration option defined as a key=value pair. Empty lines and lines starting with # are omitted.

The allowed options are:

The $HOME sub-string in the poolset-dir path is replaced with the current user home directory.

EXAMPLE

Example of the configuration file:

# This is an example of configuration file
log-file = $HOME/.logs/rpmemd.log
poolset-dir = $HOME/poolsets/
persist-apm = yes
persist-general = no
use-syslog = no # Use log file instead of syslog
log-level = info

DEFAULT CONFIGURATION

The rpmemd default configuration is equivalent of the following configuration file:

log-file = /var/log/rpmemd.log
poolset-dir = $HOME
persist-apm = no
persist-general = yes
use-syslog = yes
log-level = err

PERSISTENCY METHODS

The librpmem supports two methods for making data written to remote persistent memory durable. The difference between the use of the two mechanisms is based on whether librpmem will make use of non-allocating writes on the remote node.

“Non-allocating write requests” is the Intel Integrated IO Controller mode where all incoming PCIe writes will utilize non-allocating buffers for the write requests. Non-allocating writes are guaranteed to bypass all of the CPU caches and force the write requests to flow directly to the Integrated Memory Controller without delay.

The rpmemd dynamically choose the appropriate persistency method and the flushing to persistence primitive for GPSPM for each opened pool set name depending on available persistency methods and whether all pool set parts are stored in the persistent memory.

If the Appliance Persistency Method is enabled and the pool set is stored in the persistent memory rpmemd will use the Appliance Persistency Method. If the pool set is NOT stored in the persistent memory it will fallback to the General Puropose Server Persistency Method with pmem_msync().

If the General Puropose Server Persistency Method is enabled and the pool set is stored in the persistent momory rpmemd will use pmem_persist(). If the pool set is NOT stored in the persistent momory it will use pmem_msync().

See libpmem(3) for details about pmem_persist() and pmem_msync().

SEE ALSO

librpmem(3), libpmem(3), libpmemobj(3) and http://pmem.io