Installing MediaWiki on 5.0-Nano: Difference between revisions

From The Uniform Server Wiki
Jump to navigation Jump to search
(New page: <span id="top"></span> {| cellpadding="2" |__TOC__||'''Installing MediaWiki on 5.0-Nano''' |} '''Introduction''' This step-by-step guide shows how to install MediaWiki on Uniform Server V...)
 
m (Update links.)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<span id="top"></span>
<span id="top"></span>
{| cellpadding="2"
{| cellpadding="2"
|__TOC__||'''Installing MediaWiki on 5.0-Nano'''
|__TOC__||'''Installing MediaWiki on 5-Nano Series'''
|}
|}
'''Introduction'''
'''Introduction'''


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


Uniform Server is inherently portable copy the above to a USB memory stick and run on another PC. If a host PC is currently running another server 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 its worth reading how to [[#Move Servers |'''move servers''']].  
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 a personal server and will not be used online hence no need to change any of Uniform Server’s settings, its locked down and safe to use even when your PC is connected to the Internet. That said it is easy to put the servers online.
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 ==
== 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 that little bit easier.
'''''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.
{|
{|
|-
|-
Line 19: Line 19:


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


Line 25: Line 25:
<ol start="4">
<ol start="4">
<li> '''B)''' Create a new folder '''mediawiki_a''' (Can be any name its only a temporary folder)</li>
<li> '''B)''' Create a new folder '''mediawiki_a''' (Can be any name its only a temporary folder)</li>
<li> Download  Mediakiki '''1.15.0''' (or newer version) from [http://www.mediawiki.org/wiki/Download here] save to a convenient folder for example '''mediawiki_a'''</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.0.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>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.0.tar.gz''' to current path, creates a new folder '''mediawiki-1.15.0.tar''' open this folder '''C)'''</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.0.tar to current path, creates a new folder mediawiki-1.15.0 '''(D)'''</li>
<li>'''C)''' Extract  mediawiki-1.15.2.tar to current path, creates a new folder mediawiki-1.15.2 '''(D)'''</li>
</ol>
</ol>
'''''Copy files to Uniform Server'''''
'''''Copy files to Uniform Server'''''
<ol start="9">
<ol start="9">
<li>'''E)''' Copy folder '''mediawiki-1.15.0''' to server root folder '''www'''</li>
<li>'''E)''' Copy folder '''mediawiki-1.15.2''' to server root folder '''www'''</li>
<li>'''F)''' Rename folder '''mediawiki-1.15.0''' to '''wiki'''</li>
<li>'''F)''' Rename folder '''mediawiki-1.15.2''' to '''wiki'''</li>
</ol>
</ol>
|
|
Line 39: Line 39:
|}
|}


'''''[[#top | Top]]'''''


== Switch to production, start servers ==
== Switch to production, start servers ==
UniServer’s default is to use the development PHP configuration file before installing any applications it’s a good idea to switch-in the production file and then 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.
# Start UniTray, in folder UniServer double click on '''Start.exe''' tray icon created.
# Switch to production, Left click '''tray icon > Advanced > click php.ini switch to Production'''.
# Check configuration: Left click '''tray icon > Server Status''' – Top of page php.ini displays either Production or development.
# Start Uniform Server. Left click '''tray icon > click Start UniServer '''  
# 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 '''


'''''[[#top | Top]]'''''


== Wiki – Installation ==
== Wiki – Installation ==
Line 125: Line 131:
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.
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 server see below.
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.


'''''[[#top | Top]]'''''


== Move Servers ==
== Move Servers ==
One of Uniform Server’s unique features is the capability to run more than one complete server 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 one (meaning standard ports). Moving UniServer increments this digit and so on for each server move. In reality it’s not just a port change but a complete server update, running server status displays the server characteristics.  
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'':'''   
'''''Move Servers'':'''   
# Assumes a new extracted server (see note 1)
# Assumes a newly extracted server (see note 1)
# '''Stop all''' running Uniform Servers
# '''Stop all''' running Uniform Servers
# Start UniTray, in folder UniServer double click on '''Start.exe''' tray icon created.
# 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'''.
# 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.
# 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'''.
# 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'''.


    
    
Line 145: Line 150:
* To find these: Left click '''tray icon > Server Status'''
* To find these: Left click '''tray icon > Server Status'''


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


To start installation: type <nowiki>http://localhost</nowiki>''':81'''/wiki/ into your browser
To start installation: type <nowiki>http://localhost</nowiki>''':81'''/wiki/ into your browser
Line 152: Line 156:
Database Configuration host name becomes: '''localhost:3307'''
Database Configuration host name becomes: '''localhost:3307'''


After installation Access your wiki by typing the following into your browser address bar:
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/</nowiki>''' or
*'''<nowiki>http://localhost:81/wiki/index.php/Main_Page</nowiki>'''
*'''<nowiki>http://localhost:81/wiki/index.php/Main_Page</nowiki>'''
Line 158: Line 162:
'''''Note 1'':'''
'''''Note 1'':'''


If you have already installed MediaWiki on UniServer V5-Nano and want to move the servers it is possible.
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
# Follow steps 2-6 as above
Line 165: Line 169:
# Save file.
# 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.
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.
 
'''''[[#top | Top]]'''''
'''''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 ==
== Conclusion ==
From the above you have seen how easy it is to install MediaWiki on Uniform Server.
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 hence I used that.
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.0-Nano take a look at [[Moving MediaWiki to 5.0-Nano | this page]].
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]].


'''''[[#top | Top]]'''''


----
----


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

Latest revision as of 21:58, 21 June 2013

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.

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.

Install Uniform server

  1. A) Create a new folder named mediawiki_b (Can be any name)
  2. Extract a new copy of Uniform Server V5-Nano to this folder
     --- Database user name root - No need to change this
     --- Database password root - Before installing MediaWiki I recommend changing this using apanel
  3. Start Uniform Server.

Download Mediawiki

  1. B) Create a new folder mediawiki_a (Can be any name its only a temporary folder)
  2. Download Mediawiki 1.15.2 (or newer version) from here and save to a convenient folder, for example mediawiki_a
  3. Unzip the downloaded file (mediawiki-1.15.2.tar.gz) Windows cannot do this use something like 7-Zip Portable
     --- Download site: PortableApps.com
     --- File name: 7-Zip Portable - Multilingual file archiver and compressor
  4. B) Extract mediawiki-1.15.2.tar.gz to current path, creates a new folder mediawiki-1.15.2.tar open this folder C)
  5. C) Extract mediawiki-1.15.2.tar to current path, creates a new folder mediawiki-1.15.2 (D)

Copy files to Uniform Server

  1. E) Copy folder mediawiki-1.15.2 to server root folder www
  2. F) Rename folder mediawiki-1.15.2 to wiki


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:

  1. Start UniTray, in folder UniServer double click on Start.exe tray icon created.
  2. Check configuration: Left click tray icon > Server Status – Top of page php.ini displays either Production or development.
  3. If Production displayed, no action required; you can start servers.
  4. If development displayed, proceed as follows:
  5. 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

  1. Type the following into your browser address bar:
    http://localhost/wiki/ redirects to installation page.
  2. Click the link Please set up the wiki first.
  3. This opens the configuration page scroll down to
    Site config and fill in the form.
File:Nano mediawiki b.gif

Site config

Wiki name:MPG (whatever you like)
Contact e-mail:admin@localhost
Language:en-English
Copyright/license: (radio button) select No license metadata
Admin username:WikiSysop
Password:root66 (whatever you like)
Password confirm:root66 (same as above)
Object caching:(radio button) select eAccelerator
Memcached servers:(leave blank)

E-mail, e-mail notification and authentication setup

E-mail features (global): (radio button) select Disabled
User-to-user e-mail:(radio button) select Disabled
E-mail notification about changes:(radio button) select Disabled
E-mail address: (radio button) select Disabled

Database config

Database type:(radio button) select MySQL
Database host:localhost
Database name: wikidb
DB username:root
DB password confirm: root
Superuser account:tick box
Superuser name:root
Superuser password:root

MySQL specific options

Database table prefix:leave blank
Storage Engine:(radio button) select MyISAM
Database character set: : (radio button) select MySQL 4.1/5.0 binary

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 
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)

  1. Copy file: LocalSettings.php
  2. Located in folder: *\UniServer\www\wiki\config
  3. To folder: *\UniServer\www\wiki


Note 2: Access your wiki by typing the following into your browser address bar:

  1. http://localhost/wiki/ or
  2. http://localhost/wiki/index.php/Main_Page


Notes 3: To enable image uploads:

  1. Open file: LocalSettings.php
  2. Located in folder: *\UniServer\udrive\www\wiki
  3. Change this line: $wgEnableUploads = false;
  4. 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:

  1. Assumes a newly extracted server (see note 1)
  2. Stop all running Uniform Servers
  3. Start UniTray: in folder UniServer, double click on Start.exe and the tray icon is created.
  4. Move servers: Left click tray icon > Advanced > click Move Servers multi-server operation.
  5. In the pop-up window, at all prompts press enter to accept defaults.
  6. 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 http://localhost: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:

  • http://localhost:81/wiki/ or
  • http://localhost:81/wiki/index.php/Main_Page

Note 1:

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

  1. Follow steps 2-6 as above
  2. Edit file UniServer\www\wiki\LocalSettings.php
  3. Locate line (61)
    Change line: $wgDBserver = "localhost";
    To: $wgDBserver = "localhost:3307";
  4. 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:

// ===  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";


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 SourceForge

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 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 this page.