Manual:Memuktahirkan

This page is a translated version of the page Manual:Upgrading and the translation is 100% complete.
Other languages:
Alemannisch • ‎Bahasa Indonesia • ‎Deutsch • ‎English • ‎Nederlands • ‎Türkçe • ‎Zazaki • ‎dansk • ‎español • ‎français • ‎italiano • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sardu • ‎čeština • ‎Ελληνικά • ‎български • ‎русский • ‎سنڌي • ‎فارسی • ‎ไทย • ‎中文 • ‎日本語 • ‎ꯃꯤꯇꯩ ꯂꯣꯟ • ‎한국어

Ikhtisar dasar

Transfer berkas

Pilih metode untuk mentransfer berkas:

Persiapan

Bacalah berkas teks UPGRADE yang termasuk dalam MediaWiki.

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

Cek persyaratan

MediaWiki 1.34 memerlukan:

  • PHP 7.2.9+
  • Salah satu di antara yang berikut:
    • MySQL 5.5.8+ (atau ekuivalennya MariaDB)
    • PostgreSQL 9.2+
    • SQLite 3.8+

Jika Anda menggunakan PostgreSQL, tolong baca juga Manual:Upgrading Postgres .

Untuk informasi lebih lanjut, tolong baca Manual:Persyaratan instalasi dan Compatibility .

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 RELEASE-NOTES (wiki). Sekarang waktunya membukanya dan mengetahui apa yang telah diubah dalam rilis ini.

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 runJobs.php untuk menjalankan semua pekerjaan yang ditunda dan membersihkan antrean sebelum menjalankan pemutakhiran.

Cadangkan berkas dan basisdata yang sudah ada

Instruksi selengkapnya: Manual:Backing up a wiki

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 mysql:
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_restore:
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 images, logo wiki /skins/common/images/wiki.png)
  • berkas-berkas konfigurasi, contohnya LocalSettings.php dan .htaccess (apabila ada)
  • Berkas program MediaWiki, termasuk semua kulit dan ekstensi, khususnya apabila Anda telah mengubahnya.

Ekstrak berkas baru

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.

Anda sebaiknya meletakkan tarball yang telah diekstrak di dalam berkas baru yang kosong di peladen Anda. Jika Anda mengekstrak versi baru tepat di tempat versi lama Anda, bukannya di direktori baru, Anda sebaiknya mengikuti instruksi yang dijelaskan di Cadangkan berkas dan basis data yang sudah ada: jika tidak, apabila Anda telah membuat kustomisasi Anda mungkin menghapusnya tanpa mengetahui cara menerapkannya kembali. Mengekstrak tarball di atas salinan langsung MediaWiki Anda juga bisa meninggalkan berkas-berkas dari versi lama MediaWiki yang mungkin mengganggu kode yang dimutakhirkan. Disarankan bagi Anda untuk mengekstrak berkas yang baru ke dalam direktori yang baru, dan kemudian terapkan kustomisasi ke direktori baru (mengembalikan LocalSettings.php, berkas gambar, ekstensi, dan kustomisasi lainnya seperti kulit buatan sendiri)

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.

Baris perintah

Anda mungkin perlu menjalankan perintah sebagai sudo 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:

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

Pengguna (Open)Solaris sebaiknya menggunakan gtar, atau:

$ gzip -dc mediawiki-1.34.2.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:

  • LocalSettings.php, yang berisi pengaturan konfigurasi lama Anda.
  • Direktori images (atau uploads 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. find ./images -type d -exec chmod 755 {} \; dan chgrp -R apache images (jika misalnya pengguna web Anda adalah apache).
  • Beberapa ekstensi di direktori extensions. 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 skins/common/images/. Setelah 1.24 letaknya di resources/assets/ atau images/ tergantung yang mana yang Anda pilih. Kemduian tambahkan misalnya $wgLogo = "$wgScriptPath/images/logo.png"; ke LocalSettings.php.
  • Kulit-kulit khusus dari dalam direktori skins.
  • 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 Git , 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. 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. <kbc>cd ke direktori MediaWiki utama Anda (direktori yang berisi LocalSettings.php).
  2. Unduh berkas patch dan gunakan gunzip padanya.
  3. Gunakan patch -p1 --dry-run untuk memeriksa apa yang akan diubah (contoh, patch -p1 --dry-run -i mediawiki-x.xx.x.patch)
  4. Jika semuanya berjalan baik, jalankan patch lagi tanpa --dry-run.
  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.

MediaWiki version: 1.18

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

MediaWiki version: 1.23

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 Chick.php, Nostalgia.php, Simple.php dan Standard.php di dalam direktori skins/ serta subfolder-subfolder yang bersesuaian di dalam direktori skins/ 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 version: 1.24

MediaWiki 1.24 mengubah jalur ke berkas kulit inti. Setelah memutakhirkan ke versi ini, Anda sebaiknya memastikan berkas-berkas lama CologneBlue.php, Modern.php, MonoBook.php dan Vector.php yang ada secara langsung di direktori skins/ 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 LocalSettings.php 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 LocalSettings.php agar bisa digunakan, jika tidak MediaWiki akan memperingatkan bahwa Anda tidak memiliki kulit yang telah dipasang.

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

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

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 LocalSettings.php Anda akan berisi seperti ini:

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";

Ini bisa diubah menjadi:

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

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 LocalSettings.php 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 maintenance 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 XAMPP ): Pertama-tama pastikan peladen web Anda (misalnya Apache) dan basis data Anda (misalnya MySQL) sedang berjalan. Kemudian jalankan update.php: 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.

Jika Anda menggunakan basis data bersama, Anda sebaiknya memberikan parameter --doshared apabila Anda ingin tabel bersamanya diperbarui. Jika tidak mereka tidak akan disentuh oleh skrip pemutakhiran.

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 $wgDBadminuser dan $wgDBadminpassword dalam berkas LocalSettings.php 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:

$ whereis 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

MediaWiki version: 1.17
Lihat pula update.php

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 /mw-config/. Misalnya, jika wiki Anda berada di http://example.org/w/index.php, maka jelajahi ke http://example.org/w/mw-config/.
  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 LocalSettings.php Anda dan cari kunci yang diberikan untuk $wgUpgradeKey .

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.

  Peringatan Jika Anda menggunakan metode ini, pastikan untuk mengubah kembali nama berkas .htaccess setelah menjalankan skrip pemutakhiran! Jika tidak URL pendek dan beberapa hal lainnya akan rusak!

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 LocalSettings.php , 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 1.33.0 ke 1.33.4, 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 UPGRADE.

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.

Agar tidak perlu menambal berkas css dan js (javascript) "global" setiap kali memutakhirkan, Anda bisa menambhkan kodenya ke halaman MediaWiki:Common.js dan MediaWiki:Common.css Anda. Karena halaman-halaman tersebut merupakan bagian dari basis data yang akan kembali digunakan ketika Anda memutakhirkan, Anda tidak perlu menambal berkas inti MediaWiki lagi.

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 ($wgUseLatin1 perlu diatur menjadi true dalam LocalSettings.php Anda agar ini bekerja). Kemudian, jalankan update.hp, dan atur pilihan $wgLegacyEncoding 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 old_text di tabel text dengan mediumblob, bukan mediumtext 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 mendapatkan galat, apabila Anda tidak melewati versi, tetapi galatnya diterima untuk masing-masing pemutakhiran. Jika Anda melewati versi, 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!

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 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 LocalSettings.php 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 $wgLogo 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:
    $wgReadOnly = 'Upgrading to MediaWiki 1.34.2';
    • 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 Manual:$wgReadOnly#Upgrading . Lihat pula task T151833.
  5. Jalankan skrip pemutakhiran atau pembaru web dalam direktori baru.
  6. Salin gambar dari subdirektori gambar dari direktori lama ke direktori baru.
  7. 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 Siklus hidup versi ). 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:

Juga, pada MediaWiki 1.19 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