Upgrading Overview

Morpheus Packages

Morpheus Release Package urls can be obtained from https://morpheushub.com

Upgrade Requirements

Warning

Morpheus v5.2.13 contain 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 v5.2.13 package installation and before reconfigure to clean old node and vm node packages from the package-repo when room is needed.

Important

BACKUP YOUR DATABASE before the upgrade. You can use the appliance backup job in Morpheus, but make sure you download it before you do the upgrade.

v5.2.13 Compatibility & Breaking Changes

When installing and upgrading to Morpheus v5.2.13, refer to the following to ensure compatibility.

Breaking Changes

  • 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 Morpheus Appliance running on 14.04 must be upgraded to 16.04, 18.04 or 20.04 BEFORE upgrading to 4.2.1+. Upgrades on 14.04 will not succeed

  • 4.2.1+: Clouds: VirtualBox, VirtuSteam, and MetaCloud Cloud Types are no longer supported or available

  • 4.2.1+: Puppet: Morpheus integration now supports version 6+. Puppet versions prior to 6 are no longer supported

  • 4.2.1+: Tasks: Python: Virtual environment are now used for Python Tasks. Note: virtualenv is required on all Appliance App nodes: pip install virtualenv

  • 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 Morpheus will not start. Morpheus should handle this change automatically for all-in-one appliances.

  • 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

  • 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.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.6+: Appliance & Agent java version updated to 8u292-b10. jdk8u292 disables TLS 1.0 and 1.1 by default.

  • 5.2.8: Appliance: The local code repository path has been moved from /var/opt/morpheus/morpheus-ui/repo to /var/opt/morpheus/morpheus-local/repo to reduce potential shared storage issues and perfomace 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 old /var/opt/morpheus/morpheus-ui/repo path will be automatically deleted in a fulture release but can be manually recursivly deleted at any time for storage reclaimation.

  • 5.2.9: OpenStack v2 Identity API will be deprecated in v5.2.9 and will be removed in v5.3.3

  • 5.2.9: The following System Instance Types and associated layouts were disabled and no longer appear in the system provided library: Cassandra, Confluence, Devstack, Hadoop, Jboss, Jenkins, Magento, Mongo, Moogsoft, Nexus, Percona, Puppet, RethinkDb, Riak, RiakCs, Stash, Solr, Wordpress, Zookeeper. Note this only disables the Instance type from the system seeded library and does not affect user created Insatnce Types or Layouts.

  • 5.2.11: Veeam 9.5u3a and 9.5u4 integration support has been deprecated as they near end of support

  • 5.2.11-2 contains important security updates. v5.2.11-1 is no longer available and it is recommended to update from v5.2.11-1 to v5.2.11-2

Morpheus Application OS

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

Note

If CentOS 8.2 is pinned to 8.2.2004 vault, the PowerTools repository will need to be pinned to 8.2.2004 to access freerdp-libs 2.0.0

Supported Appliance Operating Systems

OS

Version(s)

Notes

Amazon Linux

2

CentOS

7.x, 8.x

If CentOS 8.2 is pinned to 8.2.2004 vault, the PowerTools repository will need to be pinned to 8.2.2004 to access freerdp-libs 2.0.0

Debian

9,10,11

FreeRDP 2.0 is not compatible with Debian 9. guacd will remain at 1.0.0 for Appliances running on Debian 9.

RHEL

7.x, 8.x

SUSE Linux Enterprise Server (SLES)

12, 15

Ubuntu

16.04, 18.04, 20.04

14.04 is no longer supported for Appliance OS. Existing Appliances on 14.04 must upgrade to 16.04, 18.04 or 20.04 PRIOR to upgrading to v4.2.1+. Note: 14.04 is still supported by the Morpheus Agent.

Services

v5.2.13 Service Version Changes

  • Java upgraded to 8u312-b07 5.3.4

  • MySQL upgraded to 5.7.35 5.3.4

  • Nginx upgraded to 1.20.1 5.3.4

  • RabbitMQ upgraded to 3.9.8 5.3.4

  • Tomcat upgraded to 9.0.54 5.3.4


v5.2.13 Service Version Compatibility

When externalizing MySQL, Elasticsearch and/or RabbitMQ services, the following versions are compatible with version Morpheus v5.2.13

Service

Compatible Branch

Morpheus Installer Version

MySQL

v5.7

v5.7.35

MySQL (FIPS)

v5.7

v.5.7.35

Percona

5.7, WSREP 31

n/a

Elasticsearch

v7.x

v7.8.1

RabbitMQ

v3.5-3.9

v3.9.8

Tomcat

v9.0.54

Nginx

v1.20.1

OpenSSL

1.1.1k, 1.0.2u (FIPS)

Java

v8u312-b07

Java (macOS agent)

v8u312-b07

Security

CVEs Addressed

  • CVE-2021-23369

Upgrade Support Matrix

From Version To Verison
4.0.0 → 4.1.0 4.1.1 4.1.2 4.2.0 4.2.1 4.2.2 4.2.3 4.2.4 4.2.5 4.2.6
4.1.0 → 4.1.1 4.1.2 4.2.0 4.2.1 4.2.2 4.2.3 4.2.4 4.2.5 4.2.6
4.1.1 → 4.1.2 4.2.0 4.2.1 4.2.2 4.2.3 4.2.4 4.2.5 4.2.6
4.1.2 → 4.2.0 4.2.1 4.2.2 4.2.3 4.2.4 4.2.5 4.2.6
4.2.0 → 4.2.1 4.2.2 4.2.3 4.2.4 4.2.5 4.2.6 5.0.0 5.2.0 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
4.2.1 → 4.2.2 4.2.3 4.2.4 4.2.5 4.2.6 5.0.0 5.2.0 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
4.2.2 → 4.2.3 4.2.4 4.2.5 4.2.6 5.0.0 5.2.0 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
4.2.3 → 4.2.4 4.2.5 4.2.6 5.0.0 5.2.0 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
4.2.4 → 4.2.5 4.2.6 5.0.0 5.2.0 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
4.2.5 → 4.2.6 5.0.0 5.2.0 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
4.2.6 → 5.0.0 5.2.0 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
5.0.0 → 5.2.0 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
5.2.0 → 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
5.2.1 → 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
5.2.2 → 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
5.2.3 → 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
5.2.4 → 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
5.2.5 → 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
5.2.6 → 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
5.2.7 → 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
5.2.8 → 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13
5.2.9 → 5.2.10 5.2.11 5.2.12 5.2.13
5.2.10 → 5.2.11 5.2.12 5.2.13
5.2.11 → 5.2.12 5.2.13
5.2.12 → 5.2.13
Rolling Upgrade Supported
Non-Rolling Upgrade Supported
Upgrade Not Supported
Downgrade Not Supported

Integrations

Note

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

Integration

Supported Version(s)

Notes

Ansible

2.7.x

Ansible Tower

3.8.x

App Dynamics

4.5.x

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.10

Commvault

v11 sp 19

Jenkins

2.x

Kubernetes

1.x

Microsoft Hyper-V

2012R2, 2016, 2019

Nutanix AHV

5.0 - 5.10 Note: Prism Central is not a supported endpoint

In 5.5 - 5.7 if Prism Central is managing Prism Element, image creation will not function due to PC Image Management.

Openstack

Latest Versions Supported

When creating an OpenStack integration, select the latest available from the OS Version dropdown menu when running a later version

Rubrik

4.2

SCVMM

2016, 2019

ServiceNow

Orlando, Paris, Quebec, Rome

Splunk

7.10

Terraform

v0.11.x, v0.12.18+, 0.13.x, 0.14.x

vCloud Director

8.20, 9.1, 9.5, 9.7, 10.0, 10.2

vCD 9.7+ supported on API v31, vCD 10.2+ supported on API v34.0

Veeam

10, 11

9.5u3, 9.5u4 support deprecated in v5.2.11

VMware ESXi

5.5, 6.0, 6.5, 6.7, 7

VMware Fusion

8, 9, 10+

VMware NSX

-V, -T v3.1.0

VMware vCenter

5.5, 6.0, 6.5, 6.7, 7

XenServer

7.x

Note

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