Quelltext der Seite Projekt:Maintenance

== Update mediawiki core ==
Remember your file layout looks like this:
{{code|io|
drwxr-xr-x  8 www-data www-data 4096 Feb 18 12:43 .git                           // your repository files
-rw-r--r--  1 www-data www-data  362 Feb 18 12:06 .gitignore                     // ignore files for your repo
-rw-------  1 www-data www-data   58 Oct 21 17:11 _admin_login.php               // located in this file are the credentials for the local admin login
drwxr-xr-x  2 www-data www-data 4096 Feb 18 12:06 _config                        // this is where your config files are located
drwxr-xr-x 51 www-data www-data 4096 Feb 18 12:41 _extensions                    // this is the assortment of available extensions
drwxr-xr-x  3 www-data www-data 4096 Dec 16 09:58 _images                        // this is your image directory, almost empty after unpacking
drwxr-xr-x  5 www-data www-data 4096 Feb 17 12:39 _init                          // this is where all starter files and some useful scripts are located
-rwx------  1 www-data www-data  593 Oct 21 17:11 get_new_version_going          // a small script to initialize a new version (update, not upgrade) of the mediawiki software
lrwxrwxrwx  1 www-data www-data   16 Feb 18 12:40 mediawiki -> mediawiki-1.23.8  // a symbolic link to the current mediawiki core software
drwxr-xr-x 12 www-data www-data 4096 Feb 18 12:39 mediawiki-1.23.8               // the current mediawiki core software
drwxr-xr-x  2 www-data www-data 4096 Oct 23 13:04 php_temp                       // folder for temporary files and session data
}}
In this example the core software runs on version 1.23.5. Identify your new version number and execute these to commands (in this example we upgrade to 1.23.42):
{{code|bash|code=
wget http://releases.wikimedia.org/mediawiki/1.23/mediawiki-1.23.42.tar.gz
tar xvzf mediawiki-1.23.42.tar.gz
}}
You should have a new directory called <code>mediawiki-1.23.42</code> in the above listing. Now cd in it and run
{{code|bash|code=
../get_new_version_going
}}
After that all you have to do is remove the symbolic link pointing to your old core software and create a new one pointing to <code>mediawiki-1.23.42</code>.

{{ambox|text=It is recommended setting your wiki to read only during the upgrade. Do this by setting <code>$wgReadOnly="Upgrading"</code> or some other string.}}

You should also run update.php after each upgrade:
{{code|bash|code=
php mediawiki/maintenance/update.php
}}

== Update extensions ==
The extensions are located in <code>./_extensions</code>. Most of them have a directory indicating their version number and a symbolic link pointing to them. Something like:
{{code|io|code=
lrwxrwxrwx  1 www-data www-data   16 Oct 12 21:56 ApprovedRevs -> ApprovedRevs.0.7
drwxr-xr-x  5 www-data www-data 4096 Oct 12 21:54 ApprovedRevs.0.7
lrwxrwxrwx  1 www-data www-data   19 Aug 22 14:37 Arrays -> Arrays.2.0rc3_alpha
drwxr-xr-x  3 www-data www-data 4096 Aug 22 14:36 Arrays.2.0rc3_alpha
}}
When there is a new version just unpack it here, be sure to include ne new version number in the directory name and let the symbolic link point to the new directory (mind the user and directory rights in the newly downloaded extension and run <code>chown</code> if needed).

As ususual you should run update.php after each update:
{{code|bash|code=
php mediawiki/maintenance/update.php
}}

Extension w/o version numbers are most likely either installed by composer or downloaded via git:
=== Composer ===
Some extensions are installed via [[wpen:composer|composer]]. Namely:
* lingo
* semantic-extra-special-properties
* semantic-glossary
* semantic-media-wiki
* semantic-result-formats

You can find an actual overview of all composer installed extensions in the file <code>./mediawiki/composer.json</code>. With a fresh install of this platform it should look like this:
{{code|php|code=
{
    "require": {
        "mediawiki/semantic-media-wiki": "~2.0",
        "mediawiki/semantic-extra-special-properties": "*",
        "mediawiki/lingo": "*",
        "mediawiki/semantic-result-formats": "*",
        "mediawiki/semantic-glossary": "*"
    }
}
}}

Go to your mw core root directory and hit <code>composer update</code>. Your composer installed extensions should update automatically.
{{warning|text=When you hit {{code snippet|lang=bash|code=./mediawiki/composer update}} you have to reapply a small patch to semantic mediawiki core code.<br />You can find the patch notes in the file {{code snippet|lang=bash|./_extensions/_patched}}.}}

=== Git ===
To play it safe either note the commit you're running the extension on or backup the directory. Then hit {{code snippet|lang=bash|code=git pull}}.

== Maintenance scripts ==
You should run them regularely, either by hand or as recommenden by cron:

* <code>mediawiki/maintenance/runJobs.php</code> to clean the job queue on a daily or hourly basis (please consider specifying a parameter --maxjobs 1000)
* <code>_extensions/SemanticMediaWiki/maintenance/rebuildData.php</code> to rebuild the smw store. probably once per week or month so:
** <code>php rebuildData.php -ftp -d 20</code>, to clear the store (thus removing false entries) and rebuild the properties and after that a couple of times
** <code>php rebuildData.php -d 20</code>, to rebuild the new data
* <code>_extensions/SemanticGlossary/maintenance/rebuildGlossaryCache.php</code> to rebuild the semantic glossary cache. probably once per week or month so:

Remember to set an environment variable with the mediawiki working directory:
{{code|lang=bash|code=
export MW_INSTALL_PATH=/var/www/<wikiname>/mediawiki
}}

=== Clean up session files ===
You should also clean up all session files, located <code>./php_temp</code>. Best do this with a cron job.