Changes between Version 7 and Version 8 of TracMigratePlugin

Timestamp:

Feb 15, 2014, 7:10:13 AM (10 years ago)

Author:

Jun Omae

Comment:

Added example for in-place migration

TracMigratePlugin

@@ -54 +54 @@
 
 == Example ==
-
+=== Usage
 {{{#!sh
 $ ./trac-migrate.py
-Usage: ./trac-migrate.py SOURCE-TRACENV DEST-TRACENV DBURI
+Usage: trac-migrate.py [OPTIONS] SOURCE-TRACENV [DEST-TRACENV] DBURI
+
+  Migrate to new environment with another database or another
+  database without creating a new environment.
+
+Options:
+  -i, --in-place    migrate without creating a new environment
 
 Examples:
-  $ ./trac-migrate.py /path/to/source /path/to/dest sqlite:db/trac.db
-  $ ./trac-migrate.py /path/to/source /path/to/dest postgres://tracuser:password@localhost/trac?schema=destination
-  $ ./trac-migrate.py /path/to/source /path/to/dest mysql://tracuser:password@localhost/trac
+  $ trac-migrate.py /path/to/source /path/to/dest sqlite:db/trac.db
+  $ trac-migrate.py /path/to/source /path/to/dest postgres://tracuser:password@localhost/trac?schema=destination
+  $ trac-migrate.py /path/to/source /path/to/dest mysql://tracuser:password@localhost/trac
+  $ trac-migrate.py --in-place /path/to/source sqlite:db/trac.db
+  $ trac-migrate.py --in-place /path/to/source postgres://tracuser:password@localhost/trac?schema=destination
+  $ trac-migrate.py --in-place /path/to/source mysql://tracuser:password@localhost/trac
 
 }}}
+=== Migration to a new environment
 {{{#!sh
-$ ./trac-migrate.py /path/to/source-tracenv migrate /path/to/destination-tracenv postgres://tracuser:password@localhost/trac?schema=destination
+$ ./trac-migrate.py /path/to/source-tracenv /path/to/destination-tracenv postgres://tracuser:password@localhost/trac?schema=destination
 Copying tables:
   attachment table... 10 records.
@@ -92 +102 @@
   plugins directory... done.
 }}}
+=== Migration to a new database without creating a new environment
+{{{#!sh
+$ ./trac-migrate.py --in-place /path/to/tracenv postgres://trac:password@localhost/trac?schema=new_schema
+Back up trac.ini to trac.ini.migrate-1392447405 in /path/to/tracenv/conf.
+Copying tables:
+  attachment table... 0 records.
+  auth_cookie table... 2 records.
+  cache table... 5 records.
+  component table... 2 records.
+  enum table... 13 records.
+  milestone table... 4 records.
+  node_change table... 58918 records.
+  permission table... 19 records.
+  report table... 8 records.
+  repository table... 15 records.
+  revision table... 13854 records.
+  session table... 2 records.
+  session_attribute table... 4 records.
+  system table... 3 records.
+  ticket table... 4 records.
+  ticket_change table... 3 records.
+  ticket_custom table... 0 records.
+  version table... 2 records.
+  wiki table... 57 records.
+}}}
 
 == Tickets ==