From 92130619b6c7c3e1125abe7955ce589292e379cf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Nowak?= <luke@nexedi.com>
Date: Wed, 9 Sep 2020 12:40:40 +0200
Subject: [PATCH] software/kvm: Explain how to update boot-image-url-select

---
 software/kvm/README.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/software/kvm/README.rst b/software/kvm/README.rst
index 696ea5cf6..59ada1ffb 100644
--- a/software/kvm/README.rst
+++ b/software/kvm/README.rst
@@ -117,3 +117,18 @@ files for more instance parameters (cpu-count, ram-size, disk-size, specific loc
 
 Then, if you want one of the two clones to takeover, you need to login into
 the hosting machine, go to the partition of the clone, and invoke bin/takeover.
+
+Technical notes
+---------------
+
+Updating boot-image-url-select
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+ * download the new OS installation image
+ * calculate it's sha512sum and store as <SHA512>
+ * calculate it's md5sum and store as <MD5>
+ * upload it to shacache
+ * construct download url: ``https://shacache.nxdcdn.com/<SHA512>#<MD5>``
+ * update the ``boot-image-url-select`` in:
+    * ``instance-kvm-input-schema.json``
+    * ``instance-kvm-cluster-input-schema.json``
-- 
2.30.9