From 949e17f279e7e5049f4e47c387c8879b004e689d Mon Sep 17 00:00:00 2001
From: Mike McLean <mikem@redhat.com>
Date: Aug 09 2019 14:12:31 +0000
Subject: migration doc


---

diff --git a/docs/source/migrating_to_1.18.rst b/docs/source/migrating_to_1.18.rst
new file mode 100644
index 0000000..353046c
--- /dev/null
+++ b/docs/source/migrating_to_1.18.rst
@@ -0,0 +1,33 @@
+Migrating to Koji 1.18
+======================
+
+..
+  reStructured Text formatted
+
+You should consider the following changes when migrating to 1.18:
+
+DB Updates
+----------
+
+This release has a few schema changes:
+
+    * Several new indexes to speed operations
+    * A ``cg_id`` field has been added to the ``build`` table
+    * A new ``build_reservations`` table
+    * A new ``build_notifications_block`` table
+    * Updates to the data in the ``archivetypes`` table
+
+As in previous releases, we provide a migration script that updates the
+database.
+
+::
+
+    # psql koji koji  </usr/share/doc/koji/docs/schema-upgrade-1.17-1.18.sql
+
+
+Other changes
+-------------
+
+There are numerous other changes in 1.18 that should not have a direct impact
+on migration. For details see:
+:doc:`release_notes_1.18`