Actions
Bug #21005
openUpgrade notes documentation is not clear enough
Pull Request:
Severity:
UX impact:
User visibility:
First impressions of Rudder
Effort required:
Very Small
Priority:
0
Name check:
To do
Fix check:
To do
Regression:
Description
The upgrade notes documentation to upgrade from 6.1/6.2 to 7.0 is confusing.
It starts with https://docs.rudder.io/reference/7.0/installation/upgrade/notes.html#_upgrade_from_rudder_6_1_or_6_2_to_7_0:
It is advised to upgrade the root server before upgrading the relays and the nodes, but 7.0 nodes are also compatible with older server. Two cases are unsupported:
But when you upgrade the server first, you expose yourself to trouble if you are using a custom certificate since the API and node communication now used the same certificate by default.
And here https://docs.rudder.io/reference/7.0/installation/upgrade/notes.html#_agent_side_server_certificate_verification we can read:
Before upgrade: Upgrade agents to 7.0 before the server. This will allow the agent to
The sentence is unfinished but conflicts with the previous statement which recommends to upgrade the root server before the nodes.
If the nodes must be updated first when you are using a custom certificate, I think it should be stated at the top of the documentation, with its limitations (relay upgrade).
But if the root server must always be upgraded first for safety reasons, we should clearly state it and avoid any mention of the other order except in a last resort section.
Updated by Vincent MEMBRÉ over 2 years ago
- Target version changed from 7.0.3 to 7.0.4
Updated by Vincent MEMBRÉ over 2 years ago
- Target version changed from 7.0.4 to 7.0.5
Updated by Vincent MEMBRÉ over 2 years ago
- Target version changed from 7.0.5 to 7.0.6
Updated by Vincent MEMBRÉ over 2 years ago
- Target version changed from 7.0.6 to 7.0.7
Updated by Vincent MEMBRÉ over 2 years ago
- Target version changed from 7.0.7 to 7.0.8
Updated by Vincent MEMBRÉ over 2 years ago
- Target version changed from 7.0.8 to 1002
Updated by Vincent MEMBRÉ about 2 years ago
- Target version changed from 1002 to 7.1.7
Updated by Vincent MEMBRÉ about 2 years ago
- Target version changed from 7.1.7 to 7.1.8
Updated by Vincent MEMBRÉ about 2 years ago
- Target version changed from 7.1.8 to 7.1.9
Updated by Vincent MEMBRÉ about 2 years ago
- Target version changed from 7.1.9 to 7.1.10
Updated by Vincent MEMBRÉ almost 2 years ago
- Target version changed from 7.1.10 to 1016
Updated by Alexis Mousset almost 2 years ago
- Target version changed from 1016 to 7.2.5
Updated by Vincent MEMBRÉ almost 2 years ago
- Target version changed from 7.2.5 to 7.2.6
Updated by Vincent MEMBRÉ over 1 year ago
- Target version changed from 7.2.6 to 7.2.7
Updated by Vincent MEMBRÉ over 1 year ago
- Target version changed from 7.2.7 to 7.2.8
Updated by Vincent MEMBRÉ over 1 year ago
- Target version changed from 7.2.8 to 7.2.9
Updated by Vincent MEMBRÉ over 1 year ago
- Target version changed from 7.2.9 to 7.2.10
Updated by Alexis Mousset over 1 year ago
- Target version changed from 7.2.10 to 7.2.11
Updated by Vincent MEMBRÉ over 1 year ago
- Target version changed from 7.2.11 to 1046
Updated by Alexis Mousset about 1 year ago
- Target version changed from 1046 to 7.3.8
Updated by Vincent MEMBRÉ about 1 year ago
- Target version changed from 7.3.8 to 7.3.9
Updated by Vincent MEMBRÉ about 1 year ago
- Target version changed from 7.3.9 to 7.3.10
Updated by Vincent MEMBRÉ about 1 year ago
- Target version changed from 7.3.10 to 7.3.11
Updated by Vincent MEMBRÉ 11 months ago
- Target version changed from 7.3.11 to 7.3.12
Updated by Vincent MEMBRÉ 10 months ago
- Target version changed from 7.3.12 to 7.3.13
Updated by Vincent MEMBRÉ 10 months ago
- Target version changed from 7.3.13 to 7.3.14
Updated by Vincent MEMBRÉ 8 months ago
- Target version changed from 7.3.14 to 7.3.15
Updated by Vincent MEMBRÉ 7 months ago
- Target version changed from 7.3.15 to 7.3.16
Updated by Vincent MEMBRÉ 6 months ago
- Target version changed from 7.3.16 to 7.3.17
Actions