Make it more prominent that the user needs to provide enough disk space for the upgrade

[yanavasileva]

Copied from https://github.com/camunda/camunda-optimize/issues/10482

Context

In the past, we experienced the problem that a user wasn't able to perform the upgrade successfully as there wasn't enough disk space available. The error message also used to be very cryptic:

{"@timestamp":"2020-09-13T20:13:49.208+02:00","@version":"1","message":"Error while executing upgrade from 3.0.0 to 3.1.0","logger*name":"org.camunda.optimize.upgrade.main.UpgradeProcedure","thread_name":"main","level":"ERROR","level_value":40000,"stack_trace":"org.camunda.optimize.upgrade.exception.UpgradeRuntimeException: Error while trying to read reindex progress!\n\tat org.camunda.optimize.upgrade.es.ESIndexAdjuster.waitUntilReindexingTaskIsFinished(ESIndexAdjuster.java:460)\n\tat org.camunda.optimize.upgrade.es.ESIndexAdjuster.reindex(ESIndexAdjuster.java:145)\n\tat org.camunda.optimize.upgrade.steps.schema.UpdateIndexStep.execute(UpdateIndexStep.java:80)\n\tat org.camunda.optimize.upgrade.plan.UpgradeExecutionPlan.execute(UpgradeExecutionPlan.java:77)\n\tat org.camunda.optimize.upgrade.main.UpgradeProcedure.performUpgrade(UpgradeProcedure.java:43)\n\tat org.camunda.optimize.upgrade.main.UpgradeMain.main(UpgradeMain.java:62)\nCaused by: org.elasticsearch.client.ResponseException: method <GET>, host http://localhost:8098, URI </_tasks/pQE1nR1ySrmoqee4HNADnA:1700177>, status line <HTTP/1.1 404 Not Found>\n{\"error\":{\"root*cause\":<

{\"type\":\"resource*not_found*exception\",\"reason\":\"task [pQE1nR1ySrmoqee4HNADnA:1700177> isn't running and hasn't stored its results\"}
],\"type\":\"resource*not_found*exception\",\"reason\":\"task <pQE1nR1ySrmoqee4HNADnA:1700177> isn't running and hasn't stored its results\"},\"status\":404}\n\tat org.elasticsearch.client.RestClient.convertResponse(RestClient.java:260)\n\tat org.elasticsearch.client.RestClient.performRequest(RestClient.java:238)\n\tat org.elasticsearch.client.RestClient.performRequest(RestClient.java:212)\n\tat org.camunda.optimize.upgrade.es.ESIndexAdjuster.waitUntilReindexingTaskIsFinished(ESIndexAdjuster.java:410)\n\t... 5 common frames omitted\n"}

Acceptance Criteria (Required on creation)

• it's more prominent in the upgrade guide that the user needs to ensure that there's enough disk space
• the warning message on the start up of the upgrade script emphasizes the disk space issue

Hints

Links

• is related to https://jira.camunda.com/browse/SUPPORT-8671

Breakdown

Pull Requests

Preview Give feedback

1. https://github.com/camunda/camunda-optimize/pull/14904
2. https://github.com/camunda/camunda-optimize/pull/14940
3. https://github.com/camunda/camunda-docs-optimize/pull/349

Dev2QA handover

• Does this ticket need a QA test and the testing goals are not clear from the description? Add a Dev2QA handover comment

[yanavasileva]

❓ Reproduce the scenario with less memory
Docs: https://docs.camunda.org/optimize/3.14/technical-guide/update/#1-preparation
Code: org.camunda.optimize.upgrade.main.UpgradeMain.main(String...)