User Guide
Overview and Installation
Understanding how persistent memory works is helpful when getting started with MemVerge Memory Machine. You can then install Memory Machine on a server and begin monitoring memory usage and capturing application snapshots.
Introduction to MemVerge Memory Machine
MemVerge Memory Machine (Memory Machine) enables applications to expand from volatile memory (DRAM) into persistent memory (PMem).
Getting Started with Memory Machine
You run Memory Machine on a host equipped with one or more PMem devices.
Using the Memory Machine Management Center
Memory Machine Management Center (M3C) is a web UI application available on the host that is running the Memory Machine Management Service. You can view system resources and performance metrics; create and restore snapshots; schedule jobs; and more in M3C.
Getting Familiar with the Memory Machine Management Center
Memory Machine Management Center (M3C) is a web-based user interface (UI) from which an administrator can view memory and processor statistics and capture and restore application snapshots on any number of servers under management by Memory Machine.
Managing Hosts
Use the Hosts Console to manage hosts and to view statistics about application instances, memory performance, and snapshots on individual hosts and host groups.
Managing Applications
You can view application instances from the Applications Console. Application instances must be started and stopped using the command line.
Using Snapshots in Memory Machine Management Center
Use ZeroIO Snapshot from Memory Machine Management Center to capture the state of a running process. You can then stop the process and restore it to the running state captured in the snapshot.
Viewing Metrics and System Status
The Memory Machine Management Center makes it easy to view and compare running processes, snapshots, system resources and performance metrics.
Using the Command Line Tools
You can administer and use MemVerge Memory Machine using a Command Line Interface (CLI).
Using the Memory Machine Command Line Tool
You can administer and use Memory Machine using the mvmcli command line tool on any data host.
Memory Machine Administration
MemVerge Memory Machine can be installed and run using CLI commands. Many administrative tasks can be performed using the Memory Machine Management Center web interface.
Upgrading Memory Machine
To upgrade Memory Machine, run the Memory Machine Package File on each host using the --upgrade option.
Upgrading Application Dependencies
Upgrading dependency packages for snapshotted applications may render existing snapshots of that application unrestorable.
Understanding the Memory Machine Database
Memory Machine Memory Machine Management Center (M3C) uses a database to store information about preferences, statistics, and configurations. You must choose a database system for M3C to use.
Understanding the Memory Machine Software License
You must have a valid license to run Memory Machine. The license file is read at startup by the MemVerge Memory Allocation Service (MVMAS). Without a license, MVMAS defaults to running applications using only DRAM.
Running Memory Machine Services
Memory Machine data services must be running to enable PMem management, snapshot operations, and connection to the Memory Machine Management Center (M3C).
Using the MemVerge Memory Allocation Service
The MemVerge Memory Allocation Service (MVMAS), mvmallocd, is a service that maps programmatic memory to PMem. See oxy_ex-3/topics/a_mvmm_dpme_intro.html.
Resetting a Host
Reset a host by removing all snapshot and log data and initializing the DAX devices. This erases the host's PMem.
Reporting Tiering Statistics
Use the mvmcli command to view information about paging activity between PMem and the DRAM performance tier for an application.
Viewing Logs
Examine the Memory Machine log files to troubleshoot errors – for example, to determine why a license didn't load.
Managing Application Memory
To manage application memory with Memory Machine, you run the application on a data host in an environment with Transparent Memory Service (TMS) and MemVerge Memory Allocation Service (MVMAS).
Preparing Intel® Optane™ Persistent Memory
Prepare PMem for use by configuring the Intel Optane Persistent Memory Direct Access (DAX) devices in AppDirect mode.
Preparing to Run an Application
Normally you run applications by using the mm wrapper script supplied with Memory Machine. See oxy_ex-3/topics/t_mvmm_running_an_application_with_mvmm.html. If you do not use the mm to run your application, you must set up the Memory Machine environment manually before running the application.
Working with Applications
MemVerge provides additional instructions for some popular applications supported by Memory Machine, either to assist with complex setup or to support additional functionality.
Working with Hazelcast Clusters
Using MemVerge Memory Machine, you can manage the hosts of a Hazelcast cluster, capture snapshots of the cluster, and restore snapshotted clusters.
Working with KVM in Memory Machine
Running KVMs in Memory Machine requires extra setup and configuration.