Skip to content

Install Memory Machine

To install Memory Machine 1.4.0, we need to verify that any previous memory viewer installations are removed, download the Memory Machine software, then install that software.

Remove Previous Memory Viewer Installation

Versions of Memory Viewer prior to 1.3.0 are incompatible and must be uninstalled before installing Memory Viewer 1.4.0.

To confirm if mvmv installed and remove the mvmv package:

RHEL/CentOS/Fedora

$ sudo dnf list --installed | grep -i mvmv

If the mvmv package is installed, and you wish to remove the package and all dependencies, use:

$ sudo dnf erase mvmv

Ubuntu

$ sudo apt list --installed | grep -i mvmv

If the mvmv package is installed, and you wish to remove the package and all dependencies, use:

$ sudo apt --purge autoremove mvmv

Download Memory Machine

Download the Memory Machine package from the MemVerge download site:

Using Ubuntu: Cell_Mgmt_1.4.0-20240131192231.bin [MD5 Checksum]

If the host has an Internet connection, use curl or wget to download the file directly on the target server.

For example:

$ wget https://memory-viewer-bucket.s3.amazonaws.com/releases/v1.4.0/Cell_Mgmt_1.4.0-20240131192231.bin

If the host does not have Internet access, download it and the dependency packages to a host that does, then transfer the packages to the target server.

Install Memory Viewer

Install Memory Viewer using the self-extracting BIN package file.

$ sudo ./Cell_Mgmt_1.4.0-20240131192231.bin

The usage information shows options to specify non-default values:

$ sudo ./Cell_Mgmt_1.4.0-20240131192231.bin --help
Verifying archive integrity...  100%   MD5 checksums are OK. All good.
Uncompressing Memory Machine  100%  
./Cell_Mgmt_1.4.0-20240131192231.bin

Options:
    --install-path                Optional. Default is /opt/memverge. Specify CXL Memory Machine install path
    --install=[SERVICE]           Optional.
                                  SERVICE='all', default, install both mmmgr and mmlet services
                                  SERVICE='management-host', install only mmmgr service on management-host
                                  SERVICE='compute-host', install only mmlet service on compute-host
    --mmmgr-port=[PORT]           Optional. Default port is 8081
    --mmlet-port=[PORT]           Optional. Default port is 8090
    --prometheus-port=[PORT]      Optional. Default port is 8091
    --grafana-port=[PORT]         Optional. Default port is 8092
    --caddy-port=[PORT]           Optional. Default port is 8080
    --help                        Print this help message

Installation Example:

$ sudo ./Cell_Mgmt_1.4.0-20240131192231.bin 
[sudo] password for steves: 
Verifying archive integrity...  100%   MD5 checksums are OK. All good.
Uncompressing Memory Machine  100%  
./Cell_Mgmt_1.4.0-20240131192231.bin
Welcome to the MemVerge Memory Machine installation wizard!
Please press ENTER to read the MemVerge End User License Agreement: 
I have read and agree to the End User License Agreement [y/n]: y
Start to install MemVerge CXL Memory Machine...
Ready to install into "/opt/memverge"
Installing compute host components...
--> Installing mmlet service...
temp_file.tar.gz                                     100%[=====================================================================================================================>]   3.57M  20.0MB/s    in 0.2s    
--> Installing mmtier services...
Verifying archive integrity...  100%   MD5 checksums are OK. All good.
Uncompressing Memverge Tiering Component Services  100%  
Created symlink /etc/systemd/system/mmtier.service.wants/mmtier_dm.service  /etc/systemd/system/mmtier_dm.service.
Created symlink /etc/systemd/system/mmtier.service.wants/mmtier_de.service  /etc/systemd/system/mmtier_de.service.
Created symlink /etc/systemd/system/mmtier.service.wants/mmtier_mp.service  /etc/systemd/system/mmtier_mp.service.
Created symlink /etc/systemd/system/mmtier.service.wants/mmtier_bw.service  /etc/systemd/system/mmtier_bw.service.
Created symlink /etc/systemd/system/multi-user.target.wants/mmtier.service  /etc/systemd/system/mmtier.service.
Starting mmlet service
Created symlink /etc/systemd/system/multi-user.target.wants/mmlet.service  /etc/systemd/system/mmlet.service.
Feb 02 15:39:41 sr0 bash[42393]: }]
Feb 02 15:39:41 sr0 bash[42393]: 2024/02/02 15:39:41 "GET http://sr0.eng.memverge.com:8080/v1/wss/history?startTimestamp=0&endTimestamp=1706917181128000 HTTP/1.1" from 10.4.0.105:52828 - 200 138B in 942.261µs
Feb 02 15:39:42 sr0 bash[42393]: 2024/02/02 15:39:42 "GET http://sr0.eng.memverge.com:8080/v1/core/processes HTTP/1.1" from 10.4.0.105:54512 - 200 31713B in 1.611500163s
Feb 02 15:55:10 sr0 bash[240627]: 2024/02/02 15:55:10 [/opt/memverge/sbin/mmlet --config=/etc/memverge/mmlet.yml]
Feb 02 15:55:11 sr0 bash[240627]: 2024/02/02 15:55:11 Starting server on :8090
mmlet is running
Installing management host components...
--> Installing mmmgr service...
temp_file.tar.gz                                     100%[=====================================================================================================================>]  90.48M  18.6MB/s    in 5.0s    
temp_file.tar.gz                                     100%[=====================================================================================================================>]  79.30M  18.9MB/s    in 4.2s    
temp_file.tar.gz                                         [     <=>                                                                                                              ]   9.63M  11.3MB/s    in 0.9s    
temp_file.tar.gz                                     100%[=====================================================================================================================>]  13.98M  19.0MB/s    in 0.7s    
Starting mmmgr service
Created symlink /etc/systemd/system/multi-user.target.wants/mmmgr.service  /etc/systemd/system/mmmgr.service.
Feb 02 15:55:34 sr0 bash[240812]: 2024/02/02 15:55:34 [/opt/memverge/sbin/mmmgr --config=/etc/memverge/mmmgr.yml]
Feb 02 15:55:34 sr0 bash[240812]: 2024/02/02 15:55:34 Opened Bolt database
Feb 02 15:55:34 sr0 bash[240812]: 2024/02/02 15:55:34 Started Prometheus on 8091
Feb 02 15:55:34 sr0 bash[240812]: 2024/02/02 15:55:34 Started Grafana on 8092
Feb 02 15:55:34 sr0 bash[240812]: 2024/02/02 15:55:34 Started Caddy on 8080
Feb 02 15:55:34 sr0 bash[240812]: 2024/02/02 15:55:34 Starting server on :8081
mmmgr is running
Adding Compute Host to Management Host list ...
Install completed.
Successfully installed MemVerge CXL Memory Machine to "/opt/memverge", see "/var/log/memverge/package_install.log" for details.