aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2015-12-18 12:01:07 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2015-12-18 12:01:07 +0200
commit0b69ab0367d83da4a86d9f9d429d72e00d9e8f7f (patch)
tree47df6f020e67ee2bd0bf041ff1c65c2421310f40
parente6f997a7918d4e53f765b866d3775cc38d1a7ee5 (diff)
Add upgrade procedure
-rw-r--r--INSTALL62
1 files changed, 53 insertions, 9 deletions
diff --git a/INSTALL b/INSTALL
index 7519bb2..fcc4302 100644
--- a/INSTALL
+++ b/INSTALL
@@ -130,6 +130,10 @@ $ psql -c 'SELECT name, summary FROM repository'
$ cp install/share/brep/etc/brep-module.conf config/
$ edit config/brep-module.conf # Adjust default values if required.
+If you happy to run with the default values, you can instead do:
+
+$ ln -s install/share/brep/etc/brep-module.conf config/
+
Here we assume you have setup an appropriate Apache2 virtual server. Open the
corresponding Apache2 .conf file and add the following inside VirtualHost (you
can also find this fragment in install/share/brep/etc/brep-apache2.conf):
@@ -223,16 +227,56 @@ If everything looks good, enable the timer to be started at boot time:
$ systemctl --user enable brep-loader.timer
-8. Upgrade procedure
+8. Upgrade Procedure
+
+During upgrade we will stop apache for what should normally be a short period
+of time. To ensure that there are no surprises, for production environments it
+is generally recommended to first perform the upgrade on a staging machine, for
+example, a VM with an identical setup.
+
+Save the previous installation and configuration, for example, using the
+brep version as a suffix:
+
+$ cp -r config config-`cat install/share/doc/brep/version`
+$ cp -r install install-`cat install/share/doc/brep/version`
+
+Build new version of brep:
+
+$ bpkg -d brep build brep
+
+Stop and disable loader:
+
+$ systemctl --user disable --now brep-loader.timer
+$ systemctl --user stop brep-loader.service
+
+Stop apache:
+
+$ sudo systemctl stop apache2
+
+Install new brep:
-@@ TODO
+$ rm -rf install/*
+$ bpkg -d brep install brep
- - stop apache
- - suspend periodic loader
- - migrate schema
- - resume loader, force a run
- - start apache
+Review brep-module.conf changes that may need to be merged:
- - save old config, install
+$ diff -u install/share/brep/etc/brep-module.conf config/brep-module.conf
-systemctl --user daemon-reload
+Update database schema:
+
+$ psql --quiet -f install/share/brep/package.sql
+
+Start and enable loader:
+
+$ systemctl --user start brep-loader.service
+$ systemctl --user status brep-loader.service
+
+If everything looks good, enable periodic execution:
+
+$ systemctl --user enable --now brep-loader.timer
+
+Start apache:
+
+$ sudo systemctl start apache2
+
+To verify, visit the repository root. To troubleshoot, see Apache logs.