Home
Using the Command Line Interface
You can administer and use MemVerge Memory Machine using the Command Line Interface (CLI) on any installed host.
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 Distributed Persistent Memory Engine (DPME).
Using Containers with Memory Machine
You can configure Memory Machine to manage memory for containers running in OpenShift or Kubernetes.
Configuring the Container Manager
Configure access to the Memory Machine OpenShift or Kubernetes packages.

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 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.
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.
- 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 Distributed Persistent Memory Engine (DPME).
  - Calculating Process Count Limits
  - Running an Application in Memory Machine
    To run an application with Memory Machine memory management, use the mm script supplied with Memory Machine.
  - Stopping an Application Instance
    Stop an application instance in whatever manner is recommended for the application you are running.
  - Configuring Application Memory
    Configure managed memory to optimize for individual application instances. You can do this by setting the size of DRAM Tier and configuring Linux HugePages. To facilitate experimentation, these adjustments can be made "on the fly" while the application instance is running.
  - Using Containers with Memory Machine
    You can configure Memory Machine to manage memory for containers running in OpenShift or Kubernetes.
    - The Memory Machine Container Model
      To manage containers, Memory Machine runs in a single pod on each container node and manages memory in a local persistent volume (PV). Application container pods on that node mount the PV to gain access to managed memory.
    - Container Management Overview
      To manage containers in Memory Machine, deploy a Kubernetes or OpenShift® cluster and deploy Memory Machine on the cluster.
    - Configuring the Container Manager
      Configure access to the Memory Machine OpenShift or Kubernetes packages.
    - Configuring HugePages
    - Configuring PMEM
    - Deploying the Container Webhook
    - Deploy the DaemonSet
    - Testing the Container Setup
- Using Snapshots in the Memory Machine CLI
  Use the mvmcli snapshot 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 captured state.
- Troubleshooting
- Preparing Intel® Optane™ DC Persistent Memory PMEM
  Prepare PMEM for use by configuring the Intel Optane DC 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.
All Documentation
Links to documentation for all releases of MemVerge Memory Machine.

Configuring the Container Manager

Configure access to the Memory Machine OpenShift or Kubernetes packages.

Before you begin

Create a personal access token (PAT) for use with Github. For information on how to create and configure PATs, see these instructions on Github. Ensure your GitHub account with this token has access to the mm-k8s repository.

Note: Do not modify the DOCKER_CONFIG environment variable. Memory Machine uses the default Docker configuration file path.

Procedure

Export the kubeconfig location:

$ export KUBECONFIG=path_to_kubeconfig
$

Use your Docker login to access GitHub packages with GITHUB_TOKEN. Ensure your GitHub account with this token has access to the mm-k8s repository:
```
$ cat file-containing-github-token | docker \
  login https://docker.pkg.github.com -u user-name --password-stdin
```
Note: Do not modify the DOCKER_CONFIG environment variable. Memory Machine uses the default Docker configuration file path.

What to do next

Next, configure HugePages on VMs.