Home
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.
Getting Started with Memory Machine
You run Memory Machine on a host equipped with one or more PMEM devices.
Installing MemVerge Memory Machine
Install MemVerge Memory Machine (Memory Machine) data service on all hosts requiring memory management.
Installing a Single-Host License
To install or update a single-host license, use the mvmcli license update command.

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.
- 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.
  - Hardware Recommendations
  - Network Recommendations
    For optimal performance and consistency throughout the Memory Machine System, MemVerge either requires or recommends specific values for open port numbers, communication protocols, and other network-related configurations.
  - Software Recommendations
    MemVerge recommends that you conform to software dependencies, such as operating systems and packages, that have been tested with MemVerge products.
  - Installing MemVerge Memory Machine
    Install MemVerge Memory Machine (Memory Machine) data service on all hosts requiring memory management.
    - Installing the Data Service
      Install the data service on every data host using the Memory Machine Package File.
    - Installing the Management Service
      Install the management service using the Memory Machine Package File.
    - Initializing Direct Access Devices
      To initialize the server's direct access (DAX) devices and start the Distributed Persistent Memory Engine (DPME) service, use the command mvmallocd <dax device> ... [--socket=<socket>] [--format_dax].
    - Installing a Single-Host License
      To install or update a single-host license, use the mvmcli license update command.
    - Uploading a License
      One host in your network runs a management service. See oxy_ex-3/topics/t_mvmm_installing_the_management_service.html. You must install at least one license using this management service in order to use Memory Machine.
    - Adding a User
      Authorize a user to use Memory Machine by adding the user to the mvmm group.
  - Configuration Files
    MemVerge Memory Machine uses several YAML-formatted configuration files. Two of these, mvmallocd.yml and mvmalloc.yml contain user-configurable parameters.
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.
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.

Installing a Single-Host License

To install or update a single-host license, use the mvmcli license update command.

About this task

You must install a software license to use Memory Machine memory allocation.

To install a single-host license file from the command line, do the following.

Procedure

Run the mvmcli command with the license subcommand:

# mvmcli license update -f license_file_path

where license_file_path is the license file supplied by MemVerge.

Results

For single-host, data-only installations, the command copies the contents of the license file to /etc/memverge/license.lic. Altering or removing this file will cause a license error in Memory Machine.

What to do next

Add one or more users to Memory Machine. See Adding a User.