Upgrading Central from v1.2.0 to latest version

Support
1

Hi everyone
1. What is the issue? Please be detailed.
I'm about to upgrade Central v1.2.0 (client and server) to the latest version
I have the following beforehand questions:

  1. at which step of the upgrading process should I provide the version I'm upgrading to?
  2. at which step can I change my "olddomain.com" by a "newdomain.com"?
  3. If something possibly went wrong, how can I revert the upgrading process?
    Thanks in advance
2

The high-level steps are as follows:

  1. Take a full machine snapshot and try the upgrade on the snapshot so you know what to expect. Snapshots also allow you to roll back if something goes wrong.
  2. Read all upgrade notes for all versions between your current version and the one you are upgrading to: https://docs.getodk.org/central-upgrade. Try them on your snapshot to make sure you've got all the steps mastered.
  3. If you are changing the domain name, you have two options after you upgrade.
    • If you have devices or dashboards that need to use that same old domain, use a CNAME redirect.
    • If you want a complete break from that domain, you can find/replace the domain by following the "Create Domain Update Script Files" section of @KagundaJM's migration guide.
3

Thank you for your reply, dear Yaw.
I will follow these steps and let you know.
In the meantime, I have a few more questions:
1- I just created a snapshot of my droplet on DO; but I can't find a link to its console in order to perform its upgrading: any idea?
2-
in the following command git submodule update -i, should "i" be replaced by something?

4

Hi everyone.
When I execute the command
"docker compose pull && docker compose build --pull"
at the upgrade's step4, I receive the error message :
'compose' is not a docker command
Could someone help me with that?
Thanks in advance

5

Updating docker compose plugin fixed the "compose is not a docker command" error,
but I get the error message on the attched file.

upgrade step4 error message
upgrade step4 error message1020×101 16.3 KB

Thanks in advance for any help.

6

Hi everyone.
1. What is the issue? Please be detailed.
Prior to Cental upgrading, I'm upgrading an instance built from an image from the source instance.
Upon running the step4 Command, I'm getting the error message below
upgrade step4 error message v2

Any help to solve this with will be much appreciated!
Thanks in advance.
Amal

7

I've checked the directory ./files but can't find any file named "allow-postgres14-upgrade".
Please, where should be "allow-postgres14-upgrade" ?
Thanks in advance for any idea.

8

When you are going from an old version to a new version, it's important to follow all the version-specific upgrade instructions for all the versions at https://docs.getodk.org/central-upgrade.

In the Upgrading to Central v2023.2 section, in step 8.4 it says:

  1. Create a file to prove that you're carefully reading these instructions. This is required to continue.
    $ touch ./files/allow-postgres14-upgrade
9

Thank you for underlining this.
By the way, when upgrading to v2023.2 for instance,
should I replace i by "v2023.2" or by "2023.2" in the command
git submodule update -i
of the standard Upgrade instruction3?