Manual talk:Installation guide/Archive

From mediawiki.org

Please Discuss Your Revert

I disagree about the Appendix being better then the sidebar. Why is it better? What benefit does an appendix provide? Using a template means the list only needs to be updated in one place instead of two. Also a template can be added to all of the other install pages making them look more consistent, like they are part of a body of documentation instead of disconnected pages. Also, wouldn't most users want to jump instantly to directions for their specific operating system instead of having to read through the page to find the appendix?

Also, you changed the link from Manual:Configuring MediaWiki to Manual:Config script which is just a redirect to Manual:Configuring MediaWiki. Same goes for Manual:Manual configuration and Manual:LocalSettings.php. --Cneubauer 18:13, 29 August 2007 (UTC)Reply

Here's my various reasonings:
  • The side-bar is messy, and gives undue prominence to these articles. The whole point of the installation guide is to give a simple set of pages to get MediaWiki up-and-running in a standard scenario. We don't want to baffle our readers with loads of different alternatives that (particularly in their current state) are over-complicated and hard to read. Too many options = too hard to locate the information you need. I am less concerned with how the template is used elsewhere, as there are currently several parallel versions of documentation that we need to merge, so I'm not going to spend time fixing stuff that will ultimately be deleted anyway. If you think we should use the template for 'keeping in sync' reasons, then it needs to be tidied up to look more like the appendix list and transcluded at the bottom of the page, rather than as a box-out in the header. Re: your point about 'most users', above. I would say that most users want to know how to install MediaWiki in as simple a way as possible. The system pages go into far too much detail to be useful to most users, but are very valuable resources for those users when they get into trouble and things don't work as expected (due to the vagaries of their system), so no, I don't think it is the first port of call. The main installation guide should get 90% of users up and running with the minimum amount of fuss, with the appendices providing help for the remaining 10% when they encounter problems.
  • Manual:Configuring MediaWiki to Manual:Config script - Config script will hold a detailed walk-through for using the config script. Configuring MediaWiki should deal with local settings. I created the redirect because until this is written, it's better to link there.
  • Manual:Manual configuration to Manual:LocalSettings.php - Ditto. At time of writing there was no page about manually configuring MW beyond the LocalSettings page, so I made it a temporary redirect. Now, however, Configuring MediaWiki exists and is closer to what I intended with Manual configuration, so I'm going to change the link to point there instead.
I am aware that I have not necessarily explained all this very well, so please ask for more clarification if needed. My point in creating this installation guide is that most of our existing installation documentation is not very user-friendly. It is an attempt to rework (and ultimately replace) the existing install docs, which is very much a work in progress, which is why you will find a lot of duplication at the moment. What I don't want to happen (and which you have started to do by splitting up Manual:Installation) is to end up with a new page that simply links to the bad-old docs, however, if those pages get rewritten instead of just moved about then we might end up with something decent...  :) --HappyDog 18:30, 29 August 2007 (UTC)Reply
No, I agree with your point about a simple set of instructions being desirable. I think the template actually looks better but we can agree to disagree on that one. My goal in splitting out Manual:Installation is to make it more manageable. I think ultimately what we want is something more like Manual:Installation guide. A simple overview with links to more detailed information on how to do each piece of the installation if a user encounters problems. However, I didn't want to destroy Manual:Installation since its the best page we have at the moment, installation wise, so I transcluded everything back in. I've been slowly gathering all of the various pieces out of the Manual namespace and collecting them on the hub pages. I am working on improving and merging the individual pieces as I go. --Cneubauer 18:43, 29 August 2007 (UTC)Reply
That's fine by me. I've done a rewrite of Manual:Installation requirements, which is now arguably too wordy, but is more complete. I incorporated all the requirements-based info that was already on the page, as well as the stuff at Installation (the destination of the previous redirect). That page is now obsolete, but should not be removed until we've got the guide into shape, as it's part of our general introduction. --HappyDog 20:01, 29 August 2007 (UTC)Reply

Cross-domain installations

I operate several small wikis. Is there a way to have a single installation of Mediawiki that is used by multiple sites? Basically, I want mydomain1.com to have the full MediaWiki scripts, and mydomain2.com and mydomain3.com to run the same script but have a separate LocalSettings.php for each, so they can link to separate databases and have different extensions and skins. Then, when it comes time to upgrade MediaWiki, I only have to do it in one place instead of 3, and I use less space on my server. –Jonathan Kovaciny 02:01, 20 September 2007 (UTC)Reply

References removed from Manual:Installation

Manual:Installation is now fully merged into the installation guide (previously it transcluded the main 3 pages with a small bit of extra info - not very user-friendly!).

I have not merged the 'see also' or external references, because they are currently a mish-mash off 'useful stuff' that people have posted without any coherent structure or order, with a lot of links that seem either overly specific or very much out of date.

We should probably have a place for this kind of link, but I'm not sure where. However, the links should be carefully selected for their usefulness and accuracy and it shouldn't just become a drive-by dumping ground.

Here is the content I removed:

Installation for offline access

See:

See also

External links

  • Lopez, Daniel Sams Teach Yourself Apache 2 in 24 Hours. Excellent easy to use book, the 3rd chapter, which explains how to install Apache, can be viewed on Amazon.com here (must register with Amazon first to view pages)
  • An outdated explanation of how to install, configure, and get Apache 1.3, MySQL 3, PHP 4 running under Windows XP in less than 30 minutes. (This document is significantly out of date, having been updated October 5, 2003, but is otherwise well written!) For example, as of January 1, 2006:
  • It references Apache 1.3, Apache 2.2 is current. The syntax it suggests for httpd.conf prevents Apache from restarting.
    1. It references PHP 4. PHP 5.1 is current.
    2. It references MySQL 3.23. MySQL 5.x is current.

Installing MediaWiki with Sun Java System Web Server 7.0

  • Sun has recently released their latest version of Web Server - Sun Java System Web Server 7.0(formerly known as iPlanet Enterprise Server or Sun ONE Web Server). Here is a technical article on how to deploy MediaWiki with Sun Java System Web Server 7.0. Feel free to post your queries and concerns that you run into at Sun's Web Server Software forum
  • Also, if you need more help on how to get PHP as such working with Sun Java System Web Server 7.0, then check out this article which describes the steps involved in configuring and running PHP with Web Server 7.0.
  • A compact step-by-step guide to configure WAMP + MediaWiki is also available.

For Windows XP, you may want to point users to a site similar to XAMPP for Windows. This appears to cover the basic requirements of Apache, PHP and MySQL.

Installing MediaWiki on Windows Server 2008 R2 64bit

  • For my organization I've set up the above server on a virtual machine using VMware (with software recommended settings).
    • The use of VMware required the enabling of VT (virtualized technology) to allow me to run a 64bit OS.
  • Following the recommended Wikimedia Installation instruction and this online guide I've installed the following software:
    • Apache Version 2.2.19 windows installer (including OpenSSL) from here.
    • PHP version 5.3.6 (VC9 x86 Thread Safe) from here.
    • MySQL version 5.5.14 (Windows (x86, 64-bit), MSI Installer) here
  • Installation instructions were very helpful, with minimum configuration, and once the setting of the machine was done, setting it up was as simple as copying the Wikimedia files and following the online instruction.

I suggest editing the above list on this page to remove any cruft before figuring out whether to (a) include the remaining useful information in a single place as before, or (b) move individual links to the relevant sub-page within the wiki (my preference). --HappyDog 23:54, 29 November 2007 (UTC)Reply

Can't access Config directory

When I go to the wiki/config directory, Firefox asks me to download a PHTML file instead of taking me to a setup? What did I do wrong?

Installation Database error

Hi. I've nearly finished installing MediaWiki. I used Wampserver (I got Apache, MySQL and PHP all in that package) and now whenever I click "install Mediawiki", this is added to the list at the begining:

  • Attempting to connect to database server as wikiuser...failed due to authentication errors. Check passwords.

and this comes up in a big red box: "Something's not quite right yet; make sure everything below is filled out correctly."

My database name is wikidp
My database username is wikiuser
And I've filled in my password
Do I have to edit any MySQL thing, if so, what and how do I do it?
Thanks Silver Yoshi 08:14, 24 July 2009 (UTC)Reply

PostgreSQL 8.0 support?

Accoding to Manual:PostgreSQL, I changed PostgreSQL versions in the system requirements (as a draft). Does anyone knows about a current support for PostgreSQL 8.0?--Ayucat 09:20, 27 December 2009 (UTC)Reply

XAMPP

XAMPP for Windows installs the buggy version of PHP (5.3.1). Even after unistalling and then reinstalling the good version (5.3.2), I still get the incompatibility message about 5.3.1. How do I completely uninstall PHP 5.3.1.???