Full HA Debian / Ubuntu Upgrade

The following covers upgrading the Morpheus App nodes in Full HA Architecture configurations to v4.2.2.

Important

The following is only for Full HA Architecture configurations, where MySQL, Elasticsearch and RabbitMQ services are external to the App nodes.

Morpheus Packages

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

4.1.2+ -> v4.2.2 (rolling)

Note

All system services will automatically be stopped during the package install, and started during the reconfigure process. After the reconfigure has succeeded, tail the ui service to watch ui startup logs with morpheus-ctl tail morpheus-ui.

Important

Any externalized/non-system install services will not be stopped/started/upgraded/touched during package installs/upgrades or during reconfigures.

  1. Upgrade the DEB package on Node 1, then run a Reconfigure on Node 1

    [root@app-server-1 ~]# sudo wget https://packageUrl.morpheus-appliance_x.x.x-x.amd64.deb
    [root@app-server-1 ~]# sudo dpkg -i morpheus-appliance_x.x.x-x.amd64.deb
    [root@app-server-1 ~]# sudo morpheus-ctl reconfigure
    
  2. Once Node 1 upgrade has completed and the u is available, upgrade the DEB package on Node 2, then run a Reconfigure on Node 2.

    [root@app-server-2 ~]# sudo wget https://packageUrl.morpheus-appliance_x.x.x-x.amd64.de
    [root@app-server-2 ~]# sudo dpkg -i morpheus-appliance_x.x.x-x.amd64.deb
    [root@app-server-2 ~]# sudo morpheus-ctl reconfigure
    
  3. Then upgrade the DEB package and run a Reconfigure on Node 3.

    [root@app-server-3 ~]# sudo wget https://packageUrl.morpheus-appliance_x.x.x-x.amd64.de
    [root@app-server-3 ~]# ssudo dpkg -i morpheus-appliance_x.x.x-x.amd64.deb
    [root@app-server-3 ~]# sudo morpheus-ctl reconfigure
    
  4. The upgrade is complete and the Morpheus-ui services should be running across the 3 nodes.

4.0.0, 4.1.0, 4.1.1 -> v4.2.2 Upgrade

  • Elasticsearch 7.x is required for the external Elasticsearch cluster or services. Refer to Elasticsearch Upgrade Documentation for upgrading external ES Clusters. The Morpheus v4.2.2 package upgrade and reconfigure process will NOT upgrade external services.
  1. Starting with Node 3, on All App Nodes, stop all Morpheus services via morpheus-ctl stop. This will stop all system services. If any services timeout, run morpheus-ctl stop again.

    [root@app-server-3 ~]# morpheus-ctl stop
    
    [root@app-server-2 ~]# morpheus-ctl stop
    
    [root@app-server-1 ~]# morpheus-ctl stop
    
  2. Upgrade the deb package on Node 1, then run a Reconfigure on Node 1

    [root@app-server-1 ~]# sudo wget https://packageUrl.morpheus-appliance_x.x.x-x.amd64.deb
    [root@app-server-1 ~]# sudo dpkg -i morpheus-appliance_x.x.x-1.amd64.deb
    [root@app-server-1 ~]# sudo morpheus-ctl reconfigure
    

    Note

    All services will automatically start during the upgrade process. After the reconfigure has succeeded, tail the ui service to watch ui startup logs with morpheus-ctl tail morpheus-ui.

  3. Once Node 1 upgrade has completed and the u is available, upgrade the deb package on Node 2, then run a Reconfigure on Node 2.

    [root@app-server-2 ~]# sudo wget https://packageUrl.morpheus-appliance_x.x.x-x.amd64.deb
    [root@app-server-2 ~]# sudo dpkg -i morpheus-appliance_x.x.x-1.amd64.deb
    [root@app-server-2 ~]# sudo morpheus-ctl reconfigure
    
  4. Then upgrade the deb package on Node 3, then run a Reconfigure on Node 3

    [root@app-server-3 ~]# sudo wget https://packageUrl.morpheus-appliance_x.x.x-x.amd64.deb
    [root@app-server-3 ~]# sudo dpkg -i morpheus-appliance_x.x.x-1.amd64.deb
    [root@app-server-3 ~]# sudo morpheus-ctl reconfigure
    
  5. After all morpheus-ui services have finished loading, the upgrade is complete.

3.6.x -> v4.2.2 Upgrade

  • MySQL 5.7.x is required for external MySQL clusters or services. Refer to Percona Upgrade Documentation for upgrading external Percona Clusters. The Morpheus v4.2.2 package upgrade and reconfigure process will NOT upgrade external services.
  • Elasticsearch 7.x is required for the external Elasticsearch cluster or services. Refer to Elasticsearch Upgrade Documentation for upgrading external ES Clusters. The Morpheus v4.2.2 package upgrade and reconfigure process will NOT upgrade external services.
  • Existing 3.6.x RabbitMQ clusters are compatible with v4.2.2 and do not require an upgrade. On 3-Node configurations, the RabbitMQ queues and configuration will be dropped and the cluster will need to be configured and established again.
  • The Morpheus package repo download location has changed to https://downloads.morpheusdata.com from https://downloads.gomorpheus.com. Update firewall and proxy ACLs when applicable.
  1. Starting with Node 3, on All App Nodes, stop all Morpheus services via morpheus-ctl stop. This will stop all system services. If any services timeout, run morpheus-ctl stop again.

    [root@app-server-3 ~]# morpheus-ctl stop
    
    [root@app-server-2 ~]# morpheus-ctl stop
    
    [root@app-server-1 ~]# morpheus-ctl stop
    
  2. Upgrade the deb package on Node 1, then run a Reconfigure on Node 1

    [root@app-server-1 ~]# sudo wget https://packageUrl.morpheus-appliance_x.x.x-x.amd64.deb
    [root@app-server-1 ~]# sudo dpkg -i morpheus-appliance_x.x.x-1.amd64.deb
    [root@app-server-1 ~]# sudo morpheus-ctl reconfigure
    

    Note

    All services will automatically start during the upgrade process. After the reconfigure has succeeded, tail the ui service to watch ui startup logs with morpheus-ctl tail morpheus-ui.

  3. Once Node 1 upgrade has completed and the u is available, upgrade the deb package on Node 2, then run a Reconfigure on Node 2.

    [root@app-server-2 ~]# sudo wget https://packageUrl.morpheus-appliance_x.x.x-x.amd64.deb
    [root@app-server-2 ~]# sudo dpkg -i morpheus-appliance_x.x.x-1.amd64.deb
    [root@app-server-2 ~]# sudo morpheus-ctl reconfigure
    
  4. Then upgrade the deb package on Node 3, then run a Reconfigure on Node 3

    [root@app-server-3 ~]# sudo wget https://packageUrl.morpheus-appliance_x.x.x-x.amd64.deb
    [root@app-server-3 ~]# sudo dpkg -i morpheus-appliance_x.x.x-1.amd64.deb
    [root@app-server-3 ~]# sudo morpheus-ctl reconfigure
    
  5. After all morpheus-ui services have finished loading, the upgrade is complete.