From c0a617aa9d1eadd0d00e993c1039f4818d8b2ff5 Mon Sep 17 00:00:00 2001
From: Jiri Vlasak <jiri.hubacek@gmail.com>
Date: Tue, 8 Dec 2020 23:47:17 +0100
Subject: [PATCH] Add upgrade to v0.12.0 section to readme

---
 CHANGELOG.md |  8 ++++++++
 README.md    | 40 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 48 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e6a6053..f643f31 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -19,6 +19,14 @@ Upgraded
 - Client to v0.14.1.
 - Manager to v0.2.0.
 
+Added
+-----
+
+- PostGIS function to split area with custom square size. You need to update
+  database manually. Please, see [Upgrade to `v0.12.0`][] section in readme.
+
+[Upgrade to `v0.12.0`](https://git.sr.ht/~qeef/damn-deploy#upgrade-to-codev080code)
+
 
 0.11.0 - 2020-12-06
 ===================
diff --git a/README.md b/README.md
index 51012df..f5fc5bb 100644
--- a/README.md
+++ b/README.md
@@ -312,6 +312,46 @@ volume:
 
     docker volume rm damn_deploy_damndb-volume
 
+Upgrade to `v0.12.0`
+--------------------
+
+This upgrade introduces custom square width and height when creating areas. The
+function is stored in `damndb/72_st_area_split_custom_square_size.sql` file.
+The steps to upgrade follow.
+
+Stop the damn service and update the repository:
+
+    systemctl stop damn.service
+    git stash
+    git pull
+    git stash pop
+
+Run the database:
+
+    docker-compose up -d db
+
+Import the new function into the database (you will be asked for the password
+stored in `.env` file):
+
+    export DB_HOST=$(docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' damndb)
+    psql -h $DB_HOST -d damndb -U damnuser < damndb/72_st_area_split_custom_square_size.sql
+
+Stop the database container:
+
+    docker-compose down
+
+Finally, there is no need to build the database container again. The database
+is created only once anyway. However, `server`, `client`, and `manager` need to
+be updated:
+
+    docker-compose -f server.yml build --no-cache api
+    docker-compose -f clients.yml build --no-cache client
+    docker-compose -f clients.yml build --no-cache manager
+
+Finally, run the damn service again:
+
+    systemctl start damn.service
+
 
 Damn upkeep
 ===========
-- 
2.30.2