Cara Penggunaan & Instalasi SLiMS 9
Dalam dokumentasi ini, beberapa metode instalasi akan dibahas. Instalasi menggunakan alat penginstal SLiMS (installer) dan instalasi SLiMS Portable (PSLiMS).
SLiMS adalah aplikasi lintas platform (*multi-platform*). Dengan kata lain, SLiMS dapat diinstal pada perangkat keras yang terpasang sistem operasi MS-Windows, GNU/Linux, dan/atau MacOS.
Panduan instalasi ini ditujukan untuk SLiMS 9 Bulian kode rilis 9.4.1. Untuk menginstal SLiMS versi ini, Anda harus memenuhi persyaratan minimum berikut:
- PHP versi 7.4
- MySQL versi 5.7 dan atau MariaDB versi 10.3
- PHP GD tersedia/diaktifkan
- PHP gettext tersedia/diaktifkan
- PHP mbstring tersedia/diaktifkan
Source Code (Kode Sumber)
Agar SLiMS dapat diinstal, pastikan server web (web server, misalnya web server Apache), MySQL (aplikasi basis data), dan PHP (bahasa pemrograman) telah terinstal di perangkat keras server dan berjalan dengan baik. Akan lebih membantu jika aplikasi phpMyAdmin atau Adminer juga diinstal untuk membantu pengaturan basis data melalui antarmuka web. Jika SLiMS digunakan di internet (publik), direkomendasikan untuk meningkatkan keamanan dengan menambahkan firewall pada sisi TCP/IP (layer 3 dan 4 dari layer OSI), pada sisi aplikasi (misalnya modsecurity), dan pada sisi basis data (misalnya greensql).
Setelah sistem yang akan digunakan siap, tempatkan kode sumber SLiMS di direktori web root yang Anda gunakan.
Source Code dengan GNU/Linux
Untuk pengguna sistem operasi GNU/Linux, misalnya GNU/Linux Ubuntu (atau Debian), direktori web root dapat ditemukan di direktori /var/www/html. Untuk pengguna GNU/Linux Ubuntu versi 12.04 ke bawah, direktori web root berada di direktori /var/www/.
Pertama, unduh kode sumber SLiMS yang bisa didapatkan melalui halaman resmi SLiMS atau melalui repositori di halaman GitHub. Kemudian tempatkan di direktori web root.
Mengekstrak Source Code
Langkah berikutnya adalah mengekstrak kode sumber yang terkompresi. Masukkan perintah berikut:
$ sudo unzip slims9_bulian-master.zipSetelah proses ekstraksi selesai, sebuah direktori instalasi SLiMS tunggal akan dibuat di dalam direktori web root (biasanya nama direktori akan sama dengan nama file yang dikompresi).
Memulai Instalasi
Setelah proses ekstraksi selesai, kita dapat memulai proses instalasi SLiMS menggunakan SLiMS Installer.
Source Code dengan Microsoft Windows
Untuk pengguna sistem operasi ini, penggunaan Apache, PHP, dan MySQL tersedia dalam bentuk paket. Ada banyak paket yang bisa digunakan. Salah satu yang paling terkenal adalah XAMPP oleh Apache Friends. Aplikasi ini dapat diunduh di http://apachefriends.org.
Setelah menginstal XAMPP, Anda dapat memulai layanan web server dan database dengan memilih XAMPP control panel dari menu aplikasi.
Jika Anda menggunakan XAMPP, maka direktori web root terletak di xampp/htdocs. Untuk mulai menginstal SLiMS menggunakan kode sumber, salin file kode sumber SLiMS (seperti yang dijelaskan pada bab sebelumnya) ke dalam direktori tersebut.
Setelah selesai menyalin file, langkah berikutnya adalah mendekompresi (mengekstrak) file sumber. Untuk mengekstrak, Anda dapat menggunakan aplikasi 7zip (atau aplikasi sejenis seperti WinZip dan WinRAR).
Setelah proses ekstraksi selesai, kita dapat memulai proses instalasi SLiMS menggunakan SLiMS Installer.
The Installer (Alat Penginstal)
Seperti versi SLiMS Installer sebelumnya, pada versi ini Anda tidak perlu menentukan database secara manual. Anda hanya perlu memasukkan nama database yang akan digunakan, nama pengguna yang memiliki hak akses (biasanya root atau Anda tentukan sendiri), dan jangan lupa kata sandi yang digunakan untuk mengakses database.
Sebelum melangkah ke tahap berikutnya, mari kita bahas tampilan installer baru pada SLiMS 9 Bulian. Installer baru ini secara fungsional tidak jauh berbeda dengan installer sebelumnya, namun disajikan dengan tampilan yang lebih "segar". Beberapa fungsionalitas installer juga dibuat lebih mudah dipahami bagi pengguna pemula.
Untuk memulai proses instalasi SLiMS, Anda dapat menekan tombol "Get Started". Kemudian Anda akan dibawa ke halaman Persyaratan Sistem (System Requirements).
Halaman ini akan memindai sistem apakah komputer yang Anda gunakan sudah memiliki komponen yang diperlukan. Komponen yang ditandai dengan kata optional merupakan komponen alternatif. Dengan kata lain, jika komponen tersebut tidak tersedia/terinstal, instalasi SLiMS tetap dapat dijalankan. Berbeda halnya dengan komponen yang tidak ditandai dengan kata optional. Komponen yang tidak ditandai tersebut merupakan komponen yang WAJIB terinstal. Tanpa komponen-komponen ini, instalasi SLiMS tidak dapat dilanjutkan. Jika Anda menggunakan aplikasi XAMPP sebagai aplikasi AMP (Apache, MySQL, PHP) yang terpasang di sistem, maka komponen-komponen ini sudah terinstal secara default.
Pada bagian "Pre-Installation Step", pastikan direktori yang ditampilkan di bagian tersebut statusnya sudah berubah menjadi read-write. Kasus ini hanya terjadi pada sistem operasi berbasis Unix atau GNU/Linux. Jika Anda menggunakan sistem operasi MS-Windows, Anda tidak perlu mengubah izin direktori (permissions) pada direktori-direktori tersebut.
Klik tombol "Next" untuk melanjutkan proses instalasi.
Selanjutnya, apakah Anda ingin menginstal baru atau memperbarui (upgrade) versi SLiMS yang Anda gunakan? Silakan klik pada tombol yang Anda inginkan. Tombol "Install SLiMS" berarti Anda akan menginstal SLiMS 9 Bulian baru pada perangkat Anda. Tombol "Upgrade my SLiMS" berarti Anda adalah pengguna SLiMS lama yang ingin memperbarui versi SLiMS Anda ke SLiMS 9 Bulian.
Ketika Anda mengklik tombol "Install SLiMS", Anda akan dibawa ke langkah pertama (dari dua langkah) proses instalasi. Informasi penjelasan:
- Database Host: Secara default, isian di kolom ini tidak perlu diubah, seperti informasi yang tertera di samping segmen tersebut.
- Database Port: Port yang dialokasikan untuk merespons akses database. Untuk MySQL, nomor port default-nya adalah 3306.
- Database Name: Masukkan nama database yang akan dibuat, yang nantinya akan digunakan oleh SLiMS.
- Database Username: Merupakan akun yang digunakan untuk mengakses database. Secara default, akun yang disediakan oleh MySQL / MariaDB adalah
root. Status akun root adalah akun tertinggi yang memiliki akses penuh dan hak terhadap semua database. Berhati-hatilah saat menggunakan akun root ini.
Tip Keamanan
Pada komputer produksi (live/server asli), buatlah akun terpisah untuk setiap database yang dibuat daripada hanya menggunakan akun root saja, di mana akun tersebut hanya diberikan hak atau akses ke database tertentu. Hal ini dilakukan demi keamanan.
- Database Password: Masukkan kata sandi yang digunakan untuk akun yang diisi pada kolom Database Username.
Setelah Anda menyelesaikan semua kredensial, klik tombol "Test Connection" untuk memastikan bahwa kredensial tersebut benar. Jika benar, maka Anda akan melihat tombol seperti gambar berikut:
Lanjutkan dengan mengklik tombol tersebut untuk meneruskan proses instalasi ke langkah kedua.
Penjelasan:
- Generate Sample Data: Ragu atau tidak ingin menambahkan data contoh ke SLiMS Anda? Silakan pilih opsi "No, don't do that!"
- Username: Perhatikan baris "Super User Profiles". Informasi nama pengguna (username) yang akan Anda buat ini adalah pengguna yang memiliki akses ke seluruh sistem. Dapat diubah sesuai keinginan Anda.
- Password: Pada installer versi terdahulu, kolom ini tidak wajib diisi. Installer akan memberikan kata sandi bawaan "admin" jika kolom tersebut dibiarkan kosong. Pada installer baru, kata sandi WAJIB dimasukkan. Tidak boleh dibiarkan kosong.
- Retype Password: Ketik ulang kata kunci yang telah dimasukkan pada kolom sebelumnya di sini.
Setelah mengisi kolom-kolom tersebut, klik tombol "Run the Installation" untuk melanjutkan instalasi. Jika tidak ada masalah, halaman berikut akan muncul:
Dengan munculnya halaman seperti di atas, proses instalasi telah selesai dan Anda dapat menggunakan SLiMS yang telah terinstal dengan mengklik tombol "Go to My SLiMS".
Catatan Penting (Note)
Perhatikan baris yang berbunyi "Folder install in your SLiMS is already exist. For security reason please rename or remove it from your machine". Informasi pada baris ini berfungsi sebagai pengingat bahwa setelah instalasi selesai, jangan lupa untuk menghapus atau mengubah nama (rename) direktori install yang ada di dalam direktori kode sumber SLiMS Anda. Seperti yang ditunjukkan pada gambar berikut.
Setelah mengklik tombol "Go to My SLiMS", Anda akan dibawa ke halaman OPAC SLiMS 9 Bulian.
Portable SLiMS (PSLiMS)
Portable SLiMS (untuk Windows) atau PSLiMS adalah paket perangkat lunak yang terdiri dari aplikasi SLiMS, Apache Web Server, PHP Scripting engine, MySQL atau MariaDB Database Server, dan Adminer Database Management. PSLiMS dirancang untuk mempermudah penggunaan SLiMS. Salin, ekstrak, dan jalankan!
Catatan Penting (Note)
Pada PSLiMS versi satu bersamaan dengan rilis SLiMS 9 Bulian, pustaka (library) YAZ dan MARC yang diperlukan untuk menggunakan fitur salin katalog Z3950 dan ekspor data MARC belum terinstal. Instalasi pustaka-pustaka ini akan dilakukan pada versi PSLiMS berikutnya.
Pembaruan (Update)
Pada rilis PSLiMS terakhir, cara mengaktifkan fitur YAZ dan MARC dapat dibaca pada dokumentasi Tips dan Trik SLiMS melalui tautan https://tinyurl.com/w7jv8bz.
Setelah mengunduh file PSLiMS, salin file tersebut ke dalam direktori utama (root) seperti direktori C:, direktori D:, dan seterusnya. Kemudian, ekstrak file tersebut.
Hasil dari ekstraksi file PSLiMS dicontohkan seperti pada gambar di atas, dengan nama direktori "x86" untuk PSLiMS yang digunakan pada sistem operasi MS-Windows 32bit. Sementara itu, nama direktori "amd64" digunakan untuk sistem operasi dengan arsitektur MS-Windows 64bit.
Di dalam direktori tersebut, untuk mulai menggunakan SLiMS, klik pada nama file "httpd.bat" dan "mariadb.bat". File "httpd.bat" digunakan untuk memulai web server Apache.
Jika Anda melihat pop-up seperti gambar berikut, klik pada tombol "Allow Access" agar aplikasi tersimpan dalam konfigurasi firewall sistem operasi.
Selanjutnya, klik pada file "mariadb.bat" untuk memulai server basis data MariaDB.
Jika Anda melihat pop-up seperti gambar berikut, klik pada tombol "Allow Access" agar aplikasi tersimpan dalam konfigurasi firewall sistem operasi.
Jika kedua file berjalan tanpa menampilkan pesan kesalahan, Anda dapat menggunakan SLiMS dengan membuka browser dan memasukkan alamat localhost:8089 ke dalam kolom alamat (address bar) browser.
Tampilan OPAC dari aplikasi SLiMS akan muncul. Sekarang SLiMS sudah dapat digunakan. Jika Anda ingin menghentikan proses Apache dan MariaDB, masukkan kombinasi tombol CTRL + C pada keyboard di masing-masing jendela Apache dan MariaDB, lalu ketik "Y" untuk "Yes".
PSLiMS dari pembaruan terbaru menggunakan Adminer dan phpMyAdmin sebagai aplikasi manajemen database. Masukkan alamat localhost:8089/adminer.php dan atau localhost:8089/phpmyadmin untuk mengakses aplikasi tersebut. Untuk login, Anda dapat menggunakan nama pengguna akses berbasis aplikasi: slimsuser dan kata sandi: passwordslimsuser untuk masuk ke dashboard. Anda dapat mulai mengelola database yang diperlukan.
Tampilan halaman login Adminer.
Tampilan halaman login phpMyAdmin.
