7.1. Upgrade Storm

Storm does not support rolling upgrade of the Storm service. It is best to stop the topology, update the client version to match the new version, and resubmit the topology:

  1. Deactivate your currently running topology, using the CLI or Web UI:

    CLI: storm deactivate <your-topology-name>

    Web UI:

    1. To see a summary page for your topology, go to the Storm Web UI home page (http://<storm-ui-server>:8080) and click on your topology name.

    2. Look for a button to activate, deactivate, rebalance, or kill, on the top left side of the screen. Click "deactivate".

    3. In the popup window, enter the number of seconds after which the topology should be deactivated. Press OK.

  2. Make sure that your topology has been deactivated:

    CLI: storm list

    Web UI: Go to the Storm Web UI home page. You should see topology status in the list of topologies. Make sure the status column lists "Deactivated".

  3. Kill the deactivated topology, so that you can submit a new topology under the same name:

    CLI: storm kill <your-topology-name>

    Web UI:

    1. Go to the Storm Web UI home page and click on your topology name. This should open a summary page for your topology.

    2. Look for a button to activate, deactivate, rebalance, or kill, on the top left side of the screen. Click "kill".

    3. In the popup window, enter the number of seconds after which the topology should be killed. Press OK.

  4. Make sure that your topology has been killed. Note: unlike the deactivate step, which shows the status of your topology, if your topology is killed you will not see an entry for your topology.

    CLI: storm list

    Web UI: Go to the Storm Web UI home page. You should see topology status in the list of topologies. Make sure the status column lists "Deactivated".

  5. Update the component client's version to the new version.

  6. Rebuild your topology jar with the new dependency. (For more information, see "Packaging Storm Topologies" in the Storm User's Guide.)

  7. Upgrade the component to the new version.

  8. Resubmit the topology using the new jar:

    storm jar <jar-path> <main class>

  9. Confirm that your topology is active:

    CLI: storm list

    Web UI: Go to the Storm Web UI home page. You should see topology status in the list of topologies. Make sure the status column lists "Active".

If the upgrade process fails, follow the steps in Downgrading the Cluster, starting with "Downgrade components outside of the cluster." Otherwise, continue with the next upgrade step.


loading table of contents...