Upgrading Memory Machine

To upgrade Memory Machine, run the Memory Machine Package File on each host using the --upgrade option.

About this task

The same Memory Machine Package File is used to install or upgrade Memory Machine on a host. You can use the --upgrade option to run the install script without prompts for your configuration preferences. The script leaves your existing configuration files and install directories in place.

Warning: Upgrade all the data hosts and the management host to the same Memory Machine version. Failure to upgrade all hosts can result in data loss.

Procedure

Ensure that all of the host's hardware and software meets the requirements for the new Memory Machine version.
If you are upgrading a data host, see Hardware Recommendations and Software Recommendations. A standalone Management Service host requires modest resources to run. Any physical or virtual host with 1 GB of available memory can run the software, provided the CPU resources are not entirely consumed by another service. The operating system requirements are the same as for a Data Service host.
Optional: Capture snapshots of any application instances that you want to back up or restart after the upgrade. See Using Snapshots in Memory Machine Management Center or Using the Memory Machine CLI Snapshot Command.
Stop all running application instances on the host. See Stopping an Application Instance in the Memory Machine User Guide.
Determine whether the Data Service, Management Service, or both were installed on the host.
- If both services are installed on the host, continue with the next step and complete all remaining steps in this procedure.
- If only the Data Service is installed on the host, proceed to the next step.
- If only the Management Service is installed on the host, skip to step 6 and complete the procedure from there.
If this is a data host, stop the Memory Machine data, snapshot, and agent services:
```
# systemctl stop mvmallocd mvsvcd mvcsnapd mmagent
```
If there is no Management Service installed on this host, skip to step 7 and complete the procedure.
If this is a management host, stop the Memory Machine management service:
```
# systemctl stop mmctl
```
Run the installer with the --upgrade option.

Important: Include the extra pair of dashes before the --upgrade option as shown below. These dashes are required; they signal to the command script that --upgrade is an option rather than a command-line argument.
```
# MemoryMachine-release-OS_name.bin -- --upgrade
#
```
Warning: You can upgrade Memory Machine by running the installer without the --upgrade option. Doing this causes the installer to prompt you for installation options such as whether to retain the snapshot data directory and the Memory Machine database. If you choose to do this, answer the questions carefully. Using the --upgrade option is safer, since it automatically retains all directories, snapshots, and data.
The installer self-extracts and prompts you for the data service installation:
```
Verifying archive integrity... All good.
Uncompressing MemVerge Memory Machine  100%
Do you want to upgrade data services? [y/N]: 
```
- If this is a data host, respond y and continue with the next step, regardless of whether the host is also the management host.
- If this is the management host only (and not a data host), respond n and skip to 10.

The installer prompts you (again) to begin the data service install:

Start updating the Memory Machine data service? [y/N]:

Respond y.

The installer displays its progress (the following display is abbreviated):

--> Performing pre-installation checks...
--> Installing binaries...
--> Installing libraries...
--> Installing configuration files...
...

The Memory Machine data service has been updated.
Uninstalling mmagent service...
Removed /etc/systemd/system/multi-user.target.wants/mmagent.service.
Done.

Upgrading the mmagent service...
Done.

Checking dependency for mmagent service...
Dependency check passed for mmagent service...
Starting the mmagent service...
mmagent service started.

The installer prompts you to install the management service.
```
Do you want to upgrade the management center? [y/N]: 
```
- If this host is the management host, respond y and continue with the next step.
- If this host is not the management host, respond n and skip to step 13.

The installer displays its progress:

Uninstalling the old management service...
Stopping management service.
Removed /etc/systemd/system/multi-user.target.wants/mmctl.service.
Done.

Upgrading the management service...
Done.

Starting the management service...
mmctl service started.
The management service is running.

When the installer finishes, the Memory Machine software is updated on this host.

Restart the Memory Machine data services by completing the following instructions:

To launch the Memory Machine data service (requires root):
1. Start the mvmallocd system service:
      systemctl start mvmallocd.service
   Make the data service start automatically when the system starts (optional):
      systemctl enable mvmallocd.service
2. Start the mvsvcd system service:
      systemctl start mvsvcd.service
   Make the mvsvcd service start automatically when the system starts (optional):
      systemctl enable mvsvcd.service
3. Start the mvcsnapd system service:
      systemctl start mvcsnapd.service
   Make the mvcsnapd service start automatically when the system starts (optional):
      systemctl enable mvcsnapd.service
4. To allow an existing user to use Memory Machine:
      usermod -a -G mvmm user-id
   Re-login is recommended for the user-id to enable its mvmm group membership.
#

Repeat this process for every host running either the Memory Machine Data Service or Management Service.