Skip to main content


Upgrading Unravel from version 4.6.1.x TAR installation to 4.7.5x

This topic provides instructions to upgrade from Unravel v4.6.1.x TAR installation to v4.7.5.x

The following upgrade path is supported for upgrading from Unravel v4.6.1.x TAR installation to v4.7.5.x

  • v4.6.1.xv4.7.5.x

Upgrading Unravel v4.6.1.x TAR installation to v4.7.5.x


Before upgrading Unravel, you must take a backup of the data directory and external database (if using). Perform the following steps:

  1. Stop Unravel.

    <Unravel installation directory>/unravel/manager stop
  2. Archive the entire data directory.

    For example,

    tar czf /archive/destination/unravel-backup.tar.gz /opt/unravel/data
  3. If using an external database, perform a backup of the database.


    For the details on how to back up the database, refer to the documentation for your corresponding database.

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

    For example:

    $ curl -v -u username:password | tar xvz -C /path/to/installation/directory


    The default installation directory is /usr/local. It may have been changed during the initial deployment. Make sure that the same installation directory is used when upgrading Unravel.

  2. Stop Unravel.

    <Unravel installation directory>/unravel/manager stop
  3. Activate the version that you want to upgrade/downgrade to.

    <Unravel installation directory>/unravel/manager activate <Unravel-version>
  4. Apply the changes.

    <unravel_installation_directory>/unravel/manager config apply
  5. Start all the services.

    <unravel_installation_directory>/unravel/manager start 
  6. Check the status of services.

    <unravel_installation_directory>/unravel/manager report 

    The following service statuses are reported:

    • OK: Service is up and running.

    • Not Monitored: Service is not running. (Has stopped or has failed to start)

    • Initializing: Services are starting up.

    • Does not exist: The process unexpectedly disappeared. Restarts will be attempted 10 times.

  7. Remove the old version of Unravel. Do the following:

    1. Remove the pre-conversion-can-be-deleted directory in /usr/local/unravel/versions

    2. Remove the zk_*_data.pre-conversion-can-be-deleted directories in /src/unravel.

    3. Run rpm -e to delete the old RPM. That will also clean up the scripts in /etc/init.d.


If you have used the manager refresh files earlier, the following error is shown. This is because the command resets the content of current.yaml file.

INS00142: Upgrade manager blocked the upgrade, reason: current.yaml state is unexpected.
INSTALL-2347: This is a known issue on 4.6.1.x, run 'manager refresh all' and try the upgrade again.

In such a case, you must follow the instructions and run refresh all command before attempting the upgrade again.

Upgrading Unravel sensors

Refer to Upgrading sensors.


In a multi-cluster deployment, it is mandatory to upgrade the core node before you upgrade the sensors on the edge node.