487
edits
Installing MediaWiki on 5.0-Nano: Difference between revisions
Punctuation and grammatical changes; some clarification and additional explanation.
mNo edit summary |
(Punctuation and grammatical changes; some clarification and additional explanation.) |
||
| Line 7: | Line 7: | ||
This step-by-step guide shows how to install MediaWiki on Uniform Server V5-Nano Series. | This step-by-step guide shows how to install MediaWiki on Uniform Server V5-Nano Series. | ||
Uniform Server is inherently portable copy | 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 | 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) | '''''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-Nano to this folder<br> --- Database user name '''root''' - No need to change this<br> --- Database password '''root''' - Before installing | # Extract a new copy of Uniform Server V5-Nano to this folder<br> --- Database user name '''root''' - No need to change this<br> --- Database password '''root''' - Before installing MediaWiki I recommend changing this using [[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 | <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. | <li>Unzip the downloaded file (mediawiki-1.15.2.tar.gz) Windows cannot do this use something like 7-Zip Portable<br> --- Download site: [http://portableapps.com/apps/utilities PortableApps.com]<br> --- File name: 7-Zip Portable - Multilingual file archiver and compressor</li> | ||
<li>'''B)''' Extract '''mediawiki-1.15. | <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. | <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. | <li>'''E)''' Copy folder '''mediawiki-1.15.2''' to server root folder '''www'''</li> | ||
<li>'''F)''' Rename folder '''mediawiki-1.15. | <li>'''F)''' Rename folder '''mediawiki-1.15.2''' to '''wiki'''</li> | ||
</ol> | </ol> | ||
| | | | ||
| Line 39: | Line 39: | ||
|} | |} | ||
== Switch to production, start servers == | == 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. | 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. | Before installing any applications, ensure the production configuration is selected. | ||
'''''Check configuration file'':''' | '''''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. | ||
# Check configuration: Left click '''tray icon > Server Status''' – Top of page php.ini displays either Production or development. | # 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 Production displayed, no action required; you can start servers. | ||
# If development displayed proceed as follows: | # If development displayed, proceed as follows: | ||
# Switch to production | # Switch to production: Left click '''tray icon > Advanced > click php.ini switch to Production'''. | ||
'''''Start Servers'':''' | '''''Start Servers'':''' | ||
* Start Uniform Server. Left click '''tray icon > click Start UniServer ''' | * Start Uniform Server. Left click '''tray icon > click Start UniServer ''' | ||
== Wiki – Installation == | == Wiki – Installation == | ||
| Line 133: | 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) | 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 == | == 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 | 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 | # Assumes a newly extracted server (see note 1) | ||
# '''Stop all''' running Uniform Servers | # '''Stop all''' running Uniform Servers | ||
# Start UniTray | # Start UniTray: in folder UniServer, double click on '''Start.exe''' and the tray icon is created. | ||
# Move servers | # 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 | # 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 153: | 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 | |||
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 160: | Line 156: | ||
Database Configuration host name becomes: '''localhost:3307''' | Database Configuration host name becomes: '''localhost:3307''' | ||
After installation | 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 166: | 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 173: | Line 169: | ||
# Save file. | # Save file. | ||
Use the port number that matches your server, start the servers. Pages are accessible as mentioned above | 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'':''' | '''''Note 2'':''' | ||
If you install MediaWiki using the plugin | 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: | A MySQL port change is automatically tracked using the following code: | ||
| Line 212: | Line 208: | ||
|} | |} | ||
== Plugin == | == Plugin == | ||
The above instructions are generic allowing you to install the latest version of MediaWiki. | 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%2055-Nano%20Plugins/Applications/ '''SourceForge'''] | If you prefer a click-and-go solution, go to [http://sourceforge.net/projects/miniserver/files/Plugins/UniServer%2055-Nano%20Plugins/Applications/ '''SourceForge'''] | ||
* Under '''Plugins''' | * Under '''Plugins''' | ||
* Navigate to sub-folder '''Uniform Server 5-Nano Plugins''' | * Navigate to sub-folder '''Uniform Server 5-Nano Plugins''' | ||
* Download file [http://sourceforge.net/projects/miniserver/files/Plugins/UniServer% | * 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 == | == MySQL Security == | ||
The above installation guide and associated downloadable plugin are intended to get the application up and running purely for testing. | 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 | 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 | 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. | Its imperative you secure the MySQL server before putting your servers online. | ||
Please read | 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 | 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 | 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 | 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]]. | ||
---- | ---- | ||