# Elevating to HPE Morpheus Enterprise

This section of the guide goes over the process for upgrading a HPE Morpheus VM Essentials Software appliance to a HPE Morpheus Enterprise Software appliance. HPE Morpheus VM Essentials and HPE Morpheus Enterprise are essentially the same product with HPE Morpheus VM Essentials focused specifically on management and consumption of HVM clusters and HPE Morpheus Enterprise adding on support for many other public and private Cloud types with a richer orchestration and automation experience (in addition to all features included with HPE Morpheus VM Essentials). HPE Morpheus Enterprise requires separate licensing, reach out to your account manager if you’re unsure which licensing entitlements you can access. This guide is intended for HPE Morpheus VM Essentials administrators to upgrade their existing appliances and assumes a level of comfort with the Linux command line and the version upgrade process for HPE Morpheus VM Essentials and/or HPE Morpheus Enterprise. After upgrading, refer to HPE Morpheus Enterprise [documentation](https://www.hpe.com/support/morpheus-enterprise-documentation-latest) for use guides to consuming the full HPE Morpheus Enterprise feature set.

## Prerequisites

- HPE Morpheus VM Essentials manager version 8.0.1+
- A bucket integrated with HPE Morpheus VM Essentials manager which can house an appliance database backup
- The HPE Morpheus Enterprise upgrade package (version 8.0.4+)
- A HPE Morpheus Enterprise license to add following the upgrade to enable the full feature set

## Back Up the Appliance

Start by taking a fresh backup of the appliance database. View the appliance backup job by navigating to Backups > Jobs. As in the screenshot, there should be a backup job named “Morpheus Appliance.” If an appliance backup job is not shown, enable the “Backup Appliance” setting within global settings (Administration > Settings > Backups).

![../_images/upgradeCheckBackups.png](https://support.hpe.com/hpesc/public/api/document/sd00007620en_us/GUID-983B614F-468D-405F-8143-085388C6B629-high.png)

Click Run Now and wait for a new green checkmark to appear indicating a new run of the backup job was successful.

## Package Installation

Upgrading the HPE Morpheus VM Essentials manager to a HPE Morpheus Enterprise appliance is as simple as installing the HPE Morpheus Enterprise package over the existing HPE Morpheus VM Essentials package in a process very similar to version upgrades you may have done in the past. First, download the HPE Morpheus Enterprise `.deb` package. The download URL shown below is a placeholder, reach out to your account manager if you’re unsure where to find the download URL for the latest package.

```
```
wget https://url.to.morpheus-appliance_x.x.x-x.deb
```
```

Next, stop the HPE Morpheus VM Essentials UI.

```
```
sudo morpheus-ctl stop morpheus-ui
```
```

Install the HPE Morpheus Enterprise package and force it to overwrite.

```
```
dpkg -i --force-overwrite morpheus-appliance_x.x.x-x.deb
```
```

Wait for the installation to complete. There will be warnings about conflicts which may be safely ignored. When installation is complete, you will see a message similar to the screenshot below:

![../_images/upgradeFinishInstall.png](https://support.hpe.com/hpesc/public/api/document/sd00007620en_us/GUID-967FDDAE-077D-492D-A9E6-27259A79FCCB-high.png)

Now, remove the HPE Morpheus VM Essentials package.

```
```
sudo apt-get remove -y hpe-vm-essentials
```
```

Following removal, restart any recommended services if prompted.

![../_images/upgradeRemoveVme.png](https://support.hpe.com/hpesc/public/api/document/sd00007620en_us/GUID-DCBE5796-22E4-4207-B179-DD8B37BA91EF-high.png)

We must now clean up OpenSearch directories. Currently, HPE Morpheus Enterprise uses ElasticSearch while HPE Morpheus VM Essentials manager uses OpenSearch. Migration through snapshots is not supported due to this incompatibility. In general, OpenSearch and ElasticSearch contain VM performance metrics. This data can be considered ephemeral and safely deleted as the default retention is only 30 days. HPE Morpheus Enterprise is planned to migrate to OpenSearch in the future and at that point, this cleanup step will not be required and metrics will persist across an upgrade to HPE Morpheus Enterprise. Remove the following directories:

```
```
rm -rf /var/run/morpheus/opensearch  
rm -rf /opt/morpheus/service/opensearch
```
```

Next, run the reconfigure command. This will configure ElasticSearch for use with the upgraded appliance.

```
```
sudo morpheus-ctl reconfigure
```
```

Once the reconfigure is complete, make sure all HPE Morpheus Enterprise services are started

```
```
sudo morpheus-ctl status
```
```

If any services need started, use the following command:

```
```
sudo morpheus-ctl start {service name}
```
```

You can watch the logs to see when the UI comes back up:

```
```
sudo morpheus-ctl tail morpheus-ui
```
```

When the Morpheus ASCII logo appears, you should be able to reach the UI from a web browser.

## Upgrading the License

Now that HPE Morpheus Enterprise UI is reachable, the license must be upgraded. Navigate to Administration > Settings > License where you’ll see a field to paste in your license key. Once again, contact your account manager if you have questions on accessing your license key. Finally, make sure you select the appropriate option of either stacking the license onto an existing license or replacing it. Then, click Update.

At this point, the process is complete. Now that the full Morpheus feature set is unlocked, refer to Morpheus [documentation](https://support.hpe.com/connect/s/product?language=en_US&kmpmoid=1014895562&tab=manuals&cep=on) going forward.
