UPGRADING

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