Documented the installation and upgrade from beta1 using migrations
This commit is contained in:
parent
b78b693299
commit
df8cc90658
26
README
26
README
|
@ -27,7 +27,7 @@ to install (until somebody sends a patch to properly package Instiki for all tho
|
||||||
5. Install SQLite 3 driver for Ruby from http://sqlite-ruby.rubyforge.org/
|
5. Install SQLite 3 driver for Ruby from http://sqlite-ruby.rubyforge.org/
|
||||||
6. Install Rake from http://rake.rubyforge.org/
|
6. Install Rake from http://rake.rubyforge.org/
|
||||||
7. Execute rm -f db/*.db
|
7. Execute rm -f db/*.db
|
||||||
8. Execute 'rake db_schema_import'
|
8. Execute 'rake migrate'
|
||||||
9. Make an embarrassed sigh (as I do while writing this)
|
9. Make an embarrassed sigh (as I do while writing this)
|
||||||
10. Run 'instiki' again
|
10. Run 'instiki' again
|
||||||
11. Pat yourself on the shoulder for being such a talented geek
|
11. Pat yourself on the shoulder for being such a talented geek
|
||||||
|
@ -77,22 +77,20 @@ to install (until somebody sends a patch to properly package Instiki for all tho
|
||||||
6. Restart Instiki
|
6. Restart Instiki
|
||||||
7. Go over some pages, especially those with a lot of complex markup, and see if anything is broken.
|
7. Go over some pages, especially those with a lot of complex markup, and see if anything is broken.
|
||||||
|
|
||||||
The most common migration problem is this:
|
The most common migration problem is this: if you open All Pages and see a lot of orphaned pages,
|
||||||
If you open All Pages screen and see a lot of orphaned pages,
|
|
||||||
you forgot to run ruby script\reset_references after importing the data.
|
you forgot to run ruby script\reset_references after importing the data.
|
||||||
|
|
||||||
===Upgrading from Instiki-AR Beta 1
|
===Upgrading from Instiki-AR Beta 1
|
||||||
In Beta 2 two new tables are added: sessions and wiki_files. Also, there are some indexes renamed or added.
|
In Beta 2, we switch to ActiveRecord:Migrations. Therefore:
|
||||||
Otherwise, there are no schema changes, table structure is the same as in Beta 1.
|
1. Back up your production database.
|
||||||
Therefore:
|
2. Open command-line session to your database and execute:
|
||||||
1. Create a new development database.
|
create table schema_info (version integer(11));
|
||||||
2. Edit config/database.yml as appropriate.
|
insert into schema_info (version) values (1);
|
||||||
3. Execute 'rake db_schema_import'.
|
3. Go back to the shell, change directory to the new Instiki and execute "rake migrate".
|
||||||
4. Export data (but not structure!) from Beta 1 database.
|
|
||||||
5. Import it into the new one.
|
Step 2 creates a table that tells to ActiveRecord:Migrations that the current version
|
||||||
6. Check that Beta 2 development environment works with imported data, and finally
|
of this database is 1 (corresponding to Beta 1), and step 3 makes it up-to-date with
|
||||||
7. Copy the development database (both data AND structure this time) to production.
|
the current version of Instiki.
|
||||||
Future releases will use Rails Migrations, so the upgrade will be somewhat less of a hassle.
|
|
||||||
|
|
||||||
===Download the latest release from:
|
===Download the latest release from:
|
||||||
* http://rubyforge.org/project/showfiles.php?group_id=186
|
* http://rubyforge.org/project/showfiles.php?group_id=186
|
||||||
|
|
Loading…
Reference in a new issue