Di dunia akademik dan penelitian, pengelolaan aset digital bukan lagi sekadar pilihan, melainkan keharusan. Institusi pendidikan tinggi dan lembaga riset membutuhkan wadah yang aman, terindeks, dan mudah diakses untuk menyimpan karya ilmiah, tesis, disertasi, hingga data penelitian. Inilah peran vital dari sebuah Institutional Repository.
Salah satu solusi paling populer dan teruji di dunia untuk kebutuhan ini adalah EPrints. Dalam tutorial ini, kita akan membahas secara mendalam apa itu EPrints, fitur unggulannya, hingga panduan teknis langkah demi langkah untuk menginstal EPrints versi 3.4 di atas server Ubuntu 24.04 LTS menggunakan Apache, MySQL, dan pengamanan SSL gratis dari Let’s Encrypt.
Apa itu EPrints?
EPrints adalah perangkat lunak open-source yang dirancang khusus untuk membangun repositori akses terbuka (open access). Dikembangkan oleh School of Electronics and Computer Science di University of Southampton, Inggris, EPrints menjadi standar emas dalam pengelolaan arsip digital.
Secara fundamental, EPrints memungkinkan institusi untuk mengumpulkan, melestarikan, dan menyebarluaskan aset intelektual mereka secara daring. Fleksibilitasnya tidak hanya terbatas pada literatur penelitian; EPrints juga mampu menangani data ilmiah yang kompleks, tesis, laporan, hingga multimedia. Komunitasnya yang besar menjamin keberlanjutan dukungan dan pengembangan fitur yang terus relevan dengan kebutuhan akademik modern.
Fitur Utama EPrints 3.4
Versi 3.4 membawa penyempurnaan signifikan dari pendahulunya, berfokus pada efisiensi sistem dan pengalaman pengguna. Berikut adalah fitur kuncinya:
- Manajemen Workflow yang Fleksibel: Proses deposit, review, hingga publikasi dapat dikustomisasi sesuai kebijakan institusi.
- Pengindeksan Lanjutan: Mendukung OAI-PMH (Open Archives Initiative Protocol for Metadata Harvesting), memastikan konten repositori Anda mudah ditemukan oleh mesin pencari akademik seperti Google Scholar.
- Desain Responsif (v3.4): Antarmuka yang lebih modern dan ramah perangkat seluler dibandingkan versi lama.
- Pratinjau Dokumen: Kemampuan untuk menampilkan preview dokumen secara langsung tanpa harus mengunduh file terlebih dahulu.
- Ekspor Metadata: Mendukung berbagai format bibliografi (BibTeX, EndNote, MODS, dll).
Testimoni Pengguna
Kredibilitas EPrints telah diakui secara global. Ribuan repositori di seluruh dunia menggunakan platform ini.
“EPrints adalah platform yang paling fleksibel untuk repositori institusi kami. Kemampuan kustomisasinya memungkinkan kami menyesuaikan tampilan dan alur kerja sesuai kebutuhan spesifik universitas.” — Pengguna dari komunitas akademik global.
Institusi besar seperti Caltech dan NOAA (National Oceanic and Atmospheric Administration) tercatat menggunakan teknologi ini untuk mengelola arsip data dan publikasi mereka.
Persyaratan Sistem & Persiapan
Sebelum memulai instalasi, pastikan lingkungan server Anda memenuhi kriteria berikut. EPrints 3.4 sangat bergantung pada tumpukan teknologi LAMP (Linux, Apache, MySQL, Perl).
Spesifikasi Server:
- OS: Ubuntu 24.04 LTS (Recommended)
- RAM: Minimal 2GB (4GB disarankan untuk produksi)
- Disk: Sesuai kebutuhan penyimpanan data repositori.
Prasyarat:
- Akses SSH (root/sudo).
- Domain atau subdomain yang sudah diarahkan (A Record) ke IP server (misal: eprints.domain.tld).
Pada panduan ini kita menggunakan Ubuntu 24.04 + Apache + MySQL sesuai rekomendasi resmi.
Langkah 1: Update & Install Dependensi
Langkah pertama adalah memastikan repositori paket Ubuntu diperbarui dan menginstal semua pustaka Perl serta tools pendukung yang dibutuhkan EPrints.
Update sistem:
sudo apt update
sudo apt upgrade -y Install paket dependensi (Perl modules, Apache, tools manipulasi gambar/dokumen):
sudo apt install perl libncurses6 libselinux1 apache2 libapache2-mod-perl2 libxml-libxml-perl \
libunicode-string-perl libterm-readkey-perl libmime-lite-perl libmime-types-perl libdigest-sha-perl \
libdbd-mysql-perl libxml-parser-perl libxml2-dev libxml-twig-perl libarchive-any-perl libjson-perl \
liblwp-protocol-https-perl libtext-unidecode-perl lynx wget ghostscript poppler-utils antiword elinks \
texlive-base texlive-base-bin psutils imagemagick adduser tar gzip unzip libsearch-xapian-perl \
libtex-encode-perl libio-string-perl libcgi-pm-perl libdbd-mysql-perl git xpdf python3-html2text make -y Install MySQL Server:
sudo apt install mysql-server -y Langkah 2: Konfigurasi Database
Kita perlu membuat user khusus di MySQL agar EPrints dapat berkomunikasi dengan database.
Masuk ke konsol MySQL:
sudo mysql Buat user eprints dengan hak akses penuh (Ganti strongpassword dengan password yang aman):
CREATE USER 'eprints'@'localhost' IDENTIFIED by 'strongpassword';
GRANT ALL PRIVILEGES ON *.* TO 'eprints'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;
exit Langkah 3: Membuat System User & Konfigurasi Apache
EPrints sebaiknya dijalankan oleh user sistem tersendiri, bukan root, demi keamanan.
Buat user sistem eprints:
sudo useradd -d /opt/eprints3 -s /bin/bash eprints Siapkan direktori instalasi dan atur hak akses:
sudo mkdir /opt/eprints3
sudo chown eprints:eprints /opt/eprints3
sudo chmod 2775 /opt/eprints3 Penting: Kita harus mengubah user yang menjalankan Apache agar sesuai dengan user EPrints. Edit konfigurasi envvars:
sudo nano /etc/apache2/envvars Cari baris APACHE_RUN_USER dan APACHE_RUN_GROUP, ubah menjadi:
export APACHE_RUN_USER=eprints
export APACHE_RUN_GROUP=eprints Restart Apache untuk menerapkan perubahan user:
sudo systemctl restart apache2 Langkah 4: Download & Instalasi EPrints
Sekarang kita akan mengunduh source code EPrints langsung dari GitHub resmi mereka.
Beralih ke user eprints:
sudo su - eprints Clone repository EPrints ke direktori /opt/eprints3:
git clone https://github.com/eprints/eprints3.4.git /opt/eprints3 Masuk ke direktori dan checkout ke versi stabil 3.4.7:
cd /opt/eprints3
git checkout tags/v3.4.7 Langkah 5: Membuat Repository (Inisialisasi)
Ini adalah inti dari instalasi. Kita akan menggunakan perintah epadmin untuk membuat konfigurasi repositori baru.
Jalankan perintah pembuatan repositori:
bin/epadmin create pub Ikuti panduan interaktif berikut (sesuaikan input dengan data Anda):
- Archive ID: repository
- Configure vital settings? [yes]: Tekan ENTER
- Hostname: eprints.domain.tld (Sesuaikan dengan domain Anda)
- Webserver Port [80]: Tekan ENTER
- Alias: Tekan ENTER (ketik # jika diminta saat selesai)
- Path [/]: Tekan ENTER
- HTTPS Hostname: eprints.domain.tld
- Secure Webserver Port [443]: Tekan ENTER
- Administrator Email: [email protected]
- Archive Name: Nama Kampus Repository
- Organisation Name: Nama Universitas/Institusi
- Write these core settings? [yes]: Tekan ENTER
Konfigurasi Database saat diminta:
- Configure database? [yes]: Tekan ENTER
- Database Name: repository
- MySQL Host [localhost]: Tekan ENTER
- MySQL Port/Socket: Tekan ENTER (default)
- Database User: repository (atau biarkan default)
- Database Password: Masukkan password acak/kuat untuk DB spesifik ini
- Database Engine [InnoDB]: Tekan ENTER
- Write these database settings? [yes]: Tekan ENTER
- Create database “repository”? [yes]: Tekan ENTER
Masukkan kredensial Superuser MySQL yang dibuat di Langkah 2:
- Database Superuser Username: eprints
- Database Superuser Password: Masukkan password ‘strongpassword’ dari Langkah 2
- Create database tables? [yes]: Tekan ENTER
Buat akun Administrator Web EPrints (untuk login ke dashboard nanti):
- Create an initial user? [yes]: Tekan ENTER
- Username: admin
- User type: admin
- Password: Buat password login web
- Email: [email protected]
Finalisasi:
- Jawab [yes] (ENTER) untuk build static web pages, import LOC subjects, dan update apache config files.
Keluar dari user eprints:
Keluar dari user eprints:
exit Langkah 6: Integrasi Apache
Agar Apache mengenali konfigurasi EPrints yang baru dibuat, kita perlu memasukkannya ke konfigurasi global Apache.
Tambahkan include path ke apache2.conf:
echo "Include /opt/eprints3/cfg/apache.conf" | sudo tee -a /etc/apache2/apache2.conf Restart Apache:
sudo systemctl restart apache2 Saat ini, Anda sudah bisa mengakses http://eprints.domain.tld, namun masih menggunakan HTTP.
Langkah 7: Instalasi SSL (HTTPS)
Untuk keamanan data dan kepercayaan pengguna, wajib menggunakan HTTPS. Kita akan menggunakan Certbot (Let’s Encrypt) dan konfigurasi SSL manual yang aman.
Install Certbot:
sudo apt install certbot python3-certbot-apache -y Request sertifikat SSL (Mode certonly karena kita akan konfigurasi manual vhost-nya):
sudo certbot --non-interactive \
-m [email protected] \
--agree-tos \
--no-eff-email \
--apache certonly \
-d eprints.domain.tld Konfigurasi Virtual Host SSL EPrints: Masuk kembali sebagai user eprints:
sudo su - eprints Buat direktori dan file konfigurasi:
mkdir -p /opt/eprints3/archives/repository/ssl
nano /opt/eprints3/archives/repository/ssl/securevhost.conf Masukkan konfigurasi berikut:
<VirtualHost *:443>
ServerName eprints.domain.tld:443
ErrorLog /var/log/apache2/eprints.domain.tld_error.log
TransferLog /var/log/apache2/eprints.domain.tld_access.log
LogLevel warn
SSLEngine on
SSLProtocol all -SSLv2 -SSLv3 -TLSv1 -TLSv1.1
SSLHonorCipherOrder on
SSLCipherSuite ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256
SSLCertificateFile /etc/letsencrypt/live/eprints.domain.tld/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/eprints.domain.tld/privkey.pem
SSLCertificateChainFile /etc/letsencrypt/live/eprints.domain.tld/chain.pem
SetEnvIf User-Agent ".*MSIE.*" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0
CustomLog /var/log/apache2/eprints.domain.tld_access.log \
"%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
Include /opt/eprints3/cfg/apache_ssl/repository.conf
PerlTransHandler +EPrints::Apache::Rewrite
</VirtualHost> Regenerasi konfigurasi Apache EPrints:
/opt/eprints3/bin/generate_apacheconf --system --replace Aktifkan SSL di Apache System.
Keluar ke user sudo (exit), lalu tambahkan konfigurasi SSL EPrints ke Apache global:
echo "Include /opt/eprints3/archives/repository/ssl/securevhost.conf" | sudo tee -a /etc/apache2/apache2.conf Aktifkan modul SSL dan restart layanan:
sudo a2enmod ssl
sudo systemctl restart apache2 SSL telah terinstal, EPrints sudah bisa diakses di https://eprints.domain.tld.
Kesimpulan
Selamat! Anda telah berhasil menginstal EPrints 3.4 di server Ubuntu 24.04 dengan konfigurasi HTTPS yang aman. Repositori Anda kini dapat diakses melalui https://eprints.domain.tld. Langkah selanjutnya adalah login sebagai administrator, melakukan kustomisasi branding (logo dan warna institusi), serta mengatur struktur “Divisions” (Fakultas/Prodi) agar siap digunakan untuk deposit karya ilmiah. Dengan pondasi open source yang kuat ini, institusi Anda kini memiliki kendali penuh atas aset digitalnya.
