# Upgrading Overview

IMPORTANT

Known issue with embedded Opensearch upgrade: When upgrading to v5.4.8+, v5.4.9 or v5.5.1, there is a potential issue with embedded Opensearch clustering on rolling upgrades and existing data migration for all embedded Opensearch architechtures. Refer to the Release Notes for additional informaiton.

## HPE Morpheus Enterprise Packages

HPE Morpheus Enterprise Release packages can be downloaded from My HPE Software Center. Contact your account manager with any questions regarding access.

## Upgrade Requirements

WARNING

HPE Morpheus Enterprise v8.1.1 contains new node and VM node packages that require 3.5GB of storage. It is safe to run `sudo rm -Rf /var/opt/morpheus/package-repos/*` after v8.1.1 package installation and before reconfigure to clean old node and VM node packages from the package-repo when appliance free space is needed.

IMPORTANT

BACKUP YOUR DATABASE before the upgrade! You can use the [appliance backup job in Morpheus](https://docs.morpheusdata.com/en/latest/getting_started/guides/backup_restore.html#create-a-backup-job), then [rollback and restore your appliance](https://docs.morpheusdata.com/en/latest/getting_started/guides/backup_restore.html#restoring-an-appliance-from-backup) if needed. Make sure you download the backup before you do the upgrade!

- For firewall/proxy/acl considerations, the domain for Appliance, Supplemental and Agent packages was changed recently to <https://downloads.morpheusdata.com> from <https://downloads.gomorpheus.com>. Please update ACL’s to allow access to <https://downloads.morpheusdata.com> when necessary.

### v8.1.1 Compatibility & Breaking Changes

When installing and upgrading to HPE Morpheus Enterprise v8.1.1, refer to the following to ensure compatibility.

#### Breaking Changes

- 7.0.8, 8.0.0: On first ui startup after upgrade, HPE Morpheus Enterprise will normalize all IPv6 records within HPE Morpheus Enterprise-type pools. There will be a warning in appliance logs warning how many records will be normalized. This takes between 5-15 minutes per 1m records
- 7.0.8, 8.0.0: Updated the AccountUsage table in the appliance database to accept LONGTEXT data type to prevent data from oversetting the table in specific scenarios. Note that this schema change will take time for databases with large numbers of account usage records
- 6.3.0: Version 6.3.0 is the first version to require Plugin API 1.0.0+. Small changes will need to be made in order to make plugins created for prior versions of HPE Morpheus Enterprise compatible with 6.3.0+. See the [related article in our KnowledgeBase](https://support.morpheusdata.com/s/article/Making-plugins-compatible-with-Morpheus-6-3-0?language=en_US) on the small changes that will need to be made to ensure plugin compatibility
- 6.2.2, 6.0.7 v8.0.7 contains embedded MySQL v8 upgrade when upgrading from v6.0.0 - v6.0.6 or 6.1.0 - 6.2.1. BACKUP YOUR DATABASE PRIOR TO UPGRADE when using embedded MySQL (all-in-one appliances)
- 6.2.2, 6.0.7 Minimum v6.x required to upgrade to v8.0.7 for environments using embedded RabbitMQ. Environments running 5.5.x or earlier using embedded RabbitMQ must upgrade to v6.0.0 - v6.0.6, or 6.1.0 - 6.2.1 prior to upgrading to v8.0.7
- 6.2.2, 6.0.7 Rolling upgrades for HA environments using embedded RabbitMQ and/or embedded Elasticsearch services are not supported when upgrading from v6.0.0 - v6.0.6 or 6.1.0 - 6.2.1
- 6.1.1 contains database datatype mondifications on account\_invoice and account\_invoice\_item that may cause long initial ui start up times while the modifications are ran in MySQL for environments with over 100k invoice records when upgrading from any version other than 6.0.3
- 6.1.1 relocates the embedded plugin folder and remove the previous folder. For HA environments using shared storage, rolling upgrades from any version other than 6.0.3 are not advised as the embeeded plugins will not be found on non-upgraded nodes after one node is upgraded.
- 6.1.1: NSX-V networking integration support is removed and no longer supported as of HPE Morpheus Enterprise 6.1.1
- 6.0.3 contains database datatype mondifications on account\_invoice and account\_invoice\_item that may cause long initial ui start up times while the modifications are ran in MySQL for environments with over 100k invoice records.
- 6.0.3 relocates the embedded plugin folder and remove the previous folder. For HA environments using shared storage, rolling upgrades are not advised as the embeeded plugins will not be found on non-upgraded nodes after one node is upgraded.
- 6.0.0: NSX-V support is deprecated though still supported as of HPE Morpheus Enterprise 6.0.0. It will be removed and unsupported in 6.1.1 and higher.
- 6.0.0+: In HPE Morpheus Enterprise 6.0.0+, many third party integrations have been moved out of the core installer package and converted to HPE Morpheus Enterprise plugins. As a result, during the upgrade process your appliance will need to be able to access share.morpheusdata.com, the online repository for all HPE Morpheus Enterprise plugins. Where this is not possible, users may instead apply the supplemental installer package which is also available at HPE Morpheus Enterprise Hub alongside the main installer package.
- 6.0.0+: In HPE Morpheus Enterprise 6.0.0+, older service specific system provided Instance Types and Layouts were deprecated and disabled. Updating to 6.0.0 will not affect existing Instances that are associated with the disabled types, however existing catalog item configurations, blueprints and api requests that use disabled Instance Types and layouts will need to be updated.
- 5.5.2: VM Node Packages: Due to build java version requiremnets, the i386.deb and i386.rpm (32-bit) VM Node Packages can no longer be updated, and remain on v3.2.9.
- 5.4.12: Guacd: Guacd is now complied iwth libssh2-1.10.0 on all platforms. Appliances on SLES15 may need openssl-devel manually installed for guacd to succesfully compile.
- 5.4.12: Session Manager: Morpheus features a new session manager that was necessary in order to resolve expiring connections from the agents due to a Spring framework update. This new session manager no longer requires Sticky Sessions and they can now be turned off at the load balancer if so desired. However, keeping them on is totally reasonable as well as it reduces overall system load. Rolling restarts no longer kick you out of your session if sticky sessions are off as it distributes your session data across the morpheus nodes in an HA environment. Additionally, overall system load is reduced as a result of the new session manager.
- 5.4.9: HPE Morpheus Enterprise 5.4.9 adds the “Provisioning: State” Role permission. This permission determines access to the State tab for Terraform-backed Instances and is set to “None” by default. On upgrade, only System Admin users will be able to see the State tab for these Instances. For other users who should have this access, edit their Roles to include “Provisioning: State” permissions.
- 5.4.5: Warning: Database indexes added for account\_usage and metadata\_tag tables. Customers with very large account\_usage and/or metadata\_tag tables (10 million+) may experience slower initial morpheus-ui loading time after upgrading to 5.4.5, as well as additional database load.
- 5.4.5: ‘AVI Load Balancer’ renamed to ‘NSX Advanced Load Balancer’
- 5.4.5: Cloud Types disabled by default: Dell, HPE (NOT HPE Oneview), Supermicro and Cloud Foundry. Users would still be able to re-enable this clouds in the appliance settings. Does not affect existing Clouds.
- 5.4.5: A10 Load Balancer type has been disabled, and will no longer be an option when adding new Load Balancers. This does not affect existing Load Balancers.
- 5.4.5: HPE Morpheus Enterprise Cluster type “Combo Cluster” renamed to “KVM/Docker Cluster”
- 5.4.5: Greenfield managed vm’s (provisioned with HPE Morpheus Enterprise) can no longer be deleted in HPE Morpheus Enterprise without removing the actual vm/infrastructure. Restriction does not apply to brownfield vm’s that have been converted to managed.
- 5.4.4: The Venafi and AppDynamics integrations are deprecated in v5.4.4 and will be removed in v5.4.5. AppDynamic will return as a plugin at a later date.
- 5.4.4: The morpheus-ui logging configuration file has changed from logback.groovy to logback.xml in v5.4.4 (/opt/morpheus/conf/logback.xml). The logback.groovy file from previous versions can be removed, and any updates to logback.groovy will not result in any logging configuration changes.
- 5.4.3: vCloud Director: Support for integrations with vCD 9 ended
- 5.4.3: HPE Morpheus Enterprise Worker/Gateway v5.4.3 packages are now available. Existing Worker & Gateway nodes must be upgraded to v5.4.3 for compatibility with HPE Morpheus Enterprise v5.4.3 Appliances.
- 5.4.2: vCloud Director: vCD 9.x will no longer be supported by Morpheus
- 5.4.2: ServiceNow: Instance and Blueprint specific exposures will be removed from ServiceNow plugin support. More advanced configurations of Instances and Blueprints, in addition to Workflows, can be exposed utilizing Catalog Items
- 5.4.2: After upgrading, it is recommended that you manually perform one “Daily” refresh Amazon Clouds to ensure availability of Amazon Service Plans for each region. To manually refresh a Cloud, navigate to Infrastructure > Clouds > (Selected Amazon Cloud) and select “Daily” from the REFRESH dropdown menu. If this is not done, HPE Morpheus Enterprise may not show Amazon Service Plans in the provisioning wizard until after Midnight UTC following the upgrade when the next automatic Daily sync would run.
- 5.3.3: Support for OpenStack v2 Identity API is removed
- 5.3.2+: The local code repository path moved from `/var/opt/morpheus/morpheus-ui/repo` to `/var/opt/morpheus/morpheus-local/repo` to reduce potential shared storage issues and performance restrictions. The reconfigure process creates the folders and sets the paths in application.yml, no manual intervention is needed unless symlinks exisit on `/var/opt/morpheus/morpheus-ui/repo/git` which will need to be removed prior to reconfiguring - 5.3.2+ The deprecated `/var/opt/morpheus/morpheus-ui/repo` path will be automatically deleted in a future release but can be manually recursively deleted at any time for storage reclamation.
- 5.3.2+: Provisioning ‣ Deployments has been moved to Provisioning ‣ Code ‣ Deployments
- 5.2.9: OpenStack v2 Identity API is deprecated as of v5.2.9 (and is removed as of v5.3.3)
- 5.2.6, 5.3.1: Appliance & Agent java version updated to `8u292-b10`. jdk8u292 disables TLS 1.0 and 1.1 by default
- 5.2.3+: `codeready` (codeready-builder-for-rhel-8-x86\_64-rpms) repo access required for RHEL 8+ Appliances, replacing the previous PowerTools/powertools requirement
- 5.2.1 & 4.2.5: API: Metadata: Metadata tags now referred to as `tags` and labels now referred to as `labels`. Previously metadata tags were referred to as `metadata` and labels were referred to as `tags`
- 5.0.0+: When upgrading to 5.0.0+ from 4.x.x, any bearer tokens that have been generated are deleted which requires users to request new bearer tokens
- 4.2.4: For appliances with externalized MySQL databases, due to MySQL deprecation of the “EDT” timezone you may need to update your database timezone to UTC or another compatible value. If this is not done, you will receive errors referencing timezone and HPE Morpheus Enterprise will not start. HPE Morpheus Enterprise should handle this change automatically for all-in-one appliances.
- 4.2.1+: Tasks: Python: Virtual environment are now used for Python Tasks. Note: `virtualenv` is required on all Appliance App nodes
- 4.2.1+: Puppet: HPE Morpheus Enterprise integration now supports version 6+. Puppet versions prior to 6 are no longer supported
- 4.2.1+: Clouds: VirtualBox, VirtuSteam, and MetaCloud Cloud Types are no longer supported or available
- 4.2.1+: Appliance: OS: Ubuntu 14.04 has reached its end of life (EOL) and is no longer supported as a Morpheus Appliance Host Operating System. Any HPE Morpheus Enterprise Appliance running on 14.04 must be upgraded to 16.04, 18.04, 20.04, 22.04 or 24.04 BEFORE upgrading to 4.2.1+. Upgrades on 14.04 will not succeed

#### HPE Morpheus Enterprise Application OS

HPE Morpheus Enterprise can be installed on the following platforms. Please note the table below is for HPE Morpheus Enterprise Application OS support, not HPE Morpheus Enterprise Agent OS Support.

Table 1. Supported Appliance Operating Systems

     | OS | Version(s) | Notes |
| --- | --- | --- |
| Amazon Linux | 2 |  |
| CentOS | 7.x (deprecated). 8.x (stream) 9.x (stream) |  |
| Debian | 11, 12 |  |
| RHEL | 7.x (deprecated), 8.x, 9.x |  |
| Oracle Enterprise Linux (OEL) | 7.x (deprecated), 8.x |  |
| SUSE SLES | 15 |  |
| Ubuntu | 20.04, 22.04, 24.04 | 14.04 is no longer supported for Appliance OS. Note: 14.04 is still supported by the HPE Morpheus Enterprise Agent. |

#### Services

##### v8.1.1 Service Versions & Compatibility

Table 2. v8.1.1 Service Versions and Compatibility

      | Service | Compatible Branch | Current Installer Version | Updated in v8.1.1 |
| --- | --- | --- | --- |
| Plugin API | 1.3.3 | 1.3.3 |  |
| Morpheus Worker | 5.4.8+ |  |  |
| MySQL | v8.0 | v8.0.40 | Yes |
| MySQL (FIPS) | v8.0 | v8.0.36 |  |
| OpenSearch | v8.9+ | v8.15.5 |  |
| RabbitMQ | v3.5-3.13 | v3.13.7 |  |
| Tomcat |  | v9.0.106 |  |
| Nginx |  | v1.26.2 |  |
| OpenSSL |  | 1.1.1w, 1.0.2u (FIPS) |  |
| Java |  | 17.0.14+7 |  |
| Java (MacOS Agent) |  | 11.0.14+9 |  |

##### HPE Morpheus Enterprise Agent & Node Package Versions

Table 3. v8.1.1 Agent & Node Package Versions

     | Package | Version | v8.1.1 changes from v8.1.0 |
| --- | --- | --- |
| Morpheus Node and VM Node Packages | 3.3.11 | Updated to 3.3.11 |
| Morpheus Linux Agent | v3.1.0 | Updated to v3.1.0 |
| Morpheus Windows Agent | v2.6.1.0 | No changes |
| Morpheus macOS Agent | v2.4.0 | No changes |

##### HPE Morpheus Enterprise Software Upgrade Paths

Depending on the specific changes from version to version, HPE Morpheus Enterprise may support rolling upgrades for multi-node HA appliances. For some version hops, specific changes such as database schema modifications may make the upgrade unsuitable for a rolling upgrade. Use this table to confirm if a rolling upgrade will be possible in each case. Instructions for both rolling and non-rolling upgrades are contained in this documentation.

Table 4. v8.1.1 Upgrade Paths

                   | From Version | To 8.0.1 | To 8.0.2 | To 8.0.3 | To 8.0.4 | To 8.0.5 | To 8.0.6 | To 8.0.7 | To 8.0.8 | To 8.0.9 | To 8.0.10 | To 8.0.11 | To 8.0.12 | To 8.0.13 | To 8.1.0 | To 8.1.1 | To 8.1.2 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Versions 6.0.0 - 7.0.11 | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.0.0 | Rolling️ | Rolling️ | Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.0.1 | **X** | Rolling️ | Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.0.2 | **X** | **X** | Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.0.3 | **X** | **X** | **X** | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.0.4 | **X** | **X** | **X** | **X** | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.0.5 | **X** | **X** | **X** | **X** | **X** | Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.0.6 | **X** | **X** | **X** | **X** | **X** | **X** | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.0.7 | **X** | **X** | **X** | **X** | **X** | **X** | **X** | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.0.8 | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.0.9 | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | Rolling️ | Rolling️ | Rolling️ | Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.0.10 | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | Rolling️ | Rolling️ | Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.0.11 | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | Rolling️ | Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.0.12 | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | Rolling️ | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.0.13 | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | Non-Rolling️ | Non-Rolling️ | Non-Rolling️ |
| 8.1.0 | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | Non-Rolling️ | Non-Rolling️ |
| 8.1.2 | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | **X** | Rolling️ |

#### Integrations

NOTE

Current iterations of Amazon AWS, Microsoft Azure, Google Cloud Platform, Digital Ocean, OpenTelekom Cloud, IBM Bluemix, Softlayer and UpCloud are all supported.

Table 5. Integration Compatibility

     | Integration | Supported Version(s) | Notes |
| --- | --- | --- |
| Ansible | 2.7.x or higher |  |
| Ansible Tower | 3.8.x |  |
| App Dynamics | 4.5.x |  |
| ArubaCX | 8325 series ‐ GL.10.10.x or higher |  |
| Avamar | 18 |  |
| Azure Stack | 2002 back to 1908 | `2019‐03‐01‐hybrid` api‐profile version used which is supported in 1908 and later Azure Stack versions |
| Cisco ACI | 3.x,4.x,5.x |  |
| Citrix Netscaler | v12.1 |  |
| Commvault | v11 sp 19 |  |
| F5 Big‐IP | 11.4+ |  |
| HPE Alletra MP Storage | 10.4.2 or higher |  |
| Infoblox | Latest Versions Supported |  |
| Kubernetes | 1.21+ |  |
| Microsoft Hyper‐V | 2012R2, 2016, 2019, 2022, 2025 |  |
| Nutanix AOS | For HPE Morpheus Enterprise version 6.3.4 and higher, Nutanix AOS version 6.5.3.7+ is required. See the [Nutanix Compatibility and Interoperability table](https://portal.nutanix.com/page/documents/compatibility-interoperability-matrix/software?partnerName=Morpheus%2520Data&solutionType=all&componentVersion=all&hypervisor=all&validationType=all) for additional information | In 5.5 ‐ 5.7 if Prism Central is managing Prism Element, image creation will not function due to PC Image Management. |
| Nutanix Prism Central | Plugin QA tested against pc.2024.3.0.1 | Nutanix Prism Central Cloud integration is added through an officially‐developed plugin. See share.morpheusdata.com and the Prism Central integration guide in this documentation for more details. |
| Openstack | Latest Versions Supported | When creating an OpenStack integration, select the latest available from the OS Version dropdown menu when running a later version |
| Puppet | 6+ | Puppet Agent version will be latest 6 version from yum.puppetlabs.com or apt.puppetlabs.com |
| Rubrik | Up to 7.x |  |
| SCVMM | 2016, 2019, 2022, 2025 |  |
| ServiceNow | Per servicenow plugin version | Refer to the [servicenow store](https://store.servicenow.com/sn_appstore_store.do#%21/store/application/8d8b6bbf0ff07e009c84306be1050e67) for Morpheus Catalog compatibility |
| Terraform | Latest | When HPE Morpheus Enterprise is handling Terraform installation, the version used will be 1.5.5 for licensing reasons. If a later version is required, you will need to manually handle Terraform installation. See the “Terraform Installation” section of HPE Morpheus Enterprise docs for more details. |
| vCloud Director | 10.0, 10.2, 10.3, 10.4 | When upgrading a vCD environment, you should update the API Version setting on the HPE Morpheus Enterprise Cloud configuration first |
| Veeam | 11, 12, 12 |  |
| VMware ESXi | 6.5, 6.7, 7, 8 |  |
| VMware Fusion | 8, 9, 10+ |  |
| VMware NSX | NSX (up to 4.1) |  |
| VMware vCenter | 5.5, 6.0, 6.5, 6.7, 7.x, 8.x |  |
| XenServer | 7.x |  |
| Zerto | 10 |  |

NOTE

Non-listed versions may be compatible but are not verified.
