Manual:Memasang MediaWiki

This page is a translated version of the page Manual:Installing MediaWiki and the translation is 100% complete.

Install MediaWiki

Langkah cepat pengembangan lokal

Halaman ini menjelaskan langkah-langkah yang diperlukan untuk memasang MediaWiki secara manual. Setelah instalasi, penjelasan konfigurasi tambahan dapat ditemukan di Manual:System administration#Configuration.

Untuk memasangnya, diperlukan pemahaman dasar tentang penginangan web. Pengalaman dengan Apache, PHP, dan MySQL/MariaDB akan mempermudah proses instalasi. Jika ada pertanyaan mengenai instalasi MediaWiki, tanyakan kepada Project: Support desk atau lihat sumber lain yang ada di Komunikasi .

Bagian Lampiran di bawah ini menawarkan alternatif untuk instalasi manual, bersama dengan catatan instalasi khusus untuk konfigurasi sistem yang berbeda.

Untuk pengaturan peladen lokal MediaWiki yang lebih cepat, lihat Langkah cepat pengembangan lokal .

Persyaratan pemasangan

Periksa apakah sistem Anda memenuhi persyaratan instalasi.

Pastikan juga untuk memeriksa Catatan perilisan versi MediaWiki yang akan Anda pasang.

Mengunduh perangkat lunak MediaWiki

Unduh berkas tar MediaWiki dari halaman unduhan resmi.

Jika Anda menggunakan MediaWiki di lingkungan produksi, manajer rilis telah mengeluarkan rekomendasi kuat bahwa hanya versi yang tercantum di siklus hidup versi dan masa berakhirnya, yang termasuk dalam kategori "versi stabil", "versi lawas", atau "versi dukungan jangka panjang", yang sebaiknya digunakan di lingkungan produksi. Versi yang lebih lama mungkin mengandung kerentanan keamanan kritis dan kekutu besar lainnya, termasuk ancaman kehilangan data dan/atau kerusakan. Versi stabil saat ini adalah MediaWiki MediaWiki 1.43.1.

Ekstrak perangkat lunak MediaWiki

File yang diunduh berformat .zip atau .tar.gz. Berkas tersebut perlu diekstrak sebelum digunakan. Proses ekstraksi dapat dilakukan secara lokal (kemudian diunggah melalui FTP ke peladen) atau langsung diekstrak di peladen Anda.

Di Windows, ekstraksi biasanya dilakukan menggunakan perangkat lunak seperti 7-Zip (gratis), WinZip, WinRAR, atau IZArc (gratis).

Di Linux dan macOS, Anda dapat mengekstraknya dengan perintah: tar -xzvf mediawiki-*.tar.gz

Keamanan dan izin berkas - Jika Anda mengekstrak berkas arsip sebagai pengguna root atau admin, mungkin perlu mengubah kepemilikan berkas setelahnya demi keamanan, tergantung pada pengaturan sistem Anda. Pada sistem Linux, hal ini dapat dilakukan dengan menggunakan perintah chown: chown -R <new_owner_user> <mediawiki_folder> Untuk informasi lebih lanjut tentang mengamankan izin berkas, lihat: Manual:Security#File permissions

Mengunggah berkas ke peladen anda

Jika Anda belum mengunggah berkas ke peladen web Anda (atau menyalinnya, jika perangkat lunak peladen web Anda berjalan secara lokal di localhost), lakukan sekarang.

Unggah berkas ke direktori web peladen web Anda dengan cara:

dengan menyalin langsung folder yang telah diekstrak, atau
menggunakan klien FTP seperti FileZilla (Windows, macOS, dan Linux) atau Cyberduck (Windows dan macOS),
menggunakan perangkat lunak yang sudah disediakan oleh layanan penginangan Anda, seperti Pengelola Berkas cPanel.

Jika perkakas unggah Anda memiliki opsi "ubah nama berkas menjadi huruf kecil", Anda harus menonaktifkan opsi ini untuk mencegah perubahan nama berkas yang tidak diinginkan selama proses unggah.

Jika Anda menggunakan peladen web Apache HTTPD, direktori yang tepat ditentukan dalam berkas httpd.conf Anda pada direktif DocumentRoot. Secara bawaan, ini adalah /var/www/ atau <apache-folder>/htdocs.

Lokasi berkas pengaturan dan direktori peladen Apache, yaitu httpd.conf, bervariasi tergantung sistem operasi yang digunakan. Di Debian dan Ubuntu, berkas pengaturan dan direktori Apache terletak di /etc/apache2/apache2.conf. Sementara di Red Hat dan Fedora, berkas tersebut berada di /etc/httpd/conf/httpd.conf.

Ubah nama folder yang diunggah sesuai dengan nama yang diinginkan, karena ini akan memengaruhi tampilannya di URL.

Misalnya, jika Anda mengganti nama folder menjadi wiki, URL-nya akan menjadi example.com/wiki.

Jika peladen web Anda berjalan di http://localhost, mengganti nama direktori menjadi /w/ berarti Anda dapat mengakses wiki Anda di http://localhost/w/index.php.

Jangan gunakan nama /wiki/ terlebih dahulu jika Anda berencana untuk mengatur URL Pendek setelah menjalankan skrip konfigurasi awal.

Mengatur basis data

Skrip konfigurasi awal MediaWiki memerlukan nama basis data dan nama pengguna basis data untuk menyimpan konten wiki.

Jika Anda sudah memiliki peladen basis data dan mengetahui kata sandi untuk pengguna root (administrator), Anda dapat langsung menuju ke bagian Jalankan skrip instalasi.

Jika Anda tidak mengetahui kata sandi pengguna root, misalnya jika Anda menggunakan peladen yang diinangkan, Anda perlu membuat basis data baru sebelum melanjutkan ke skrip instalasi MediaWiki.

MariaDB/MySQL adalah basis data yang disarankan. Meskipun PostgreSQL dan SQLite didukung, keduanya menawarkan kompatibilitas terbatas dan sebaiknya hanya digunakan jika diperlukan. Jika Anda ragu memilih basis data, gunakan MariaDB.

Setelah pengaturan basis data selesai, lanjutkan ke bagian Jalankan skrip instalasi di bawah.

SQLite

Tidak diperlukan pengaturan tambahan untuk SQLite jika modul pdo-sqlite untuk PHP sudah terpasang di sistem.

Pada halaman instalasi SQLite, pilih nama basis data (nama apa pun dapat digunakan) dan direktori basis data SQLite. Pemasang akan berusaha menggunakan direktori di luar dokumen root dan membuatnya jika diperlukan. Jika direktori ini dapat diakses oleh web atau tidak aman, sebaiknya ubah secara manual untuk mencegah akses tidak sah.

MariaDB/MySQL

Untuk membuat basis data dan pengguna untuk MariaDB/MySQL, Anda dapat menggunakan salah satu metode berikut:

Panel kontrol yang disediakan oleh layanan penginang Anda, seperti phpMyAdmin.
Akses SSH ke peladen Anda, di mana Anda dapat memasukkan perintah berikut ke dalam MySQL. Lihat dokumentasi penyedia penginangan Anda. Sebagai alternatif, Anda dapat meminta penyedia layanan Anda untuk membuatkan basis data dan pengguna untuk Anda.

Perintah berikut akan membuat basis data bernama my_wiki, pengguna bernama wikiuser, dan memberikan izin untuk pengguna tersebut pada basis data tersebut.

CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;

Hanya jika basis data Anda tidak dijalankan di peladen yang sama dengan peladen web, Anda perlu memberikan nama host peladen web yang sesuai (mediawiki.example.com pada contoh di bawah ini):

GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';

Peringatan MySQL/MariaDB mencatat semua kueri dalam berkas riwayat, yang akan menyertakan kata sandi basis data untuk akun pengguna. Jika hal ini membuat Anda khawatir, hapus dan nonaktifkan berkas .mysql_history setelah menjalankan kueri-kueri ini dengan merujuk pada dokumentasi MySQL.

PostgreSQL

Jika Anda menggunakan PostgreSQL, Anda perlu memiliki basis data dan pengguna yang dibuat untuk Anda, atau memberikan nama pengguna PostgreSQL dengan hak akses "superuser" pada formulir konfigurasi. Biasanya, ini merupakan pengguna basis data bernama postgres.

Perintah berikut di baris perintah Linux, sebagai pengguna postgres, akan membuat pengguna basis data bernama wikiuser, dan basis data bernama my_wiki yang dimiliki oleh pengguna bernama wikiuser.

 createuser -S -D -R -P -E wikiuser (kemudian masukkan kata sandi basis data)
 createdb -O wikiuser my_wiki

atau sebagai superuser (postgres bawaan), jalankan perintah berikut pada basis data:

CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;

Waspadai daftar masalah yang diketahui saat menjalankan MediaWiki dengan PostgreSQL.

Jalankan skrip instalasi

Selanjutnya, selesaikan instalasi MediaWiki dengan mengunjungi URL instalasi MediaWiki Anda di browser web: Ikuti petunjuk yang ada di Manual:Skrip Configurasi .

Pengaturan selanjutnya

Manual:Administrasi sistem - Konfigurasi tambahan
Manual:Administrator - Pengelolaan wiki

Pastikan tetap mutakhir!

Setelah terpasang, pastikan untuk selalu memperbarui versi terbaru dan menjaga keamanan peladen Anda.

Langgananlah daftar surel pengumuman rilis MediaWiki.

Lampiran

Alternatif pemasangan manual

Instalasi manual sering dipilih karena memberikan pengguna kendali lebih besar dan pemahaman yang lebih mendalam tentang bagaimana wiki mereka dipasang, sehingga memudahkan dalam pemecahan masalah dan pemeliharaan. Proses otomatis, paket, bundel, dan layanan memiliki kekhasan masing-masing.

Selain memasang MediaWiki secara manual, opsi alternatif mungkin lebih mudah:

Layanan penginangan yang menyediakan instalasi otomatis aplikasi seperti MediaWiki mungkin menawarkan versi yang sudah ketinggalan zaman atau memiliki masalah lainnya. Jika Anda menghadapi masalah, itu tidak berarti Anda tidak dapat memasang MediaWiki. Artinya, Anda harus memasang MediaWiki secara manual.

Lihat pula comparison of distribution options .

Instruksi khusus sistem

Halaman-halaman yang tercantum di Manual:OS specific help memberikan petunjuk instalasi lebih lengkap yang ditujukan untuk sistem tertentu.

Namun, umumnya dokumentasi per sistem ini kurang terpelihara dan mungkin tidak selalu diperbarui. Sebaiknya, periksa terlebih dahulu Memasang MediaWiki sebelum melihat dokumentasi instalasi per sistem.