Manual:Running MediaWiki on XAMPP

XAMPP, a XAMP, can be used to get an environment for your Mediawiki installation up and running pretty quickly on your local machine.

Or you can use an AMP with Mediawiki built in; see Software bundles

Getting Apache and MySQL running

• Download the latest version for your platform (Linux, Windows, Mac OS X, or Solaris) from apachefriends.
• Run the executable to extract it (you can extract it straight to C:\ if you want; it'll create an XAMPP subfolder and put all the files there) and answer the questions setup will ask you.
• At the end, setup will give you an option to start the XAMPP control panel; select that option and it should pop up.
• Check the checkboxes for Apache and MySql and click on their respective Start buttons to start those.

Creating your database

• Direct your browser to http://localhost/xampp/
• Go to phpMyAdmin (on the left sidebar)
• Create a new database (you'll need to enter a name for your new database, e.g., wikidb, and click Create)
• When you create the database, it will take you into it. Click on Privileges (on the top sidebar)
• Click Add a new user
• Enter a name for the user (e.g., wikiuser) and a password. You can leave all the rest blank. You may want to write down your database name, user name, and password, because you'll need those to install Mediawiki.
• Check All global privileges.
• Click Go.

Editing PHP.ini

To make sure that the Apache HTTP server doesn't time out during the creation of the databases, modify the php.ini config file:

1. Open the php.ini file using your favorite text editor and find the following section and change to max_execution_time = 300
2. Save the file and restart Apache

Setting up Mediawiki

• Extract all your Mediawiki folders into the htdocs folder, wherever that is (e.g. c:\xampp\htdocs\), or a subfolder thereof (e.g. c:\xampp\htdocs\mediawiki\).
• Direct your browser to the appropriate page, e.g. http://localhost/mediawiki/
• Follow the Mediawiki installer's instructions, entering the database name, user name, and password you wrote down during the "creating your database" step above.
• If you enabled the "security" option, then you need to Use superuser account. This means the MySQL root account and its password.
• After Mediawiki tells you that everything went smoothly, remember to move your LocalSettings.php from the config folder (e.g. c:\xampp\htdocs\mediawiki\config\) into its parent folder. (The parent folder is the one with bin, configs, docs, etc. subfolders).
• Direct your browser once again to the appropriate page, e.g. http://localhost/mediawiki/ . It should take you to the Main Page of your new wiki. Congratulations! You're done.

Back-up and restore

Please be bold in adding\modifying steps:

Back-up

• In SQL admin, go to the wiki database (typically wikidb), and click Export. Check the first box under "structure" (DROP TABLES), and check the "save as file" checkbox near the bottom. Click Go and save the file to the back-up drive.
• Save the wiki folder from htdocs to the back-up drive. This is "Mediawiki x.x.x" by default but typically it is renamed to "wiki"

Restore

• Install XAMPP on the new server.
• In SQL admin:
  • Create a new blank database with the default options and a name of your choice.
  • Import the database file you backed-up.
  • Change the SQL password of the root for that db (in privileges tab)
• Copy the wiki folder from back-up into the htdocs folder.
• Change localsettings.php to reflect the new db username and password.

External links

• NetBeans Guide to Configuring PHP Development Environment in Windows using XAMPP
• How to set up MediaWiki within XAMPP