View source for Manual:Installation on Uniform Server (Windows)/en

<languages />
{{Outdated}}
{{merge|Manual:Installing MediaWiki|discuss=Thread:Project:Current issues/Installation guide consolidation |date=June 2014}}The instructions in this guide refer to a version of [https://www.uniformserver.com/ Uniform Server] which is over 10 version numbers old and assumes that the most recent OS available is Windows XP. The process to install MediaWiki using Uniform is now significantly different. Those wishing to create a local MediaWiki who are not already familiar with Uniform should consider using [[Manual:Running MediaWiki on Windows|XAMPP and the Bitnami MediaWiki installer]], which can install a modern version of MediaWiki in a few minutes with minimal user input.
{{Installation Guides}}
<!-- The goal of this page is to be a self-contained installation guide that is as quick and easy as possible without too much functional and security compromise -->

[https://www.uniformserver.com/ Uniform Server] is one of several WAMP systems.
It allows a wiki and required web and database servers to be installed, configured and running under various versions of Windows in 10 minutes (with practice and on a good day) after downloading 2 files totaling 7MB in size and following the procedure below.

Because the software and databases use less than 21MB of storage, it can allow you to set up MediaWiki as a {{ll|Manual:Wiki on a stick|Wiki on a stick}}.
For an alternate, possibly simpler, way to do this on a Windows system, see {{ll|Manual:Installing on WOS Portable (Windows)}}.

__TOC__

== Procedure ==
This procedure installs the main [[#Components|components]] needed to run MediaWiki on Windows.
See [[#Requirements|#Requirements]] before starting, and if you have problems see [[#Troubleshooting & support|#Troubleshooting & support]].

=== Download ===
{| border="1" cellspacing="0" cellpadding="4"
|-
|align="right"|1.
|align="center"|Uniform Server
|align="center"|v3.5 (don't work)
|align="right"|ca. 7 Mb (compressed)
|[http://downloads.sourceforge.net/miniserver/UniServer3_5.exe?download Download]
|-
|align="right"|2.
|align="center"|MediaWiki
|align="center"|currently {{MW stable release number}}
|align="right"|ca. 4 Mb (compressed)
|{{ll|Download}}
|}

==== Alternate Approach ====
You can use WOS Portable from CH Software instead of Uniform Server.
WOS Portable does not need an extra drive letter and it is ready to run instantly after unzipping.
It is published under the GNU GPL.
You can get it from [http://www.chsoftware.net/en/useware/mowesmixer/mowesmixer.htm?step=2 MoWeS Mixer - CH Software]
(See {{ll|Manual:Wiki on a stick with WOS (Webserver on Stick)}} for instructions.)

{{anchor|Install UniformServer}}
=== Install the servers ===

*Run <code>UniServer3_5.exe</code>. This is a self-extracting compressed file that contains the Apache and MySQL server files for the wiki. During the extraction you will be asked for a destination folder. Click the browse button and find the storage device you want to use for the wiki.

The extraction creates a folder called "<code>Uniform Server</code>".
This folder contains a sub-folder called "<code>udrive</code>", which is the top of the folder tree that will become a drive letter.
You can rename "<code>Uniform Server</code>" if the name offends you.
Do not rename "<code>udrive</code>" unless you want to spend a lot of time changing the references to that directory.

=== Edit two text files to configure the servers ===

Edit the config file for the Apache server by following these steps:

# If it is not already there, create a sub-folder under <code>udrive</code> called "<code>tmp</code>". <!-- But no usage of this has been confirmed yet under Windows. ... -->
# Open the file <code>udrive\usr\local\Apache2\conf\httpd.conf</code>* in a text editor (such as WordPad).
# Search for "<code>ThreadsPerChild</code>" and change <code>250</code> to <code>16</code>. The lower number of threads is better for testing.
# Search for "<code>Listen 80</code>" and change it to "<code>Listen 127.0.0.1:80</code>" - this restricts access to the local computer. You will also see the local computer called the "<code>''localhost''</code>" in some of these instructions.
# Save and close this file

<nowiki>*</nowiki>Note: In previous versions of Uniform Server the <code>udrive</code> folder was named <code>diskw</code>.

Edit the config file for the MySQL server by following these steps:

# Open a text editor, such as Notepad, and set the file type to show ''all files''. Open  <code>udrive\usr\local\mysql\bin\my-small.cnf</code>. If you try to find the file the usual way to double-click and open it, Windows Explorer shows this file as a shortcut named <code>SpeedDial</code> and will not open it in the text editor. If you have problems opening this file, try dragging the ''my-small'' icon into an open text editor window.
# Search for "<code>[mysqld]</code>". Insert one line under "<code>[mysqld]</code>" and type this text onto that line: <code>bind-address=127.0.0.1</code>
# Save and close this file

=== Install the MediaWiki software ===
MediaWiki is a compressed file that can be uncompressed by most "Zip" utilities.
One [http://www.gnu.org/copyleft/lesser.html free] Windows tool to uncompress zip files is [http://www.7-zip.org/ 7-zip].
There exists a command line version for linux called [http://sourceforge.net/projects/p7zip/ p7zip].

If you use WinZip, you must turn off the "TAR file smart CR/LF conversion" (look under Options|Configuration|Miscellaneous), to prevent corruption of the configuration file.
Also be sure that the "Use Folder Names" option is selected.

Depending on the decompression tool, you may need to do a second decompression for the <code>.tar</code> file that is inside the <code>.gz</code> file.
Look in the folder after the first decompression: if all you see is the <code>.tar</code> file, uncompress it.

# Uncompress the MediaWiki zip file into the sub-folder <code>udrive\www</code>.
# Unpacking creates a sub-folder called "<code>mediawiki-''x.y.z''</code>", where "''x.y.z''" is the version number of the wiki software. This folder will contain your wiki. The folder name is part of the URL for the wiki.
# These instructions use the folder name "<code>wi</code>". It is easier to follow the instructions if you rename "<code>mediawiki-''x.y.z''</code>" to "<code>wi</code>" until you have the wiki working. Then you can rename the folder to whatever you want.

=== Configure the wiki ===
The installation at this point is 39 MB.
How do you reduce the size of the installation?
One option is to check the MediaWiki languages subdirectory, which 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).
This still only gets the installation down to 35 MB.
It is not explained sufficiently in the article how to get it down to the 21 MB.

==== Assigning a drive letter ====
Windows uses drive letters, not names.
Most systems will have a C: drive, and may have a D: and E: or even more.
Any hard drives, CD/DVD drives and USB storage devices will have their drive letter automatically assigned.
The Wiki "server-start.bat" file sends a command to Windows that makes Windows act as if the Wiki directories on the memory stick are on a hard drive of their own.

These instructions use "w" as the drive letter.
To make sure this is a valid drive letter, look at "My Computer" and see which letters have been assigned to local and network hard drives.
In the example below, a typical Windows installation, drives C, D, and E are assigned.

[[Image:StickWiki_drive_letter.png]]

'''NB:''' If the drive letter is changed from "w", the Uniform Server administration configuration file (<code>udrive/home/admin/www/includes/config.inc.php</code>) must also be updated, or the Admin Panel won't be accessible.
Search for "<syntaxhighlight lang=php inline>$drive = "W:";</syntaxhighlight>" and specify the correct drive letter.

====Editing the Uniform Server start-up script (optional)====

The script used to start the Uniform Server has the following syntax:

<code>Server_Start.bat {''drive letter''} {mysql} {console}</code>

''Comments:''

* If no drive letter is specified, &quot;w&quot; is used by default.
* Specifying &quot;<code>mysql</code>&quot; as the second argument will make MySQL start automatically.
* Specifying &quot;<code>console</code>&quot; as the third argument will leave the console window open after the servers have been started.

In order to remove the need for supplying command line arguments to the start-up script, it can be modified as follows:

# Open <code>Server_Start.bat</code> in a text editor
# Find this line:  <code>IF &quot;%Disk%&quot;==&quot;&quot; set Disk=w </code>
# Replace <code>Disk=w</code> with <code>Disk=k</code> to set &quot;k&quot; as the default drive.

====Creating shortcuts for starting and stopping the servers====

*Right-click on	Server_Start.bat and drag it to your desktop. Select &quot;Create Shortcuts Here&quot;. Label the shortcut &quot;Start Wiki Servers&quot;
*Right-click on	stop.bat and drag it to your desktop. Select &quot;Create Shortcuts Here&quot;. Label the shortcut &quot;Stop Wiki Servers&quot;

====Starting the Wiki Servers====

<OL>
	<LI><P>Doubleclick the &quot;Start Wiki Servers&quot; shortcut icon to start the servers.</P></LI>
	<LI><P>This starts the servers' admin page in your web browser. You may get an error the first time due to timing. Click OK on any error messages. A refresh should confirm the server is running.<br/>If you see a blue screen that resembles this, the Apache server is working.</P>

<P>Successful server start.</P>
	</LI>
	<LI>Click "Run MySQL" on the left side of the Uniform Server window</LI>

====Configuring the Wiki Variables====
<OL>
	<LI><P>With your browser, open this file by typing or pasting this URL: http://localhost/wi/mw-config/index.php</P></LI>
	<LI><P>Fill in the variables on that page.</P></LI>
</OL>
<OL>
	<OL>
		<UL>
			<LI><P>The warning about register_globals can be ignored. You will fix it in the next step.</P></LI>
			<LI><P>If you use lower case for the first letter of the site name, it will be capitalised on most of the wiki pages.</P></LI>
			<LI><P>Leave &quot;MySQL server&quot; as localhost</P></LI>
			<LI><P>Set &quot;DB root password&quot; to <I>root</I> (Yes, it's BAD from a security standpoint, but it won't work with a proper password) the name has also to be set to root</P></LI>
		</UL>
	</OL>
</OL>
	<LI><P>Click the Install button at the bottom of the page.<br/><br/>This writes the file LocalSettings.php and creates the <I>wikidb</I> database, with one initial user (<I>WikiSysop</I>). An empty page is displayed.</P>

'''Problems probably MySQL is not running.'''
run <code>\Uniform Server\udrive\usr\local\mysql\mysqlrun.bat</code>

'''Something wrong here''' - error message MySQL server localhost "Couldn't connect to database".  on the apachel panel page (localhost\apanel) click Start MySQL on the left hand of "Uniform Server" table of contents.

	</LI>
</OL>

====Configuring	PHP Variables====

As instructed in the web page, move the file named <code>LocalSettings.php</code> from <code>udrive\www\wi\config\</code> up one level to <code>udrive\www\wi\</code>

==== Optional wiki features ====

These can also be configured later.
<br />Before editing configuration files:
* Stop the servers: in the Uniserver folder, click <code>stop.bat</code>
* Make backup copies of the configuration files

===== Uploads =====
Uploads are disabled by default.
To enable them:

# Open <code>udrive\www\wi\LocalSettings.php</code> in any text editor (e.g. notepad)
# Find "<code>$wgEnableUploads</code>", and remove the "<code># </code>" in front of it (you may need to change "false" to "true")
# Save and close the file

Uploads will then go into the directory <code>udrive\www\wi\images</code> by default.

'''Problems: Try uncommenting $wgDisableUploads (Line 66)'''

===== Email =====
If you do not have a SMTP server running on the local computer, pages that generate email will display an error.
To use another SMTP server:
# Get the name or IP address of the SMTP server on your LAN or at your ISP
# Open <code>udrive\usr\local\Php\php.ini</code> in any text editor (e.g. notepad)
# Change the line "<code>SMTP = localhost</code>" to use the actual SMTP server instead of "<code>localhost</code>".
# Optionally change the line "<code>sendmail_from = me@localhost.com</code>" to use an actual email address instead of "<code>me@localhost.com</code>" for receiving bounces from inter-user email
# Save and close the file

===== Default skin =====

To set a different default skin:

# Open <code>udrive\www\''wi''\LocalSettings.php</code> in any text editor (e.g. notepad)
# Find "<code>$wgDefaultSkin</code>", and remove the "<code># </code>" in front of it, and change "<code>monobook</code>" to "<code>standard</code>" (or "<code>cologneblue</code>" or "<code>nostalgia</code>") &mdash; see [[#Software limitations|#Software limitations]]
# Save and close the file

===== Other default user settings =====

Other default user settings can be changed in:

* <code>udrive\www\wi\LocalSettings.php</code>
**if using English and you wish to allow users to choose their date preferences, add the line <syntaxhighlight lang=php inline>$wgUseDynamicDates  = true;</syntaxhighlight>
* <code>udrive\www\wi\languages\Language.php</code>
** search for the array <code>$wgDefaultUserOptionsEn</code> which can be modified (for other option names that can be added to the array, see the array <code>$wgUserTogglesEn</code>)

===== Performance =====

Performance can be improved and memory stick life extended by adding some of these lines to <code>udrive\www\wi\LocalSettings.php</code>:

*<syntaxhighlight lang="php" inline>$wgDisableCounters = true;  # prevents page statistics being stored and displayed</syntaxhighlight>
*<syntaxhighlight lang="php" inline>$wgDisableTextSearch = true;  # prevents text search</syntaxhighlight>
*<syntaxhighlight lang="php" inline>$wgDisableSearchUpdate = true;  # prevents search tables being updated, requiring them to be rebuilt if you ever re-enable text search</syntaxhighlight>

If a hard disk drive is being used for the storage instead of a memory stick, also add:

*<syntaxhighlight lang="php" inline>$wgEnableParserCache = true;  # uses php zlib</syntaxhighlight>

==== Tidy up ====

# Start the servers again: <code>start.bat w mysql</code>
## (Everything should now be working, but the following steps can be done immediately.)
# In your webbrowser, open <code>''localhost''/wi/index.php?title='''Special''':'''Userlogin'''</code> [http://localhost/wi/index.php?title=Special:Userlogin]
## Login as <code>WikiSysop</code>
# In your webbrowser, open <code>''localhost''/wi/index.php?title='''MediaWiki''':'''Sitesubtitle'''&action=edit</code> [http://localhost/wi/index.php?title=MediaWiki:Sitesubtitle&action=edit]
## Edit the sub-title (keep it short)
## Press the "Save" button. (The sub-title is shown in the Cologne Blue skin, but not in the Classic or Nostalgia skins.)
# In your webbrowser, open <code>''localhost''/wi/index.php?title='''Help''':'''Editing'''&action=edit</code> [http://localhost/wi/index.php?title=Help:Editing&action=edit]
## Type (or copy & paste): <code><nowiki>#REDIRECT [[MetaWikiPedia:Help:Editing]]</nowiki></code>
## Press the "Save" button
# In your webbrowser, open <code>''localhost''/wi/index.php?title='''Help''':'''Contents'''&action=edit</code> [http://localhost/wi/index.php?title=Help:Contents&action=edit]
## Type (or copy & paste): <code><nowiki>#REDIRECT [[MetaWikiPedia:Help:Contents]]</nowiki></code>
## Press the "Save" button
# If you didn't choose GFDL as the license during wiki configuration, open <code>''localhost''/wi/index.php?title='''MediaWiki''':'''Copyrightwarning'''&action=edit</code> [http://localhost/wi/index.php?title=MediaWiki:Copyrightwarning&action=edit]
## Edit the page to match the license
## Press the "Save" button

===== Other pages to edit soon =====

These empty pages are already linked to from other pages in various skins, so you should edit them soon.

*Pages in the default namespace:
**<code>''localhost''/wi/index.php?title='''Main'''_'''Page'''&action=edit</code> [http://localhost/wi/index.php?title=Main_Page&action=edit]
**<code>''localhost''/wi/index.php?title='''Current'''_'''events'''&action=edit</code> [http://localhost/wi/index.php?title=Current_events&action=edit]

*Pages in your site's namespace (these are listed in [http://localhost/wi/index.php/Special:Allmessages Special:Allmessages] where you see <code><nowiki>{{ns:4}}:</nowiki></code> ):
**<code>''localhost''/wi/index.php?title='''''sitename''''':'''About'''&action=edit</code>
**<code>''localhost''/wi/index.php?title='''''sitename''''':'''Administrators'''&action=edit</code> (linked from [http://localhost/wi/index.php/Special:Statistics Special:Statistics])
**<code>''localhost''/wi/index.php?title='''''sitename''''':'''Bug'''_'''reports'''&action=edit</code>
**<code>''localhost''/wi/index.php?title='''''sitename''''':'''Community'''_'''Portal'''&action=edit</code>
**<code>''localhost''/wi/index.php?title='''''sitename''''':'''Copyrights'''&action=edit</code>
**<code>''localhost''/wi/index.php?title='''''sitename''''':'''FAQ'''&action=edit</code>
**<code>''localhost''/wi/index.php?title='''''sitename''''':'''General'''_'''disclaimer'''&action=edit</code>
**<code>''localhost''/wi/index.php?title='''''sitename''''':'''Links'''_'''to'''_'''disambiguating_pages'''&action=edit</code>
**<code>''localhost''/wi/index.php?title='''''sitename''''':'''Site'''_'''support'''&action=edit</code>
**<code>''localhost''/wi/index.php?title='''''sitename''''':'''User'''_'''preferences'''_'''help'''&action=edit</code> (linked from [http://localhost/wi/index.php/Special:Preferences Special:Preferences]) &mdash; could redirect to [[m:Help:Preferences]]

*You may also want to add a "[[:en:Wikipedia:Sandbox|''sitename'':Sandbox]]" to assist new users.

== Components ==

''See also'': [[#Licensing|#Licensing]]

=== Uniform Server v3.2a ===
[http://sourceforge.net/projects/miniserver/ Uniform Server] v3.2a is a quick, easy and small installation containing the servers and platform software for [[MediaWiki]].
It includes:

* web-server [[:en:Apache HTTP Server|Apache]] 2 (v2.0.54)
* scripting engine [[:en:PHP programming language|PHP]] 5 (v5.0.4) with libraries (inc. zlib, libxml2, iconv) and extensions (sockets, mysql, GD2)
* database administration [[:en:phpMyAdmin|phpMyAdmin]] (v2.6.3-rc1)
* databaser server [[:en:MySQL|MySQL]] 4 (v4.1.12a)
* command scripting ActiveState [[:en:Perl|Perl]] 5 (v5.8.7.813)

=== Uniform Server v3.3 ===

Released 2005-12-26, [http://sourceforge.net/projects/miniserver/ Uniform Server] v3.3 "includes the latest versions of Apache2, Perl5, PHP5, MySQL5, phpMyAdmin and ..." and for protected servers (schools, work, ETC>) this download will not work.

=== MediaWiki v1.3.7 ===

{{ll|MediaWiki|MediaWiki}} v1.3.7 is the same wiki software seen [[Special:MyLanguage/Download|here]], and consists of PHP web scripts and libraries (including [[:en:PHPTAL|PHPTAL]] "non-[[:en:PEAR|PEAR]]-users" v0.7.0 and optional {{ll|memcached|memcached}} v1.0.10 support), and a database [[Special:MyLanguage/Database layout|schema]], data, and interfaces.

== Requirements ==

These are the requirements and related work-arounds for this [[#Procedure|procedure]].

=== Windows ===
This procedure may work on any 32-bit/64-bit Windows, but initial testing of this procedure has only been done on Windows 2000 SP4.
This procedure has also been tested with success on both Windows XP (Professional Edition) and Windows 98.
Testing on Windows XP pro 64-bit edition shows no problems.

Exceptions and any work-arounds are:

; Windows 95 : Ensure that the latest TCP/IP update (winsock2) has been applied. <br />If you are using USB removable media, Windows 95 needs to be the OSR2 edition, and may need extra drivers.
; Windows 98 : If you are using USB removable media, extra media drivers may be needed.
: You may need to comment out the eighth line of the START.BAT file to allow this script to work, especially if you have any instance of the Apache web server installed anywhere on your hard drive(s).
; Windows NT 4 : Possible [http://sourceforge.net/tracker/index.php?func=detail&aid=1000671&group_id=53691&atid=471253 server-control problem] [http://msdn.microsoft.com/library/default.asp?url=/library/en-us/perfmon/base/process32first.asp].

For non-Windows operating systems, see {{ll|Manual:Installation}}.

=== Disk space ===

*  7MB for the downloads
* 21MB for the initial installation and configuration
* Additional space as the wiki database grows with edits and uploads

=== Drive letter ===
This procedure assumes that the drive letter <code>w:</code> is unused.
Otherwise use a different unused letter where you see the italicised letter <code>''w''</code>.

=== HTTP TCP port ===
This procedure assume that the HTTP TCP port (80) is unused.
To check, run: <code>netstat.exe -p TCP -n -a|find.exe ":80 "|find.exe "LISTEN"</code>

If the output shows <code>0.0.0.0:80</code> or <code>127.0.0.1:80</code>, you need to either stop the current web server or use a different TCP port in this procedure.
See [[#How to access the wiki from other computers|#How to access the wiki from other computers]].

=== No other Apache.exe ===

If another Apache is installed and running on the same computer, with the exact name "Apache.exe", then:

* Rename <code>Apache.exe</code> in the folder <code>udrive\usr\local\Apache2\bin\</code> to <code>ApacheW.exe</code>
* Change "<code>Apache.exe</code>" to "<code>ApacheW.exe</code>" inside these files: <code>start.bat</code> (2&times;), <code>stop.bat</code> (1&times;), <code>udrive\home\admin\CGI\shutdown.cgi</code> (1&times;; old version) , <code>udrive\home\admin\www\cgi-bin\{language code}\sserver.cgi</code> (1&times;; new version)

== Troubleshooting & support ==

=== Troubleshooting & support resources ===

* These log files may contain clues if errors seem to be happening:
** <code>udrive\usr\local\Apache2\logs\error.log</code>
** <code>udrive\usr\local\mysql\data\%COMPUTERNAME%.err</code>
** <code>udrive\usr\local\Apache2\logs\access.log</code>
* PHP can be configured to log errors to the Application event log (but not under Windows 95). Edit <code>udrive\usr\local\Phpp\php.ini</code>:
** set "<code>log_errors = On</code>"
<!-- could not file-logging to work
** set "<code>error_log = "''w'':\\usr\\local\\Php\\PHPerrors.log"</code>"
-->
** set "<code>error_log = syslog</code>"
** to include "notice"-level logging, set "<code>error_reporting = E_ALL</code>"
* MediaWiki can be configured to log errors, by adding lines to <code>udrive\www\''wi''\LocalSettings.php</code>.
** <syntaxhighlight lang=php inline>$wgDBerrorLog = '...';</syntaxhighlight> ...
* MediaWiki can be configured to profile/trace, by adding lines to <code>udrive\www\''wi''\LocalSettings.php</code>.
** <syntaxhighlight lang=php inline>$wgProfiling = true;</syntaxhighlight>
** <syntaxhighlight lang=php inline>$wgDebugLogFile = '/tmp/mediawiki-profile.log';</syntaxhighlight>
* There is a [[Special:MyLanguage/Help:Contents|formal user guide]]
* There are [[m:Mailing_list#Technical issues mailing lists|MediaWiki mailing list]]s with archives
* There are [[m:Special:MyLanguage/IRC channels|IRC channels]] {{irc|mediawiki}} and {{irc|uniserver}}.
* Skype will keep Wiki on a stick from starting! Just shutdown Skype.
* [http://forum.uniformserver.com Uniform Server's Support Forum]

=== How to throw away the wiki and start again ===

# In your web browser, open <code>''localhost''/a/phpMyAdmin-2.6.3-rc1/db_details_structure.php?lang=en-iso-8859-1&server=1&db=''wikidb''</code> [http://localhost/a/phpMyAdmin-2.6.3-rc1/db_details_structure.php?lang=en-iso-8859-1&server=1&db=wikidb]
# Click the "Drop" tab to remove the selected ''wikidb'' database
# Click the "<= Uniform Server" link
# Stop the servers by clicking the "Shutdown the server" link
# Delete <code>LocalSettings.php</code> from the <code>udrive\www\''wi''</code> sub-folder
# Follow the instructions again from [[#Configure the wiki|#Configure the wiki]]

=== How to throw it all away and start again ===

# Stop the servers using <code>''localhost''/a/stop.html</code> [http://localhost/a/stop.html]
# Delete the top folder
# Follow the instructions again from [[#Install UniformServer|#Install UniformServer]]

== Limitations ==

=== Software limitations ===

* <del>No monobook skin, as MediaWiki automatically disables it due to its included PHPTAL library being incompatible with Uniform Server's included PHP v5</del> PHPTal is no longer used.
* <del>No maths markup, due to lack of texvc, LaTeX, dvips, and [http://www.imagemagick.org/www/download.html ImageMagick] software</del>
*Avoid <code>texvc</code>. Look at [[Special:MyLanguage/Manual:Running MediaWiki on Windows#Alternative Solution|the alternative method]] of using math without <code>texvc</code>. You can use LaTeX, dvips from a [http://www.miktex.org/ Miktex] distribution (be sure to copy the dlls into the folder <code>/usr/bin</code>)
* <del>Image resizing may not support certain formats, due to lack of ImageMagick software (but PNG, GIF, JPG, XBM and WBMP formats should be okay)</del>.
* <del>Image resizing may result in ugliness, due to lack of ImageMagick software</del>
*Download ImageMagick from http://www.imagemagick.org/download/binaries/ImageMagick-6.2.8-0-Q16-windows-dll.exe and install it. From <code>C:\Program Files\ImageMagick-6.2.8-Q16\</code> copy the following files to your <code>/usr/bin</code> (i.e. <code>udrive/usr/bin/</code>). Also set the correct path to <code>convert.exe</code> in <code>LocalSettings.php</code>
   <code>CORE_RL_Magick++_.dll</code>
   <code>CORE_RL_bzlib_.dll</code>
   <code>CORE_RL_jbig_.dll</code>
   <code>CORE_RL_jpeg_.dll</code>
   <code>CORE_RL_lcms_.dll</code>
   <code>CORE_RL_libxml_.dll</code>
   <code>CORE_RL_magick_.dll</code>
   <code>CORE_RL_png_.dll</code>
   <code>CORE_RL_tiff_.dll</code>
   <code>CORE_RL_ttf_.dll</code>
   <code>CORE_RL_wand_.dll</code>
   <code>CORE_RL_xlib_.dll</code>
   <code>CORE_RL_zlib_.dll</code>
   <code>X11.dll</code>
   <code>convert.exe</code>
* Edit conflicts do not automatically merge, due to lack of diff3 software (available from inside [http://prdownloads.sourceforge.net/gnuwin32/diffutils-2.8.7-1-bin.zip?download] <!-- untested -->)
* The <code>udrive\tmp</code> folder may gain small "<code>sess_*</code>" files, which can be deleted when the servers are stopped

=== Procedure limitations ===

* The servers only run while you are logged-in

=== Other limitations ===

* Running the wiki from portable writable media, while convenient, is slow.
** Perhaps this limitation can be overcome by running a copy of Wikiwyg.org instead.

== 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 : ... The initial <code>''WikiSysop''</code> user has the user rights <code>sysop</code> and <code>bureaucrat</code>. For more information on user rights, see {{ll|Manual:User rights}}.

==== 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:

===== "Anything goes" e.g. most sites operated by Wikimedia =====
{| border="1" cellspacing="0" cellpadding="3"
!style="text-align:left"|Permissions:!!Read!!Edit!!Delete!!Register!!Ban addresses!!Ban users!!Grant sysop-right
|-
||Anonymous users:||style="text-align:center"|'''''All'''''||style="text-align:center"|'''''Yes'''''||style="text-align:center" rowspan="2"|Never||style="text-align:center" rowspan="2"|'''''Yes'''''||style="text-align:center" rowspan="2"|Never||style="text-align:center" rowspan="2"|Never||style="text-align:center" rowspan="3"|Never
|-
||Registered users:||style="text-align:center" rowspan="3"|All||style="text-align:center" rowspan="3"|Yes
|-
||Sysop right:||style="text-align:center" rowspan="2"|Always||style="text-align:center" rowspan="2"|Yes||style="text-align:center" rowspan="2"|Yes||style="text-align:center" rowspan="2"|Yes
|-
||Bureaucrat right:||style="text-align:center"|Always
|}

===== Public with restricted editors =====
{| border="1" cellspacing="0" cellpadding="3"
!style="text-align:left"|Permissions:!!Read!!Edit!!Delete!!Register!!Ban addresses!!Ban users!!Grant sysop-right
|-
||Anonymous users:||style="text-align:center"|'''''All'''''||style="text-align:center"|'''''No'''''||style="text-align:center" rowspan="2"|Never||style="text-align:center" rowspan="2"|'''''No'''''||style="text-align:center" rowspan="2"|Never||style="text-align:center" rowspan="2"|Never||style="text-align:center" rowspan="3"|Never
|-
||Registered users:||style="text-align:center" rowspan="3"|All||style="text-align:center" rowspan="3"|Yes
|-
||Sysop right:||style="text-align:center" rowspan="2"|Always||style="text-align:center" rowspan="2"|Yes||style="text-align:center" rowspan="2"|Yes||style="text-align:center" rowspan="2"|Yes
|-
||Bureaucrat right:||style="text-align:center"|Always
|}

===== Private =====
{| border="1" cellspacing="0" cellpadding="3"
!style="text-align:left"|Permissions:!!Read!!Edit!!Delete!!Register!!Ban addresses!!Ban users!!Grant sysop-right
|-
||Anonymous users:||style="text-align:center"|'''''Explanatory<br />pages only'''''||style="text-align:center"|'''''No'''''||style="text-align:center" rowspan="2"|Never||style="text-align:center" rowspan="2"|'''''No'''''||style="text-align:center" rowspan="2"|Never||style="text-align:center" rowspan="2"|Never||style="text-align:center" rowspan="3"|Never
|-
||Registered users:||style="text-align:center" rowspan="3"|All||style="text-align:center" rowspan="3"|Yes
|-
||Sysop right:||style="text-align:center" rowspan="2"|Always||style="text-align:center" rowspan="2"|Yes||style="text-align:center" rowspan="2"|Yes||style="text-align:center" rowspan="2"|Yes
|-
||Bureaucrat right:||style="text-align:center"|Always
|}

=== Privacy ===

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

=== Servers ===
Uniform Server, like all [[w:WAMP|WAMP]] packages, gets fixed slowly compared to its individual components.
This makes these packages a security risk.
Do not even think about making these servers accessible from the Internet without extra front-end authentication (e.g. by using a [[w:Virtual private network|VPN]]).

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

''See also'': [http://dev.mysql.com/doc/mysql/en/Security.html MySQL Manual: 5.4 General Security Issues]

=== General ===

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

== How to access the wiki from other computers ==

edit these files:

<code>UniServer3_2a\udrive\usr\local\Apache2\conf\httpd.conf</code>:

Listen on the appropriate interfaces:

to accept connections from all networks:

 Listen 80

or to accept connections from localhost and for example 192.168.100.0:

 Listen 127.0.0.1:80
 Listen 192.168.100.0:80

to make self references to your apache work you will have to edit the ServerName entry: put your DNS name there or your IP

 ServerName 192.168.11.100:80

Give the appropriate rights in your .htaccess files:

<code>UniServer3_2a\udrive\www\.htaccess</code>
<pre>
Order Deny,Allow
Deny from all
Allow from 127.0.0.1
Allow from 192.168.11.0
</pre>

if there is already a webserver active on port 80 you can switch to another port, for example 81.
Then exchange :80 for :81 in Listen and ServerName. additionally you will have to edit the setup of phpmyadmin:

<code>UniServer3_2a\udrive\home\admin\WWW\phpMyAdmin-2.6.3-rc1\config.inc.php</code>

 <code><nowiki>$cfg['PmaAbsoluteUri'] = 'http://localhost:81/a/phpMyAdmin-2.6.3-rc1/'; </nowiki></code>

If you want to have access to phpmyadmin from the network you will also have to give access to this directory in the corresponding .htaccess file:

<code>UniServer3_2a\udrive\home\admin\WWW\.htaccess</code>
<pre>
Order Deny,Allow
Deny from all
Allow from 127.0.0.1
Allow from 192.168.11.0
</pre>

== Multiple wikis ==
Since the mysql-database for the wiki on a stick wiki runs locally, there is no limit on the number of databases which can be stored.
To have several independent wikis on the same apache and mysql, just put them in distinct directories below <code>UniServer3_2a\udrive\www</code> and let each run it's install.php routine.
Give different database names in the install.php routine.
you can share the mysql-wiki user amongst different wikis, but it might be good to give each wiki its own mysql-user.

directory layout (example)

 <code>UniServer3_2a\udrive\www\TestWiki</code>
 <code>UniServer3_2a\udrive\www\Wikim\mediawiki-1.4rc1</code> (for testing)
 <code>UniServer3_2a\udrive\www\Wikim\Wiki</code> (stable for production)

=== Installing multiple wikis on a single server, using the same database ===
Here is how to install the MediaWiki software just once, but use it to power more than one wiki, keeping the tables for all the wikis in a single database-- including step-by-step instructions for a Unix-type of installation.
This solution should work for most shared-hosting servers, too.
Level of difficulty: Novice.
See the instructions [http://www.steverumberg.com/wiki/index.php/WikiHelp on this site].{{deadlink}}

== 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.2a: [http://sourceforge.net/projects/miniserver/ BSD-revised-style license]
**ActiveState Perl 5.8.7.813: [http://www.activestate.com/Products/ActivePerl/license_agreement.plex ActiveState Community License]
***Perl 5: choose one of the [http://www.activestate.com/ASPN/Legal/Artistic_License_Text.txt Artistic License] or the [http://www.fsf.org/licenses/gpl.html GNU General Public License] (GPL v2)
**Apache v2.0.54: [http://www.apache.org/licenses/LICENSE-2.0 Apache License v2.0].
**MySQL 4.1.12a: GPL v2
**PHP 5 v5.0.4: [https://php.net/license/3_0.txt PHP License v3.0]
***Zend Engine 2: [http://www.zend.com/license/2_00.txt Zend Engine License v2.00] {{Webarchive|url=https://web.archive.org/web/20190118051204/http://www.zend.com/license/2_00.txt |date=2019-01-18 }}
**phpAdmin v2.6.3-rc1: GPL v2
***FPDF v1.51: [http://www.fpdf.org/en/FAQ.php "freeware"] ([[:en:public domain|public domain]])
***PHPFM v0.2.3 (plugin): GPL v2
***go-pear v1.57 (plugin): choose one version of these PHP Licenses: [https://php.net/license/2_02.txt v2.0] or v3.0
***blowfish (library): [http://www.fsf.org/copyleft/lgpl.html GNU Library General Public License]
***profiling (library): [http://www.mozilla.org/MPL/ Mozilla Public License] (MPL) (the version does not seem to be specified, and could be [http://www.mozilla.org/MPL/MPL-1.1.html v1.0] or [http://www.mozilla.org/MPL/MPL-1.0.html v1.1])

*MediaWiki v1.3.7: GPL v2
**PHPTAL-NP-0.7.0: [http://www.gnu.org/copyleft/lesser.html GNU Lesser General Public License v2.1] (GLGPL or LGPL)
**pear v1.1: PHP License v2.0

Also, some documentation files may be covered by the [[GNU Free Documentation License]] (GFDL) [http://www.gnu.org/licenses/old-licenses/fdl-1.1.html v1.1] or [http://www.gnu.org/copyleft/fdl.html v1.2].
Some software library 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.

== See also ==
*{{ll|Manual:Wiki on a stick}}
*{{ll|Manual:Installation}}
*{{ll|Manual:Running MediaWiki on Windows|nsp=0}}
*[[OrganicDesign:MediaWikiLite]] ''- A portable way of running MediaWiki without changing the host OS or requiring it to have any existing LAMP components''
*[http://www.organicdesign.co.nz/Training_on_a_stick Training On A Stick]

[[Category:Installation{{#translation:}}|{{PAGENAME}}]]