Home

Upgrade Unravel

This section provides information about upgrading Unravel and upgrading Unravel sensors.

The following upgrade paths are supported for Unravel.

Tarball supported upgrade path

RPM supported upgrade path

4.6.2.0 to 4.7.0.0

4.6.2.0 to 4.7.0.0

4.6.2.1 to 4.7.0.0

4.6.2.1 to 4.7.0.0

Upgrading Unravel in a single cluster deployment

  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. 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.

Upgrading Unravel in multi-cluster deployment

To upgrade Unravel in a multi-cluster environment, you must upgrade all the edge nodes, upgrade the core node, and pull in all the edges node updates to the core node.

  1. Run the following steps, to upgrade Unravel, on the edge nodes involved in Unravel monitoring.

    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. 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.

  2. Run the following steps only on the core node.

    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. 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. Run manager config edge show to get the list of all the configured edge nodes and then refresh to get the edge node updates to the core node.

      <unravel_installation_directory>/unravel/manager config edge show
      <unravel_installation_directory>/unravel/manager config edge auto <edge-key> --refresh
      
    6. Apply the changes.

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

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

      <unravel_installation_directory>/unravel/manager report 
      

Upgrading Unravel sensors

Refer to Upgrading sensors. In this release, the following platform-specific Sensors must be upgraded:

Important

In case of a multi-cluster deployment, it is mandatory to Upgrade the sensors on the core node.