3-Node HA CentOS / RHEL Upgrade¶
The following covers upgrading the Morpheus App nodes in 3 Node HA configurations to v6.1.0.
Warning
As a best practice, always backup your database prior to any upgrade.
Important
The following is only for “3 Node HA” Architecture configurations.
Morpheus Packages¶
Morpheus Release Package urls can be obtained from https://morpheushub.com
v6.0.1 or lower -> v6.1.0 Upgrade¶
Warning
Rolling upgrades from v6.0.1 or lower to v6.1.0 are not supported
Important
It is important to stop the morpheus-ui service on all app nodes prior to upgrade. Failure to do so will resilt in a flood of log errors due to previous message serializaiton conflict. The messages will eventually expire and the logs will clear.
Warning
Morpheus v6.1.0 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 v6.1.0 package installation and before reconfigure to clean old node and vm node packages from the package-repo when room is needed.
Starting with Node 3, on All App Nodes, stop the morpheus-ui services via
morpheus-ctl stop morpheus-ui
. If you receive a timeout, runmorpheus-ctl graceful-kill morpheus-ui
.[root@app-server-3 ~]# morpheus-ctl stop morpheus-ui
[root@app-server-2 ~]# morpheus-ctl stop morpheus-ui
[root@app-server-1 ~]# morpheus-ctl stop morpheus-ui
Upgrade the RPM 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.x86_64.rpm [root@app-server-1 ~]# sudo rpm -Uhv morpheus-appliance-x.x.x-x.x86_64.rpm [root@app-server-1 ~]# sudo morpheus-ctl reconfigure
Note
All services will automatically be stopped 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
.Once Node 1 upgrade has completed and the ui is available, upgrade the RPM 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.x86_64.rpm [root@app-server-2 ~]# sudo rpm -Uhv morpheus-appliance-x.x.x-x.x86_64.rpm [root@app-server-2 ~]# sudo morpheus-ctl reconfigure
Then upgrade the RPM 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.x86_64.rpm [root@app-server-3 ~]# sudo rpm -Uhv morpheus-appliance-x.x.x-x.x86_64.rpm [root@app-server-3 ~]# sudo morpheus-ctl reconfigure
The upgrade is complete and the Morpheus-ui services should be running with clustered Elasticsearch and RabbitMQ services across the 3 nodes.
Important
If reconfigure after a rpm package upgrade stalls or hangs on starting a service (mysql, rabbitmq, elasticsearch …) it is possible the morpheus-runsvdir
service did not start or a process it was managing was manually shutdown or killed. To resolve, run systemctl stop morpheus-runsvdir
then systemctl start morpheus-runsvdir
, then run reconfigure again, morpheus-ctl reconfigure
.
v6.0.2 -> v6.1.0 Upgrade¶
Note
Rolling upgrades are supported for v6.0.2 -> v6.1.0 only.
Warning
Morpheus v6.1.0 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 v6.1.0 package installation and before reconfigure to clean old node and vm node packages from the package-repo when room is needed.
Upgrade the RPM 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.x86_64.rpm [root@app-server-1 ~]# sudo rpm -Uhv morpheus-appliance-x.x.x-x.x86_64.rpm [root@app-server-1 ~]# sudo morpheus-ctl stop morpheus-ui [root@app-server-1 ~]# sudo morpheus-ctl reconfigure [root@app-server-1 ~]# sudo morpheus-ctl start morpheus-ui
After the reconfigure has succeeded, tail the ui service to watch ui startup logs with
morpheus-ctl tail morpheus-ui
. Once morpheus-ui is started, proceed to the next node.Once Node 1 upgrade has completed and the u is available, upgrade the RPM 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.x86_64.rpm [root@app-server-2 ~]# sudo rpm -Uhv morpheus-appliance-x.x.x-x.x86_64.rpm [root@app-server-2 ~]# sudo morpheus-ctl stop morpheus-ui [root@app-server-2 ~]# sudo morpheus-ctl reconfigure [root@app-server-2 ~]# sudo morpheus-ctl start morpheus-ui
After the reconfigure has succeeded, tail the ui service to watch ui startup logs with
morpheus-ctl tail morpheus-ui
. Once morpheus-ui is started, proceed to the next node.Then upgrade the RPM 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.x86_64.rpm [root@app-server-3 ~]# sudo rpm -Uhv morpheus-appliance-x.x.x-x.x86_64.rpm [root@app-server-3 ~]# sudo morpheus-ctl stop morpheus-ui [root@app-server-3 ~]# sudo morpheus-ctl reconfigure [root@app-server-3 ~]# sudo morpheus-ctl start morpheus-ui
After the reconfigure has succeeded, tail the ui service to watch ui startup logs with
morpheus-ctl tail morpheus-ui
. Once morpheus-ui is started, proceed to the next node.The upgrade is complete and the Morpheus-ui services should be running with clustered Elasticsearch and RabbitMQ services across the 3 nodes.
Important
If reconfigure after a rpm package upgrade stalls or hangs on starting a service (mysql, rabbitmq, elasticsearch …) it is possible the morpheus-runsvdir
service did not start or a process it was managing was manually shutdown or killed. To resolve, run systemctl stop morpheus-runsvdir
then systemctl start morpheus-runsvdir
, then run reconfigure again, morpheus-ctl reconfigure
.