Project

General

Profile

Actions

Bug #21005

open

Upgrade notes documentation is not clear enough

Added by Félix DALLIDET over 2 years ago. Updated 5 months ago.

Status:
New
Priority:
N/A
Assignee:
-
Category:
Documentation
Target version:
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.

Actions #1

Updated by Vincent MEMBRÉ over 2 years ago

  • Target version changed from 7.0.3 to 7.0.4
Actions #2

Updated by Vincent MEMBRÉ over 2 years ago

  • Target version changed from 7.0.4 to 7.0.5
Actions #3

Updated by Vincent MEMBRÉ over 2 years ago

  • Target version changed from 7.0.5 to 7.0.6
Actions #4

Updated by Vincent MEMBRÉ about 2 years ago

  • Target version changed from 7.0.6 to 7.0.7
Actions #5

Updated by Vincent MEMBRÉ about 2 years ago

  • Target version changed from 7.0.7 to 7.0.8
Actions #6

Updated by Vincent MEMBRÉ about 2 years ago

  • Target version changed from 7.0.8 to 1002
Actions #7

Updated by Vincent MEMBRÉ about 2 years ago

  • Target version changed from 1002 to 7.1.7
Actions #8

Updated by Vincent MEMBRÉ about 2 years ago

  • Target version changed from 7.1.7 to 7.1.8
Actions #9

Updated by Vincent MEMBRÉ almost 2 years ago

  • Target version changed from 7.1.8 to 7.1.9
Actions #10

Updated by Vincent MEMBRÉ almost 2 years ago

  • Target version changed from 7.1.9 to 7.1.10
Actions #11

Updated by Vincent MEMBRÉ almost 2 years ago

  • Target version changed from 7.1.10 to 1016
Actions #12

Updated by Alexis Mousset almost 2 years ago

  • Category set to Documentation
Actions #13

Updated by Alexis Mousset over 1 year ago

  • Target version changed from 1016 to 7.2.5
Actions #14

Updated by Vincent MEMBRÉ over 1 year ago

  • Target version changed from 7.2.5 to 7.2.6
Actions #15

Updated by Vincent MEMBRÉ over 1 year ago

  • Target version changed from 7.2.6 to 7.2.7
Actions #16

Updated by Vincent MEMBRÉ over 1 year ago

  • Target version changed from 7.2.7 to 7.2.8
Actions #17

Updated by Vincent MEMBRÉ over 1 year ago

  • Target version changed from 7.2.8 to 7.2.9
Actions #18

Updated by Vincent MEMBRÉ over 1 year ago

  • Target version changed from 7.2.9 to 7.2.10
Actions #19

Updated by Alexis Mousset over 1 year ago

  • Target version changed from 7.2.10 to 7.2.11
Actions #20

Updated by Vincent MEMBRÉ about 1 year ago

  • Target version changed from 7.2.11 to 1046
Actions #21

Updated by Alexis Mousset about 1 year ago

  • Target version changed from 1046 to 7.3.8
Actions #22

Updated by Vincent MEMBRÉ about 1 year ago

  • Target version changed from 7.3.8 to 7.3.9
Actions #23

Updated by Vincent MEMBRÉ about 1 year ago

  • Target version changed from 7.3.9 to 7.3.10
Actions #24

Updated by Vincent MEMBRÉ 12 months ago

  • Target version changed from 7.3.10 to 7.3.11
Actions #25

Updated by Vincent MEMBRÉ 10 months ago

  • Target version changed from 7.3.11 to 7.3.12
Actions #26

Updated by Vincent MEMBRÉ 9 months ago

  • Target version changed from 7.3.12 to 7.3.13
Actions #27

Updated by Vincent MEMBRÉ 9 months ago

  • Target version changed from 7.3.13 to 7.3.14
Actions #28

Updated by Vincent MEMBRÉ 7 months ago

  • Target version changed from 7.3.14 to 7.3.15
Actions #29

Updated by Vincent MEMBRÉ 6 months ago

  • Target version changed from 7.3.15 to 7.3.16
Actions #30

Updated by Vincent MEMBRÉ 5 months ago

  • Target version changed from 7.3.16 to 7.3.17
Actions

Also available in: Atom PDF