Panduan Umum Upgrade Moodle (Major & Minor Version)

A. Pendahuluan

Panduan ini menjelaskan langkah-langkah Standard Operating Procedure (SOP) untuk melakukan upgrade sistem Moodle. Dokumentasi ini mencakup prinsip dasar yang harus dipegang, perbedaan persiapan upgrade, peringatan khusus untuk versi terbaru, serta panduan eksekusi berbasis Hybrid (kombinasi penggunaan antarmuka Web UI dan Command Line Interface / CLI).

Referensi Resmi & Bantuan Troubleshooting:

• Agar proses upgrade berjalan lancar, selalu jadikan panduan resmi dari Moodle sebagai rujukan utama kamu pada tautan berikut: Panduan Upgrade Moodle.
• Tips: Panduan pada tautan di atas mengarah ke versi terbaru, yaitu Moodle versi 5.1. Jika kamu melakukan upgrade ke versi tertentu (misalnya 4.5), ubah angka pada URL (contoh: ubah menjadi 405 pada https://docs.moodle.org/405/en/Upgrading), atau gunakan menu dropdown di bagian atas halaman situs tersebut.
• Release Notes: Sebelum melakukan upgrade, kamu wajib untuk meninjau release notes sesuai dengan versi tujuan upgrade moodle untuk memastikan spesifikasi server sudah terpenuhi. Silakan merujuk ke halaman berikut: Release Notes Moodle.
• Mengalami Kendala? Apabila kamu menemui error spesifik, blank page, atau kendala teknis di tengah proses, sangat disarankan untuk mencari solusi pada Forum Komunitas Moodle. Komunitas developer dan pengguna Moodle sangat aktif mendiskusikan bug serta berbagi langkah troubleshooting dari berbagai kasus upgrade.

---

B. Tiga Prinsip Dasar Upgrade Moodle

Setiap proses upgrade Moodle, apa pun versinya, selalu berpegang pada tiga pilar utama untuk menjaga keutuhan dan integritas sistem:

1. Keamanan Data (Backup): Mengamankan seluruh aset (database dan file) sebelum terjadi perubahan apa pun.
2. Penyegaran Source Code: Mengganti core files Moodle dengan versi terbaru, namun tetap mempertahankan konfigurasi lokal (config.php), folder data eksternal (moodledata), serta plugin atau tema kustom milikmu.
3. Sinkronisasi Database: Menjalankan script upgrade.php untuk menyesuaikan struktur tabel database dengan logika kode Moodle yang baru.

---

C. Perbedaan Upgrade: Minor vs. Major

Sebelum memulai, penting untuk memahami perbedaan tingkat upgrade yang akan kamu lakukan:

Aspek	Upgrade Minor (contoh: 4.1 ke 4.1.2)	Upgrade Major (contoh: 4.1.2 ke 4.5.10)
Tujuan	Perbaikan bug, keamanan (security patch), dan stabilitas.	Penambahan fitur baru dan perubahan arsitektur inti.
Kebutuhan Sistem	Biasanya tetap menggunakan versi PHP dan Database yang sama.	Sering menuntut pembaruan versi PHP dan Database ke versi yang lebih tinggi.
Kompatibilitas	Plugin dan tema hampir selalu tetap berfungsi normal.	Wajib memeriksa ulang kompatibilitas seluruh plugin dan tema pihak ketiga.

CATATAN KHUSUS: Upgrade ke Moodle 5.1 dan Versi Lebih Baru

Jika kamu melakukan upgrade menuju Moodle 5.1 atau versi yang lebih baru, terdapat perubahan arsitektur folder yang sangat signifikan dan wajib kamu perhatikan:

1. Struktur Direktori /public/ Baru: Moodle memperkenalkan struktur folder baru di mana hanya direktori /public/ yang dapat diakses secara publik melalui web. File inti dan file konfigurasi (config.php) kini ditempatkan di luar web root demi keamanan.
2. Pemindahan Lokasi Plugin & Tema: Seluruh plugin dan tema pihak ketiga kini harus berada di bawah direktori /public/. Kamu wajib memindahkannya ke lokasi yang relevan (contoh: dipindahkan ke /public/theme/... atau /public/mod/...).
3. Perubahan Document Root Server: Kamu harus mengubah pengaturan Document Root pada web server kamu (Nginx/Apache/LiteSpeed) agar mengarah langsung ke folder /moodle/public/, bukan lagi ke root folder Moodle secara keseluruhan.

---

D. Fase 1: Persiapan (Pre-Upgrade)

1. Audit Plugin dan Tema (Via Web UI)

Pastikan seluruh komponen tambahan siap untuk versi baru melalui antarmuka web.

1. Masuk ke menu Site administration > Plugins > Plugins overview.
2. Silakan merujuk ke situs resmi Moodle Plugins Directory untuk mencari plugin yang kamu gunakan, memastikan ketersediaan versi terbarunya, dan mengecek kompatibilitas dengan versi Moodle tujuanmu.

2. Matikan Cron Job

Mencegah proses background berjalan dan mengunci database saat pembaruan berlangsung. Berikan tanda pagar (#) pada baris cron Moodle di pengaturan crontab kamu:

crontab -e

# Contoh hasil edit: 
# * * * * * /usr/bin/php /path/to/moodle/admin/cli/cron.php

3. Aktifkan Maintenance Mode

Cegah aktivitas pengguna selama proses pembaruan.

• Via Web UI: Masuk ke Site administration > Server > Maintenance mode.
• Via CLI:

  sudo -u nginx php /path/to/moodle/admin/cli/maintenance.php --enable
  

  (Catatan: Ganti `nginx` dengan user web server kamu, misal `www-data`).

4. Full Backup (Wajib via CLI/Panel)

Lakukan pencadangan pada database, folder moodledata, dan direktori utama Moodle.

# Backup Database (Ganti user dan nama database)
mysqldump -u root -p moodle_db > /backup/moodle_db_backup.sql

# Backup Folder Moodledata & Core
tar -czvf /backup/moodledata_backup.tar.gz /path/to/moodledata
tar -czvf /backup/moodle_core_backup.tar.gz /path/to/moodle

---

E. Fase 2: Eksekusi Upgrade

1. Unduh, Ekstrak, dan Penggantian File (Via CLI)

Ganti sistem lama dengan sistem baru, namun pastikan config.php kamu tetap terjaga.

# Ekstrak versi terbaru yang sudah diunduh
tar -zxvf moodle-latest-45.tgz

# Rename folder lama sebagai cadangan
mv moodle moodle_old

# Pindahkan folder baru menjadi folder utama
mv moodle-latest moodle

# Salin config.php dari folder lama ke folder baru
cp moodle_old/config.php moodle/

# Salin plugin/tema kustom (Jika upgrade ke 5.1+, salin ke /public/mod/)
cp -r moodle_old/mod/nama_plugin moodle/mod/

# Perbaiki hak akses (Sesuaikan user nginx atau www-data)
chown -R nginx:nginx /path/to/moodle
find /path/to/moodle -type d -exec chmod 755 {} \;
find /path/to/moodle -type f -exec chmod 644 {} \;

2. Jalankan Script Sinkronisasi Database

Mengapa Kami Sangat Merekomendasikan Sinkronisasi via CLI?
Eksekusi upgrade database melalui browser sangat rawan terputus akibat batasan waktu pemuatan (timeout / Error 504/502), terutama jika database kamu berskala besar. Dengan CLI, proses akan berjalan di latar belakang hingga tuntas tanpa terpengaruh timeout, dan menampilkan log error yang jauh lebih transparan jika terjadi kendala.

Opsi Utama (Via CLI):
Jalankan perintah berikut melalui terminal:

sudo -u nginx php /path/to/moodle/admin/cli/upgrade.php

Ketik Y saat diminta konfirmasi dan tunggu hingga proses selesai dengan keterangan Success.

Opsi Alternatif (Via Web UI - Tanpa SSH):
Jika kamu adalah pengguna layanan shared hosting dan tidak memiliki akses root/SSH, proses ini dapat dipicu dengan sekadar membuka halaman utama website Moodle kamu melalui browser. Layar akan mendeteksi versi baru, silakan ikuti petunjuk di layar dan klik tombol Continue.

---

F. Fase 3: Pasca-Upgrade (Post-Upgrade)

1. Purge Caches

Bersihkan cache sistem agar antarmuka (UI) memuat tampilan versi baru tanpa masalah atau glitch.

• Via Web UI: Masuk ke Site administration > Development > Purge caches dan klik tombol "Purge all caches".
• Via CLI:

  sudo -u nginx php /path/to/moodle/admin/cli/purge_caches.php
  

2. Pengecekan Sistem & Matikan Maintenance Mode

1. Pastikan semua indikator status menunjukkan warna hijau atau "OK" pada menu Site administration > Server > Environment.
2. Matikan mode maintenance via Web UI atau CLI:

   sudo -u nginx php /path/to/moodle/admin/cli/maintenance.php --disable
   

3. Buka kembali pengaturan cron (crontab -e) dan hilangkan tanda pagar (#) pada baris cron Moodle kamu agar pekerjaan latar belakang kembali berjalan normal.

3. Verifikasi Akhir dan Cek Versi Terbaru

Langkah terakhir adalah memastikan website Moodle kamu sudah benar-benar berjalan normal dengan versi yang baru.

1. Buka browser (sangat disarankan menggunakan mode Incognito / Private Window agar tidak memuat cache browser lama) dan akses halaman utama website kamu.
2. Cobalah melakukan login menggunakan akun administrator.
3. Masuk ke menu Site administration > Notifications. Perhatikan informasi di halaman tersebut, pastikan tidak ada peringatan error sistem dan cek keterangan versi Moodle yang tertera di bagian paling bawah halaman (misalnya: Moodle 4.5.1). Pastikan versinya sudah berubah dan sesuai dengan yang kamu unduh.
4. Lakukan pengujian beberapa fungsi dasar, seperti masuk ke halaman course, mencoba membuka materi, atau mengakses halaman profil pengguna untuk memastikan seluruh sistem berfungsi sempurna.

---

G. Kesimpulan

Dengan menggabungkan kepraktisan Web UI untuk audit dan keamanan CLI untuk eksekusi, kamu bisa memperbarui sistem Moodle dengan risiko kegagalan yang sangat minim. Jangan lupa bahwa rutinitas melakukan backup sebelum melakukan eksekusi adalah kunci utama agar sistem e-learning kamu tetap aman dari kendala teknis yang tidak terduga.