I have tried updating my local instance app from the admin page but I got the error message “Error while fetching update” after the upgrade had began. Now I can’t even log in to the app (see caption below) with previous credentials. I also get 502 Gateway error when I refresh the login page
Hi @kembo
I take it this is running on your machine? How are you running it, ie: docker compose, docker helper, node, etc? It sounds like the API is no longer running - can you access the API logs from when you tried to update?
I am running on local machine, docker helper. The cht api logs output this
Ahh thanks. This was reported as a bug two weeks ago. I’m not sure it was ever designed to work, because the admin app has no way to upgrade the docker containers in docker helper. At the very least the “upgrade” button should be disabled in docker helper to avoid this happening, and the documentation should be updated to show how to update manually.
For now, can you deploy a new container using docker helper at the version you want to try?
Noted. That however means starting afresh on populating that new instance with data that was there before in the old (is there a non manual way for this?). Either way I hope a fix will be provided soon or at least the temporary fixes you mentioned
Docker helper stores the data for each project in the ~/medic/cht-docker folder. You should be able to start a new project, shut down all instances, and then copy the files from the old project to the new one.
I am trying to upgrade via admin in my local machine as well. I am using docker desktop in macbook.
I initially had CHT version 4.2 alpha at the beginning and I tried upgrading to 4.7 which gave me error. Then, I tried upgrading to next closest release which was 4.2.1 which went fine. Tried again from 4.2.1 to 4.7 which failed but was able to upgrade to 4.2.2. Then, trying further 4.2.2 to 4.3.0 which also worked.
Is there any limitations on how we upgrade?
@niraj Given that range of versions it sounds like you’re hitting a limitation due to the changing CouchDB version between 4.3 and 4.4, documented here. This is handled gracefully in production using the upgrade service, but this doesn’t work for local installs so you’ll have to manually update these images.
thanks @gareth. I am searching for manual upgrade process as well as where to find images for the upgrade for different versions. Not sure what exact keywords should I search. Could you please point me to the right direction?
The trick is not to upgrade, but to create a new instance, just like you created the others: https://docs.communityhealthtoolkit.org/hosting/4.x/app-developer/#running-the-nth-cht-instance
thanks @gareth. Not sure if I understand correct but I am having difficulty understanding whether I need to change .yml URLs since they say 4.10.0-alpha. If I need version 4.7.1, how do I change it?
Replace master with 4.7.1, eg:
I’m a bit late following up on this thread, but I wanted to call out that Docker Helper very much can do in place upgrades using the admin web UI! The issue that has been filed is great to capture the issue, but this should be fixable!
