Upgrading

Morpheus provides a very simple and convenient upgrade process. In most cases it is simply a matter of installing the new package on top of itself and reconfiguring the services.

Important

All services except the morpheus-ui must be running during a reconfigure. The morpheus-ui also must be restarted or stopped and started during an upgrade. Failure to do so will result in errors.

Debian / Ubuntu

Simply download the latest package or request the latest package from your account service representative.

Then run the install process as follows:

sudo dpkg -i morpheus-appliance_x.x.x-1.amd64.deb
sudo morpheus-ctl stop morpheus-ui
sudo morpheus-ctl reconfigure
sudo morpheus-ctl start morpheus-ui

This typically is enough to complete a full upgrade. Databases will automatically be migrated upon restart of the application and service version upgrades will automatically be applied.

CentOS / RHEL

Yum based package upgrades are a little different. In this case we want to run a rpm -U command as the package manager is slightly different.

sudo rpm -Uhv morpheus-appliance-x.x.x-1.x86_64.rpm
sudo morpheus-ctl stop morpheus-ui
sudo morpheus-ctl reconfigure
sudo morpheus-ctl start morpheus-ui

Tip

Sometimes it may be necessary to restart all appliance services on the host. In order to do this simply type sudo morpheus-ctl restart. This will restart ALL services.

Morpheus UI war files

Pre-release or patched versions of the Morpheus UI are sometimes provided. To deploy the ui war on a Morpheus Appliance:

  1. Download the war file to the target appliance

    wget https://url/war_file
    

    Note

    If the war file is provided via a droplr link, ensure a + is added to end of droplr url or the file will not download

  2. Backup current war file

    sudo mv /opt/morpheus/lib/morpheus/morpheus-ui.war /opt/morpheus/lib/morpheus/morpheus-ui.bak.`date +"%m-%d-%Y"`
    
  3. Move and rename new war file

    sudo mv <file> /opt/morpheus/lib/morpheus/morpheus-ui.war
    
  4. Ensure war is owned by morpheus-app

    sudo chown morpheus-app.morpheus-app /opt/morpheus/lib/morpheus/morpheus-ui.war
    
  5. Restart the Morpheus UI

    sudo morpheus-ctl restart morpheus-ui
    

The new ui war will load on startup!