Manual:Upgrading/id



Transfer berkas
Pilih metode untuk mentransfer berkas:


 * wget
 * Penyalinan aman dengan SCP atau WinSCP
 * SSH File Transfer Protocol (SFTP)
 * Menggunakan sebuah klien FTP.
 * Perusahaan hosting mungkin menyediakan antrarmuka manajer berkas via peramban web; periksa penyedia Anda.
 * Suatu metode lain. Ada daftarnya di List of file transfer protocols

Persiapan
Bacalah.


 * 1) Periksa persyaratannya
 * 2) Baca berkas RELEASE-NOTES
 * 3) Baca berkas UPGRADE
 * 4) Cadangkan berkas dan basis data yang sudah ada
 * 5) Ekstrak berkas-berkas baru
 * 6) Mutakhirkan ekstensi-ekstensinya
 * 7) Jalankan skrip pembaruan untuk memeriksa basis data
 * 8) Uji coba hasil pemutakhirannya
 * 9) Hapus sisa-sisa dari instalasi yang lama

Cek persyaratan
MediaWiki memerlukan:


 * PHP +
 * Salah satu di antara yang berikut:
 * MySQL + (atau ekuivalennya MariaDB)
 * PostgreSQL +
 * SQLite +

Sejak Versi 1.36, MediaWiki hanya melakukan commit untuk mendukung pemutakhiran dari dua rilis LTS terbaru (lihat T259771). Pemutakhiran dari versi MediaWiki yang lebih lama harus dilakukan melalui beberapa tahap. Jadi jika Anda ingin memutakhirkan ke 1.36 dari 1.23 atau sebelumnya, Anda harus memutakhirkan wiki 1.23 Anda ke 1.27 (atau 1.35) terlebih dahulu, kemudian dari 1.27 (atau 1.35) Anda bisa memutakhirkan ke 1.36.

Jika Anda menggunakan PostgreSQL, tolong baca juga.

Untuk informasi lebih lanjut, tolong baca dan.

Baca catatan rilis
Di dalam tarball distribusi, atau di dalam berkas-berkas yang diperiksa/diekspor dari Git, terdapat beberapa berkas dengan nama berkas yang dikapitalkan, salah satunya berisi  (wiki). Sekarang waktunya membukanya dan mengetahui apa yang telah diubah dalam rilis ini. Anda sebaiknya juga membaca instruksi di berkas UPGRADE.

Tuntaskan pekerjaan tertunda
Untuk alasan performa, beberapa tindakan dalam basis data ditunda, dan dikelola oleh antrean pekerjaan. Pekerjaan-pekerjaan disimpan dalam basis data dan berisi parameter-parameter dengan informasi mengenai tindakan yang dilakukannya. Sangat disarankan untuk menjalankan pekerjaan-pekerjaan yang ditunda sebelum memutakhirkan wiki, agar tidak terjadi masalah yang disebabkan spesifikasi parameter pekerjaan tersebut berubah di versi yang baru. Gunakan untuk menjalankan semua pekerjaan yang ditunda dan membersihkan antrean sebelum menjalankan pemutakhiran.

Cadangkan berkas dan basisdata yang sudah ada

 * Instruksi selengkapnya: 

Meskipun skrip pemutakhiran telah diperlihara dengan baik, masalah masih bisa terjadi. Sebelum memulai memutakhirkan skema basis data, buatlah cadangan lengkap wiki, termasuk seluruh basis data dan berkas:


 * konten wiki, dari basis data, (pastikan Anda menentukan set karakternya dengan benar, periksa dulu LocalSettings.php). Sebaiknya dibuat juga sebuah dump XML sebagai pelengkap dump basis data SQL.
 * MySQL, baik dump SQL dan dump XML digunakan dengan perintah :

mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb > file.sql mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb --xml > file.xml
 * PostgreSQL, dump basis data digunakan dengan perintah :

pg_dump --create -Fc wikidb > file.db.dump
 * SQLite, Anda menggunakan sebuah skrip MediaWiki untuk membuat salinan:

php wikifolder/maintenance/sqlite.php --backup-to file
 * gambar dan berkas media lainnya (isi dari direktori, logo wiki /skins/common/images/wiki.png)
 * berkas-berkas konfigurasi, contohnya  dan   (apabila ada)
 * Berkas program MediaWiki, termasuk semua kulit dan ekstensi, khususnya apabila Anda telah mengubahnya.

Menggunakan sebuah paket tarball
Anda bisa menaruh berkas-berkas baru menggunakan FTP atau barisan perintah (command line). Gunakan barisan perintah, apabila Anda bisa mengaksesnya! Menggunakan baris perintah lebih cepat daripada mengunggah setiap berkas melalui FTP.

FTP atau grafis
Jika Anda tidak bisa mengakses baris perintah di peladen Anda, unduh tarball MediaWiki ke komputer lokal Anda dan gunakan 7zip untuk mengekstrak tarball di PC lokal Anda.

Setelah Anda mengekstrak berkasnya secara lokal, gunakan perangkat lunak klien FTP kesukaan Anda untuk mengunggah direktori dan berkas ke peladen Anda.

cPanel File Manager
cPanel is a popular interface provided by many web hosts. This method is efficient because the files are uncompressed on the server itself.


 * Navigate to the directory that holds your wiki folder.
 * Upload the mediawiki-1.xx.x.tar.gz file. You may need to hit "Reload" to see it.
 * Extract the mediawiki-1.xx.x.tar.gz file. Reload again.
 * Confirm that the mediawiki-1.xx.x folder is present.
 * Delete the tar.gz file.
 * Copy all necessary skins, extensions, image folders, customizations, and the LocalSettings.php into the new folder. (see below)
 * When you are ready to run update.php, rename your old wiki folder and your new wiki folder. (e.g. "w" becomes "w1.34" and then "mediawiki1.35.0" becomes "w") This step is easily reversible if you run into problems.

Baris perintah
Anda mungkin perlu menjalankan perintah sebagai  apabila Anda tidak punya izin menulis penuh ke direktori instalasi wiki menggunakan pengguna Anda yang sekarang. Ketika mengekstrak paket tarball biasanya sebuah direktori baru akan dibuat dan Anda akan punya salinan berkas konfigurasi dan direktori gambar lama dari direktori instalasi lama Anda:

Pengguna (Open)Solaris sebaiknya menggunakan gtar, atau:

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

Berkas lain
Setelah mengekstrak tarball, Anda sebaiknya menyalin atau memindahkan beberapa berkas dan folder dari direktori instalasi yang lama ke yang baru:


 * , yang berisi pengaturan konfigurasi lama Anda.
 * Direktori  (atau   dalam versi yang lebih lama), yang berisi semua berkas yang telah diunggah ke wiki, kecuali Anda memilih direktori pengunggahan yang berbeda, dan ubah kepemilikan dan perizinannya.   dan   (jika misalnya pengguna web Anda adalah apache).
 * Beberapa ekstensi di direktori . Anda sebainya selalu memakai ekstensi yang mutakhir, ekstensi lama tidak dijamin akan bekerja di versi MediaWiki yang lebih baru.
 * Jika Anda menggunakan logo buatan sendiri berkas ini juga perlu dikembalikan dari cadangan. Sebelum 1.24 ini biasanya terletak di . Setelah 1.24 letaknya di   atau   tergantung yang mana yang Anda pilih. Kemduian tambahkan misalnya   ke LocalSettings.php.
 * For 1.35 you may need to restore the logos from wgLogos. Then add to LocalSettings.php e.g.
 * Kulit-kulit khusus dari dalam direktori.
 * Modifikasi apapun yang dilakukan pada berkas instalasi atau ekstensi yang lama.
 * Berkas .htaccess apapun (apabila Anda menggunakan Apache dan Anda telah mendefinisikan aturan-aturan di dalamnya).

Setelah melakukannya, jadikan folder baru ini folder yang dimuatkan di peladen web, atau ubah nama direktori instalasi yang lama lalu ubah nama direktori yang baru menjadi nama direktori yang lama.

Menggunakan Git
Jika menggunakan, ekspor berkas-berkasnya ke dalam lokasi yang bersih, lalu salin berkas yang dulu pernah disesuaikan ke dalam lokasi baru sebagaimana dijelaskan di bagian sebelumnya.

Anda juga perlu menginstal beberapa pustaka PHP eksternal menggunakan Composer atau kumpulan pustaka yang disediakan dan dipelihara untuk wiki farm Wikimedia. Rincian lebih lanjut mengenai pemasangan dan pembaruan pustaka eksternal bisa ditemukan di dokumentasi unduhan Git.

Menggunakan patch
Berkas patch kecil biasanya disediakan untuk pemutakhiran versi minor. Anda perlu mengunduh patch untuk melakukan ini. Unduh dan ekstrak berkas patch secara manual dari situs dump atau ikuti petunjuk dengan wget di bawah. Patch bersifat bertahap, Anda tidak bisa melewatkan salah satu versi.


 * 1) cd ke direktori MediaWiki utama Anda (direktori yang berisi LocalSettings.php).
 * 2) Unduh berkas patch dan gunakan gunzip padanya.
 * 3) Gunakan   untuk memeriksa apa yang akan diubah (contoh,  )
 * 4) Jika semuanya berjalan baik, jalankan patch lagi tanpa.
 * 5) Periksa Special:Version Anda dan Anda seharusnya melihat nomor versi yang baru.

Sisa berkas yang mungkin menimbulkan kesalahan
Jika Anda mengekstrak menimpa direktori instalasi yang lama, beberapa berkas lama bisa menyebabkan masalah untuk versi yang baru.

Jika Anda tidak menggunakan profiling, tetapi memiliki berkas  di folder akar MediaWiki, Anda mungkin mendapatkan galat yang merujuk pada. Menghapus, atau mengubah nama, berkas  akan menyelesaikan galat ini. Berkas, juga terletak di folder akar MediaWiki, bisa menjadi templat apabila Anda suatu saat mau mengaktifkan profiling.

MediaWiki 1.23 mengusangkan mekanisme penemuan kulit secara otomatis untuk berkas-berkas kulit inti. Setelah memutakhirkan ke versi ini, Anda sebaiknya memastikan berkas-berkas lama,  ,   dan   di dalam direktori   serta subfolder-subfolder yang bersesuaian di dalam direktori   telah dihapus. MediaWiki akan mengingatkan Anda dengan mencatat peringatan apabila masih ada di antara mereka yang masih ditemukan. (Anda juga perlu menyesuaikan kulit-kulit buatan sendiri agar mengikuti konvensi yang serupa.) Lihat $discover untuk rinciannya.

MediaWiki 1.24 mengubah jalur ke berkas kulit inti. Setelah memutakhirkan ke versi ini, Anda sebaiknya memastikan berkas-berkas lama,  ,   dan   yang ada secara langsung di direktori   tidak lagi ada. Lihat $discover untuk rinciannya.

Memuktahirkan ekstensi
Ekstensi-ekstensi tertentu telah dimutakhirkan agar bekerja dengan versi MediaWiki yang baru. Pastikan untuk memutakhirkan ekstensi-ekstensi tersebut ke versi terkininya. Anda mungkin perlu melakukan pemutakhiran secara manual untuk ekstensi-ekstensi kustom.

Tarball yang berbeda-beda memasukkan beberapa subset dari ekstensi dan memiliki pengelolaan versi yang membantu Anda memilih yang tepat untuk rilis inti MediaWiki Anda.

Extension Distributor bekerja baik untuk kebanyakan orang yang menginginkan cuplikan ekstensi-ekstensi yang akan bekerja pada versi MediaWiki yang didukung.

Jika Anda menginginkan banyak ekstensi maka sebaiknya Anda mengunduh dari Git. Jika Anda tidak punya Git tetapi Anda ingin memperbarui banyak ekstensi, Anda sebaiknya mempertimbangkan untuk menggunakan mwExtUpgrader.

Menyesuaikan LocalSettings.php anda
Jika Anda menggunakan  yang sama dengan versi yang lama, Anda mungkin perlu menyesuaikannya dengan bagaimana versi yang baru menjalankannya:

Pendaftaran kulit
Sejak MediaWiki 1.24, kulit-kulit yang sepaket seperti Vector, Monobook, Modern dan CologneBlue tidak lagi menjadi bagian dari inti MediaWiki, dan perlu didaftarkan secara eksplisit di  agar bisa digunakan, jika tidak MediaWiki akan memperingatkan bahwa Anda tidak memiliki kulit yang telah dipasang.

Ini adalah apa yang perlu Anda tambahkan ke  ketika memutakhirkan dari versi-versi yang lebih lama daripada 1.24 dan menginginkan kulit-kulit tersebut tersedia:

Kulit-kulit lainnya mungkin belum disesuaikan dengan sistem pendaftaran kulit yang baru, jadi rujuklah halaman dokumentasi masing-masing kulit untuk melihat bagaimana cara mendaftarkannya apabila terjadi masalah.

Pendaftaran ekstensi
Sejak MediaWiki 1.25, ekstensi menggunakan sistem pendaftaran ekstensi baru.

Sebelumnya  Anda akan berisi seperti ini:

Ini bisa diubah menjadi:

Ekstensi disesuaikan agar menggunakan sistem pendaftaran ekstensi baru. Ekstensi yang tidak disesuaikan sebaiknya menggunakan cara instalasi yang lama. Rujuklah instruksi instalasi di halaman ekstensi untuk informasi lebih lanjut.

Variabel lainnya
Beberapa variabel mungkin telah usang atau bahkan dihapus. Memiliki mereka di  biasanya tidak akan berpengaruh. Variabel-variabel baru mungkin ditambahkan di versi lebih baru, atau beberapa variabel yang sudah ada diubah tipenya. Kami biasanya mencoba menggunakan default yang wajar untuk mereka, dan apabila tipenya berubah, dibuat agar kompatibel mundur. Dalam kasus apapun, periksa catatan rilis untuk melihat perubahan tersebut.

Menjalankan skrip pemuktahiran
Anda bisa memutakhirkan basis data MediaWiki dengan dua cara: Dari baris perintah atau dari peramban web. Jika Anda punya akses shell ke peladen Anda, memutakhirkan dari basis perintah lebih disarankan, karena ini mengurangi risiko proses pemutakhirannya diganggu oleh masalah waktu habis atau pengaturan ulang koneksi.

Skrip juga akan mencoba mengunduh hal-hal yang belum ada yang dibutuhkan MediaWiki.

Baris perintah
Akses baris perintah peladen Anda atau shell SSH atau sejenisnya. Anda bisa mengakses baris perintah dengan menghubungi peladen Anda via SSH. Jika PC lokal yang Anda gunakan menjalankan Microsoft Windows, Anda akan membutuhkan alat seperti PuTTY untuk menggunakan SSH. Dari baris perintah atau Shell, pindah ke direktori  dan jalankan skrip pemutakhiran:

$ php update.php

Di sebuah peladen Linux jika Anda mendapatkan galat coba lakukan perintah yang sama sebagai root ( sudo php update.php ). Catatan untuk instalasi sederhana di Windows (misalnya menggunakan ): Pertama-tama pastikan peladen web Anda (misalnya Apache) dan basis data Anda (misalnya MySQL) sedang berjalan. Kemudian jalankan : klik kanan, pilih Open With, dan telusuri hingga PHP.exe. Jendela baris perintah yang dihasilkan kemungkinan akan tertutup secara otomatis ketika pemutakhiran skemanya selesai.

Anda mungkin mendapatkan pesan bahwa versi PHP Anda terlalu tua dan bahwa MediaWiki memerlukan versi yang lebih baru. Setelah pesan tersebut pemutakhiran akan dibatalkan. Penyebab galat ini adalah baris perintah menggunakan versi PHP yang berbeda dengan yang Anda miliki ketika Anda menjalankan MediaWiki dari peladen web. Ketika Anda mendapatkan pesan ini Anda sebaiknya memeriksa, apabila Anda menjalankan versi PHP yang lebih baru di shell dengan menggunakan perintah yang berbeda: Itu mungkin bisa jadi php5 atau php56. Jika versi lain tersedia dan — apabila iya — dengan nama apa, bergantung pada pengaturan peladen Anda. Jika tidak bekerja, tanya penyedia hos Anda; mereka pasti tahu.

MediaWiki akan memeriksa skema yang ada dan memutakhirkannya agar bekerja dengan kode yang baru, menambahkan tabel dan kolom apabila diperlukan.

Apa yang perlu dilakukan apabila "php update.php" tidak melakukan apa-apa, hanya terjadi jeda sebentar kemudian kembali ke baris perintah
Ini bisa jadi disebabkan malfungsi pada kulit atau ekstensi.


 * Periksa apakah semua ekstensi dan kulit yang dipanggil di LocalSettings.php tersedia
 * Periksa apakah ekstensi-ekstensi menggunakan metode registrasi yang benar (wfLoadExtension vs. require_once)
 * Satu per satu matikan ekstensi di pengaturan lokal sampai update.php bekerja untuk menemukan ekstensi mana yang bersalah

Apa yang dilakukan ketika muncul kesalahan "ALTER command denied to user" (atau yang mirip)
Jika skripnya dibatalkan dengan pesan seperti begini:

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

Ini berarti Anda sebaiknya memeriksa apakah Anda telah mendefinisikan dan  dalam berkas  Anda (di direktori utama). Ini adalah pengguna dan kata sandi yang diperlukan oleh skrip ini agar bisa mengakses basis data.

Dalam beberapa kasus, variabel lama $wgDBmwschema (untuk Postgres) kelihatannya dibaca sebagai nama tabel yang diperbarui bukannya $wgDBname, meskipun ketika mysql yang digunakan. Jika ini penyebabnya, tinggal hapus definisi $wgDBmwschema di LocalSettings.php.

Apa yang dilakukan ketika muncul kesalahan "unexpected T_STRING"
Orang-orang yang menjalankan update.php dari baris perintah mungkin menemui galat berikut:

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

Galat ini terjadi ketika update.php dijalankan dari php4.

Orang-orang yang situsnya dihos oleh penyedia yang menyediakan php4 sekaligus php5 sebaiknya melakukan langkah-langkah berikut:


 * 1) dari baris perintah, masukkan perintah 'whereis php5'
 * 2) begitu Anda menemukan lokasi jalur php5, daftarkan isi direktori php5/bin
 * 3) setelah Anda mengetahui nama berkas php yang dapat dieksekusi (php atau php5), ketikkan seluruh jalur untuk menjalankan update.php

Berikut adalah sebuah contoh:

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

Apa yang dilakukan ketika muncul kesalahan 'register_argc_argv is set to false'
Anda mungkin menemui galat berikut:  Cannot get command line arguments, register_argc_argv is set to false


 * 1) Pergi ke ~/maintenance. Sunting berkas 'php.ini' yang sudah ada, atau buat yang baru.
 * 2) Tambahkan sebuah baris seperti berikut:

 register_argc_argv=true


 * 1) Jalankan kembali php update.php

Peramban web

 * Lihat pula 

Jika basis data Anda sudah besar dan dalam penggunaan yang tinggi, maka Anda sebaiknya tidak menggunakan pembaru Web, di antaranya karena proses pembaruan akan kehabisan waktu ketika maximum_execution_time tercapai. Jika begitu, Anda sebaiknya menggunakan update.php dari antarmuka baris-perintah (tidak dari web). Apa yang dimaksus "terlalu besar" bergantung pada peladen Anda (performanya, muatannya, dan berapa lama waktu eksekusi maksimum PHP yang diberikan kepada skrip). Jika wiki Anda terlalu besar untuk pembaru web dan penyedia hosting Anda tidak memungkinkan akses baris-perintah, maka Anda perlu memindahkan wiki Anda ke akun hosting lainnya, sebaiknya yang memiliki akses shell.


 * 1) Selalu cadangkan sebelum melakukan pemeliharaan basis data.
 * 2) Jelajahi peramban web Anda hingga ke  . Misalnya, jika wiki Anda berada di , maka jelajahi ke.
 * 3) Pilih bahasa Anda dan tekan lanjutkan.
 * 4) Instalasi yang sudah ada harusnya terdeteksi. Ikuti instruksi di layar untuk memperbaruinya. Jika diminta sebuah "upgrade key", bukalah berkas  Anda dan cari kunci yang diberikan untuk.

Mungkin juga pembaru-web tampak tidak bekerja: Bukannya melihat layar pemilihan bahasa awal, Anda malah melihat sebuah halaman wiki kosong, mungkin dengan suatu pesan galat. Jika begini, kemungkinan ini disebabkan peladen web Anda menggunakan Rewrite Rules (kemungkinan untuk URL pendek), yang tidak menampilkan pembaru di mw-config/, melainkan sebuah halaman wiki di Mw-config/'', dengan "M" kapital. Jika begini, ubah nama berkas .htaccess untuk waktu pembaruan. Kemudian Anda seharusnya bisa mengakses pembaru web.

Mengujicoba pemuktahiran
Ketika pemutakhiran telah selesai, pergi ke wiki dan periksa apakah operasi-operasi berikut bekerja sebagaimana mestinya:


 * Membaca halaman
 * Menyunting halaman
 * Mengunggah berkas
 * Kunjungi Special:Version dan periksa apakah versi yang ditampilkan benar dan ekstensi-ekstensinya ada

Menghapus sisa-sisa dari instalasi yang lama
Jika Anda telah menyalin instalasi lama Anda ke folder lain di peladen, pastikan untuk menghapusnya atau membuatnya sama sekali tidak bisa diakses dari web. Sangat penting untuk tidak membiarkan instalasi lama bisa diakses dari web, karena itu tidak sesuai dengan tujuan pemutakhiran, dan membuat peladen Anda berisiko diserang.

Pertanyaan yang sering diajukan


Seberapa sulit melakukan pemuktahiran?
Jika satu-satunya berkas yang telah Anda ubah adalah, dan Anda memutakhirkan dari 1.5 atau setelahnya, prosesnya sangatlah sederhana. Pekerjaan manusia yang harus dilakukan hanya berdurasi beberapa menit. Perubahan skema basis data akan menghabiskan waktu sebanding dengan ukuran basis data Anda — mungkin beberapa jam untuk wiki dengan jutaan halaman, tetapi untuk ukuran biasa sekitar beberapa ribu halaman, biasanya dilakukan dalam hitungan detik.

Pemutakhiran minor, di antara versi-versi mayor yang sama, misalnya dari .0 ke, tidak membutuhkan perubahan skema sama sekali. Anda bisa hanya memperbarui berkas-berkasnya. Basis datanya tidak perlu, sehingga tidak perlu menjalankan skrip pembaru.

Memutakhirkan dari 1.4 atau sebelumnya akan lebih rumit karena dukungan untuk set karakter selain UTF-8 dihentikan, dan skema untuk menyimpan banyak teks diubah. Tolong baca bagian yang relevan di berkas.

Pemutakhiran menjadi sulit apabila Anda telah mengubah kode sumber, dan Anda tidak ingin pengubahan Anda ditimpa. Peralatan seperti diff, patch, Meld atau WinMerge bisa jadi berguna. Juga terdapat potensi masalah apabila Anda menggunakan ekstensi yang tidak terpelihara. Mutakhirkan ekstensi Anda bersamaan dengan Anda memperbarui MediaWiki.

Jika Anda telah mengubah kulit atau menggunakan kulit buatan sendiri Anda kemungkinan harus menyesuaikannya lagi agar bisa bekerja di versi MediaWiki yang baru.

Bagaimana saya memuktahirkan dari versi yang lama sekali? Dalam satu langkah, atau beberapa langkah?
Tergantung: Jika Anda memutakhirkan dari MediaWiki 1.4 atau lebih lama, Anda sebaiknya memperbarui ke MediaWiki 1.5 dulu. Jika Anda memperbarui dari wiki Latin-1, gunakan upgrade1_5.php (ditemukan di MediaWiki 1.5) untuk mengubah bagian-bagian yang relevan dari basis data ke UTF-8 ( perlu diatur menjadi true dalam Anda agar ini bekerja). Kemudian, jalankan update.hp, dan atur pilihan di LocalSettings.php untuk kode yang sebelumnya digunakan di wiki (misalnya windows-1252). Ini pada dasarnya adalah bagaimana Wikipedia dari situs Yayasan Wikimedia lainnya diperbarui dari MediaWiki 1.4 ke 1.5 — lihat berkas pengaturan yang relevan (peringatan: halaman besar!) dan beberapa catatan-catatan terkait di Wikitech. Anda mungkin perlu memperbarui dari MediaWiki 1.4 sebelum menjalankan skrip upgrade1.5. Jika Anda ingin membuat sebuah dump basis data (misalnya MySQL) dari wiki Latin-1 Anda, pastikan untuk mengetik isian  di tabel  dengan , bukan   untuk menghindari masalah pengodean karakter.

Jika Anda memutakhirkan dari MediaWiki 1.5 atau lebih baru, Anda bisa memutakhirkan dalam satu langkah, dari versi lama Anda ke versi stabil terbaru. Kebanyakan laporan, serta pengujian otomatis, mengindikasikan bahwa melakukannya dalam satu langkah bekerja dengan baik. Jika Anda kesulitan memercayainya, bacalah posting milis ini. Akan tetapi, tolong perhatikan bahwa ketika Anda memutakhirkan dari versi lama, kemungkinan Anda akan menemukan galat PHP yang lebih besar dibandingkan dengan memutakhirkan dari versi yang tepat sebelum versi baru. Anda akan tetap menerima kesalahan ini, jika Anda tidak melewatkan versi, tetapi kesalahan akan dikaitkan dengan setiap pembaruan individu. Jika Anda memutakhirkan beberapa versi secara bersamaan, Anda akan mendapatkan semua galatnya secara bersamaan. Ini akan mebuat pemutakhiran lebih sulit, tetapi jangan lupa bahwa Anda tidak mengalami masalah ketika memutakhirkan ke versi pertengahan, yang Anda lewatkan!

Jika Anda memutakhirkan ke MediaWiki 1.36 atau setelahnya, hanya pemutakhiran dari dua rilis LTS terakhir yang didukung (T259771). Ini berarti untuk versi yang sangat lama, Anda harus memutakhirkan ke MediaWiki 1.35 terlebih dahulu kemudian memutakhirkan ke 1.36.

Apakah sebaiknya saya mencadangkan dulu?
Jawaban singkat: Ya.

Jawaban panjang: Bergantung pada a) seberapa berharga data Anda, b) seberapa sulit membuat cadangan dan c) seberapa yakin Anda pada pemeliharaan dan administrasi MySQL.

Kegagalan dalam pemutakhiran bisa menyebabkan basis data Anda berada dalam keadaan yang tidak konsisten, di antara dua versi. Sebuah galat PHP atau MySQL bisa terjadi ketika pemutakhiran sehingga basis data Anda hanya sebagian yang dimutakhirkan. Dalam situasi tersebut mungkin saja untuk memperbaiki masalahnya dengan kerja manual yang banyak. Akan tetapi, jauh lebih mudah untuk meletakkan basis data cadangan dari sebelum dijalankannya update.php dan meneruskan pemutakhiran menggunakan itu. Jika tidak Anda mungkin perlu menghabiskan pekerjaan — yang tidak perlu — selama berjam-jam.

Pemulihan adalah hal yang biasanya rumit. Sukarelawan di forum dukungan tidak akan senang apabila Anda tidak membuat cadangan dan perlu bantuan untuk memulihkan data yang rusak dalam proses pemutakhiran. Hasil yang ideal adalah apabila Anda bisa mengembalikan cadangan Anda, dan kemudian [$phab melaporkan bug pada proyek MediaWiki yang sesuai] selama proses pemutakhiran yang menyebabkan kerusakan data.

Bisakah saya menyimpan LocalSettings.php saya?
Ya, tetapi Anda harus membuat beberapa perubahan kecil. Format pada umumnya kompatibel mundur. Perubahan yang akan merusak kompatibilitas akan didokumentasikan dalam bagian "configuration changes" di catatan rilis.

Bisakah wiki saya tetap dalam jaringan ketika pemuktahiran?
Secara umum iya, tetapi Git bisa memutuskannya secara sementara (selama beberapa detik).

Jika Anda memutakhirkan di antara rilis minor MediaWiki, satu-satunya yang perlu Anda lakukan adalah memutakhirkan berkas-berkas sumber.

Catatan: instruksi berikut mengasumsikan Anda punya akses baris perintah. Jika Anda memutakhirkan di antara rilis utama MediaWiki, prosedur yang disarankan adalah:


 * 1) Ekstrak versi baru MediaWiki ke dalam direktori baru.
 * 2) Siapkan direktori baru tersebut: salin LocalSettings.php Anda dari direktori yang lama, sali ekstensi-ekstensi dan kulit-kulit yang telah dipasang (apabila ada). Periksa pengaturan  dan  di LocalSettings.php dan jika perlu sali berkas logo dari direktori lama ke direktori baru.
 * 3) Dalam catatan rilis untuk versi yang baru, lihat apakah ada perubahan yang harus dibuat pada LocalSettings.php.
 * 4) Letakkan basis data dalam mode hanya baca dengan memasukkan variabel berikut ke LocalSettings.php di direktori lama — para pengguna akan melihat pesan ini apabila mereka mencoba menyunting selama proses pemutakhiran:


 * 1) * Ini tidak lagi bekerja sejak MediaWiki 1.27, yang juga menghentikan dijalankannhya skrip pemutakhiran. Cara mengatasinya untuk versi sejak MediaWiki 1.27 bisa ditemukan di . Lihat pula.
 * 2) Jalankan skrip pemutakhiran atau pembaru web dalam direktori baru.
 * 3) Salin gambar dari subdirektori gambar dari direktori lama ke direktori baru.
 * 4) Tukar direktori lama dengan direktori baru.

Mengapa memuktahirkan?

 * Berlanggananlah dengan mediawiki-announce agar diberitahukan soal rilis baru.

Karena memutakhirkan biasanya cukup mudah, satu langkah dari versi Anda ke versi terbaru dan juga lewat web.

Rilis terbaru menerima perbaikan keamanan untuk menjaga wiki dan hos Anda aman dari para vandal, sedangkan rilis lama tidak (lihat ). Jadi ada lusinan alasan yang bagus untuk memutakhirkan.

Rilis utama yang baru menyediakan fitur-fitur baru, yang Anda mungkin mau gunakan: lihat catatan rilis untuk rinciannya. Jika Anda perlu argumen tambahan untuk meyakinkan bos Anda untuk membiarkan Anda memutakhirkan dari versi yang sudah tua, berikut adalah ringkasannya:

$ Sejak (rilis dukungan jangka panjang stabil),  menjadi bagian dari inti. Fitur "pantau" bisa ditingkatkan dengan tanggal kedaluwarsa.
 * Sejak, suntingan bisa dipratayangkan sebelum menyimpan dalam bentuk diff.
 * Sejak, tersedia sebuah tombol balikkan.
 * Sejak, berpatroli di Special:NewPages menjadi lebih mudah.
 * Sejak, Anda bisa mengganti nama (memindahkan) berkas.
 * Sejak, Anda bisa memperbaiki pengalihan ganda secara otomatis.
 * Sejak, tersedia.
 * Jika Anda memiliki tembolok yang sesuai, sejak 1.17 mengoptimalkan kecepatan pemuatan halaman.
 * Sejak 1.17, pengurutan kategori menjadi masuk akal! (terutama untuk huruf non-Inggris); diperluas menjadi 68 bahasa setelah.
 * Sejak dan, pengguna dari semua bahasa dan jenis kelamin dipanggil oleh antarmuka dan catatan secara tepat (sebelum 1.15, sama sekali tidak ada jenis kelamin).
 * Dalam sistem perkulitan diubah agar lebih mudah untuk menggunakan bagian dari kulit yang sudah ada untuk kulit Anda sendiri.
 * Sejak 1.20, diff menjadi lebih mudah dibaca.
 * Pada 1.21 dan 1.23, pemberitahuan surel menjadi lebih jelas dan bisa ditebak, membuat wiki Anda lebih efektif.
 * Sejak 1.22, pemberantasan vandal (patroli) menjadi lebih hemat waktu.
 * Pada 1.24, penyimpanan kata sandi diperbaiki untuk memungkinkan peningkatan keamanan.
 * Sejak 1.25, perubahan terbaru enhanced disediakan
 * Pada 1.26, mekanisme "ResourceLoader" diperbaiki
 * Pada 1.27, manajemen sesi diubah dan manajemen autentikasi pengguna sepenuhnya dimodernkan. InstantCommons tidak lagi membutuhkan berkas lokal.
 * Sejak, tembolok untuk HTML halaman artikel yang digambarkan telah ditingkatkan.
 * Sejak, Action API diubah dan diperbaiki. Pemberian kelompok pengguna juga sekarang bisa dilakukan untuk suatu periode waktu yang bisa dipilih. Memungkinkan memblokir suatu jangkauan IP.
 * Sejak, pengguna terblokir tidak bisa mengubah surel mereka. Menambahkan kemampuan untuk mencari kontribusi untuk suatu jangkauan IP di Special:Contributions.
 * Sejak, beberapa ekstensi menjadi bagian dari inti, contohnya , , . diperkenalkan. Menambahkan batasan laju suntingan baku sebesar 90 suntingan/menit untuk semua pengguna.
 * Sejak, MediaWiki mendukung lebih dari 350 bahasa.
 * Sejak, MediaWiki mendukung "pemblokiran sebagian", sehingga IP dan akun bisa ditahan dari menyunting halaman atau ruang nama tertentu.
 * Sejak, lebih banyak ekstensi menjadi bagian dari inti: (untuk modul Lua), ,.

Juga, pada kami mulai membundel beberapa ekstensi penting, seperti alat penyuntingan dan pelawan vandalisme ConfirmEdit dan Nuke; lebih banyak lagi ditambahkan pada rilis-rilis berikutnya. 

Lihat pula

 * Posting blog Greg Sabino Mulla memberikan rincian lebih lanjut mengenai pemutakhiran rilis titik.
 * Project:Support desk apabila Anda perlu bantuan atau terjadi kesalahan
 * - apabila Anda tidak punya cadangan yang berhasil
 * - apabila Anda tidak punya cadangan yang berhasil
 * - apabila Anda tidak punya cadangan yang berhasil
 * - apabila Anda tidak punya cadangan yang berhasil
 * - apabila Anda tidak punya cadangan yang berhasil