1 To migrate to a new phpwiki installation you have to backup your old pages
2 (best via a zip dump), configure your new installation, and restore the old
3 pages in PhpWikiAdministration. Or just upgrade your configuration as
8 To upgrade default pages, the database and some config settings
9 add "?action=upgrade" to your HomePage url and press "Enter", which will
10 do most of the upgrades automatically.
11 You might need to enter the DBADMIN_USER and DBADMIN_PASSWD in
12 config/config.ini for SQL databases and default permissions.
16 At first you have to manually create a config/config.ini based on
17 config-dist.ini and your previous index.php. We don't have a script,
18 to do that automatically.
21 ALTER TABLE page CHANGE id id INT NOT NULL AUTO_INCREMENT;
22 NOTE: ?action=upgrade does this also, if your mysql user has the
23 ALTER permissions or DBADMIN_USER and DBADMIN_PASSWD are set.
28 ALTER TABLE session ADD sess_ip CHAR(15) NOT NULL;
29 CREATE INDEX sess_date ON session (sess_date);
32 New pref and session tables have been added for more
37 WikiUser and signin.tmpl changed from $user->getId() to
38 $user->getAuthenticatedId()
39 Authenticated reflects the level (confirmed by password),
40 Signed just the username (possibly by cookie only)
44 To upgrade not-existing pages add "?action=upgrade" to
45 your HomePage url and press "Enter", which will
46 add all fresh pages from pgsrc to your pageset.
47 If you deleted some pages on purpose, you'll have to removed
48 them again with PhpWikiAdminisstration/Remove then.
50 There's no smart "Merge Diffs" yet to upgrade existing docs,
51 this will come with the next release. Also upgrading the
52 database automatically.
56 FIXME: WARNING WARNING: the schemas used by the new databases
57 are completely incompatible with schemas in any previous version
58 (i.e. before release 1.3.1 of PhpWiki). If you install this new
59 PhpWiki, you must start with a new empty database (currently
60 either mysql, postgres or dba). (It will be filled with the
65 Here's an excerpt from a note I posted on phpwiki-talk with my
66 recommendation on how to move a wiki from and older version of
67 PhpWiki to a 1.3.x PhpWiki:
69 From: Jeff Dairiki <dairiki@dairiki.org>
70 Cc: phpwiki-talk@lists.sourceforge.net
71 Date: Fri, 9 Nov 2001 11:33:18 -0800
73 > Now, say I want to migrate all my 1.2.1 pages. I need to do a zip dump
74 > (does the admin page let me do that?) and then.... what?
76 It's still a bit of a messy process at this point. Here's my suggestion.
78 1. Start 1.3.x with an empty database. Browse the FrontPage. This should
79 fill the wiki with the distributed default 1.3.x pgsrc. (You've probably
80 already gotten this far.)
82 2. Make a zip dump of your 1.2 wiki. If the contents of
83 PhpWikiAdministration are correct there should be a links
84 (near the top) which will do that for you. You need to be
85 in admin mode, though. This means you must have set an
86 admin user and passwd in admin.php, and you should be browsing
88 http://path.to.your/wiki/admin.php?PhpWikiAdministration
89 (If your PhpWikAdministration page is broken, then
90 http://path.to.your/wiki/admin.php?zip=all
91 should get you a zip dump.)
93 WARNING! WARNING! WARNING! There is a bug in releases 1.2.0
94 and 1.2.1 of PhpWiki which results in corrupt zip dumps if
95 you are using the DBA, DBM or flat-file backends. If you
96 are using one of those backends you should make sure to
97 fix that bug (see note below) before making the zip dump.
100 3. Now upload your zip dump to your new 1.3 wiki. (First you need to
101 have set the admin user/passwd in the new index.php.) You should
102 be able to use the "Upload File" form on the PhpWikiAdministration
106 If that works, the pages from your 1.2 wiki have now overwritten
107 the 1.3 pages (though the 1.3 pages are still saved in the archive).
108 This will break a bunch of 1.3 functionality until you restore
109 the page contents. Of the top of my head, some pages for which
110 this will be an issue are:
111 MostPopular, RecentChanges, PhpWikiAdministration,
112 MagicPhpWikiURLs, and ReleaseNotes.
114 To restore these pages to the original (1.3) contents:
116 4a. Login as the administration user (using the SignIn button at the
117 bottom right corner of the page.) (You need to do this because
118 some of the pages which need fixing are locked.)
120 4b. Browse to a page which needs restoring. Hit the "History" button
121 (at the bottom of the page). This should get you a list of all
122 archived versions of the page.
124 4c. Browse to the archive 1.3 version of the page (probably version
125 number 1) by clicking on the version number of the desired version.
127 4d. Click the "Edit old revision" button (bottom of page). This should
128 get you to the edit form.
130 4e. Click the "Save" button. This should save the archived page contents
131 as the current contents.
133 We really need to figure out a way to simplify this process, but, for now,
134 that's what you gotta do.
136 An older note on the same subject can be found at:
137 http://sourceforge.net/forum/message.php?msg_id=107858
139 $Id: UPGRADING,v 1.9 2004-12-17 09:23:41 rurban Exp $