Skip to main content


Upgrading Unravel from version 4.6.2.x to 4.7.x

This topic provides instructions to upgrade from Unravel version 4.6.2.x to 4.7.x.


  • If you have manually added certificates to unravel’s JVM, those will not be imported when you upgrade to Unravel 4.7x. Therefore, you must add these certificates again. Refer to Configuring Truststore certificates and follow the instructions to add the Truststore certificates.

  • If you have configured Unravel for HTTPS, those configurations will not be imported. Hence, you must re-configure this again. Refer to Enabling Transport Layer Security (TLS) for Unravel UI and follow the instructions to re-configure TLS. Enabling Transport Layer Security (TLS) for Unravel UI


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.

Upgrading Unravel (4.6.2.x to 4.7.x)
  1. Download and extract the Unravel binaries of the Unravel version that you want to upgrade/downgrade to.

  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. Run auto-configuration and refresh to automatically reload the updates.

    <unravel_installation_directory>/unravel/manager config auto --refresh

    After the auto-configuration completes, 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. Delete the old install directory from unravel/versions/<THE.OLD.VERSION>.

Enable hive_worker daemon

After upgrade from versions prior to v4.7.x, you must manually enable the hive_worker daemon.

  1. Open the <Unravel_installation_directory>/unravel/data/conf/unravel.yaml file using an editor.

  2. In the unravel.yaml file, set the hive_worker to true to enable the hive_worker daemon.

        enabled: true
        enabled: true
        enabled: true
        enabled: false
  3. Stop Unravel, refresh the files, and start Unravel again.

    <Unravel installation directory>/unravel/manager stop
    <Unravel installation directory>/unravel/manager refresh all
    <Unravel installation directory>/unravel/manager start