From be66791e59b9030b458d817b8269672f0fcc7f14 Mon Sep 17 00:00:00 2001 From: Vitaliy Filippov Date: Sat, 9 Nov 2024 00:57:54 +0300 Subject: [PATCH] Add another note about 1.8 upgrade --- docs/usage/admin.en.md | 9 ++++++++- docs/usage/admin.ru.md | 9 ++++++++- 2 files changed, 16 insertions(+), 2 deletions(-) diff --git a/docs/usage/admin.en.md b/docs/usage/admin.en.md index a90b5b22..42a4aab4 100644 --- a/docs/usage/admin.en.md +++ b/docs/usage/admin.en.md @@ -171,7 +171,14 @@ to make them use the new version of the client library. ### 1.7.x to 1.8.0 -After upgrading version <= 1.7.x to version >= 1.8.0, BUT <= 1.9.0: restart all clients +It's recommended to upgrade from version <= 1.7.x to version >= 1.8.0 with full downtime, +i.e. you should first stop clients and then the cluster (OSDs and monitor), because 1.8.0 +includes a fix for etcd event stream inconsistency which could lead to "incomplete" objects +appearing in EC pools, and in rare cases, probably, even to data corruption during mass OSD +restarts. It doesn't mean that you WILL hit this problem if you upgrade without full downtime, +but it's better to secure yourself against it. + +Also, if you upgrade version from <= 1.7.x to version >= 1.8.0, BUT <= 1.9.0: restart all clients (VMs and so on), otherwise they will hang when monitor clears old PG configuration key, which happens 24 hours after upgrade. diff --git a/docs/usage/admin.ru.md b/docs/usage/admin.ru.md index d8367cbb..d3edf59c 100644 --- a/docs/usage/admin.ru.md +++ b/docs/usage/admin.ru.md @@ -168,7 +168,14 @@ done ### 1.7.x -> 1.8.0 -После обновления с версий <= 1.7.x до версий >= 1.8.0, НО <= 1.9.0: перезапустите всех +Обновляться с версий <= 1.7.x до версий >= 1.8.0 рекомендуется с полной остановкой +сначала клиентов, а затем кластера, так как в 1.8.0 исправлена проблема (неконсистентность +потоков событий от etcd), способная приводить к появлению incomplete объектов в EC-пулах +и, хоть и редко, но даже к повреждению данных при массовых перезапусках OSD. Если вы +обновляетесь без полной остановки - это не значит, что вы обязательно столкнётесь с этой +проблемой, но лучше подстраховаться. + +Также, если вы обновляетесь с версии <= 1.7.x до версии >= 1.8.0, НО <= 1.9.0: перезапустите всех клиентов (процессы виртуальных машин можно перезапустить путём миграции на другой сервер), иначе они зависнут, когда монитор удалит старый ключ конфигурации PG, что происходит через 24 часа после обновления.