diff --git a/offline/upgrading.md b/offline/upgrading.md index 0821870fa..79ae99188 100644 --- a/offline/upgrading.md +++ b/offline/upgrading.md @@ -11,7 +11,41 @@ $ cd ... # you pick a good location! Obtain the latest airgrap artifact for wire-server-deploy. Please contact us to get it for now. We are working on publishing a list of airgap artifacts. -Extract the above listed artifacts into your workspace: +## Clean up enough disk space to operate: + +### AdminHost +Prune old containers that are generated during our 'd' invocations: +``` +df -h +sudo docker container prune +``` + +### Kubernetes hosts: +Remove wire-server images from two releases ago, or from the current release that we know are unused. For instance, + +``` +sudo docker image ls +VERSION="2.106.0" +sudo docker image ls | grep -E "^quay.io/wire/" | grep $VERSION | sed "s/.*[ ]*\([0-9a-f]\{12\}\).*/sudo docker image rm \1/" + +``` + +If you are running a DMZ deployment, prune the old wire-server images and their dependencies on the SFT kubernetes hosts... +``` +sudo docker image ls | grep -E "^quay.io/wire/(team-settings|account|webapp|namshi-smtp)" | sed "s/.*[ ]*\([0-9a-f]\{12\}\).*/sudo docker image rm \1/" +sudo docker image ls | grep -E "^bitnami/redis" | sed "s/.*[ ]*\([0-9a-f]\{12\}\).*/sudo docker image rm \1/" +sudo docker image ls | grep -E "^airdock/fake-sqs" | sed "s/.*[ ]*\([0-9a-f]\{12\}\).*/sudo docker image rm \1/" +sudo docker image ls | grep -E "^localstack/localstack" | sed "s/.*[ ]*\([0-9a-f]\{12\}\).*/sudo docker image rm \1/" +sudo docker image rm +``` +and remove SFT images from the Wire Kubernetes. +``` +``` + +## Preparing for deployment +Verify you have the container images and configuration for the version of wire you are currently running. + +Extract the latest airgap artifact into your workspace: ``` $ wget https://s3-eu-west-1.amazonaws.com/public.wire.com/artifacts/wire-server-deploy-static-.tgz @@ -22,7 +56,7 @@ Extract this tarball. There's also a docker image containing the tooling inside this repo. -If you don't intend to develop *on wire-server-deploy itself*, you should source the following shell script. +Source the following shell script. ``` source ./bin/offline-env.sh ``` @@ -45,7 +79,7 @@ ansible 2.9.12 ## Artifacts provided in the deployment tarball. -The following artifacts are provided: +The following is a list of important artifacts which are provided: - `containers-adminhost/wire-server-deploy-*.tar` A container image containing ansible, helm, and other tools and their @@ -85,10 +119,11 @@ The following artifacts are provided: ## Comparing the inventory +Copy `ansible/inventory/offline/99-static` to `ansible/inventory/offline/hosts.ini`. + Compare the inventory from your old install to the inventory of your new install. -Open `ansible/inventory/offline/99-static`. Here you will describe the topology -of your offline deploy. There's instructions in the comments on how to set +Here you will describe the topology of your offline deploy. There are instructions in the comments on how to set everything up. You can also refer to extra information here. https://docs.wire.com/how-to/install/ansible-VMs.html @@ -124,8 +159,8 @@ cp ../