annotate examples/trac/wiki-default/TracImport @ 39:71ecbe90aafc

Copy Trac to main branch.
author cmlenz
date Mon, 03 Jul 2006 18:53:27 +0000
parents
children
rev   line source
39
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
1 = Importing ticket data =
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
2
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
3 == Bugzilla ==
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
4
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
5 Ticket data can be imported from Bugzilla using the [http://projects.edgewall.com/trac/browser/trunk/contrib/bugzilla2trac.py bugzilla2trac.py] script, available in the contrib/ directory of the Trac distribution.
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
6
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
7 {{{
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
8 $ bugzilla2trac.py
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
9 bugzilla2trac - Imports a bug database from Bugzilla into Trac.
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
10
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
11 Usage: bugzilla2trac.py [options]
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
12
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
13 Available Options:
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
14 --db <MySQL dbname> - Bugzilla's database
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
15 --tracenv /path/to/trac/env - full path to Trac db environment
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
16 -h | --host <MySQL hostname> - Bugzilla's DNS host name
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
17 -u | --user <MySQL username> - effective Bugzilla's database user
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
18 -p | --passwd <MySQL password> - Bugzilla's user password
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
19 -c | --clean - remove current Trac tickets before importing
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
20 --help | help - this help info
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
21
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
22 Additional configuration options can be defined directly in the script.
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
23 }}}
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
24
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
25 Currently, the following data is imported from Bugzilla:
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
26
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
27 * bugs
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
28 * bug activity (field changes)
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
29 * bug attachments
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
30 * user names and passwords (put into a htpasswd file)
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
31
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
32 The script provides a number of features to ease the conversion, such as:
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
33
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
34 * PRODUCT_KEYWORDS: Trac doesn't have the concept of products, so the script provides the ability to attach a ticket keyword instead.
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
35
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
36 * IGNORE_COMMENTS: Don't import Bugzilla comments that match a certain regexp.
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
37
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
38 * STATUS_KEYWORDS: Attach ticket keywords for the Bugzilla statuses not available in Trac. By default, the 'VERIFIED' and 'RELEASED' Bugzilla statuses are translated into Trac keywords.
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
39
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
40 For more details on the available options, see the configuration section at the top of the script.
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
41
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
42 == Sourceforge ==
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
43
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
44 Ticket data can be imported from Sourceforge using the [http://projects.edgewall.com/trac/browser/trunk/contrib/sourceforge2trac.py sourceforge2trac.py] script, available in the contrib/ directory of the Trac distribution.
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
45
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
46 == Mantis ==
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
47
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
48 Mantis bugs can be imported using the attached script.
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
49
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
50 Currently, the following data is imported from Mantis:
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
51 * bugs
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
52 * bug comments
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
53 * bug activity (field changes)
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
54
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
55 Attachments are NOT imported. If you use the script, please read the NOTES section (at the top of the file) and make sure you adjust the config parameters for your environment.
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
56
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
57 mantis2trac.py has the same parameters as the bugzilla2trac.py script:
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
58 {{{
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
59 mantis2trac - Imports a bug database from Mantis into Trac.
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
60
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
61 Usage: mantis2trac.py [options]
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
62
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
63 Available Options:
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
64 --db <MySQL dbname> - Mantis database
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
65 --tracenv /path/to/trac/env - Full path to Trac db environment
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
66 -h | --host <MySQL hostname> - Mantis DNS host name
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
67 -u | --user <MySQL username> - Effective Mantis database user
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
68 -p | --passwd <MySQL password> - Mantis database user password
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
69 -c | --clean - Remove current Trac tickets before importing
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
70 --help | help - This help info
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
71
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
72 Additional configuration options can be defined directly in the script.
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
73 }}}
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
74
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
75 == Other ==
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
76
71ecbe90aafc Copy Trac to main branch.
cmlenz
parents:
diff changeset
77 Since trac uses a SQL database to store the data, you can import from other systems by examining the database tables. Just go into [http://www.sqlite.org/sqlite.html sqlite] command line to look at the tables and import into them from your application.
Copyright (C) 2012-2017 Edgewall Software