Update of /cvsroot/phpwiki/phpwiki In directory usw-pr-cvs1:/tmp/cvs-serv11398 Modified Files: UPGRADING Log Message: Updated notes on how to move an older PhpWiki to a new 1.3.x wiki. Index: UPGRADING =================================================================== RCS file: /cvsroot/phpwiki/phpwiki/UPGRADING,v retrieving revision 1.4 retrieving revision 1.5 diff -C2 -r1.4 -r1.5 *** UPGRADING 2001年11月07日 22:27:54 1.4 --- UPGRADING 2001年11月09日 20:36:45 1.5 *************** *** 1,59 **** FIXME: WARNING WARNING: the schemas used by the new databases are completely incompatible with schemas in any previous version ! of PhpWiki. If you install this new PhpWiki, you must start with a ! new empty database (currently either mysql or dba). (It will be ! filled with the usual default pages.) FIXME: add more. ! More comprehensive updgrading information is forthcoming... however in ! the meantime, this message is in the Open Discussion board on ! Sourceforge (see URL below for the thread). In it Jeff describes how ! to dump your current Wiki to a zip file and load the zip file into a ! new Wiki. ! ! To: no...@so... ! Subject: [phpwiki - Open Discussion] RE: convert dbm to mySql ! From: nobody <no...@so...> ! Date: 2001年2月09日 16:42:57 -0800 ! ! Read and respond to this message at: ! http://sourceforge.net/forum/message.php?msg_id=107858 ! By: dairiki ! ! Yes this is a little clumsy and non-obvious. ! I'm currently working on making it better (at least ! in the development branch.) ! ! In the mean time, here's how I suggest you ! ! Get either a zip dump, or a serialized dump from your ! old wiki. (But first, create a copy of FrontPage called HomePage, or ! else you will have trouble loading the new wiki. It will try to load ! the zip file every time since it doesn't detect a HomePage. --SW) ! ! (If your using a zip dump, it must (for now) be ! on the server machine. Copy it there if it's not ! there yet.) ! ! Edit lib/config.php in the new wiki and set WIKI_PGSRC ! to point either to your zip file, or the the serialized ! dump directory. ! ! Blow away the database of your new wiki. ! (Delete the db files for a db base wiki, ! or do something like: ! mysql -u <user> -p <database> < schemas/schema.mysql ! to blow away a mysql based wiki. ! ! Now with your web browser, go browse to ! the HomePage of your new wiki. It will detect ! that it's working with a virgin database and ! will pull in the pages from the source ! specified in WIKI_PGSRC. - Jeff $Id$ --- 1,78 ---- FIXME: WARNING WARNING: the schemas used by the new databases are completely incompatible with schemas in any previous version ! (i.e. before release 1.3.1 of PhpWiki). If you install this new ! PhpWiki, you must start with a new empty database (currently ! either mysql, postgres or dba). (It will be filled with the ! usual default pages.) FIXME: add more. + Here's an excerpt from a note I posted on phpwiki-talk with my + recommendation on how to move a wiki from and older version of + PhpWiki to a 1.3.x PhpWiki: + + From: Jeff Dairiki <da...@da...> + Cc: php...@li... + Date: Fri, 9 Nov 2001 11:33:18 -0800 + + > Now, say I want to migrate all my 1.2.1 pages. I need to do a zip dump + > (does the admin page let me do that?) and then.... what? + + It's still a bit of a messy process at this point. Here's my suggestion. + + 1. Start 1.3.x with an empty database. Browse the FrontPage. This should + fill the wiki with the distributed default 1.3.x pgsrc. (You've probably + already gotten this far.) + + 2. Make a zip dump of your 1.2 wiki. If the contents of + PhpWikiAdministration are correct there should be a links + (near the top) which will do that for you. You need to be + in admin mode, though. This means you must have set an + admin user and passwd in admin.php, and you should be browsing + through a URL like: + http://path.to.your/wiki/admin.php?PhpWikiAdministration + (If your PhpWikAdministration page is broken, then + http://path.to.your/wiki/admin.php?zip=all + should get you a zip dump.) + + 3. Now upload your zip dump to your new 1.3 wiki. (First you need to + have set the admin user/passwd in the new index.php.) You should + be able to use the "Upload File" form on the PhpWikiAdministration + page. + + + If that works, the pages from your 1.2 wiki have now overwritten + the 1.3 pages (though the 1.3 pages are still saved in the archive). + This will break a bunch of 1.3 functionality until you restore + the page contents. Of the top of my head, some pages for which + this will be an issue are: + MostPopular, RecentChanges, PhpWikiAdministration, + MagicPhpWikiURLs, and ReleaseNotes. + + To restore these pages to the original (1.3) contents: + + 4a. Login as the administration user (using the SignIn button at the + bottom right corner of the page.) (You need to do this because + some of the pages which need fixing are locked.) + + 4b. Browse to a page which needs restoring. Hit the "History" button + (at the bottom of the page). This should get you a list of all + archived versions of the page. + + 4c. Browse to the archive 1.3 version of the page (probably version number + 1) by clicking on the version number of the desired version. + + 4d. Click the "Edit old revision" button (bottom of page). This should + get you to the edit form. + + 4e. Click the "Save" button. This should save the archived page contents + as the current contents. ! We really need to figure out a way to simplify this process, but, for now, ! that's what you gotta do. + An older note of mine on the same subject can be found at: + http://sourceforge.net/forum/message.php?msg_id=107858 $Id$