View source for Installing MediaWiki on 5.0-Nano

<span id="top"></span>
{| cellpadding="2"
|__TOC__||'''Installing MediaWiki on 5-Nano Series'''
|}
'''Introduction'''

This step-by-step guide shows how to install MediaWiki on Uniform Server V5-Nano Series.

Uniform Server is inherently portable. You can copy it to a USB memory stick and run it on another PC. If a host PC is currently running another server though, it will prevent UniServer from running. To resolve this situation, either stop the host servers, or preferably install your UniServer on different ports by moving the server. Before installing MediaWiki it's worth reading how to [[#Move Servers |'''move servers''']]. 

This is set initially as a personal server and will not be used online, so there's no need to change any of Uniform Server’s settings. It's locked down and safe to use even when your PC is connected to the Internet. That said, it is also easy to put the servers online.

== Preparation ==
'''''Note'':''' There is no real need to create folders at A) and B). They are there to provide a reference point and make screen capture a little bit easier.
{|
|-
|valign="top"|
'''''Install Uniform server'''''

# '''A)''' Create a new folder named '''mediawiki_b''' (Can be any name)
# Extract a new copy of Uniform Server V5-Nano to this folder<br>&nbsp;--- Database user name '''root''' - No need to change this<br>&nbsp;--- Database password '''root''' - Before installing MediaWiki I recommend changing this using [[Old:4.0-Mona: Security & passwords#MySQL Password | apanel]]  
# '''Start''' Uniform Server. 

'''''Download Mediawiki''''' 
<ol start="4">
<li> '''B)''' Create a new folder '''mediawiki_a''' (Can be any name its only a temporary folder)</li>
<li> Download  Mediawiki '''1.15.2''' (or newer version) from [http://www.mediawiki.org/wiki/Download here] and save to a convenient folder, for example '''mediawiki_a'''</li>
<li>Unzip the downloaded file (mediawiki-1.15.2.tar.gz) Windows cannot do this use something like 7-Zip Portable<br>&nbsp;--- Download site: [http://portableapps.com/apps/utilities PortableApps.com]<br>&nbsp;--- File name: 7-Zip Portable - Multilingual file archiver and compressor</li>
<li>'''B)''' Extract '''mediawiki-1.15.2.tar.gz''' to current path, creates a new folder '''mediawiki-1.15.2.tar''' open this folder '''C)'''</li>
<li>'''C)''' Extract  mediawiki-1.15.2.tar to current path, creates a new folder mediawiki-1.15.2 '''(D)'''</li>
</ol>
'''''Copy files to Uniform Server'''''
<ol start="9">
<li>'''E)''' Copy folder '''mediawiki-1.15.2''' to server root folder '''www'''</li>
<li>'''F)''' Rename folder '''mediawiki-1.15.2''' to '''wiki'''</li>
</ol>
|
[[Image:Nano_mediawiki_a.gif]]
|}


== Switch to production, start servers ==
UniServer’s default is to use the production PHP configuration file, however you may have switched configuration files during development.

Before installing any applications, ensure the production configuration is selected.  

'''''Check the configuration file'':'''
# Start UniTray, in folder UniServer double click on '''Start.exe''' tray icon created.
# Check configuration: Left click '''tray icon > Server Status''' – Top of page php.ini displays either Production or development.
# If Production displayed, no action required; you can start servers.
# If development displayed, proceed as follows:
# Switch to production: Left click '''tray icon > Advanced > click php.ini switch to Production'''.

'''''Start Servers'':'''
* Start Uniform Server. Left click '''tray icon > click Start UniServer '''


== Wiki – Installation ==
<table>
<tr>
<td>
# Type the following into your browser address bar:<br /> '''<nowiki>http://localhost/wiki/</nowiki>''' redirects to installation page.
# Click the link Please '''set up the wiki''' first.
# This opens the configuration page scroll down to<br /> '''Site config''' and fill in the form.
</td>
<td>[[Image:Nano_mediawiki_b.gif]]</td>
</tr>
</table>

'''''Site config'''''
<table  width="490" border="0" cellpadding="3" cellspacing="1">
<tr bgcolor="#F4F4F4"><td  width="150" align="right">Wiki name:</td><td>MPG (whatever you like)</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Contact e-mail:</td><td>admin@localhost</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Language:</td><td>en-English</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Copyright/license: </td><td>(radio button) select No license metadata</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Admin username:</td><td>WikiSysop</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Password:</td><td>root66 (whatever you like)</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Password confirm:</td><td>root66 (same as above)</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Object caching:</td><td>(radio button) select eAccelerator</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Memcached servers:</td><td>(leave blank)</td></tr>
</table>

'''''E-mail, e-mail notification and authentication setup'''''
<table  width="490" border="0" cellpadding="3" cellspacing="1">
<tr bgcolor="#F4F4F4"><td  width="150" align="right">E-mail features (global): </td><td>(radio button) select Disabled</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">User-to-user e-mail:</td><td>(radio button) select Disabled</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">E-mail notification about changes:</td><td>(radio button) select Disabled</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">E-mail address: </td><td>(radio button) select Disabled</td></tr>
</table>
'''''Database config'''''
<table  width="490" border="0" cellpadding="3" cellspacing="1">
<tr bgcolor="#F4F4F4"><td width="150" align="right">Database type:</td><td>(radio button) select MySQL</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Database host:</td><td>localhost</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Database name: </td><td>wikidb</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">DB username:</td><td>root</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">DB password confirm: </td><td>root </td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Superuser account:</td><td>tick box </td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Superuser name:</td><td>root</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Superuser password:</td><td>root</td></tr>
</table>
'''''MySQL specific options'''''
<table  width="490" border="0" cellpadding="3" cellspacing="1">
<tr bgcolor="#F4F4F4"><td width="150" align="right">Database table prefix:</td><td>leave blank</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Storage Engine:</td><td>(radio button) select MyISAM</td></tr>
<tr bgcolor="#F4F4F4"><td align="right">Database character set: : </td><td>(radio button) select MySQL 4.1/5.0 binary</td></tr>
</table>
'''Click Install MediaWiki'''

After creating the database a second page will display, scroll down the page you will see the conformation message 
 Installation successful! Move the config/LocalSettings.php <br>file to the parent directory, then follow  this link to your wiki”

== Notes ==
'''Note 1:''' More detail for moving file, also refer to above image '''G)'''
#Copy file: '''LocalSettings.php'''
#Located in folder: *\UniServer\www\wiki\'''config'''
#To folder: *\UniServer\www\'''wiki'''


'''Note 2:''' Access your wiki by typing the following into your browser address bar:
#'''<nowiki>http://localhost/wiki/</nowiki>''' or
#'''<nowiki>http://localhost/wiki/index.php/Main_Page</nowiki>'''


'''Notes 3:''' To enable image uploads:
#Open file: '''LocalSettings.php'''
#Located in folder: *\UniServer\udrive\www\'''wiki'''
#Change this line: '''$wgEnableUploads  = false;'''
#To:  '''$wgEnableUploads = true;'''

== Portability ==
If you want a portable version of MediaWiki copy the folder '''UniServer''' and all its content to your USB memory stick that’s it. Don’t expect fantastic speeds however it is usable.

Uniform Server uses the standard ports (Apache port 80 and MySQL port 3306). If a host PC is currently running another server on these ports it will prevent UniServer from running. To resolve this situation, either stop the host servers or preferably install your UniServer on different ports by moving the servers, described next.


== Move Servers ==
One of Uniform Server’s unique features is the capability to run more than one complete server stack on the same PC. When running a server from a USB memory stick you can use this to great advantage and prevent server clashes. You will have noticed UniTray’s icon displays a one (meaning standard ports). Moving UniServer increments this digit for each server move. In reality it’s not just a port change, but a complete server update. The running server status also displays the server characteristics. 

'''''Move Servers'':'''   
# Assumes a newly extracted server (see note 1)
# '''Stop all''' running Uniform Servers
# Start UniTray: in folder UniServer, double click on '''Start.exe''' and the tray icon is created.
# Move servers: Left click '''tray icon > Advanced > click Move Servers multi-server operation'''.
# In the pop-up window, at '''all''' prompts '''press enter''' to accept defaults.
# The tray icon will display 2. If you already use a server with this number '''repeat steps 4 and 5'''. Each server must have a '''unique number'''.

   
* After moving the servers you can now install MediaWiki as explained above.
* However before proceeding you need to use the '''new server ports''' for installation.
* To find these: Left click '''tray icon > Server Status'''

I moved the servers to icon 2, so Apache port = '''81''' and MySQL port = '''3307'''

To start installation: type <nowiki>http://localhost</nowiki>''':81'''/wiki/ into your browser

Database Configuration host name becomes: '''localhost:3307'''

After installation, access your wiki by typing the following into your browser address bar:
*'''<nowiki>http://localhost:81/wiki/</nowiki>''' or
*'''<nowiki>http://localhost:81/wiki/index.php/Main_Page</nowiki>'''

'''''Note 1'':'''

If you have already installed MediaWiki on UniServer V5-Nano and want to move the servers, it is possible.

# Follow steps 2-6 as above
# Edit file UniServer\www\wiki\'''LocalSettings.php''' 
# Locate line (61)<br />Change line: '''$wgDBserver = "localhost";'''<br /> To: '''$wgDBserver = "localhost:3307";''' 
# Save file.

Use the port number that matches your server, start the servers. Pages are accessible as mentioned above. Just remember to use the port number that matches your server.

'''''Note 2'':'''

If you install MediaWiki using the plugin V56_MediaWiki_1_15_2.exe, there is no need to change line $wgDBserver = "localhost";

A MySQL port change is automatically tracked using the following code:

{|
|-
|
<pre>
// ===  Get MYSQL port number =================================================
// Use port from configuration file - because user can change this file 
$path_array = explode("www", dirname( __FILE__ ));        // Folder UniServr path
$file_conf  = $path_array[0].'usr\\local\\mysql\\my.ini'; // Config file 

if ($filearray=file($file_conf)) {              // read file into array
 foreach ($filearray as $txt) {                 // scan array for port
  if(preg_match("/^\s*port\s*=\s*(\d+)/", $txt,$match)){ // check save matches 
   $mysql_port =  $match[1];                    // match found save port number 
   break;                                       // give up nothing else to do
  }
 }
}
else {                                      // failed to read file
 echo "Cannot read the file";
}
// ===================================================== END Get MySQL Port ===

## Database settings
$wgDBtype           = "mysql";
$wgDBserver         = "localhost:$mysql_port";
$wgDBname           = "wikidb";
$wgDBuser           = "root";
$wgDBpassword       = "root";
</pre>
|}



== Plugin ==
The above instructions are generic, allowing you to install the latest version of MediaWiki.

If you prefer a click-and-go solution, go to [http://sourceforge.net/projects/miniserver/files/Plugins/UniServer%2056-Nano%20Plugins/Applications/ '''SourceForge''']
* Under '''Plugins'''
* Navigate to sub-folder '''Uniform Server 5-Nano Plugins'''
* Download file [http://sourceforge.net/projects/miniserver/files/Plugins/UniServer%2056-Nano%20Plugins/Applications/V56_MediaWiki/V56_MediaWiki_1_15_2.exe/download V56_MediaWiki_1_15_2.exe]

Save this to folder UniServer. To install, just double click on the file. MediaWiki is pre-configured and ready to go. Check out the readme file for latest information.

'''''Note'':''' This plugin is intended to quickly get MediaWiki up and running, allowing you to explore the software. If you intend running a production server, delete the folders installed and perform a manual install. This allows you to tailor MediaWiki and include any missing modules.


== MySQL Security ==
The above installation guide and associated downloadable plugin are intended to get the application up and running purely for testing.

If you are intending to put the application online, be sure to read any security advice provided with the application and check the provider's web site.

More importantly, the above installation is an extreme security risk if put online as is.   
Its imperative you secure the MySQL server before putting your servers online.

Please read [[MySQL Security | '''MySQL Security''']] and restrict privileges for any user who has connection access to your server.

== Conclusion ==
From the above you can see how easy it is to install MediaWiki on Uniform Server.

What may not be apparent from the above is the reason for using icon 2 for MediaWiki. I have a main server that runs on standard ports, hence icon 1 is in use. The next free icon (server) was 2 so I used that.


MediaWiki is extremely easy to install on UniServer. If you have a version already installed on 4.*-Mona and want to move it over to 5-Nano, take a look at [[Moving MediaWiki to 5.0-Nano | this page]].


----

[[Category: Uniform Server 5.0-Nano]]
[[Category: Installation]]