[gentoo-commits] gentoo-x86 commit in www-apps/mediawiki/files: postupgrade-1.13-en.txt postinstall-1.13-en.txt

[Peter Volkov (pva)]

pva         08/09/29 06:38:48

  Added:                postupgrade-1.13-en.txt postinstall-1.13-en.txt
  Log:
  Version bump, remove old/broken. Should install all files, bug #236411, thank Dan Johnston for report. Dropped access_restrict patch - let administrator decide what to restrict, fixes bug #236872, thank Michael Mair-Keimberger for report.
  (Portage version: 2.2_rc11/cvs/Linux 2.6.26-gentoo-r1 i686)

Revision  Changes    Path
1.1                  www-apps/mediawiki/files/postupgrade-1.13-en.txt

file : http://sources.gentoo.org/viewcvs.py/gentoo-x86/www-apps/mediawiki/files/postupgrade-1.13-en.txt?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo-x86/www-apps/mediawiki/files/postupgrade-1.13-en.txt?rev=1.1&content-type=text/plain

Index: postupgrade-1.13-en.txt
===================================================================
These instructions help you to upgrade your mediawiki installation.

Please NOTE: at this point it is supposed that you've already read
RELEASE-NOTES and done full wiki backup, as described here:
http://www.mediawiki.org/wiki/Manual:Backing_up_a_wiki


Run the update script
=====================

Note: Make sure there's an AdminSettings.php file in the wiki root, and it
contains up to date information. The user needs full permissions (shell
access) on the database. If there is no AdminSettings.php, create it:

$ cd ${MY_INSTALLDIR}
$ cp AdminSettings.sample AdminSettings.php

Now edit AdminSettings.php.

The preferred method of performing the update is using the command-line
maintenance script, although it is also possible to re-run the web-based
installer. To run command-line maintenance script, change to the maintenance
directory and execute the update script:

$ cd ${MY_INSTALLDIR}/maintenance
$ php update.php

MediaWiki will inspect the existing schema and update it to work with the new
code, adding tables and columns as needed.

For alternative ways to upgrade your wiki, please, take a look at:
http://www.mediawiki.org/wiki/Manual:Upgrading


Upgrade extensions
==================

Certain extensions have been updated in order to work with MediaWiki 1.13. Be
sure to upgrade to the latest versions of such extensions. You might need to
perform manual updates to custom extensions.


Test the update
===============

Once the upgrade has completed, browse to the wiki and check basics such as
viewing and editing pages to ensure things still work as expected.

Visit Special:Version and check that the version shown is correct.



1.1                  www-apps/mediawiki/files/postinstall-1.13-en.txt

file : http://sources.gentoo.org/viewcvs.py/gentoo-x86/www-apps/mediawiki/files/postinstall-1.13-en.txt?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo-x86/www-apps/mediawiki/files/postinstall-1.13-en.txt?rev=1.1&content-type=text/plain

Index: postinstall-1.13-en.txt
===================================================================
To complete installation you need to proceed the following steps:
=================================================================

1. Temporarily make the MediaWiki config/ directory writable to the user the
web server is running as. The quickest way is to make the directory world
writable. For example:

$ cd ${MY_INSTALLDIR}
$ chmod a+w config


2. Configure database.
a.) If you know the root password on your database, the MediaWiki installation
script can create a new database for you.

b.) If you don't know the root password, MediaWiki still needs database to
work with. So, please, read the following link and find solution which suits
your needs best:

http://www.mediawiki.org/wiki/Manual:Installing_MediaWiki#Create_a_database


3. Now continue the installation through web browser by accessing the
following page:

lynx http://${VHOST_HOSTNAME}${VHOST_APPDIR}/config/
 

4. After the setup script has finished running successfully, a file called
LocalSettings.php is created in the "config" directory. Move this file to the
root wiki directory (${MY_INSTALLDIR}):

$ mv config/LocalSettings.php .

Set stringent permissions on the LocalSettings.php file:

$ chown <webserver-user>:root LocalSettings.php
$ chmod 600 LocalSettings.php

And delete the "config" directory:

$ rm -rf config


5. Once you have done the above, your wiki should be ready to use!

http://${VHOST_HOSTNAME}${VHOST_APPDIR}/
 

Enabling Optional Features and other configuration
==================================================

Allow images and other files to be uploaded through the wiki
------------------------------------------------------------

If you wish to enable images and other files to be uploaded through wiki then
edit the LocalSettings.php file and set \$wgEnableUploads to 'true':

\$wgEnableUploads       = true;

Now if MediaWiki was built with the imagemagick USE-flag the directory
permissions are correct, otherwise install ImageMagick and adjust permissions
on the images directory to allow the web server to write. For example:
 
$ chown <webserver-user>:<webserver-group> ${MY_INSTALLDIR}/images

IMPORTANT: Uploads need to be set up properly in order to be secure! For more
details take a look at the following page:

http://www.mediawiki.org/wiki/Manual:$wgEnableUploads


Math Support
------------

If you wish to enable the math support then you need to build MediaWiki with
'math' USE-flag enabled or required support executable will no be present.
After you've installed MediaWiki with math USE-flag enabled edit
LocalSettings.php file to set the \$wgUseTeX to 'true':

\$wgUseTeX           = true;


Other
-----

For other tweaks, continue with the following:
http://www.mediawiki.org/wiki/Manual:Installing_MediaWiki#See_also