Manual:Installing on MoWeS Portable (Windows)

WOS Portable is one easy way of running MediaWiki as a wiki on a stick. This package is provided by chsoftware

WOS Portable does not need an extra drive letter and it is ready to run instantly after unzipping; just plug a USB stick in any Windows computer and the wiki webserver starts up in your browser.

WOS packages a complete Apache/PHP/MySQL webserver with a wrapper that automatically configures and starts the servers; the Small Edition takes only 20 Mb. It is published under the GNU GPL.

The complete package with MediaWiki 1.6.1, WOS Portable SE 1.1.1, Apache 2.0.5, PHP 5.1.2 (and 4.4.1), and MySQL 4.1.18-nt - all free, open source software - occupies less than 60Mb with an empty wiki. The SQL cache adds another 10Mb or so, in addition to the contents of your wiki.

You can zip the WOS folder that contain your Wiki if you have limited space on your thumbdrive. After zipping the folder the size will shrink about 60% to 70%.

'''This method of installation is not recommended anymore since there is WOS Mixer with a preinstalled MediaWiki. Goto www.wos.chsoftware.net. Select download, select "I do not have a WOS Portable package", then select Apache 2 SE, PHP 5 SE, MySQL 5 SE and MediaWiki. Download, unzip to any writable folder, run from there. Done.'''

The most recent version of MediaWiki offered by the WOS Mixer is 1.11.0

Versions
This procedure has been tested with
 * MediaWiki 1.6.1, WOS Portable SE] 1.1.1 (Apache] 2.0.5, PHP 5.1.2 and 4.4.1, MySQL 4.1.18-nt)
 * MediaWiki 1.7.1, WOS 1.1.2 (Apache 2.2.0, PHP 5.1.2, MySql 5.0.18-nt)
 * MediaWiki 1.9.2, WOSX (with WOS 1.1.2)

Installation
For best results you should always install and run WOS from the root directory of a drive. The first time it's run, WOS configures the paths for the servers based on the current directory. Each time it's started after that, it changes the drive only, so it's a pain to change directories later.


 * 1) Start by downloading the latest versions of MediaWiki and WOS Portable or WOS Portable Small Edition. Alternately, and perhaps most simply, use the WOS Mixer now available.
 * 2) Select the drive for installation. If you'd like to install to your hard disk, you can create a virtual disk using the subst command:


 * 1) Switch to your target drive and unzip the distribution files. Unzip WOS into the root directory, and MediaWiki into a subdirectory of www. It's convenient to rename the subdirectory to "w". The configuration I'm working with looks like this:


 * 1) The default for the apache web server is to listen on port 80 of the host machine. This is likely to cause problems if there's an existing server on your target machine. To change the port number, open the file apache2\conf\httpd.conf in a text editor like notepad.
 * 2) Search for the line that says   and change it to
 * 3) Search for the line that says   and change it to
 * 4) * IANA Port Numbers:
 * 5) ** 80: World Wide Web (HTTP)
 * 6) ** 8080: HTTP Alternate
 * 7) ** 443: HTTP protocol over TLS/SSL (HTTPS)
 * 8) ** 49152 through 65535: Dynamic and/or Private Ports
 * 9) ** 1024 through 49151 should not be used on the Internet without IANA registration.
 * 10) Create the directory   and create a file   in there.
 * 11) Run "start.exe" or "wos.exe" from the root directory.
 * 12) Choose your language, then click through the Terms of Use (which is actually small enough to fit on a dialog box without scrolling!)
 * 13) WOS starts up and displays the WOS Portable - Status dialog. You should see:

If you changed the port number as recommended above, you'll get a 404: Not Found error. Don't worry.
 * 1) WOS will open the welcome page in your web browser.
 * 1) * Open the WOS Portable Options tab and change the value for "Use the following URL in the browser" from  to   (or whatever port you assigned above).
 * 2) * You can either shut down and restart WOS or just copy the address to your browser.
 * 3) * You should now see the WOS startup page.


 * 1) Review the other WOS options; most of the defaults work fine for MediaWiki, except:
 * 2) * You must clear or uncheck the tick the  checkbox, or put   in wos.ini.
 * 3) Shut down and restart WOS by doing the following 2 steps:
 * 4) * Click End, then wait until it closes.
 * 5) * Run "start.exe" and verify that it starts up properly.
 * 6) Run MediaWiki web configuration. Using the directory and port settings above, the address is http://localhost:8080/wiki/config or http://127.0.0.1:8080/mediawiki/config for 1.10.1.
 * 7) If you want to use a Creative Commons license, you should select it first. Scroll down to the Copyright/license section, click on Creative Commons license - choose, and select your license.
 * 8) Fill in the site config information
 * 9) * Name your wiki
 * 10) * Assign a WikiSysop password
 * 11) * You can disable all the email options for a tiny wiki
 * 12) * Assign a wikiuser password for the Database config
 * 13) * If you've changed the root password, enter it here; otherwise, you must clear the Superuser password, because by default WOS runs with the superuser account root with no password.
 * 14) Click Install MediaWiki! After a short delay you should see the MediaWiki 1.6.1 Installation success screen.
 * 15) Move the W:\www\wiki\config\LocalSettings.php file to W:\www\wiki
 * 16) Click on "then follow this link to your wiki" and after a short delay you should see the MediaWiki home page.
 * 17) * Open the WOS Portable Options tab and change the value for "Use the following URL in the browser" from  to   (or whatever port and directory you assigned above).
 * 18) You're not quite done yet. If there's any problem with any of the configuration files (especially if you moved the WOS directory), MediaWiki will behave normally, but the data may be lost when you shut the server down.
 * 19) Shut down WOS - click End, then wait until it closes.
 * 20) Run "start.exe" from the root directory.
 * 21) If you see the MediaWiki home page, you're done.

Troubleshooting
WOS Portable is freeware, and there is no official support.

Here's how to deal with some of the ways I've messed up the installation: make sure you have cleared the WOS Portable Options  checkbox [by doing what?]. If it isn't cleared, you'll need to rebuild the MediaWiki database by doing the following: ''it appears that doing steps 2 and 3 are not sufficient to rebuild the database. (Step 4 can't be completed).'' If you still have a problem, try the troubleshooting hints on the WOS Wiki.
 * Verify the paths in the configuration files  and  . If you changed the WOS directory, then some of the paths may be pointing to the old directory. Changing the drive only is OK.
 * If you see an error message like ,
 * Shut down WOS (WOS has a little pop-up screen as long as it's running, with a "Start/Stop server" and "End" buttons. Click "End" to stop WOS).
 * Delete the W:\mysql\data\wikidb directory and contents
 * Delete or rename W:\www\wiki\LocalSettings.php
 * Start WOS again by double-clicking "start.exe", go to http://localhost:8080/wiki/config, and reinstall the wiki [by doing what?].
 * MediWiki should work with both PHP4 and PHP5. Any custom extensions you have may not.

Hints
A complete WOS installation with an empty MediaWiki takes about 55Mb. If you're really tight for space, you can delete some files: You can (and should!) back up your installation by making a complete copy of the WOS directory tree.
 * Make a backup of the complete installation first!
 * PHP4 is about 4.3Mb and PHP5 is about 3.6Mb. You can delete the one you're not using.
 * If the MediaWiki setup has trouble with the passwords, be sure you enter a blank root password if it is still blank by default, or if you have changed the root sql password be sure they match.
 * The MediaWiki languages subdirectory is about 4.25Mb. You can get it down to 150Kb by deleting all of the Language??.php and Messages??.php files you're not using (but don't delete LanguageUtf8.php).

Revisions

 * April 7, 2006 - Eric Hartwell - MediaWiki 1.6.1, WOS Portable Small Edition 1.1.1