annotate MIGRATION.txt @ 410:3a192fe4e709

Typo fix
author Jürgen Hermann <jhermann@users.sourceforge.net>
date Sun, 25 Nov 2001 10:11:14 +0000
parents 00f120add0f7
children a1a44636bace
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
272
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
1 Migrating to newer versions of Roundup
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
2 ======================================
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
3
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
4
276
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
5 Migrating from 0.2.x to 0.3.x
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
6 =============================
272
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
7
402
00f120add0f7 Some version number and documentation fixes.
Richard Jones <richard@users.sourceforge.net>
parents: 394
diff changeset
8 Please read each section carefully and edit your instance home files
00f120add0f7 Some version number and documentation fixes.
Richard Jones <richard@users.sourceforge.net>
parents: 394
diff changeset
9 accordingly.
00f120add0f7 Some version number and documentation fixes.
Richard Jones <richard@users.sourceforge.net>
parents: 394
diff changeset
10
00f120add0f7 Some version number and documentation fixes.
Richard Jones <richard@users.sourceforge.net>
parents: 394
diff changeset
11
276
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
12 Cookie Authentication changes
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
13 -----------------------------
272
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
14 0.3.0 introduces cookie authentication - you will need to copy the
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
15 interfaces.py file from the roundup source to your instance home to enable
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
16 authentication. If you used the classic schema, the interfaces file is in:
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
17
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
18 <roundup source>/roundup/templates/classic/interfaces.py
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
19
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
20 If you used the extended schema, the file is in:
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
21
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
22 <roundup source>/roundup/templates/extended/interfaces.py
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
23
276
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
24 If you have modified your interfaces.Client class, you will need to take
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
25 note of the login/logout functionality provided in roundup.cgi_client.Client
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
26 (classic schema) or roundup.cgi_client.ExtendedClient (extended schema) and
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
27 modify your instance code apropriately.
272
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
28
276
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
29
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
30 Password encoding
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
31 -----------------
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
32 This release also introduces encoding of passwords in the database. If you
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
33 have not edited the dbinit.py file in your instance home directory, you may
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
34 simply copy the new dbinit.py file from the core code. If you used the
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
35 classic schema, the interfaces file is in:
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
36
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
37 <roundup source>/roundup/templates/classic/dbinit.py
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
38
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
39 If you used the extended schema, the file is in:
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
40
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
41 <roundup source>/roundup/templates/extended/dbinit.py
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
42
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
43
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
44 If you have modified your dbinit.py file, you may use encoded passwords:
272
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
45
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
46 1. Edit the dbinit.py file in your instance home directory
276
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
47 1a. At the first code line of the open() function:
272
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
48
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
49 from roundup.hyperdb import String, Date, Link, Multilink
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
50
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
51 alter to include Password, as so:
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
52
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
53 from roundup.hyperdb import String, Password, Date, Link, Multilink
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
54
276
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
55 1b. Where the password property is defined (around line 66):
272
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
56
276
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
57 user = Class(db, "user",
272
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
58 username=String(), password=String(),
276
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
59 address=String(), realname=String(),
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
60 phone=String(), organisation=String())
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
61 user.setkey("username")
272
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
62
276
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
63 alter the "password=String()" to "password=Password()":
272
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
64
276
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
65 user = Class(db, "user",
272
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
66 username=String(), password=Password(),
276
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
67 address=String(), realname=String(),
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
68 phone=String(), organisation=String())
9fa86988375f More info for 0.2.x -> 0.3.0 migration
Richard Jones <richard@users.sourceforge.net>
parents: 272
diff changeset
69 user.setkey("username")
272
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
70
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
71 2. Any existing passwords in the database will remain cleartext until they
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
72 are edited. It is recommended that at a minimum the admin password be
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
73 changed immediately:
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
74
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
75 roundup-admin -i <instance home> set user1 password=<new password>
5f400caecaad Steps to follow when migrating between versions of roundup.
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
76
334
256776bfdfc5 fixed [SF#474749] Indentations lost
Richard Jones <richard@users.sourceforge.net>
parents: 276
diff changeset
77
256776bfdfc5 fixed [SF#474749] Indentations lost
Richard Jones <richard@users.sourceforge.net>
parents: 276
diff changeset
78 Configuration
256776bfdfc5 fixed [SF#474749] Indentations lost
Richard Jones <richard@users.sourceforge.net>
parents: 276
diff changeset
79 -------------
256776bfdfc5 fixed [SF#474749] Indentations lost
Richard Jones <richard@users.sourceforge.net>
parents: 276
diff changeset
80 FILTER_POSITION, ANONYMOUS_ACCESS, ANONYMOUS_REGISTER have been added to
256776bfdfc5 fixed [SF#474749] Indentations lost
Richard Jones <richard@users.sourceforge.net>
parents: 276
diff changeset
81 the instance_config.py. Simplest solution is to copy the default values from
256776bfdfc5 fixed [SF#474749] Indentations lost
Richard Jones <richard@users.sourceforge.net>
parents: 276
diff changeset
82 template in the core source.
256776bfdfc5 fixed [SF#474749] Indentations lost
Richard Jones <richard@users.sourceforge.net>
parents: 276
diff changeset
83
337
8cd545738d8e Features:
Richard Jones <richard@users.sourceforge.net>
parents: 334
diff changeset
84 MESSAGES_TO_AUTHOR has been added to the IssueClass in dbinit.py. Set to 'yes'
8cd545738d8e Features:
Richard Jones <richard@users.sourceforge.net>
parents: 334
diff changeset
85 to send nosy messages to the author. Default behaviour is to not send nosy
394
f43af1e97fdd Added a target version field to the extended issue schema
Richard Jones <richard@users.sourceforge.net>
parents: 356
diff changeset
86 messages to the author. You will need to add MESSAGES_TO_AUTHOR to your
f43af1e97fdd Added a target version field to the extended issue schema
Richard Jones <richard@users.sourceforge.net>
parents: 356
diff changeset
87 dbinit.py in your instance home.
337
8cd545738d8e Features:
Richard Jones <richard@users.sourceforge.net>
parents: 334
diff changeset
88
356
3aee8a37afeb Fixed HTTP headers for top-level index in CGI script
Richard Jones <richard@users.sourceforge.net>
parents: 337
diff changeset
89
3aee8a37afeb Fixed HTTP headers for top-level index in CGI script
Richard Jones <richard@users.sourceforge.net>
parents: 337
diff changeset
90 CGI script roundup.cgi
3aee8a37afeb Fixed HTTP headers for top-level index in CGI script
Richard Jones <richard@users.sourceforge.net>
parents: 337
diff changeset
91 ----------------------
3aee8a37afeb Fixed HTTP headers for top-level index in CGI script
Richard Jones <richard@users.sourceforge.net>
parents: 337
diff changeset
92 There have been some structural changes to the roundup.cgi script - you will
3aee8a37afeb Fixed HTTP headers for top-level index in CGI script
Richard Jones <richard@users.sourceforge.net>
parents: 337
diff changeset
93 need to install it again from the cgi-bin directory of the source
3aee8a37afeb Fixed HTTP headers for top-level index in CGI script
Richard Jones <richard@users.sourceforge.net>
parents: 337
diff changeset
94 distribution. Make sure you update the ROUNDUP_INSTANCE_HOMES after the
3aee8a37afeb Fixed HTTP headers for top-level index in CGI script
Richard Jones <richard@users.sourceforge.net>
parents: 337
diff changeset
95 copy.
3aee8a37afeb Fixed HTTP headers for top-level index in CGI script
Richard Jones <richard@users.sourceforge.net>
parents: 337
diff changeset
96
394
f43af1e97fdd Added a target version field to the extended issue schema
Richard Jones <richard@users.sourceforge.net>
parents: 356
diff changeset
97
f43af1e97fdd Added a target version field to the extended issue schema
Richard Jones <richard@users.sourceforge.net>
parents: 356
diff changeset
98

Roundup Issue Tracker: http://roundup-tracker.org/