From 5a59ef7c97db680795d5cb9092075ee4905fa3d1 Mon Sep 17 00:00:00 2001 From: Mark Heiges Date: Mon, 30 Nov 2015 10:18:25 -0500 Subject: [PATCH] misc. updates --- README.md | 47 +++++++++++++++++------------------------------ 1 file changed, 17 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index d70e365..6a8c9d5 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,8 @@ This is a Vagrant project to host a development copy of EuPathDB's EasyRedmine It is primarily focused on being a playground for migrating from our -vanilla Redmine 2.3. +vanilla Redmine 2.3, however it can also be used to install EasyRedmine +with an empty database. Once provisioned, Redmine should be available at http://redmine.vm.apidb.org/ @@ -14,52 +15,38 @@ Once provisioned, Redmine should be available at http://redmine.vm.apidb.org/ ansible-galaxy install rvm_io.rvm1-ruby +- Vagrant `landrush` plugin + + ansible-galaxy install landrush + - `scratch/redmine_dump.sql.gz` - a mysql dump of our production database. _(One of the daily backups on our production Redmine server -is suitable. See `/var/lib/mysql.backups/daily/redmine/`.)_ +is suitable. See `/var/lib/mysql.backups/daily/redmine/`.)_ This is +optional. To have the redmine installer create an empty database, set +`do_redmine_db_import` to `False` in `config.yml` - `scratch/easyredmine_package_u2072_d201511101601.zip` - the installation package provided by EasyRedmine (downloaded from their -customer portal). - -- Vagrant `landrush` plugin +customer portal). Set the file name for `installer_package_name` in +`config.yml` - When working with a database imported from our production Redmine, you will need a VPN tunnel to UGA's campus so LDAP authentication queries -can complete. A stock EasyRedmine installation does local -authentication, so no VPN is needed in such case. +can complete. A stock EasyRedmine installation, not using our database, +does local authentication, so no VPN is needed in such case. ## Provisioning Start the virtual machine with `vagrant up`. Vagrant provisions the VM using Ansible. See -`playbook.yml` for configuration options. Especially, +`config.yml` for configuration options. Especially, - `do_redmine_db_import`: if `True`, will import sample data from a -mysql dump file +mysql dump file. If `False`, an empty database will be created by the +redmine installer (if run). + - `do_redmine_installer`: if `True`, will run the redmine installer if `redmine_root_dir` does not exist or if there is a detected change in the database (e.g. you drop it and let Ansible recreate it). -## Configuration - -Configuration variables are in `playbook.yml` - -## EasyRedmine Package - -Place a copy of the EasyRedmine package (obtained from the vendor -customer portal) in `scratch`. Set the file name for -`installer_package_name` in `playbook.yml` - -## Redmine sample data - -To install an empty database, set `do_redmine_db_import` to `False` in -`playbook.yml` - -To import a copy of an existing Redmine database, place a copy of the -MySQL dump file at `scratch/redmine_dump.sql.gz`. _(One of the daily -backups on our production Redmine server is suitable. See -`/var/lib/mysql.backups/daily/redmine/`.)_ - -Set `do_redmine_db_import` to `True` in `playbook.yml`