Manual:Installation on Uniform Server (Windows)


 * This article will be moved out of user-space in a few days (when I've finished transferring my notes).
 * These instructions should now be functional, but they need to be re-tested. See .
 * While some sections will probably be split out to other pages later, and  should remain on the procedure page, at least in summary.
 * Please leave any feedback on this article's talk page for now.

A wiki and required web and database servers can be installed, configured and running under various versions of Windows in 10 minutes (with practice and on a good day) after downloading 2 files totalling 7MB in size and following the procedure.

Because the installed and configured software and databases use less than 21MB of storage, everything fits on a 32MB memory card, 32MB USB flash drive, PCMCIA/PC Card/CardBus disk, or other portable media. Having the wiki on a stick is useful for demonstrations, sophisticated note-taking, or super-fast installations using a simple copy. N.B. Always stop the servers and use the system tray "unplug/eject" icon to stop the media before removing it!

Uniform Server v3.2
Uniform Server v3.2 is a quick, easy and small installation containing the servers and platform software for MediaWiki. It includes:
 * web-server Apache 2 (v2.0.50)
 * scripting engine PHP 5 (v5.0.0) & extensions (GD2, mysql, sockets)
 * database administration phpMyAdmin (v2.6.0-beta2)
 * databaser server MySQL 4 (4.0.20d)
 * command scripting Perl 5 (5.8.0.810)

MediaWiki v1.3.3
MediaWiki v1.3.3 is the same wiki software seen here, and consists of PHP web scripts and libraries (including PHPTAL and optional memcached support), and a database schema, data, and interfaces.

Download

 * 1) Uniform Server (3,808,846 bytes): http://prdownloads.sourceforge.net/miniserver/UniServer3_2.exe?download
 * 2) MediaWiki (1,648,692 bytes): http://prdownloads.sourceforge.net/wikipedia/mediawiki-1.3.3.tar.gz?download

Install the servers

 * Run . This extracts the actual installation and will ask for a destination folder - i.e. do not unpack to a temp folder.  It creates a sub-folder called " ", which is the top of the folder tree for everything here. The folder can be renamed later.
 * (The default MySQL password for the " " user is " ", which will be used in this procedure.)

Configure the servers

 * 1) Open the file   in wordpad (not notepad, due to Unix-style line-feeds):
 * 2) Apache has 250 threads by default - reduce to 16 for lighter testing (search for " " in the file)
 * 3) Change " " to " " - this restricts access to the local computer (which can be referred to as " ")
 * 4) Save and close the file

Install the wiki

 * 1) Unpack the MediaWiki zip file under the sub-folder  .  (One free tool to unpack zip files is 7-zip.)
 * 2) The unpacking creates a sub-folder called " ", which should be renamed.  (These instructions will use the folder name " " as an example.)

Initial wiki configuration
needs an unused drive letter. These instructions use.
 * 1) Start both the web and database servers:
 * 2) In your webbrowser, open
 * 3) Follow the link to the configuration page
 * 4) Set the site name (if you use lower-case for the first letter, it will be capitalised on most of the wiki pages)
 * 5) Set the Sysop password (for the default initial privileged user  )
 * 6) Set the database user password (for the default database user  )
 * 7) Supply the database   password of  
 * 8) Press the button
 * This writes the file  and creates the   database, with one initial user ( ).
 * An empty page is displayed (probably due to a bug in this procedure or a wiki script).


 * 1) In your webbrowser, open
 * 2) Set   from " " to " " & press "Save"
 * 3) Click "Back to main page"
 * 4) Click "Shut-down the server"
 * 5) Copy the file   up one level from "wi\config" to "wi"

Optional wiki features
These can also be configured later.

Warnings:
 * Make backup copies before editing
 * Editing  with notepad or wordpad results in linefeeds being lost when the wiki restarts.
 * Edit while the servers are stopped

Uploads
Uploads are disabled by default. To enable them:
 * 1) Open
 * 2) Find " ", and remove the " " in front of it
 * 3) Save and close the file

Email
If you do not have a SMTP server running on the local computer, pages that email will display an error. To use another SMTP server:
 * 1) Get the name or IP address of the SMTP server on your LAN or at your ISP
 * 2) Open
 * 3) Change the SMTP server from " " to the name of the actual SMTP server
 * 4) Optionally change " " to use an actual email address for receiving bounces from inter-user email
 * 5) Save and close the file
 * 6) Open
 * 7) Find and change the two instances of " " to the relevant email address
 * 8) Save and close the file

Default skin
To set a different default skin:
 * 1) Open
 * 2) Find " ", and remove the " " in front of it, and change " " to " " (or " " or " ")
 * 3) Save and close the file

Tidy up

 * 1) Start the servers again:
 * It's should now be working, but these next steps can be done immediately.


 * 1) In your webbrowser, open
 * 2) Login as
 * 3) In your webbrowser, open
 * 4) Edit the sub-title (keep it short)
 * 5) Press the "Save" button.
 * 6) In your webbrowser, open
 * 7) Type (or copy & paste):
 * 8) Press the "Save" button
 * 9) In your webbrowser, open
 * 10) Type (or copy & paste):
 * 11) Press the "Save" button
 * 12) If you didn't choose GFDL as the license during wiki configuration, open
 * 13) Edit the page to match the license
 * 14) Press the "Save" button

Other pages to edit soon
These empty pages are already linked to from other pages, so they should be edited soon.
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * You may want to add a sandbox to assist new users ...

Troubleshooting & support resources
usr\local\Apache2\logs\error.log usr\local\mysql\data\.err access.log
 * These log files may contain clues if errors seem to be happening:
 * There is a MediaWiki mailing list archived at ... To subscribe, see ...
 * freenode.net has IRC channels called ...

How to throw away the wiki and start again

 * 1) In your webbrowser, open
 * 2) Click the "Drop" tab to remove the selected wikidb database
 * 3) Stop the database server using
 * 4) Delete   from the   sub-folder
 * 5) Follow the instructions again from

How to throw it all away and start again

 * 1) Stop the servers using
 * 2) Delete the top folder
 * 3) Follow the instructions again from

Software limitations

 * No monobook skin, as MediaWiki automatically disables it due to the included PHPTAL library being incompatible with included PHP 5
 * No maths markup, due to lack of compiled texvc Win32 software
 * Image resizing does not support certain formats, due to lack of ... software

Procedure limitations

 * The servers only run while you are logged-in

Other limitations

 * Running the wiki from portable writable media, while convenient, is slow.

Security considerations
The procedure only allows access to the web-server from the local machine. Once this changes, other aspects need to be considered for security.

Wiki security model
... overview & links ...

Types of users

 * Anonymous : ...
 * Registered : ...
 * Registered with sysop privileges : ...

Wiki access

 * Connecting to the wiki : ...
 * Reading the wiki : ...
 * Becoming a registered user : ...
 * Editing the wiki : ...
 * Special privileges (e.g. deletion) : ...

Wiki access models
Combining the types of user and types of access gives a security policy or access model. Common examples are: ...

Privacy

 * Internet : ... server certificates, caches ...
 * Web browser : ... cookies, cache, history, auto-completion, passwords ...

Servers
... httpd IP address and port, mysql IP address ...

General
... mention firewalls/NAT/packet-filters, passwords, config folder, test database ...

How to access the wiki from other computers
... httpd.conf ... edit files ...

Multiple wikis
...

Internationalisation
... phpAdmin, multiple wikis ...

Licensing
Despite the variety of licenses, all components can be copied, modified, installed and run for free for private, public or corporate use. Source code is freely available for all binary components. Restrictions may apply if you wish to claim ownership of, sell, or relicense the components. Read the licenses for the actual terms.


 * Uniform Server v3.2: BSD-revised-style license
 * ActiveState Perl 5.8.0.810: ActiveState Community License
 * Perl 5: choose one of the Artistic License or the GNU General Public License (GPL v2)
 * Apache v2.0.50: Apache License v2.0.
 * MySQL 4.0.20d: GPL v2
 * PHP 5 v5.0.0: PHP License v3.0
 * Zend Engine 2: Zend Engine License v2.00
 * phpAdmin v2.6.0-beta2: GPL v2
 * FPDF v1.51: "freeware" (public domain)
 * PHPFM v0.2.3 (plugin): GPL v2
 * go-pear v1.57 (plugin): choose one version of these PHP Licenses: v2.0 or v3.0
 * blowfish (library): GNU Library General Public License
 * profiling (library): Mozilla Public License (MPL) (the version does not seem to be specified, and could be v1.0 or v1.1)


 * MediaWiki v1.3.3: GPL v2
 * PHPTAL-NP-0.7.0: GNU Lesser General Public License v2.1 (GLGPL)
 * pear v1.1: PHP License v2.0

Also, some documentation-type files may be covered by the GNU Free Documentation License (GFDL) v1.1 or v1.2. Some library-type files may be covered by a GLPL: GNU Library General Public License or GNU Lesser General Public License. Some library files do not contain license information, some of which do contain copyright notices and/or attributions.

To be done

 * Sort out  line-feed problem
 * Document how to change MySQL's listening addresses
 * Document how to change MySQL's root password
 * Test from a read-only image, e.g. CD-ROM
 * Can the " " feature be enabled within the criteria?
 * Reduce storage usage to less than:
 * 20MB to fit on an Iomega Bernoulli Box floppy disk
 * 16MB to fit on a smaller memory card / USB stick