From a6cce91d3c0b3a6dc1a494d7bf09e5d9b2afb48d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Stevan=20Radakovi=C4=87?= <stevan.radakovic@linaro.org>
Date: Wed, 30 Jan 2013 17:11:12 +0100
Subject: Add update instructions.

---
 INSTALL | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/INSTALL b/INSTALL
index b77cb1c..dbea971 100644
--- a/INSTALL
+++ b/INSTALL
@@ -303,3 +303,27 @@ The script will mirror the repositories maintaining their directory structures.
 To update the repositories, as a cron job for the 'rhodecode' user, run:
 
     python scripts/update-repos --repos-dir /opt/rhodecode/git_repos
+
+
+Upgrading the Rhodecode instance
+================================
+
+The rhodecode-setup script also supports update of the Rhodecode to the
+specific tag or branch, while doing the reinstallation of the Rhodecode
+automatically. Downgrade of the database is not supported by the Rhodecode
+tools, so bare this in mind when updating to an older version/tag/branch.
+
+To update the system to a specific tag/branch run the following command
+from the rhodecode-config base directory:
+
+    python scripts/rhodecode-setup --rhodecode-config config/production.ini \
+    --rhodecode-usr $USR --rhodecode-branch $TAG \
+    --rhodecode-checkout-dir $CO_DIR --dbname $DB_NAME \
+    --assume-yes --update
+
+   Explaining variables:
+   * $USR: Rhodecode system user (defaults is: rhodecode)
+   * $TAG: Tag or branch in the Rhodecode cloned repository to which
+     the code base will be updated.
+   * $CO_DIR: path to the directory where Rhodecode was previously cloned.
+   * $DB_NAME: Database name for Rhodecode (default is: rhodecode)
-- 
cgit v1.2.3