Sure!
First of all, Iām a bit less ācomputer literateā than folks here on average, and havenāt run nodes for a few months. So I donāt know, or I have forgotten, many things that might be evident for others.
Anyway, I remember vaguely that nodeās ability to upgrade should be self-contained, and not dependent on any other component. I remember vaguely, that upgrade may take a few days until all nodes are upgraded. They choose their upgrade time randomly within that window. So I think that my nodes, that I have started afresh at version 4.13 will upgrade themselves. Then I check the instructions, just to be sure.
The upgrade instructions are separate for Launchpad and antctl users. I donāt use any of those, I use Formicaio, so I immediately think that these instructions donāt apply to me, but might still contain something important. Because there are separate instructions saying for exampleā¦
For MacOS/Linux Launchpad Users
⦠I start to doubt. Why is it necessary to open Launchpad? Maybe it just needs to be open for the nodes to upgrade? How does that relate to me who uses Formicaio?
Then the instructions say:
- MacOS/Linux users will auto upgrade assuming you followed the steps in the previous release: Discord
I started afresh, so what āstepsā might it mean, and how do they apply to my situation? I click the link, and I find a post in Discord, posted on 19th December:
OK, so to find out those steps, I am again instructed to click one more link, to even earlier post! I didnāt do that, seemed like a waste of time in my situation, because I am still thinking that it should happen by itself, and what does my fresh nodes have to do with stuff in December?
Then I wait for about 12 hours, but nothing has happened. I try to find information about what was the time period when the auto upgrade happens, but that was not on Autonomi readme in Github. I knew it was said somewhere in the Forum, but couldnāt be bothered to dig it out. At this point I am not sure if nodes are doing it independently or not.
Then, when checking Formicaio, I find out that it has auto upgrading disabled by default. That again is questionable in regards of nodes doing it by themselves. (paging @bochaco). Anyway I enable that, and then I soon see, that there is a clickable āupgradeā -option by every node, and upgrade them manually.
To recap:
The instructions seems to assume that people:
- Have upgraded previously. I had just started afresh.
- Run nodes using Launchpad or antctl. I donāt.
- Create assumption, that nodes are not independent in their upgrade behaviour.
- Donāt provide any sort of description of the upgrade process, against which a user could gauge if everything is alright or not - and it is not easily available in the documentation either.
My proposal is to say something like this:
In all platforms, except windows, nodes of version xx.xx or higher upgrade themselves by date x.x. time xx.xx. UTC without any user actions. If your nodes havenāt upgraded by that time, please keep the logs and submit bug report in this thread.
Then there could be separate instructions for those who wish to upgrade Launchpad or antctl or any other component.