Upgrade from 1.2 to 1.3
Aaron's attempt, beta 3
Aaron Peterson, email@example.com http://escargot.icehouse.net/mediawiki is attempting to upgrade his media wiki, here are his commands, in order.
Ironically, this is also the procedure that I use to upgrade between minor releases. It might be possible to just copy over the LocalSettings.php (when your upgrading from 1.3.x to 1.3.y) but I always rebuild it anyway...
- 1 in brief
- 2 getting started
- 3 make mediawiki not accept edits
- 4 database back-up
- 5 apache conf
- 6 start apache
- 7 Reconfiguring mediawiki
- 8 Restoring Customizations
- 9 What NOT to do
Outsider interjection here - I found an overview of what to do, from another user in the what not to do (?) sub-page useful, in that it was a concise overview; sometimes you need concise general directions, other times detailed walk-throughs. This process worked to upgrade my own wiki install and is a loose re-reworking of that overview:
- Back up the database (in case something goes wrong installing)
- Unrar the new mediawiki version into its own new folder
- Redirect (symlink) trafic (from the old wiki folder) to that new folder
- chmod the new wiki folder's /config directory to 777 (everyone can do everything with it)
- Point your browser to the wiki's index.php or config/index.php
- Fill out that install form
- Move the generated localsettings.php in /config up one directory
- chmod the /config directory back to non-readable, writable, or executable
- Restart apache.
- You probably don't need to do anything special like manually copy your old localsettings.php or tweak variables in it to be sure your setup matches (but why not check)
--Mr alex hall 18:28, 19 Dec 2004 (UTC)
open irc channel to #MediaWiki on irc.freenode.net #mediawiki
(retrieved from wikipedia.sourceforge.net --click project page in lower left)
su cd /var/www/localhost mv /home/aaron/mediawiki-1.3.0-beta3.tar.gz ./ tar -xvvzf media<tab> (old mediawiki was in the mediawiki folder, I plan to just symlink versions, or change my apache conf to alias the directories)
the directory listing
root@escargot localhost # ls -lah total 2.0M drwxr-xr-x 9 root root 4.0K Jun 23 22:22 . drwxr-xr-x 4 root root 4.0K Oct 23 2003 .. drwxr-xr-x 2 root root 4.0K Jun 5 02:00 cgi-bin drwxr-xr-x 3 root root 4.0K Sep 26 2003 error drwxr-xr-x 58 apache apache 8.0K Jun 2 14:09 htdocs drwxr-xr-x 3 root root 4.0K Sep 26 2003 icons drwxr-xr-x 11 apache apache 4.0K Jun 23 22:14 mediawiki drwxr-xr-x 14 501 dialout 4.0K Jun 12 18:25 mediawiki-1.3.0beta3 -rw-r--r-- 1 aaron users 1.4M Jun 12 18:28 mediawiki-1.3.0beta3.tar.gz drwxr-xr-x 2 root root 4.0K May 11 19:57 perl -rw-r--r-- 1 root root 617K Jun 23 22:23 wikidb-wikiuser-mediawiki-1.2.6- 2004-06-23 root@escargot localhost #
well now.. this is scarry.. I don't have a user 501 or a group dialout.. and.. yikes.. my permissions might be bad for my /var/www/localhost .. please email me (firstname.lastname@example.org)
chown -R apache mediawiki-1.3.0beta3 chgrp -R apache mediawiki-1.3.0beta3
examine previous settings
vi ./mediawiki/Local<tab> I see this information, at about line 76 $wgDBserver = "localhost" $wgDBname = "wikidb"; $wgDBuser = "wikiuser"; $wgDBpassword (and the password.. which is secret!)
make mediawiki not accept edits
/etc/init.d/apache2 stop (start it later... with start!)
This step technically isn't necessary to backup the database, but if your wiki is publicly available this will prevent any database changes during backup, which could leave your backup in an inconsistent state. (Another option is to create a lock file to disable edits, but this is not as safe.)
in new versions there is a variable to set that will lock the database
$wgReadOnly="we are upgrading mediawiki, please be patient";
It's a good time to backup your database every time you get a new version of mediawiki. This is especially important when you are upgrading from 1.2x to 1.3x because the database undergos a conversion that is not easily reversable. It's also not extremely well tested because there aren't many installations of mediawiki out there.
so the command is:
mysqldump -u wikiuser -p wikidb > wikiuser-wikidb-mediawiki-1.2.6-2004-06-23.sql
(replace usernames and database names, and dates, and versions with appropriate ones, etc)
mysqldump -u <wikiuser> -p <wikidatabase> > <something memorable.sql>
(I use gentoo linux, your flavor may vary)
don't show .php source if php isn't loaded
protect myself from leaking passwords from .php files.
<IfModule !sapi_apache2.c> <Files ~ '\.php$'> Order allow,deny Deny from all Allow from none </Files> <Files ~ '\.phps'> Order deny,allow Allow from all </Files> </IfModule>
alias the mediawiki directory to the proper directory
<IfModule sapi_apache2.c> Alias /mediawiki/ /var/www/localhost/mediawiki-1.3.0beta3/ Alias /mediawiki /var/www/localhost/mediawiki-1.3.0beta3
<Directory /var/www/localhost/mediawiki-1.3.0beta3/> Options +includes Order deny,allow Allow from all </Directory> # <Location /mediawiki> # Options +includes # <Location>
(or simply restart it if you didn't stop it earlier)
what worked for the last step
follow regular installation instructions
escargot localhost # chown -R apache mediawiki-1.3.2 escargot localhost # chgrp -R apache mediawiki-1.3.2 escargot mediawiki-1.3.2 # chmod o+w config
- (now go to http://localhost/mediawiki/ or where ever you put it in your browser)
- click on the configure your wiki link (There was a problem with it in 1.3.2, I had to type in the configure/index.php )
- You already have your database configured, so you don't need the rootdb password, but you do need to fill in the rest of the stuff
escargot mediawiki-1.3.2 # chmod o-w config escargot mediawiki-1.3.2 # cp config/LocalSettings.php ./ escargot mediawiki-1.3.2 # pwd /var/www/localhost/mediawiki-1.3.2
- and you should be done..
You should see output similar to what's in: 1.3 install success
- You'll probably want to copy over your wiki.png, and other custom skins too..
remember to fill in the same database information as was in the last LocalSettings.php / how you setup the database last time. I did not need the root db password, or restore my database.
I have been keeping a symlink called /var/www/localhost/mediawiki pointed to the latest version of mediawiki. I do that by doing:
cd /var/www/localhost rm mediawiki ln -s mediawiki-latest mediawiki
tweak your new LocalSettings.php
- look at your includes/DefaultSettings.php
variables of interest:
$wgScriptPath = "/mediawiki"; $wgStylePath = "$wgScriptPath/stylesheets"; $wgStyleDirectory = "$IP/stylesheets"; $wgLogo = "$wgStylePath/images/wiki.png";
I set my $wgLogo as follows so I don't have to copy the logo over manually.
$wgLogo = "$wgStylePath/../../wiki_persistant/wiki.png"
I also had to add an extra alias to my commonapache2.conf
copy logo over manually
escargot images # cp ../../../mediawiki-1.3.1/stylesheets/images/wiki.png ./ cp: overwrite `./wiki.png'? y escargot images # pwd /var/www/localhost/mediawiki/stylesheets/images escargot images # ls -lah /var/www/localhost/mediawiki lrwxrwxrwx 1 root root 15 Aug 31 04:43 /var/www/localhost/mediawiki -> mediawiki-1.3.2 escargot images #
What NOT to do
/What didn't work is what i tried first, instead of simply following the regular web install.