Manual:Memasang MediaWiki
MediaWiki memasang dirinya sendiri menggunakan sebuah skrip instalasi interaktif dan berbasis web. Sebelum Anda menjalankan skrip ini, Anda perlu melakukan beberapa hal: lihat persyaratan atau panduan instalasi singkat untuk para ahli.
MediaWIki bisa jadi sulit diinstal bagi pengguna komputer rata-rata yang tidak punya pengalaman menggunakan Apache, PHP dan MySQL/MariaDB. Kebanyakan pengguna yang ingin menggunakan perangkat lunak wiki sebaiknya menggunakan hos MediaWiki gratis atau melalui sebuah bundel perangkat lunak.
Mengunduh perangkat lunak MediaWiki
Penjelajah web
Unduh berkas tar MediaWiki dari halaman pengunduhan resmi. Pada umumnya, jika Anda menggunakan lingkungan produksi, Anda sebaiknya menjalankan rilis stabil terbaru, yaitu mediawiki-1.38.2.tar.gz.
Baris perintah (mesin *nix)
Untuk mengunduh MediaWiki 1.38.2, yang merupakan versi rilis stabil terbaru, ke sebuah mesin *nix Anda bisa menggunakan perintah berikut:
wget https://releases.wikimedia.org/mediawiki/1.38/mediawiki-1.38.2.tar.gz
Sebagai alternatif, menggunakan cURL:
curl -O https://releases.wikimedia.org/mediawiki/1.38/mediawiki-1.38.2.tar.gz
Berkas-berkas yang diunduh memiliki format .tar.gz
, jadi mereka perlu diekstrak sebelum digunakan.
Ini bisa dilakukan secara lokal (dan kemudian diunggah via FTP) atau secara langsung di peladen Anda.
Ini biasanya dilakukan dengan perangkat lunak seperti 7-Zip (gratis), WinZip, WinRAR atau IZArc (gratis) di Windows.
Di Linux dan Mac OS X, Anda bisa mengekstrak berkasnya menggunakan perintah ini:
tar -xf mediawiki-*.tar.gz
chown
jika tidak berkas akan dimiliki oleh pengguna # 1000, yang mungkin bukanlah yang Anda inginkan.Git (untuk developer)
Sedangkan para pengembang sebaiknya mengunduh dari Git untuk membuat repositori lokal dengan kode terbaru dalam pengembangan.
Merka juga perlu menginstal ketergantungan secara manual via Composer .
Mengunggah berkas ke peladen anda
Jika Anda belum mengunggah berkas-berkas ke peladen web Anda, lakukanlah sekarang.
Unggah berkas-berkasnya ke direktori web peladen web Anda dengan cara:
- menyalin folder yang telah diekstrak secara langsung atau
- dengan menggunakan sebuah klien FTP seperti FileZilla (Perangkat Lunak Sumber Terbuka, Windows, OSX dan Linux) atau Cyberduck (OSX).
- by using cPanel File Manager (see below)
Jika alat pengunggah Anda punya pilihan "ubah nama berkas menjadi huruf kecil", Anda harus menonaktifkannya.
Jika Anda menginstal Apache, direktori yang benar ditentukan dalam berkas httpd.conf
Anda (direktif DocumentRoot, biasanya /var/www/
atau <apache-folder>/htdocs
).
Catatan: Ini diubah di Ubuntu 14.04 dengan Apache 2.4.7 di mana berkas konfigurasi utama untuk pengaturan peladen dan direktori Apache adalah /etc/apache2/apache2.conf
.
Jika Anda menggunakan peladen Linux atau Unix Anda bisa menyalin berkas ke direktori manapun di peladen Anda lalu membuat sebuah tautan simbolis ke folder itu dari direktori web peladen web Anda.
Ubah nama folder yang diunggah menjadi apapun yang Anda ingin tampilkan di URL.
Jika peladen web Anda dijalankan sebagai misalnya http://localhost
, mengubah namanya menjadi direktori /w/
berarti Anda akan mengakses wiki Anda di http://localhost/w/index.php
.
Jangan gunakan /wiki/
apabila Anda ingin menggunaknnya sebagai URL Singkat.
(Dan jangan atur URL singkat sebelum Anda menjalankan skrip pemasangan.)
index.php
peladen Linux mungkin manpilkan "500 Internal server Error". Ini kemungkinan merupakan galat perizinan yang bisa diselesaikan dengan mengubah perizinan berkas dan direktori dengan menjalankan perintah berikut dalam SSH setelah mengubah direktori menjadi "w":
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;
Folder (yang telah diubah nama) ini sekarang akan disebut sebagai <MediaWiki-folder>
.
Manajer Berkas cPanel
cPanel adalah antarmuka populer yang digunakan oleh banyak hos web. Metode ini efisien karena berkas-berkasnya tidak dimampatkan di peladen.
- Pergi ke direktori di mana Anda ingin menaruh folder wiki Anda.
- Unggah berkas mediawiki-1.xx.x.tar.gz. Anda mungkin perlu menekan "Reload" untuk melihatnya.
- Ekstrak berkas mediawiki-1.xx.x.tar.gz. Muat ulang lagi.
- Pastikan folder mediawiki-1.xx.x ada.
- Hapus berkas tar.gz.
- Ganti nama folder mediawiki-1.xx.x menjadi w.
Membuat sebuah basis data
Jika Anda sudah punya peladen basis data dan tahu kata sandi root untuknya, skrip instalasi MediaWiki bisa membuat basis data baru untuk Anda. Kalau begitu, Anda bisa melompat ke bagian Menjalankan skrip instalasi di bawah. Jika Anda tidak tahu kata sandi rootnya, misalnya apabila Anda menggunakan peladen yang dihos, Anda harus membuat basis data yang baru. Untuk sekarang, Anda harus menggunakan SQLite, MariaDB/MySQL atau PostgreSQL untuk menyimpan isi wiki Anda. Jika Anda tidak yakin basis data yang mana yang mau dipilih, gunakan MariaDB karena itulah yang didukung dengan paling baik oleh MediaWiki.
SQLite
SQLite adalah pustaka basis data mandiri yang menyimpan isi basis data dalam satu berkas.
Jika PHP punya modul pdo-sqlite
, tidak diperlukan pengaturan lebih lanjut.
Di halaman instalasi, Anda perlu memilih nama basis data (bisa apapun namanya) dan direktori basis data SQLite. Untuk direktori basis data, penginstal akan mencoba menggunakan sebuah subdirektori di luar akar dokumen dan membuatnya apabila diperlukan. Jika direktori ini tidak aman (contohnya, bisa dibaca dari web), ubah secara manual agar direktorinya tidak bisa diakses oleh semua orang di web.
MariaDB/MySQL
MediaWiki akan menanyakan nama basis data dan pengguna dan akan mencoba membuat mereka apabila mereka belum ada. Jika tidak bisa melakukan itu dari MediaWiki, Anda bisa melakukannya menggunakan berbagai panel kendali seperti PhpMyAdmin, yang biasanya tersedia dari hos bersama, atau Anda mungkin bisa menggunakan ssh untuk masuk log ke hos Anda dan mengetikkan perintah-perintahnya ke wantian MySQL. Lihat dokumentasi yang sesuai. Untuk alternatifnya, hubungi penyedia hos Anda untuk meminta mereka membuat akun bagi Anda.
CREATE DATABASE wikidb;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
Jika basis data Anda tidak dijalankan di peladen yang sama dengan peladen web Anda, Anda perlu memberikan nama hos peladen web — mediawiki.example.com dalam contoh di bawah — sebagaimana berikut:
GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'password';
PostgreSQL
Jika Anda menggunakan PostgreSQL, Anda akan memerlukan antara basis data dan pengguna yang dibuatkan untuk Anda, atau tinggal menyediakan nama pengguna PostgreSQL dengan hak "superuser" ke isian konfigurasi. Biasanya, ini adalah pengguna basis data yang bernama postgres.
Berikut adalah salah satu cara untuk melakukan pengaturannya. Ini untuk sistem mirip Unix. Dalam contoh ini, kita akan membuat sebuah basis data bernama wikidb, yang dimiliki oleh pengguna bernama wikiuser. Dari baris perintah, sebagai pengguna postgres, lakukan langkah-langkah berikut.
createuser -S -D -R -P -E wikiuser (kemudian masukkan kata sandi) createdb -O wikiuser wikidb
atau sebagai superuser (default postgres) jalankan perintah-perintah berikut di wantian basis data:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'password';
CREATE DATABASE wikidb WITH OWNER wikiuser;
Perhatikan daftar masalah yang diketahui apabila menjalankan MediaWiki menggunakan PostgreSQL.
Menjalankan skrip instalasi
Setelah semua langkah di atas selesai, Anda bisa menyelesaikan instalasi melalui peramban web dengan pergi ke URL index.php di peramban Anda — periksa instruksi yang disebutkan di Manual:Skrip Configurasi .
Peralatan instalasi akan meminta Anda mengunduh berkas LocalSettings.php, dan untuk menyimpannya sebagai <MediaWiki-folder>/LocalSettings.php
.
Selain dengan cara itu, Anda bisa menjalankan penginstal baris perintah (command-line installer) atau CLI: php maintenance/install.php
dengan menambahkan parameter konfigurasi yang sesuai.
Langkah selanjutnya
Ini opsional tetapi membuat situs Anda terlihat jauh lebih baik.
Pastikan muktahir!
Setelah menginstal, pastikan Anda memerhatikan rilis yang mutakhir, dan tetap jaga keamanan peladen Anda!
Bantuan instalasi
- Bacalah FAQ mengenai instalasi dan konfigurasi
- Mengobrol dengan pengembang, adminstrator sistem, dan pengguna MediaWIki: #mediawiki connect
- Milis mediawiki-l adalah milis dengan lalu lintas tinggi untuk meminta bantuan.
Lihat pula
- Manual:Kustomisasi halaman - mendaftarkan halaman-halaman wiki yang ditautkan dengan pesan MediaWiki, Anda perlu membuat halaman-halaman tersebut atau menyunting pesannya.
- Manual:Mengonfigurasi MediaWiki - untuk pranala ke konfigurasi lanjutan.
- Manual:Short URL - untuk mendapatkan URL yang lebih ramah-pengguna menuju halaman artikel.
- Manual:Wiki family - untuk membuat beberapa instansi MediaWiki dengan satu set berkas MediaWiki.
- Bantuan:Templat
- Manual:Mencadangkan wiki
- Manual:Moving a wiki
- Manual:Restoring a wiki from backup
- Manual:Memuktahirkan