Tutorial langkah demi langkah untuk administrator perpustakaan yang mengelola SLiMS di VPS Linux, hosting dengan terminal SSH, atau server internal. Termasuk contoh command nyata dan penjelasan kapan harus menggunakan installer resmi.

Jika Anda sedang mencari cara upgrade SLiMS 9.6.1 ke 9.8.0 tanpa kehilangan data buku, anggota, peminjaman, dan file digital, panduan ini berfokus pada pekerjaan yang benar-benar dilakukan di server. Kita akan membuka terminal SSH, memeriksa PHP dan database, menjalankan mysqldump, mengunduh rilis resmi, menyiapkan direktori aplikasi baru, dan menguji sistem setelah perubahan. Contoh berikut ditulis untuk Ubuntu/Debian dengan Apache atau Nginx dan MySQL/MariaDB; nama folder, pengguna sistem, dan jalur konfigurasi perlu disesuaikan dengan server Anda.

Perbedaan cara upgrade SLiMS dan OJS

Pengguna Open Journal Systems (OJS) mungkin terbiasa menjalankan skrip migrasi database melalui terminal. Pada SLiMS 9, mekanisme resminya berbeda: pekerjaan persiapan dan deployment dapat dilakukan lewat SSH, tetapi perubahan skema database dijalankan dari installer web melalui opsi “Upgrade my SLiMS”. Repositori resmi SLiMS juga menegaskan bahwa file SQL upgrade manual untuk SLiMS 9 tidak lagi disediakan. Karena itu, panduan ini sengaja tidak mencantumkan perintah fiktif seperti “php upgrade.php” atau “php index.php upgrade”.

Acuan: README upgrade SLiMS 9 dan dokumentasi installer resmi.

Penting: Perintah dalam artikel adalah contoh administrasi server, bukan satu skrip yang aman dijalankan mentah-mentah pada semua instalasi. Uji pada staging, periksa direktori dan kredensial, dan lakukan backup sebelum mengubah website produksi.

Versi dan prasyarat SLiMS 9.8.0

Rilis SLiMS 9.8.0 diumumkan pada Juni 2026 dan membawa perbaikan keamanan upload, penanganan lampiran, pengelolaan gambar, dan komponen lain. README repositori rilis ini menyebut PHP 8.1 atau lebih baru, MySQL 5.7 atau MariaDB 10.3, serta ekstensi PHP GD, gettext, dan mbstring. Instalasi di server produksi umumnya juga memerlukan mysqli dan pdo_mysql. Dokumentasi lama SLiMS 9.4.1 masih menyebut PHP 7.4; untuk upgrade ke 9.8.0, ikuti persyaratan rilis yang akan dipasang, bukan syarat versi terdahulu.

Disclaimer: Panduan ini disediakan sebagai referensi edukasi. Pastikan Anda memahami setiap langkah dan melakukan backup file, database, serta konfigurasi server sebelum melakukan perubahan. Segala kesalahan, kerusakan sistem, kehilangan data, atau gangguan yang timbul akibat penerapan panduan ini menjadi tanggung jawab pengguna dan bukan tanggung jawab kami. Kami tidak menyediakan asistensi instalasi maupun troubleshooting secara gratis. Jika membutuhkan bantuan teknis, silakan menggunakan layanan kami yang tersedia.

Langkah 1. Masuk melalui SSH dan tentukan direktori SLiMS

Hubungkan laptop atau komputer Anda ke VPS menggunakan akun SSH yang memiliki izin mengelola website. Contohnya, jika aplikasi perpustakaan dapat diakses dari perpustakaan.example.ac.id, lokasi instalasinya mungkin berada di /var/www/html/slims, /home/user/domains/perpustakaan.example.ac.id/public_html, atau direktori vhost lain. Jangan menebak lokasi dengan perintah hapus atau pindah: pastikan terlebih dahulu bahwa folder tersebut berisi index.php, sysconfig.inc.php, install, dan folder aplikasi lainnya.

Perintah 1 — login dan lihat isi aplikasi

ssh admin@IP_SERVER # Setelah login, contoh lokasi aplikasi: cd /var/www/html/slims pwd ls -lah | head -30

Agar mudah mengikuti contoh di bawah, definisikan dua variabel shell. Semua perintah dengan $APP akan mengacu pada direktori aplikasi saat ini, sedangkan $WORK menjadi tempat backup dan paket upgrade. Jalankan baris ini di sesi shell yang sama; jika membuka sesi SSH baru, variabel perlu didefinisikan lagi.

Perintah 2 — atur direktori kerja (sesuaikan APP)

APP=”/var/www/html/slims” WORK=”$HOME/slims-upgrade-$(date +%Y%m%d-%H%M%S)” mkdir -p “$WORK/backup” printf “APP=%s\nWORK=%s\n” “$APP” “$WORK” test -f “$APP/index.php” && echo “Folder SLiMS ditemukan”

Langkah 2. Cek PHP, database, ekstensi, dan kapasitas disk

Sebelum menaikkan versi SLiMS, periksa lingkungan yang sedang dipakai website. Output PHP dari terminal tidak selalu identik dengan PHP-FPM atau PHP yang dipakai Apache untuk melayani website. Bila VPS memiliki beberapa versi PHP, cocokkan pula versi PHP dari konfigurasi vhost atau panel hosting. Pastikan tersedia ruang penyimpanan yang cukup untuk salinan aplikasi, dump database, dan file unggahan; upgrade saat disk hampir penuh meningkatkan risiko backup rusak atau proses migrasi terputus.

Perintah 3 — audit kebutuhan server

php -v php -m | grep -Ei “gd|gettext|mbstring|mysqli|pdo_mysql” mysql –version df -h du -sh “$APP”

Jika salah satu ekstensi tidak muncul, pasang atau aktifkan terlebih dahulu untuk versi PHP yang digunakan web server. Hindari mengganti versi PHP produksi secara mendadak saat plugin dan tema SLiMS belum diuji, karena masalah kompatibilitas dapat muncul pada modul cetak, OPAC, atau dashboard admin.

Langkah 3. Backup database SLiMS menggunakan mysqldump

Temukan nama database, host, dan user database dari konfigurasi instalasi yang ada. Pada SLiMS 9, informasi koneksi umumnya berada di config/database.php, sementara penyesuaian dari rilis lebih tua bisa berbeda. Jangan membagikan kata sandi database pada tiket publik atau menaruh password langsung dalam command karena dapat tersimpan dalam histori shell. Contoh berikut memakai prompt -p agar MySQL meminta password secara interaktif.

Perintah 4 — backup database; password diminta oleh MySQL

DB_HOST=”127.0.0.1″ DB_NAME=”nama_database_slims” DB_USER=”user_database_slims” # GANTI ketiga nilai di atas sesuai config/database.php set -o pipefail mysqldump -h “$DB_HOST” -u “$DB_USER” -p \   –single-transaction –routines –triggers \   –default-character-set=utf8mb4 “$DB_NAME” \   | gzip > “$WORK/backup/slims-database.sql.gz”

Opsi –single-transaction membantu mengambil snapshot konsisten untuk tabel InnoDB tanpa mengunci seluruh tabel selama proses ekspor, tetapi transaksi yang sedang terjadi tetap harus diperhatikan. Jika database menggunakan tabel non-InnoDB, backup konsisten memerlukan strategi tambahan. Periksa status proses dan ukuran file hasil ekspor; file yang tercipta tidak otomatis berarti database sudah berhasil dicadangkan.

Perintah 5 — cek integritas file backup

echo “Exit status terakhir: $?” gzip -t “$WORK/backup/slims-database.sql.gz” ls -lh “$WORK/backup/slims-database.sql.gz”

Jangan lanjutkan upgrade jika mysqldump gagal atau gzip -t melaporkan kerusakan. Simpan salinan backup di lokasi terpisah dan pastikan benar-benar bisa direstore di database percobaan.

Langkah 4. Backup semua file aplikasi, lampiran, gambar, dan konfigurasi

Database menyimpan metadata katalog, akun anggota, transaksi, dan konfigurasi tertentu, tetapi belum tentu memuat berkas fisik dokumen digital, gambar sampul, tema, plugin, serta perubahan kode lokal. Karena itu, selain dump SQL, buat arsip lengkap direktori aplikasi. Arsip ini dipakai untuk membandingkan versi lama dengan versi baru dan menjadi salah satu sumber pemulihan bila terjadi error setelah upgrade.

Perintah 6 — buat dan verifikasi arsip aplikasi

tar -C “$(dirname “$APP”)” -czf \   “$WORK/backup/slims-files.tar.gz” “$(basename “$APP”)” tar -tzf “$WORK/backup/slims-files.tar.gz” | head -20 ls -lh “$WORK/backup/”

Di lingkungan produksi, simpan backup di luar document root agar tidak dapat diunduh pengunjung. Bila situs sudah menunjukkan tanda peretasan atau muncul halaman judi online, jangan otomatis menyalin ulang seluruh direktori lama ke versi baru. File PHP asing di dalam direktori upload perlu diperlakukan sebagai temuan keamanan dan ditinjau secara terpisah.

Langkah 5. Siapkan staging dan backup yang dapat diuji

Untuk sistem perpustakaan yang digunakan setiap hari, staging sangat disarankan. Buat salinan database dengan nama berbeda, pulihkan dump ke database tersebut, kemudian jalankan salinan SLiMS pada subdomain atau vhost staging yang hanya bisa diakses administrator. Jangan mengarahkan staging ke database produksi karena uji sirkulasi atau perubahan skema dapat mengubah transaksi perpustakaan asli.

Perintah 7 — contoh membuat dan mengisi database staging

mysql -u ADMIN_DB -p -e \   “CREATE DATABASE slims_staging CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;” gunzip -c “$WORK/backup/slims-database.sql.gz” \   | mysql -u ADMIN_DB -p slims_staging

Ganti ADMIN_DB dengan akun yang diberi izin membuat database dan melakukan impor. Setelah itu, siapkan direktori staging dari salinan source code dan data, lalu atur kredensial database staging di konfigurasi serta virtual host web server. Jika server tidak menyediakan hak untuk membuat database, gunakan panel hosting atau minta administrator menyiapkan database staging. Langkah upgrade berikut sebaiknya dicoba pada staging terlebih dahulu sampai login, katalog, dan sirkulasi lulus pengujian.

Langkah 6. Download source code SLiMS 9.8.0 dari GitHub resmi

Unduh tag v9.8.0 dari repositori proyek SLiMS, bukan mengambil ZIP yang ditemukan dari sumber tidak dikenal. Gunakan curl -fL agar unduhan gagal bila server memberi respons error. Contoh ini memakai arsip source dari tag resmi; sebelum digunakan, pastikan paket yang diekstrak memiliki file aplikasi dan dependensi yang dibutuhkan, karena isi paket distribusi dan source archive bisa berbeda.

Perintah 8 — unduh, ekstrak, dan periksa paket

VERSION=”9.8.0″ curl -fL \   “https://github.com/slims/slims9_bulian/archive/refs/tags/v${VERSION}.tar.gz” \   -o “$WORK/slims-${VERSION}.tar.gz” tar -xzf “$WORK/slims-${VERSION}.tar.gz” -C “$WORK” NEW=”$WORK/slims9_bulian-${VERSION}” test -f “$NEW/install/index.php” && echo “Installer tersedia” ls -ld “$NEW/vendor” “$NEW/config” 2>&1

Jika direktori vendor atau file yang diperlukan tidak tersedia pada hasil ekstraksi, jangan langsung memindahkan source archive ke produksi. Periksa aset distribusi pada halaman GitHub Releases dan petunjuk pengemasan yang relevan; bila instalasi memang berbasis Composer, penyiapan dependensi harus dilakukan sesuai lockfile atau instruksi resmi dan diuji dahulu. Hindari menyalin seluruh folder vendor dari versi lama karena pustaka dapat berbeda antarversi.

Sumber unduhan: GitHub Releases SLiMS 9.8.0.

Langkah 7. Salin data pengguna ke direktori kode baru

Direktori yang lazim menyimpan data pengguna adalah files, images, dan repository. Periksa apakah instalasi Anda mempunyai folder khusus lain untuk plugin, tema kustom, atau lampiran di luar document root. Perintah rsync di bawah menyalin data tersebut ke folder source baru; ini bukan perintah untuk mengganti seluruh aplikasi dengan file lama. Jalankan hanya setelah data dinilai bersih, terutama bila situs sebelumnya terkena malware.

Perintah 9 — pindahkan media dan audit berkas yang berisiko

for DIR in files images repository; do   if [ -d “$APP/$DIR” ]; then     mkdir -p “$NEW/$DIR”     rsync -a “$APP/$DIR/” “$NEW/$DIR/”   fi done # Audit file PHP di lokasi unggahan sebelum publikasi: find “$NEW/files” “$NEW/images” “$NEW/repository” \   -type f \( -iname “*.php” -o -iname “*.phtml” \) -print 2>/dev/null

Jangan menimpa file inti sysconfig.inc.php dari versi 9.8.0 menggunakan salinan lama. Baca kembali penyesuaian pada sysconfig.local.inc.php, config/database.php, config/env.php, plugin, tema, path repositori, cron, serta integrasi pihak ketiga, kemudian migrasikan satu per satu. Installer upgrade dapat menuliskan konfigurasi database dan environment untuk rilis baru; karena itu, backup konfigurasi lama tetap disimpan sebagai referensi, bukan langsung ditimpa tanpa pemeriksaan.

Langkah 8. Siapkan folder rilis dan alihkan aplikasi saat maintenance

Setelah staging berhasil, lakukan cutover produksi pada jam sepi dan hentikan sementara transaksi katalog maupun sirkulasi melalui maintenance khusus website tersebut. Contoh berikut menyiapkan direktori rilis baru di parent directory aplikasi agar pertukaran nama folder biasanya berlangsung cepat. Administrator harus memastikan izin file dan pengaturan vhost sesuai dengan server serta pengguna PHP-FPM/Apache yang benar. Jangan menggunakan chmod -R 777 atau menghentikan Apache untuk seluruh server bila ada website lain.

Perintah 10 — siapkan direktori rilis baru

PARENT=”$(dirname “$APP”)” NEXT=”$PARENT/slims-next-${VERSION}” mkdir -p “$NEXT” rsync -a “$NEW/” “$NEXT/” test -f “$NEXT/install/index.php” && echo “Folder baru siap” # Aktifkan maintenance pada vhost SLiMS sebelum cutover.

Ketika seluruh pengujian dan backup final selesai, lakukan pertukaran folder berikut dari sesi SSH dengan hak yang sesuai. Variabel OLD menyimpan direktori aplikasi lama untuk pemulihan. Apabila salah satu perintah gagal, jangan membuka layanan sebelum memastikan folder yang aktif benar dan file konfigurasi sesuai. Cara ini mengasumsikan document root menunjuk ke $APP, bukan ke path yang berbeda.

Perintah 11 — ganti source code aplikasi saat maintenance

OLD=”${APP}.before-${VERSION}-$(date +%Y%m%d-%H%M%S)” mv “$APP” “$OLD” mv “$NEXT” “$APP” printf “OLD=%s\nAPP=%s\n” “$OLD” “$APP” ls -ld “$APP” “$OLD”

Setelah perpindahan, sesuaikan kepemilikan hanya pada folder yang perlu ditulis oleh proses PHP, seperti config dan lokasi upload. Contohnya jika PHP-FPM berjalan sebagai www-data, gunakan chown secara terbatas; pada cPanel/DirectAdmin nama user biasanya berbeda. Periksa dulu siapa pemilik website, dan jangan mengubah kepemilikan seluruh akun hosting tanpa memahami konfigurasi permission.

Perintah 12 — contoh permission terbatas, tidak memakai chmod 777

# CONTOH HANYA jika PHP berjalan sebagai user www-data: sudo chown -R www-data:www-data “$APP/config” # Lakukan penyesuaian serupa hanya pada folder upload # yang memang memerlukan akses tulis.

Langkah 9. Upgrade database melalui installer resmi SLiMS

Buka alamat installer dari browser administrator, misalnya https://perpustakaan.example.ac.id/install/. Jalankan proses “Get Started”, pastikan persyaratan sistem dan permission lolos, lalu pilih “Upgrade my SLiMS”—bukan “Install SLiMS”. Masukkan informasi database yang benar dan ikuti pemilihan versi lama jika diminta, kemudian jalankan proses upgrade sampai ada konfirmasi berhasil. Pilihan layar dapat sedikit berbeda menurut versi dan kondisi database lama; catat pesan error bila proses berhenti.

Alur 13 — tahapan di browser; bukan perintah terminal

https://perpustakaan.example.ac.id/install/ # Buka di browser, bukan dijalankan sebagai shell command. # Get Started → System Requirements → Upgrade my SLiMS # → Koneksi database → Versi asal → Jalankan Upgrade

Tidak ada satu perintah CLI resmi yang setara dengan OJS “php tools/upgrade.php upgrade” pada alur upgrade SLiMS 9 yang didokumentasikan. Jangan mencoba impor file SQL lama secara acak; dokumentasi proyek mengarahkan migrasi melalui installer.

Setelah installer selesai, pindahkan atau nonaktifkan folder install dari direktori yang bisa diakses publik. Dokumentasi SLiMS mengingatkan bahwa folder installer perlu dihapus atau diganti nama untuk alasan keamanan. Untuk tetap memiliki salinannya saat audit, contoh berikut memindahkannya ke direktori kerja di luar document root; pastikan file yang dipindahkan bukan syarat runtime yang masih diperlukan.

Perintah 14 — keluarkan installer dari document root

mv “$APP/install” “$WORK/install-disabled-${VERSION}” test ! -d “$APP/install” && echo “Installer tidak lagi publik”

Langkah 10. Validasi upgrade melalui terminal dan fitur SLiMS

Jangan menyatakan upgrade berhasil hanya karena halaman depan dapat dibuka. Periksa versi PHP yang menangani aplikasi, lakukan pengecekan sintaks dasar, kemudian periksa status SLiMS jika konsol tersedia pada instalasi tersebut. Dokumentasi pengembang SLiMS menunjukkan contoh command “php index.php status” dan “php index.php plugin:list”; perintah ini untuk pemeriksaan dan pengelolaan, bukan untuk menjalankan migrasi database.

Perintah 15 — pemeriksaan awal pasca-upgrade

cd “$APP” php -l index.php php index.php status php index.php plugin:list curl -sS -o /dev/null -w “HTTP: %{http_code}\n” \   https://perpustakaan.example.ac.id/

Jangan anggap upgrade selesai sebelum fitur ini lolos uji

Bandingkan jumlah koleksi dan anggota dengan angka sebelum upgrade. Anda dapat menjalankan kueri baca saja dari CLI MySQL untuk memeriksa tabel inti, sementara pengujian sebenarnya tetap harus dilakukan melalui antarmuka petugas. Cobalah mencari judul di OPAC, membuka dokumen digital, masuk sebagai pustakawan, melihat detail bibliografi, serta menjalankan skenario pinjam dan kembali pada data uji yang terkontrol. Pastikan juga plugin dan tema kustom tidak menyebabkan fatal error.

Perintah 16 — bandingkan data inti setelah migrasi

mysql -h “$DB_HOST” -u “$DB_USER” -p “$DB_NAME” -e \   “SELECT COUNT(*) AS total_buku FROM biblio;    SELECT COUNT(*) AS total_anggota FROM member;”

Langkah 11. Troubleshooting bila SLiMS error setelah upgrade

Error HTTP 500 setelah upgrade biasanya perlu ditelusuri dari log PHP atau web server, bukan diselesaikan dengan mengulangi upgrade database. Contohnya, file plugin mungkin belum cocok dengan PHP 8.1 atau dependensi belum terpasang. Bila halaman admin login gagal, periksa juga sesi, cookie, URL HTTPS, konfigurasi environment, serta izin tulis. Jika gambar sampul atau lampiran hilang, cek lokasi penyimpanan dan pemilik folder, lalu bandingkan dengan backup sebelum memindahkan berkas kembali.

Perintah 17 — periksa log dan sintaks

sudo tail -n 100 /var/log/apache2/error.log # Bila menggunakan Nginx: sudo tail -n 100 /var/log/nginx/error.log # Log PHP-FPM berbeda per versi dan distro. php -l “$APP/sysconfig.inc.php”

Gejala	Pemeriksaan teknis pertama	Langkah selanjutnya
HTTP 500 / blank page	Log web server dan PHP-FPM; php -l; vendor	Perbaiki error spesifik, jangan upgrade berulang
OPAC normal, admin bermasalah	Session, HTTPS, plugin admin, permission	Uji dengan tema/plugin standar
Sampul atau PDF hilang	Path files/images/repository, symlink, owner	Pulihkan data dari backup terverifikasi
Database tidak ter-upgrade	Versi asal, DB host, izin user, pesan installer	Pulihkan staging dan ulangi sesuai installer

Langkah 12. Rollback jika upgrade gagal

Rollback bukan sekadar mengganti file PHP dengan versi lama. Jika installer sudah mengubah struktur database, kode lama bisa tidak kompatibel dengan skema baru. Karena itu, strategi aman adalah mengembalikan aplikasi lama sekaligus mengarahkan koneksinya ke database hasil restore dari backup sebelum migrasi. Jangan menjalankan perintah impor yang menimpa database produksi tanpa memastikan Anda memiliki dump yang tervalidasi dan tidak ada transaksi baru yang harus dipertahankan.

Perintah 18 — restore backup ke database BARU untuk rollback

mysql -u ADMIN_DB -p -e \   “CREATE DATABASE slims_rollback CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;” gunzip -c “$WORK/backup/slims-database.sql.gz” \   | mysql -u ADMIN_DB -p slims_rollback

Arahkan konfigurasi database aplikasi lama ke slims_rollback, kemudian saat maintenance tukar kembali direktori aplikasi dengan sumber kode versi sebelumnya. Contoh dua perintah di bawah hanya mengembalikan folder; administrasi database, URL, dan permission harus sudah dipastikan sesuai. Jika sistem masih melayani transaksi setelah backup diambil, rencanakan terlebih dahulu rekonsiliasi data sebelum rollback agar tidak menghilangkan transaksi terbaru.

Perintah 19 — kembalikan direktori kode lama

FAILED=”${APP}.failed-${VERSION}-$(date +%Y%m%d-%H%M%S)” mv “$APP” “$FAILED” mv “$OLD” “$APP” # Sesuaikan koneksi aplikasi lama ke database slims_rollback.

Bagaimana upgrade SLiMS melalui cPanel atau XAMPP?

Pengelola shared hosting yang tidak memiliki SSH tetap dapat melakukan prinsip yang sama melalui File Manager dan phpMyAdmin: backup database dan seluruh document root, unduh paket resmi, siapkan salinan kode baru, pertahankan media pengguna, jalankan installer “Upgrade my SLiMS”, lalu uji hasil. Jika cPanel menyediakan Terminal, command mysqldump, tar, dan rsync mungkin tersedia sesuai kebijakan hosting. Pada XAMPP, folder aplikasi biasanya berada di htdocs dan backup database dapat dibuat lewat phpMyAdmin atau mysqldump.exe. Jangan menggunakan contoh mv /var/www/html secara langsung di Windows karena struktur direktori dan sintaks perintahnya berbeda.

Jika SLiMS pernah dihack, jangan langsung melakukan upgrade biasa

Kasus SLiMS yang terkena judol, redirect slot, webshell, atau perubahan kode mencurigakan membutuhkan langkah respons insiden sebelum migrasi. Pastikan sumber file unggahan diperiksa, akun administrator dan password database diganti sesuai kebutuhan, akses tidak sah diblokir, serta artefak insiden diamankan bila diperlukan untuk audit. Upgrade ke SLiMS 9.8.0 membantu memasang perbaikan keamanan yang sudah dirilis, tetapi tidak otomatis membersihkan file berbahaya atau memperbaiki konfigurasi server yang lemah.

Untuk contoh penanganan kasus, baca studi kasus pemulihan website SLiMS yang terdampak peretasan dari tim Open Journal Theme.

Kesimpulan

Cara upgrade SLiMS yang aman bukan hanya mengunggah file versi terbaru. Administrator perlu memeriksa prasyarat PHP dan MySQL, menjalankan mysqldump dan backup aplikasi, menyiapkan staging, mengambil rilis resmi, memisahkan source code baru dari data pengguna, kemudian menjalankan installer database. Setelah itu, periksa status aplikasi, log error, katalog, sirkulasi, plugin, serta kemampuan rollback. Rangkaian perintah di atas sengaja dilengkapi langkah pemeriksaan agar pengelola dapat memahami tindakan yang dilakukan, bukan sekadar menyalin command secara random.

Tags : slims upgrade