Skip to main content


Upgrading Unravel Server


Contact Unravel Support before upgrading from Unravel 4.2.x or 4.3.x to Unravel 4.5.x


To determine if it's mandatory to upgrade Unravel sensors when you upgrade Unravel Server, see the release notes.

This topic explains how to upgrade the Unravel Server RPM.

  1. Download the new RPM.

  2. Copy the new RPM to the Unravel host.

  3. Stop all services.

    sudo /etc/init.d/ stop
  4. Upgrade RPM on the host.

    sudo rpm -U unravel-version.rpm*
  5. Add your license key to


    Add your license key to before starting or restarting Unravel Server.

  6. Complete the following checklist before restarting all services.

    1. Verify the following items were updated.

      • Unravel's MySQL database: Check that the sql file with the most recent date in /usr/local/unravel/sql/mysql is present in the output of "select * from schema_migrations".

      • The Unravel Sensor, if you have performed a required or optional update.

      • OnDemand, when applicable. (This required for Unravel's various reports.)

    2. Check the following logs for any issues.

      • unravel_rpm_upgradeyyyy-mm-dd.log, for example unravel_rpm_upgrade_2020-02-19.log.

      • unravel_schema.log

      • unravel_post_fixupyyyymmddtHHMM.out, for example, unravel_post_upgrade_fixups.20200214t2058. (This is deprecated as of v4.5.5.0.)

      • es_migration*.out

    3. If you are running an external database verify unravel_db is disabled or does not exist by running the following command:

      chkconfig --list unravel_db

      If unravel_db exists and is running, switch it off using the following command:

      chkconfig unravel_db off
  7. Restart all services.

    sudo /etc/init.d/ start
  8. Check that all daemons successfully started and stayed up.

  9. Verify Unravel's Web UI/UX is being populated correctly and working correctly.

  10. Complete any platform-specific upgrade steps.