Home
Using the Command Line Interface
You can administer and use MemVerge Memory Machine using the Command Line Interface (CLI) on any installed host.
MemVerge Memory Machine Administration
MemVerge Memory Machine can be installed and run using CLI commands.
Understanding the Software License
You must have a valid license to run Memory Machine. The license file is read at startup by the Distributed Persistent Memory Engine (DPME). Without a license, DPME defaults to running applications using only DRAM.

Overview and Installation
Getting started with MemVerge Memory Machine requries that you understand some background information about how persistent memory works. You can then install Memory Machine on a server and begin monitoring memory usage and capturing application snapshots.
Using the Memory Machine Dashboard
You can view system resources and performance metrics, and create and restore snapshots in MemVerge Memory Machine using the Memory Machine Dashboard, a web UI application running on one of the installed hosts.
Using the Command Line Interface
You can administer and use MemVerge Memory Machine using the Command Line Interface (CLI) on any installed host.
- MemVerge Memory Machine Administration
  MemVerge Memory Machine can be installed and run using CLI commands.
  - Upgrading Memory Machine
    To upgrade Memory Machine, run the Memory Machine Package File on each host.
  - Uninstalling the MemVerge Memory Machine Data Service
    Uninstall the Memory Machine data service by running the Memory Machine uninstall script, uninstall.sh.
  - Upgrading Application Dependencies
    Upgrading dependency packages for snapshotted applications may render existing snapshots of that application unrestorable.
  - Understanding the Software License
    You must have a valid license to run Memory Machine. The license file is read at startup by the Distributed Persistent Memory Engine (DPME). Without a license, DPME defaults to running applications using only DRAM.
    - License Monitoring
      Memory Machine generates a usage report on the first of every month.
    - Checking the License
      Use the mvmcli show-usage command to check the status of the software license.
    - Memory Machine Call Home
      Memory Machine includes Call Home functionality, which securely sends usage data to MemVerge for billing and support purposes.
  - Running Memory Machine Services
    Four Memory Machine services must be running to enable PMEM management and the Memory Machine Dashboard.
  - Distributed Persistent Memory Engine
    The Distributed Persistent Memory Engine (DPME), mvmallocd, is a service that maps programmatic memory to PMEM. See oxy_ex-3/topics/a_mvmm_dpme_intro.html.
  - Running an Application in Memory Machine
    To run an application with Memory Machine memory management, use the mm script supplied with Memory Machine.
  - Using the Memory Machine Command Line Tool
    Memory Machine provides a command line tool, mvmcli, to show PMEM usage, set DRAM tier levels, manage snapshots, and manage data clusters.
  - 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
    You can examine the Memory Machine log files, for example to troubleshoot errors.
- Using Snapshots in the Memory Machine CLI
  Use the mvmcli command from the CLI on a Memory Machine host to capture the state of a running process, then later restore the running process to the state captured in the snapshot.
- Troubleshooting
- Preparing Intel Optane DC PMEM
  Prepare PMEM for use by configuring the Intel Optane DC Direct Access (DAX) devices in AppDirect 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.

Understanding the Software License

You must have a valid license to run Memory Machine. The license file is read at startup by the Distributed Persistent Memory Engine (DPME). Without a license, DPME defaults to running applications using only DRAM.

The monthly license fee is based on the maximum amount of memory under management of Memory Machine. The software counts both persistent (PMEM) and volatile memory (DRAM used as tier memory) to determine the memory under management.

Memory Machine uses one of three types of license, depending on which version of Memory Machine you are using:

On-Demand License: A multi-host "pay for what you use" license for Memory Machine Advanced Edition. A license server polls all managed hosts and aggregates memory statistics to determine billable usage.
Reserved License: A multi-host license for Memory Machine Advanced Edition with a set memory limit. A license server polls all involved hosts and aggregates memory usage statistics to verify license compliance.
Standard License: A license for Memory Machine Standard Edition with memory management but no data services, bound to a particular host.

You can use the Memory Machine web UI, Memory Machine Dashboard, to install and manage all three license types. See Installing a Software License.

You can use the CLI mvmcli license command to install and manage individual host licenses. See Installing a Single-Host License.