Skip to main content


Upgrading Unravel Server


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

This topic provides instructions for the following:

Upgrade Unravel Server - RPM

This topic explains how to upgrade the Unravel Server in case of an RPM installation.

  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.

    • Verify the following items were updated.

      • Database schema

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

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

    • 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

      • es_migration*.out

    • 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/ restart
  8. Check that all daemons successfully started and stayed up.

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

  10. Complete any platform-specific upgrade steps.

Upgrade Unravel Server - Tarball installation

This topic explains how to upgrade the Unravel Server in case of a Tarball installation.

  1. Download and extract the Unravel binaries of the Unravel version that you want to upgrade/downgrade to.

    tar zxf unravel-<version>tar.gz -C /path/to/installation/directory
  2. Stop Unravel.

    <Unravel installation directory>/manager stop
  3. Run the manager refresh all command.

    <Unravel installation directory>/manager refresh all
  4. Activate the version that you want to upgrade.

    <Unravel installation directory>/manager activate <Unravel-version>


    If you activate the upgrade version directly without running the manager refresh all command, the following error message is shown:

    INS00142: Upgrade manager blocked the upgrade, reason: current.yaml state is unexpected.

    When you face this error, you must run manager refresh all and start the upgrade again.

  5. Configure unravel using the following commands:

    <Unravel installation directory>/manager config auto
    <Unravel installation directory>/manager config apply
    <Unravel installation directory>/manager start
    <Unravel installation directory>/manager report

    These will configure Unravel, start the daemons, and check the status of the daemon processes.