Kılavuz: Güncelleme

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Upgrading and the translation is 77% complete.

Outdated translations are marked like this.
Other languages:
Alemannisch • ‎Bahasa Indonesia • ‎Deutsch • ‎English • ‎Mirandés • ‎Nederlands • ‎Türkçe • ‎Zazaki • ‎català • ‎dansk • ‎español • ‎français • ‎italiano • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sicilianu • ‎čeština • ‎Ελληνικά • ‎беларуская • ‎български • ‎русский • ‎العربية • ‎سنڌي • ‎فارسی • ‎हिन्दी • ‎মেইতেই লোন্ • ‎中文 • ‎日本語 • ‎한국어

Ana Genel Görünüm

Dosya transferi

Dosyaları aktarmak için bir yöntem seçiniz:

Ön hazırlık

MediaWiki içindeki UPGRADE metin dosyasını okuyun.

  1. Gereksinimleri kontrol edin
  2. Sürüm notlarını okuyun
  3. Mevcut dosyaları ve veritabanını yedekleyin
  4. Yeni dosyaların paketini açın
  5. Eklentileri yükseltin
  6. Veritabanını kontrol etmek için güncelleme komut dosyasını çalıştırın
  7. Güncelleme testini yapın

Kontrol gereksinimleri

MediaWiki 1.31 aşağıdakilere gereksinim duymaktadır:

  • PHP 7.0.0+
  • ve aşağıdakilerden biri:
    • MySQL 5.5.8+ (veya eşdeğer MariaDB)
    • PostgreSQL 9.2+
    • SQLite 3.3.7+
    • Oracle 9.0.1+

Eğer PostgreSQL kullanıyorsanız lütfen Manual:Upgrading PostgresManual:Upgrading Postgres bölümünü de okuyun.

Daha fazla bilgi için lütfen Manual:Installation requirementsManual:Installation requirements ve CompatibilityCompatibility'i okuyun.

Sürüm notlarını okuyun

Tarball dağıtım dosyası içinde, veya Git tarafından teslim edilen / ihraç edilen dosyalar içinde, adı büyük harflerle yazılmış dosyalardan biri olan RELEASE-NOTES (wiki) içeren bir dosya var. Şimdi paketi açıp ve bu sürümde nelerin değiştiğini öğrenmenin zamanı geldi.

Bekleyen işlerin kaldırılması

Performans nedenleriyle, veritabanındaki bazı işler ertelenir ve iş kuyruğu tarafından yönetilir. Bu ertelenen işler veritabanında saklanır ve gerçekleşmesi gereken eylemler hakkında bilgi veren parametreleri içerir. Bu bekleyen işleri, parametre özelliklerinin yeni sürümde değişmesi durumunda başarısız olmasını önlemeniz için wiki'yi yükseltmeden önce çalıştırmanız kesinlikle önerilmektedir. Tüm bekleyen işleri çalıştırmak ve yükseltmeyi gerçekleştirmeden önce sırayı temizlemek için runJobs.phpManual:RunJobs.php'iyi kullanın.

Mevcut dosyaları ve veritabanını yedekle

Tam talimatlar: Manual:Backing up a wikiManual:Backing up a wiki

Yükseltme komut dosyaları iyi-korunmuş ve sağlam olsa da, işler yine de ters gidebilir. Veritabanı şemasını güncellemeye başlamadan önce, hem veritabanını hem de dosyaları içeren, wiki'nin tam yedeğini alın:

  • wiki'nin içeriği, veritabanından (karakter setinin doğru şekilde belirlendiğinden emin olmak için önce LocalSettings.php dosyasını kontrol edin). SQL dökümanı dökümüne ek olarak bir XML dökümü oluşturmak iyi bir fikir olabilir.
  • MySQL, hem SQL dökümü hem de XML dökümü, mysql komutuyla birlikte kullanılmaktadır:
mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb > file.sql
mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb --xml > file.xml
  • PostgreSQL, veritabanı dökümü için pg_restore komutu ile birlikte kullanılmaktadır:
pg_dump --create -Fc wikidb > file.db.dump
  • SQLite, yedek oluşturmak için bir MediaWiki komut dosyası kullanıyorsunuz:
php wikifolder/maintenance/sqlite.php --backup-to file
  • resimler ve diğer medya dosyaları (images dizininin içeriği, özel logo /skins/common/images/wiki.png)
  • yapılandırma dosyaları, ör. LocalSettings.php ve .htaccess (eğer varsa)
  • MediaWiki'nin tüm kabuk ve eklentilerini içeren program dosyalarını, özellikle bunları değiştirdiyseniz.

Yeni dosyaların paketini açma

Bir tarball paketi kullanma

FTP veya komut satırı kullanarak yeni dosyaları yükleyebilirsiniz. Erişiminiz varsa komut satırını kullanın! Komut satırını kullanmak, binlerce dosyanın her birini FTP ile yüklemekten çok daha hızlı olacaktır.

Açılmış tarball'ınızı sunucunuzdaki yeni ve boş bir klasöre yerleştirmelisiniz. Eğer yeni sürümü doğrudan yeni bir dizin yerine eski sürümünüzün üstünde yüklerseniz, Var olan dosyaları ve veritabanını yedekle bölümünde açıklanan talimatları izlemelisiniz. Aksi takdirde, herhangi bir özelleştirme yaptıysanız, bunları yeniden uygulamak için herhangi bir başvuru yapmadan ayrılmanızı sağlayacak şekilde silebilirsiniz. MediaWiki'nin canlı kopyasının üstünde yeni bir tarball yükleme, MediaWiki'nin eski sürümündeki bazı dosyaları geride bırakabilir ve bu da güncellemenin kodunu etkileyebilir. Bu sebeple yeni dosyaları yeni bir dizinde açmanız ve daha sonra özelleştirmeleri yeni dizine uygulamanız (LocalSettings.php, resimler klasörü, eklentileri ve özel kabuklar gibi diğer özelleştirmeleri geri yüklemeniz önerilir)

FTP veya grafik

Eğer sunucunuzdaki komut satırına erişemiyorsanız, MediaWiki tarball'ını yerel bilgisayarınıza indirin ve yerel bilgisayarda tarball'ı çıkarmak için 7zip'i kullanın.

Dosyaları bilgisayarınıza çıkardıktan sonra, en sevdiğiniz FTP istemci yazılımını kullanarak dizinleri ve dosyaları sunucuya yükleyiniz.

Komut satırı

Mevcut kullanıcı wiki kurulum dizinleri üzerinde tam yazma izinine sahip değilse sudo komutunu kullanarak çalıştırmanız gerekebilir. Normalde bir tarball paketini açtığınızda, yeni wiki sürümü için yeni bir dizin oluşturulur ve eski kurulum dizininizden eski yapılandırma dosyaları ve resim dizinini kopyalamanız gerekir:

$ cd /path/to/your/new/installation/  
$ wget https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.1.tar.gz
$ tar -xvzf mediawiki-1.31.1.tar.gz 
$ rm mediawiki-1.31.1.tar.gz

(Open)Solaris kullanıcıları gtar, veya:

$ gzip -dc mediawiki-1.31.1.tar.gz | tar xf -

Diğer dosyalar

Tarball'ı yükledikten sonra, bazı dosya ve klasörleri eski kurulum dizininden yeni bir dizine kopyalamanız veya taşımanız gerekir:

  • LocalSettings.php, eski yapılandırma ayarlarınızı içerir.
  • Yüklenen tüm dosyaları içeren wiki images (veya eski sürümlerdeki uploads) dizininin, farklı bir yükleme dizini seçmediyseniz, sahipliğini ve izinleri değiştirin. find ./images -type d -exec chmod 755 {} \; ve chgrp -R apache images (Örneğin. web kullanıcınız "apache" ise).
  • extensions dizinindeki bazı eklentiler. Güncellenmiş eklentileri her zaman almalısınız, eski uzantıların MediaWiki'nin yeni bir sürümüyle çalışması garanti edilmez.
  • Özel bir logo kullanmanız durumunda, bu dosyanın da yedekten geri yüklenmesi gerekiyor. 1.24 öncesi sürümlerde kabuklar genellikle skins/common/images/ dizininde yer almaktadır. 1.24 sonrası sürümlerde sizin tercihinize göre resources/assets/ veya images/ dizininde yer almaktadır. Sonra LocalSettings.php ye ekleme yapınız ör. $wgLogo = "$wgScriptPath/images/logo.png"; gibi.
  • skins dizinindeki özel kabuklar.
  • Eski kurulum dosyalarında veya eklentilerde yapılan değişiklikler.
  • Herhangi bir .htaccess dosyası (Apache kullanıyorsanız ve onlarda herhangi bir kural tanımladıysanız).

İşiniz bittiğinde, bu yeni klasörü web sunucusundaki yayınlanmış klasör yapın veya eski kurulum dizinini yeniden adlandırın ve yenisini eski adla eşleşecek şekilde yeniden adlandırın.

Git kullanımı

Eğer GitDownload from Git kullanılıyorsa, dosyaları yeni bir konumda dışarı aktarınız, ve önceki özelleştirilmiş dosyaları bir önceki bölümde açıklandığı gibi yeni konuma kopyalayınız.

MediaWiki 1.25 veya sonraki bir sürüme yükseltiyorsanız, bazı harici PHP kütüphaneleri Composer veya Wikimedia wiki çiftliği için sağlanan belirli bir koleksiyon kullanarak kurmanız gerekecektir. Harici kütüphanelerin yüklenmesi ve güncellenmesi ile ilgili daha fazla bilgi Git indirme belgesinde bulunabilir.

Yama kullanma

Küçük bir sürüm güncellemesi için genellikle küçük bir yama dosyası kullanılabilir. Bir döküm sitesinden elle yama dosyasını indirip dışarı aktarınız veya aşağıdaki wget yönergelerini izleyiniz. Yamalar artımlıdır, bir sürümü atlayamazsınız.

  1. cd ana MediaWiki dizinine (LocalSettings.php ile birlikte).
  2. Yama eki dosyasını indirin ve onu gunzip yapınız.
  3. Neyin değiştiğini kontrol etmek için patch -p1 --dry-run komutunu kullanın (örn., patch -p1 --dry-run -i mediawiki-x.xx.x.patch)
  4. Eğer her şey yolundaysa, --dry-run olmadan tekrar patch'i çalıştırın.
  5. Special:Version sayfasını kontrol ediniz. Yeni sürüm numarasını bu sayfada görmelisiniz.

Kalan dosyalar hatalara neden olabilir

Eski kurulum dizininin olduğu yere paketini açarsanız, bazı eski dosyalar yeni sürümde sorunlara sebep olabilir.


MediaWiki version: 1.18

Eğer profil kullanmıyorsanız, ancak MediaWiki kök klasörünüzde bir StartProfiler.php dosyası varsa, /includes/Profiler.php'e bağlı hataları alabilirsiniz. StartProfiler.php dosyasının silinmesi veya yeniden adlandırılması bu hatayı çözer. MediaWiki kök klasöründe bulunan StartProfiler.sample dosyası gelecekte profil oluşturmayı etkinleştirmeniz durumunda bir şablon görevi görebilir.


MediaWiki version: 1.23

MediaWiki 1.23, çekirdek kabuk dosyalarının otomatik kabuk keşfi mekanizmasını kullanımdan kaldırıyor. Bu sürüme geçtikten sonra eski Chick.php, Nostalgia.php, Simple.php ve Standard.php dosyalarının skins/ dizininden, bunun yanı sıra ilgili skins/ dizininin içindeki alt klasörlerinin de kaldırıldığına emin olmanız gerekir.


MediaWiki version: 1.24

MediaWiki 1.24 çekirdek kabuk dosyalarının yollarını değiştirdi. Bu sürüme geçtikten sonra, eski CologneBlue.php, Modern.php, MonoBook.php ve Vector.php dosyalarının doğrudan skins/ dizininde artık bulunmadığından emin olmanız gerekir.

Eklentilerin güncellenmesi

Bazı eklentiler MediaWiki'nin yeni sürümüyle çalışmak için güncellendiler. Bu tür uzantıları en son sürümlerine yükseltmeyi unutmayınız. Özel uzantılar için elle güncelleme yapmanız gerekebilir.

Farklı tarballs eklentileri bazı alt grupları içerir ve MediaWiki çekirdeğiniz için doğru olan sürümü seçmenize yardımcı olur.

Eklenti Dağıtıcı, MediaWiki'nin desteklenen sürümleriyle çalışacak eklentilerin enstantanesini almak isteyen kullanıcılar için iyi çalışmaktadır.

Eğer daha fazla eklenti istiyorsanız o zaman Git deposundan indirme muhtemelen sizin için en iyisidir. If you don't have Git but you want to upgrade a lot of extensions, you might consider using mwExtUpgrader.


LocalSettings.php'nizi uyarlayın

Eski sürümlerdeki LocalSettings.php dosyasını kullanırsanız, yeni sürümlerde bunun nasıl uygulayacağını ayarlamanız gerekebilir:

Kabuk kaydı

MediaWiki'nin 1.24 sürümünden itibaren, Vector, Monobook, Modern ve CologneBlue gibi paket kabuklar artık MediaWiki çekirdeğinin bir parçası değildir. Bunları kullanmak için paketlerin LocalSettings.php dosyasında kayıtlı olması gerekir; aksi takdirde MediaWiki sizi kabukları yüklemediğiniz konusunda uyaracaktır.

1.24 sürümünden daha güncel bir sürüme güncelleme yaparken bu kabuklardan birini kullanmak olmak istiyorsanız LocalSettings.php dosyasına eklemeniz gereken şey aşağıdaki gibidir:

wfLoadSkin( 'Vector' );
wfLoadSkin( 'MonoBook' );
wfLoadSkin( 'Modern' );
wfLoadSkin( 'CologneBlue' );

Bu kod MediaWiki 1.25 ve daha yeni sürümü içindir. MediaWiki 1.24 sürümü için aşağıdaki kodu kullanmanız gerekir:

require_once "$IP/skins/Vector/Vector.php";
require_once "$IP/skins/MonoBook/MonoBook.php";
require_once "$IP/skins/Modern/Modern.php";
require_once "$IP/skins/CologneBlue/CologneBlue.php";

Diğer kabuklar henüz yeni kabuk kayıt sistemine uyarlanmamış olabilir, bu sebeple, herhangi bir sorun çıkması durumunda doğru bir şekilde nasıl kayıt olacağını görmek için her bir kabuğun dokümantasyon sayfasına bakınız.

Eklenti kaydı

MediaWiki'nin 1.25 sürümünden itibaren, eklentiler yeni eklenti kayıt sistemi kullanıyor.

Daha önceki LocalSettings.php dosyası şöyle bir şey içeriyordu:

require_once "$IP/extensions/Cite/Cite.php";
require_once "$IP/extensions/Gadgets/Gadgets.php";
require_once "$IP/extensions/ImageMap/ImageMap.php";
require_once "$IP/extensions/InputBox/InputBox.php";
require_once "$IP/extensions/Nuke/Nuke.php";
require_once "$IP/extensions/ParserFunctions/ParserFunctions.php";
require_once "$IP/extensions/Poem/Poem.php";
require_once "$IP/extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php";
require_once "$IP/extensions/WikiEditor/WikiEditor.php";

Bu, aşağıdaki biçime dönüştürüldü:

wfLoadExtension( 'Cite' );
wfLoadExtension( 'Gadgets' );
wfLoadExtension( 'ImageMap' );
wfLoadExtension( 'InputBox' );
wfLoadExtension( 'Nuke' );
wfLoadExtension( 'ParserFunctions' );
wfLoadExtension( 'Poem' );
wfLoadExtension( 'SyntaxHighlight_GeSHi' );
wfLoadExtension( 'WikiEditor' );

Eklentiler yeni eklenti kayıt sistemini kullanacak şekilde uyarlanmaktadır. Uyarlanmamış eklentiler, eski kurulum biçimini kullanmalıdır. Daha fazla bilgi için eklentinin sayfasındaki kurulum talimatlarına bakın.

Diğer değişiklikler

Bazı değişkenler eskimiş veya kaldırılmış olabilir. Onları LocalSettings.php'e yerleştirmek genellikle herhangi bir etkiye sahip olmayacaktır. Yeni sürümlerde yeni değişkenler eklenmiş veya mevcut bazı değişkenlerin türü değiştirmiş olabilir. Genellikle değişkenler için mümkün olduğunca tür değiştirme durumunda geriye dönük olarak uyumlu olalım diye varsayılan yapıyı kullanmaya çalışırız. Her durumda, bu değişiklikleri görmek için sürüm notlarına göz atınız.

Güncelleme komut dosyasını çalıştırın

MediaWiki veritabanını iki şekilde yükseltebilirsiniz: Komut satırından veya web tarayıcısından. Sunucunuzun komut satırına erişiminiz varsa, zaman aşımı veya bağlantının kesilmesi riskini azalttığı için, güncelleme işleminin komut satırından yapılması önerilir.

Komut dosyası ayrıca MediaWiki'nin ihtiyaç duyduğu eksik bağımlı paketleri indirmeye çalışacaktır.

Komut satırı

Access the command line of your server or an SSH shell or similar. You can access the command line by connecting to your server via SSH. If the local PC you are working on runs Microsoft Windows, you will need a tool like PuTTY to use SSH. From the command line or the Shell, change to the maintenance directory and execute the update script:

$ php update.php

On a Linux server if you get an error try performing the same command as root (sudo php maintenance/update.php). Note for simple installations on Windows (e.g. with XAMPPManual:Installing MediaWiki on XAMPP): First make sure that your web server (such as Apache) and your database (such as MySQL) are running. Then run update.php: right-click it, select Open With, and browse to PHP.exe. The resulting command prompt window will likely autoclose when the schema upgrade completes.

You might see a message that your PHP version is too old and that MediaWiki needs a newer version. After that message the update aborts. Reason for this error is that the command line can use another PHP version than that one which you have when you execute MediaWiki from the web server. When you get this message you should check, if you can execute a newer PHP version on the shell by using a different command: That might e.g. be php5 or php56. If another version is available and - if so - under which name, depends on the setup of your server. If it does not work, ask your hoster; he will surely know.

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

If you use a Shared database, you should pass the --doshared parameter if you want the shared tables to be updated. Otherwise they won't be touched by the update script.

What to do in case of "ALTER command denied to user" error (or similar)

In case the scripts abort with a message similar to:

Error: 1142 ALTER command denied to user 'wiki'@'localhost' for table 'mytable' (localhost)
ERROR: must be the owner of the mytable relation 

This means that you should check that you have defined $wgDBadminuserManual:$wgDBadminuser and $wgDBadminpasswordManual:$wgDBadminpassword in your LocalSettings.phpManual:LocalSettings.php file (in the main directory). These are the user and password needed by this script in order to access to the database.

In some cases, an old $wgDBmwschema variable (for Postgres) seems to be read for the table name to update instead of $wgDBname, even when mysql is used. If this is the case, just get rid of the $wgDBmwschema definition in LocalSettings.php.

What to do in case of "unexpected T_STRING" error

Individuals running update.php from the command line may encounter the following error:

syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or '}' \
in ~/maintenance/commandLine.inc on line 13

This error occurs when update.php is run from php4.

Individuals who have their site hosted by providers who provide both php4 and php5 should take the following steps:

Komut satırını kullanarak 'whereis php5' komutunu girin.

  1. once you have discerned the location of the php5 path, list the contents of php5/bin directory
  2. once you've determined the name of the php executable (either php or php5), type in the entire path to execute update.php

Below is an example:

$ whereis php5
$ ls -la /usr/local/php5/bin
$ /usr/local/php5/bin/php update.php

What to do in case of 'register_argc_argv is set to false' error

You may encounter the error:

Cannot get command line arguments, register_argc_argv is set to false
  1. Go to ~/maintenance. Either edit an existing 'php.ini' file, or create one.
  2. Add a line as follows:
register_argc_argv=true
  1. Re-run php update.php

Web tarayıcısı

MediaWiki version: 1.17
Ayrıca bkz. update.phpManual:update.php

If your database is already big and in high production usage, then you should not be using the Web updater, e.g. because the update process will time out when the maximum_execution_time is reached. In that case you should use update.php from the command-line interface (not from the web). What exactly is "too big" depends on your server (e.g. on its performance, the load and on how long the maximum execution time of PHP allows the script to run). If your wiki is too big for the web updater and your hosting provider does not allow command-line access, then you need to migrate your wiki to another hosting account, preferably to one that does have shell access.

  1. Always back up before performing database maintenance.
  2. Navigate your webbrowser to /mw-config/. For example, if your wiki is at http://example.org/w/index.php, then navigate to http://example.org/w/mw-config/.
  3. Select your language and click continue.
  4. The existing installation should be detected. Follow the instructions on the screen to upgrade it.
    If asked for the "upgrade key", open your LocalSettings.phpManual:LocalSettings.php file and look for the key assigned to $wgUpgradeKeyManual:$wgUpgradeKey.

It might happen that the web-updater does not seem to work: Instead of seeing the initial language selection screen, you might see an empty wiki page, possibly with some error message. In this case it is most likely that your webserver uses Rewrite Rules (most likely for short URLs), which do not show you the updater at mw-config/, but a wiki page at Mw-config/, with capital "M". In this case, rename the .htaccess file for the time of the update. Then you should be able to access the web-updater.

Uyarı Uyarı: If you use this method, make sure to change the name of the .htaccess file back after running the upgrade script! Otherwise short URLs and possibly other stuff will be broken!

Güncellemeyi test et

Güncelleme tamamlandıktan sonra, wiki'ye göz atınız ve aşağıdaki işlemlerin beklendiği gibi çalıştığını kontrol ediniz:

  • Sayfaları görüntüleme
  • Sayfaları düzenleme
  • Dosya yükleme
  • Special:Version sayfasını ziyaret ediniz ve gösterilen sürümün doğru olup olmadığını ve eklentilerin bulunduğunu kontrol ediniz.

Sıkça Sorulan Sorular

Güncellemek ne kadar zor?

If the only file you have modified is LocalSettings.phpManual:LocalSettings.php, and you are upgrading from 1.5 or later, the process is very simple. The amount of human work involved is only a few minutes. The database schema changes will take an amount of time proportional to the size of your database — potentially hours for wikis with millions of pages, but for a more typical size of a few thousand pages, it is usually done in seconds.

Minor upgrades, within the same major version, say from 1.13.0 to 1.13.1, do not require any schema changes at all. You can just update the files. The database needs no update, hence it is not necessary to run the installer script.

Upgrading from 1.4 or earlier is potentially complicated because support for character sets other than UTF-8 was dropped, and the schema for storing bulk text changed. Please read the relevant section in the UPGRADE file.

Upgrading becomes difficult if you have modified our source code, and you don't want your changes to be overwritten. Tools such as diff, patch, Meld or WinMerge may be useful. There is also potential for trouble if you are using unmaintained extensions. Upgrade your extensions at the same time as you upgrade MediaWiki.

If you have modified the skin or use a custom skin you very likely will have to adjust it to work again with the new version of MediaWiki.

Not Not: Instead of patching your "global" css and js (javascript) files everytime you can simply add the code to your MediaWiki:Common.js and MediaWiki:Common.css pages. As these are part of the database which will be reused when you upgrade, you will not have to patch the MediaWiki core files any more.

How do I upgrade from a really old version? In one step, or in several steps?

It depends: If you are upgrading from MediaWiki 1.4 or older, you should upgrade to MediaWiki 1.5 first. If you are upgrading from a Latin-1 wiki, use upgrade1_5.php (found in MediaWiki 1.5) to convert the relevant parts of the database to UTF-8 ($wgUseLatin1Manual:$wgUseLatin1 needs to be set to true in your LocalSettings.phpManual:LocalSettings.php for this to work). Next, run update.php, and then set the $wgLegacyEncodingManual:$wgLegacyEncoding option in LocalSettings.php to the encoding previously used by the wiki (e.g. windows-1252). This is basically how Wikipedia and other Wikimedia Foundation sites were upgraded from MediaWiki 1.4 to 1.5 – see the relevant settings file (warning: huge page!) and some related notes at Wikitech. You may need to upgrade to MediaWiki 1.4 before running the upgrade1.5 script. If you want to make a database dump (e.g. MySQL) of your Latin-1 wiki, make sure the type of the old_text field in the textManual:Text table table is mediumblob, not mediumtext, to avoid character encoding issues.

If you are upgrading from MediaWiki 1.5 or newer, you can upgrade in one step, from your old version to the latest stable version. The vast majority of reports, as well as automated testing, indicate that doing it in one step works just fine. If you have trouble believing this, read this mailing list post. However, please note that when you update from old versions, chances that you will encounter PHP errors are bigger than when you upgrade from the version directly previous to the new version. You would have received these errors anyway, also if you had not skipped versions, but if you had each time done each single update. Only will you - when you skipped versions - get them all at the same time. This will make the upgrade more difficult, but do not forget that you did not have the trouble updating to the intermediate versions, which you skipped!

Önce yedek almalı mıyım?

Kısa cevap: Evet

Uzun cevap: Bu a) verilerinize ne kadar değer verdiğinize, b) yedek oluşturmanın ne kadar zor olduğuna ve c) MySQL'in bakımı ve yönetiminden ne kadar emin olduğunuza bağlıdır.

Güncelleme hatası, veritabanınızı iki sürüm arasında tutarsız bir durumda bırakabilir. Bir PHP veya MySQL hatası, güncelleme sırasında veritabanınızı kısmen güncellemiş olabilir. Bu gibi bir durumlarda, bu sorunu elle bir şekilde düzeltmek mümkün olabilir. Bununla birlikte, update.php'yi çalıştırmadan önce bir veritabanı yedeklemesini almak ve bundan sonra çalışmayı sürdürmek daha kolay olacaktır. Aksi halde, saatlerce - gereksiz - yere uğraşmak zorunda kalabilirsiniz.

Kurtarma işlemi genellikle karmaşıktır. Eğer güncelleme işlemine başlamadan önce bir yedekleme yapmayı ihmal ederseniz ve ardından güncellemeye ilişkin hatadan kurtulmak için yardıma ihtiyacınız olursa; destek forumundaki gönüllüler bu konuda yardım etmek için pek istekli olmayacaklardır. Daha etkili bir sonuç istiyorsanız, önce yedeğinize geri dönünüz, daha sonra probleme neden olan güncelleme işlemi ilgili MediaWiki projesine hatayı bildiriniz.

LocalSettings.php dosyamı saklayabilir miyim?

Evet, ancak küçük değişiklikler yapmak zorunda kalabilirsiniz. LocalSettings.phpManual:LocalSettings.php biçimi büyük ölçüde geriye dönük olarak uyumludur. LocalSettings.php uyumluluğunu bozan değişiklikler, sürüm notlarının "yapılandırma değişiklikleri" bölümünde belirtilmiştir.

Wiki sayfam güncellenirken çevrimiçi kalabilir mi?

Genellikle evet, ancak Git geçici olarak (birkaç saniye boyunca) kesilebilir.

Eğer MediaWiki'nin küçük sürümleri arasında güncelleme yapıyorsanız, yapmanız gereken tek şey kaynak dosyalarını güncellemektir.

Not: Aşağıda, komut satırına erişiminiz olduğu varsayılmaktadır. Eğer MediaWiki'nin büyük sürümleri arasında yükseltme yapıyorsanız, tercih edilen prosedür aşağıdaki gibidir:

  1. MediaWiki'nin yeni sürümünü yeni bir dizinde çıkarın
  2. Yeni dizini hazırlayın: Geçerli LocalSettings.php dosyasını eski dizinden kopyalayın, yüklü eklentileri ve özel kabuğu (varsa) kopyalayın. LocalSettings.php dosyasında $Logo ayarını kontrol edin ve gerekirse logo dosyasını eski dizinden yeni dizine kopyalayın.
  3. Yeni sürüme ilişkin sürüm notlarında, LocalSettings.php'de herhangi bir değişiklik yapılması gerekip gerekmediğine bakın.
  4. Aşağıdaki değişkeni LocalSettings.php dosyasına eski dizinde ekleyerek veritabanını salt okunur modda yerleştirin. Kullanıcılar güncelleme işlemi sırasında bir düzenleme girişiminde bulunursa bu iletiyi görürler:
    $wgReadOnlyManual:$wgReadOnly = 'Upgrading to MediaWiki 1.31.1';
    • MediaWiki'nin 1.27 sürümünden itibaren bu özellik çalışmıyor, bu MediaWiki 1.27 de güncelleme komut dosyasını çalıştırmayı engelliyor. task T151833.'e bakınız.
  5. Güncelleme komut dosyasını veya web güncelleyicisini yeni dizinde çalıştırın.
  6. Images alt dizinindeki görüntüleri eski dizinden yeni dizine kopyalayın.
  7. Eski dizinin adını ve yeni dizinle değiştirin.
  1. Prepare that new directory: copy your current LocalSettings.php from the old directory, copy any installed extensions and custom skins (if any). Check $wgLogo setting in LocalSettings.php and if necessary copy logo file from the old directory to the new directory.
  2. In the release notes for the new version, see if any changes need to be made to LocalSettings.php.
  3. Place the database in read-only mode by inserting the following variable into LocalSettings.php in the old directory - users will see this message if they attempt an edit during the upgrade process:
    $wgReadOnlyManual:$wgReadOnly = 'Upgrading to MediaWiki 1.31.1';
  4. Run the update script or the web updater in the new directory.
  5. Copy the images from the images sub-directory from the old directory to the new directory.
  6. Swap the old directory and the new directory.

Neden güncelleme yapmalısınız?

Yeni sürümler hakkında bilgilendirilmek için mediawiki-announce listesine abone olunuz.

Çünkü küçük bir adım atarak mevcut sürümünüzden en son sürüme geçmek genellikle çok kolaydır ve üstelik bunu web arayüzünü kullanarak yapabilirsiniz.

Yeni sürümler, wiki'nizi ve sunucunuzu vandalizmden korumak için güvenlik düzeltmelerini içerir. (bkz. Version lifecycleVersion lifecycle). Bu güncelleme yapmanız için iyi bir sebeptir!

Yeni büyük sürümler, kullanmak isteyebileceğiniz bazı yeni özelliklerle birlikte gelir: Ayrıntılar için sürüm notlarına bakabilirsiniz. Eğer çok eski sürümden güncelleme yapmak için patronlarınıza ikna edecek ek argümanlara ihtiyaç duyuyorsanız, aşağıdaki bu notların bir özeti var:

  • 1.24 sürümünde, daha iyi güvenlik sağlamak için şifre deposu geliştirildi.
  • 1.27 sürümünde, oturum yönetimi ve kullanıcı kimlik doğrulama yönetimi tamamen modernize edildi.
  • 1.29 sürümünden itibaren, Action API'sı yeniden çalışıldı ve geliştirildi. Ayrıca kullanıcı grubu atamaları belirli bir süre için seçilebilir yapıldı.

Bugzilla'da 2014 yılına kadar en çok düzeltilen konuların listesine bakın.

Ayrıca, MediaWiki 1.18 sürümünde, daha iyi bir editör ve anti-vandalizm araçları olan ConfirmEdit ve Nuke gibi bazı çok önemli eklentileri paketlemeye başladık; daha sonraki sürümlerde bu eklentilerden daha fazla eklenmiştir.

Ayrıca bakınız