# Upgrade process

Having copied over the needed files and connected to the VM Essentials manager VM, the upgrade is completed in just a few commands. These commands will stop the current services, install the package, and then reconfigure the Manager. Replace the placeholder `.deb` file in the commands below with the correct path and file name of the package you’ve copied over.

IMPORTANT

Upgrading VM Essentials manager will result in downtime of 10-15 minutes. Ensure users are not doing critical work during the upgrade window. This downtime applies only to the Manager itself and has no effect on the hypervisor host(s) or any provisioned VMs currently running.

```
```
sudo morpheus-ctl stop morpheus-ui  
sudo dpkg -i xxxx.deb  
sudo dpkg -i xxxx.supplemental.deb  # Optional -- Only for offline upgrades  
sudo morpheus-ctl reconfigure
```
```

All services will automatically start during the reconfigure process. After the reconfigure has succeeded, tail the UI service to watch UI startup logs with `morpheus-ctl tail morpheus-ui`. Once the UI service is up and running, the upgrade process is complete. Attempt to reach your appliance normally through a web browser to confirm success.

NOTE

- Services will be stopped during package installation and started during the reconfigure process, including the `morpheus-ui` service.
- If the reconfigure process is interrupted or fails, the `morpheus-ui` service may need to be manually started or restarted.
- In certain situations if another service hangs on starting during reconfigure, run `systemctl restart morpheus-runsvdir` then reconfigure and restart `morpheus-ui` if successful.

Following upgrade, it's advisable to check for any available HVM Host Agent upgrades. To upgrade the HVM Host Agent, navigate to an HVM Host detail page, expand the ACTIONS menu, and click "Upgrade Agent." This process must be repeated for each HVM Host that makes up the HVM Cluster.

Alternatively, you could also select "Download Agent Script" to download an Agent upgrade script which can be run when connected to the host through a terminal session. The Agent upgrade scripts are Host-specific so an individual script would need to be downloaded for each HVM Host.

## Upgrade sequence procedure

This section contains a table of compatible upgrade paths. The far left column contains the HPE Morpheus VM Essentials Manager version you're starting from. The columns to the right indicate versions compatible for upgrade from your starting version. If the version number is listed, it is a compatible upgrade path. If an "**X**" is listed instead, the upgrade path is unsupported.

NOTE

It is possible to span multiple versions in a single upgrade. For example, you can upgrade directly from HPE Morpheus VM Essentials version 8.0.3 to version 8.0.6, or from version 8.0.7 to version 8.0.11, and so on. Consult the table below for compatible or incompatible version upgrade hops.

| From Version | To Version | | | | | | | | | | | | | | |  |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 8.0.1 → | 8.0.2 | 8.0.3 | 8.0.4 | 8.0.5 | 8.0.6 | 8.0.7 | 8.0.8 | 8.0.9 | 8.0.10 | 8.0.11 | 8.0.12 | 8.0.13 | 8.1.0 | 8.1.1 | 8.1.2 | 9.0.0 |
| 8.0.2 → |  | 8.0.3 | 8.0.4 | 8.0.5 | 8.0.6 | 8.0.7 | 8.0.8 | 8.0.9 | 8.0.10 | 8.0.11 | 8.0.12 | 8.0.13 | 8.1.0 | 8.1.1 | 8.1.2 | 9.0.0 |
| 8.0.3 → |  |  | 8.0.4 | 8.0.5 | 8.0.6 | 8.0.7 | 8.0.8 | 8.0.9 | 8.0.10 | 8.0.11 | 8.0.12 | 8.0.13 | 8.1.0 | 8.1.1 | 8.1.2 | 9.0.0 |
| 8.0.4 → |  |  |  | 8.0.5 | 8.0.6 | 8.0.7 | 8.0.8 | 8.0.9 | 8.0.10 | 8.0.11 | 8.0.12 | 8.0.13 | 8.1.0 | 8.1.1 | 8.1.2 | 9.0.0 |
| 8.0.5 → |  |  |  |  | 8.0.6 | 8.0.7 | 8.0.8 | 8.0.9 | 8.0.10 | 8.0.11 | 8.0.12 | 8.0.13 | 8.1.0 | 8.1.1 | 8.1.2 | 9.0.0 |
| 8.0.6 → |  |  |  |  |  | 8.0.7 | 8.0.8 | 8.0.9 | 8.0.10 | 8.0.11 | 8.0.12 | 8.0.13 | 8.1.0 | 8.1.1 | 8.1.2 | 9.0.0 |
| 8.0.7 → |  |  |  |  |  |  | 8.0.8 | 8.0.9 | 8.0.10 | 8.0.11 | 8.0.12 | 8.0.13 | 8.1.0 | 8.1.1 | 8.1.2 | 9.0.0 |
| 8.0.8 → |  |  |  |  |  |  |  | 8.0.9 | 8.0.10 | 8.0.11 | 8.0.12 | 8.0.13 | 8.1.0 | 8.1.1 | 8.1.2 | 9.0.0 |
| 8.0.9 → |  |  |  |  |  |  |  |  | 8.0.10 | 8.0.11 | 8.0.12 | 8.0.13 | 8.1.0 | 8.1.1 | 8.1.2 | 9.0.0 |
| 8.0.10 → |  |  |  |  |  |  |  |  |  | 8.0.11 | 8.0.12 | 8.0.13 | 8.1.0 | 8.1.1 | 8.1.2 | 9.0.0 |
| 8.0.11 → |  |  |  |  |  |  |  |  |  |  | 8.0.12 | 8.0.13 | 8.1.0 | 8.1.1 | 8.1.2 | 9.0.0 |
| 8.0.12 → |  |  |  |  |  |  |  |  |  |  |  | 8.0.13 | 8.1.0 | 8.1.1 | 8.1.2 | 9.0.0 |
| 8.0.13 → |  |  |  |  |  |  |  |  |  |  |  |  | 8.1.0 | 8.1.1 | 8.1.2 | 9.0.0 |
| 8.1.0 → |  |  |  |  |  |  |  |  |  |  |  |  |  | 8.1.1 | 8.1.2 | 9.0.0 |
| 8.1.1 → |  |  |  |  |  |  |  |  |  |  |  |  |  |  | 8.1.2 | 9.0.0 |
| 8.1.2 → |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  | 9.0.0 |
