Improve documentation on how to upgrade meilisearch on GCP

[roshammar]

Hi,

First of all, thank you for a great product!

I am running meilisearch v 0.27 in production on a GCP VM.

I followed the official instructions to set his up.

Now I want to upgrade this instance to v 0.28.

I have seen the general instructions for upgrading meilisearch. However, these instructions are for the case where you have installed the binary with

curl -L https://install.meilisearch.com | sh

./meilisearch

This is not really the case for the GCP image, which has this set up automatically.

What would be the recommended way of stopping meili, upgrading to the latest version, and restarting, while keeping the current HTTPS settings, etc?

[curquiza]

Hello @roshammar

I moved this issue to the documentation repo so that the documentation team gets your feedback 😄

We are already aware the current guide to upgrading Meilisearch is not really appropriate for the GCP/AWS/DO users, sorry for this, but this might change! We indeed opened an issue about this: https://github.com/meilisearch/documentation/issues/1849

I ping @alallema who could maybe help you with your last question!

[alallema]

Hi, @roshammar, You are right the Meilisearch image inGCP, AWS or DigitalOcean that we provide is set up differently. Meilisearch is run as a service with systemctl. If you want to upgrade your version you can try the migration script or you can do it yourself using systemctl command:

• First you can check the status of your running Meilisearch with:

  systemctl status meilisearch

• Create a dump of your instance in case.
• Then stop it with:

  systemctl stop meilisearch

• Download the version you want to upgrade to, the one called meilisearch-linux-amd64, and exchange the binary of Meilisearch who is here /usr/bin/meilisearch (rename it to meilisearch).
• Then you just had to restart it with:

  systemctl restart meilisearch

  If you had an error to recover your data or Meilisearch doesn't want to restart you have to move your data.ms who is there /var/lib/meilisearch/data.ms then restarts Meilisearch with your dump like:

  ./meilisearch --db-path /var/lib/meilisearch/data.ms --env production --import-dump "/var/opt/meilisearch/dumps/{{dump_id}}"

• Stop it again and relaunch it with the restart command.
• You can check if everything running well with the systemctl status command. Hope it will help you don't hesitate if something isn't clear or if you encounter any problems.

Edit: After check you will need a dump if your upgrade you Meilisearch in any case so you can skip and directly move your data.ms launch Meilisearch with your dump

[roshammar]

Thank you @alallema and @curquiza for your assistance! Using your instructions, I was able to upgrade without any problems!