Tutorial Lengkap Instalasi EPrints 3.4 pada Ubuntu 20.04 LTS + SSL

EPrints adalah repositori yang dirancang untuk menyimpan hasil penelitian, dengan tujuan agar hasil penelitian tersebut dapat ditemukan dengan mudah dan dijadikan referensi dimasa yang akan datang. EPrints dapat memanajemen semua objek digital hasil penelitian, mulai dari PDF hingga kumpulan data (datasets).

 

Universitas atau perguruan tinggi biasanya memiliki EPrints yang mereka kelola secara mandiri. Dengan tujuan untuk mengarsipkan skripsi, hasil riset, paper mahasiswa, dan sebagainya.

Instalasi EPrints itu gampang-gampang susah, agak tricky dan tutorial tentang instalasi EPrints yang tersedia di internet yang selama ini admin temukan masih kurang mudah untuk dimengerti. Oleh karena itulah, dalam kesempatan kali ini admin akan sharing sedikit tentang Tutorial Lengkap Instalasi EPrints 3.4 pada Ubuntu 20.04.

Persiapan Instalasi EPrints di Ubuntu 20.04

“Bahan-bahan” yang harus disiapkan sebelum mengikuti tutorial ini adalah sebagai berikut:

  • VPS atau dedicated yang fresh install Linux Ubuntu 20.04 (pilih yang versi LTS terakhir) dan memiliki dedicated IPv4 address
  • Fully Qualified Domain Name (FQDN) yang A record-nya sudah ter-pointing ke IPv4 address milik VPS (dalam tutorial ini kita akan gunakan hostname repository.fazar.net)
  • Kopi atau teh untuk disruput 🙂

EPrints bisa diinstal pada VPS dengan spesifikasi minimal 1 GB, 1 vCPU, dan storage dengan kapasitas 20 GB. Saran admin, ada baiknya sobat juga mempertimbangkan kualitas VPS hosting yang akan digunakan. Provider rekomendasi admin adalah Vultr atau IDCloudhost.

Tutorial Lengkap Instalasi EPrints 3.4 pada Ubuntu 20.04

Asumsi saya, seluruh perintah SSH pada tutorial ini dijalankan dengan akses root, sehingga tidak membutuhkan sudo. Namun jika sobat login sebagai user dengan akses terbatas, mungkin sobat perlu menambahkan sudo pada setiap perintah yang akan dimasukkan.

Instalasi EPrints

Lakukan upgrade semua packages yang ada

Jika terdapat upgrade untuk kernel, maka sebaiknya sobat reboot dulu VPS yang sobat gunakan.

Tambahkan repo EPrints

Lakukan instalasi EPrints versi 3.4.4

Setelah EPrints berhasil terinstal, maka akan muncul pesan seperti ini

Langkah selanjutnya adalah lakukan download flavoured repository

Sampai disini instalasi EPrints 3.4.4 sudah selesai. Namun belum dapat digunakan karena belum dikonfigurasi.

Pengaturan Database Umum

EPrints menggunakan database mySQL dan disini kita harus menambahkan password mySQL untuk user root karena secara default, user root tidak memiliki password. Silakan masukkan perintah berikut ini secara berurutan (jangan lupa mengganti password sesuai keinginan sobat sendiri!)

Konfigurasi EPrint di Ubuntu 20.04

Note: Jika sobat melihat <ENTER> maka yang dimaksud adalah silakan tekan tombol enter pada keyboard.

EPrints akan berjalan dengan user eprints. Oleh karena itu, kita perlu merubah user dari root menjadi eprints.

Buat repository baru dengan memasukkan perintah berikut ini:

Sobat akan diminta memasukkan repoid. Silakan masukkan identitas repository yang sobat inginkan. Dalam contoh ini kita menggunakan nama myrepo.

Selanjutnya, kita akan membuat vital settings, pencet saja enter.

Tentukan hostname yang akan digunakan. Dalam contoh ini kita menggunakan repository.fazar.net

Sobat akan diminta untuk memasukkan pengaturan webserver. Kita akan menggunakan pengaturan default saja. Pada saat diminta email, masukkan alamat email sobat.

Masukkan nama repository dan organisasi

Pengaturan database untuk EPrints

Selanjutnya sobat akan diminta untuk menambahkan user pertama repository. Silakan tambahkan user dengan akses admin.

EPrints akan menanyakan apakah sobat akan dibuatkan halaman-halaman web repository.

Terakhir, EPrints akan menambahkan konfigurasi untuk Apache Webserver

Saat ini seharusnya EPrints sudah terkonfigurasi dengan benar. Silakan ketikkan perintah exit untuk keluar dari user eprints.

Penyesuaian Konfigurasi Apache

Jika sobat mengakses alamat repository lewat browser, dalam hal ini http://repository.fazar.net maka sobat hanya akan melihat halaman default dari Apache. Oleh sebab itu, sobat harus mengganti ServerName default Apache menjadi IPv4 address.

Ubah bagian #ServerName www.example.com menjadi ServerName <IPv4 address>, misalnya ServerName 107.xxx.xxx.xxx

Selanjutnya tambahkan vhost untuk EPrints dan reload Apache.

Instalasi EPrints telah selesai, dan seharusnya EPrints sobat sudah dapat diakses dengan menggunakan hostname yang telah ditentukan. Yay, berhasil! Silakan sobat sruput dulu kopi atau teh yang sudah disediakan.

tutorial lengkap instalasi eprints 3 4 pada ubuntu 20 04 a
Repository non-HTTPS

Aktivasi HTTPS pada EPrint 3.4

Sebelumnya kita sudah berhasil melakukan instalasi EPrint 3.4.4 dengan mulus. Namun, web EPrints hanya bisa diakses melalui HTTP – sebuah protokol yang sudah mulai usang dan ditinggalkan karena tidak aman.

Google sendiri lebih mengutamakan hasil pencarian pada website-website yang sudah mendukung protokol HTTPS. Oleh karena itulah, penting untuk memiliki instalasi EPrint yang juga mendukung HTTPS.

Aktivasi Module Apache2

Sobat wajib untuk mengaktifkan 2 module Apache yang dibutuhkan untuk konfigurasi HTTPS, yaitu module ssl dan headers. Module ssl digunakan Apache untuk handling sertifikat SSL, sedangkan module headers digunakan untuk mengaktifkan HSTS (HTTP Strict Transport Security).

Instalasi certbot

Certbot merupakan skrip yang mempermudah proses aktivasi dan penerbitan SSL gratisan. Meskipun gratis, tapi kualitas dari sertifikat keluaran LetsEncrypt sudah cukup canggih dan tidak diragukan. Selain itu, certbot juga mampu memperbarui sertifikat SSL secara otomatis.

Untuk menginstal certbot pada Ubuntu 20.04, silakan ikuti prosedur berikut ini!

Hapus instalasi certbot (jika ada) dan instal snapd

Install snap core dan pastikan terupgrade ke versi terakhir

Install certbot dengan menggunakan snap

Buat softlink certbot, sehingga certbot bisa dijalankan dengan lebih mudah

Instalasi sertifikat SSL pada EPrints

Buat file baru yang mengizinkan akses acme challenge pada EPrints

Pastekan script berikut ini, kemudian save!

Rubah ownership dan permission file tersebut agar dapat dieksekusi oleh EPrints

Selanjutnya, mari kita coba untuk menerbitkan sertifikat SSL dengan certbot

Maka akan muncul prompt registrasi certbot dan opsi memilih vhost yang telah diaktifkan

Jika certbot berhasil menerbitkan sertifikat SSL maka akan muncul pesan seperti ini

Catat path CERTIFICATE dan KEY pada notepad atau sejenisnya! Selanjutnya kita akan switch user ke eprints lagi dan melakukan konfigurasi.

Buat file baru dengan nama ssl.conf

Isikan dengan konfigurasi berikut ini (sesuaikan dengan hostname dan repoid yang telah sobat tentukan sebelumnya)

Oke, selanjutnya tambahkan file baru (sesuaikan lagi repoid nya, ya gaes!)

Isi dengan baris-baris berikut ini

Kemudian generate konfigurasi Apache baru

Kemudian switch user kembali menjadi root dengan mengetikkan exit. Silakan sruput minum lagi, bossque!

Edit konfigurasi Apache untuk EPrints.

Kemudian ubah isinya seperti ini (perhatikan kembali repoid nya, ya!)

Karena banyak konfigurasi yang diutak-atik maka sebaiknya kita cek dulu konfigurasi Apache yang telah dibuat.

Pastikan muncul tulisan “Syntax OK”. Jika ada error, silakan koreksi error-nya dulu. Dan, setelah semuanya beres, kita lakukan langkah terakhir, yaitu restart Apache2.

Silakan akses halaman HTTPS dari repository yang telah sobat buat!

tutorial lengkap instalasi eprints 3 4 pada ubuntu 20 04 b
Yay! Repository EPrints dengan HTTPS

Bagaimana dengan skor SSL-nya? Well, seharusnya sih A+ dengan konfigurasi yang telah dibuat diatas.

tutorial lengkap instalasi eprints 3 4 pada ubuntu 20 04 c 1
Keren, sob! Skor SSL-nya A+

Cara Memperbaiki Masalah Error Mixed Contents Pada EPrints

Ada beberapa pertanyaan dari pengunjung web ini dan rekan-rekan yang menemukan kendala munculnya error mixed contents pada EPrints yang telah berhasil di upgrade dari yang hanya support HTTP menjadi HTTPS. Hal ini juga terjadi saat saya menerapkan konfigurasi SSL pada EPrints pada salah satu repository kampus, namun berhasil ditangani dengan beberapa konfigurasi tambahan

Untuk dicatat, bahwa prosedur untuk memperbaiki error mixed contents pada EPrints yang saya informasikan dibawah ini kompatibel dengan EPrints 3.3.16 (Gelato Blizzard). Mungkin prosedurnya berbeda pada versi EPrints yang Anda gunakan. Use with your own risk, dan jangan lupa melakukan backup repository terlebih dahulu.

Untuk memperbaiki masalah error mixed contents EPrints versi 3.3.16, langkah pertama adalah dengan merubah default scheme yang digunakan oleh EPrints dari HTTP menjadi HTTPS. Caranya adalah dengan menyesuaikan file lib/cfg.d/20_baseurls.pl menjadi seperti dibawah ini:

Dan sesuaikan juga pada bagian bawahnya

Selanjutnya, lakukan pemeriksaan konfigurasi dan scripts EPrints dengan mengetikkan perintah

Jika tidak ada masalah, maka silakan lanjutkan dengan merestart Apache, melakukan “epadmin refresh_views”, “epadmin refresh_abstracts” dan “generate_static”

Setelah “generate_static” selesai dilakukan, silakan sobat memeriksa kembali halaman repository untuk memastikan semua link sudah menggunakan HTTPS. Jika ada masih ada yang menggunakan HTTP, silakan sobat cek file archives/<repoid>/cfg/lang/en/static/index.xpage karena kemungkinan link tersebut hardcoded disini. Setelah selesai melakukan peribahan index.xpage lanujutkan kembali dengan melakukan “generate_static”

Closing

Oke demikian Tutorial Lengkap Instalasi EPrints 3.4 pada Ubuntu 20.04 plus HTTPS dengan skor A+ komplit! Semoga bisa bermanfaat untuk sobat semuanya. Ingin menambahkan atau ingin bertanya? Silakan tinggalkan komentar dibawah ini.

 

Sumber : https://fazar.net/tutorial-lengkap-instalasi-eprints-3-4-pada-ubuntu-20-04/

Leave a Comment