Upgrade OJS versi 2 ke OJS vesi 3

Sebelumnya sudah pernah saya share bagaimana cara Instalasi OJS. Nah pada kali ini saya akan share cara upgrade versi OJS 2 ke OJS 3. Karena masih ada beberapa yang menggunakan OJS versi 2, sedangkan OJS3 sudah release sejak lama bahkan sekarang sudah ada rilis minornya yakni versi OJS 3.3.0-12 LTS pada tanggal 20 September 2022. Berikut saya cantumkan link download dari officialnya.

Jika Anda masih belum tau cara install OJS versi 2 maupun 3 bisa mengunjungi artikel saya pada link berikut.

Kenapa harus Upgrade ?

Untuk mendapatkan performa terbaik dari OJS, update versi OJS secara reguler sangat disarankan. Adapun tahapan upgrade OJS ini lumayan kompleks dan diartikel ini akan dijelaskan langkah-langkahnya secara detail. Dengan menggunakan versi OJS yang terbaru, website OJS Anda akan ter-optimized (memaksimalkan performa kinerja OJS), dapat meningkatkan level keamanan dari OJS dan mendapatkan fitur yang lebih banyak dari Public Knowledge Project (PKP).

Pada artikel ini saya membagikan pengalaman saya dimana melakukan upgrade OJS versi 2 ke OJS versi 3.0.12 yang memiliki data jurnal lebih dari 50 jurnal dengan ukuran sekitar 3 GB. Ketika melakukan upgrade versi OJS harus dilakukan dengan hati-hati karena lumayan complicated ya, dibutuhkan minimal keahlian dasar yakni Linux & Database Administrator dan proses upgrade ini memakan waktu yang cukup lama (tergantung besaran data jurnal dan database).

Berikut alasannya kenapa harus Upgrade :

1. Meningkatkan level keamanan data OJS Anda dan mengurangi ancaman kehilangan data dari attacker
2. Anda tidak akan ketinggalan perbaikan Bug dan penambahan fitur OJS yang terbaru
3. Fitur baru yang bisa digunakan pada data jurnal Anda
4. Meningkatkan kepercayaan end-user karena pengelolahan data jurnal yang baik

Apa Benefit Upgrade OJS ?

Pada versi OJS yang terbaru, PKP akan memberikan benefit dengan perbaikan bug dan menambahkan fitur-fitur yang disesuaikan dengan kebutuhan data jurnal.

Detail Fitur OJS 3

Detail beberapa fitur yang dimiliki OJS versi 3 :

1. Desain lebih responsif
2. OJS versi 2 sudah usang dan tidak disupport kembali
3. Pengguna OJS lebih familiar dengan OJS 3
4. OJS versi 3 lebih memiliki banyak manajemen fitur daripada OJS versi 2
5. Lebih didukung plugin pihak ketiga

Penting untuk dicatat :
Sebelum memulai upgrade, pastikan Anda sudah backup data website, jurnal dan database ke device lain (cloud, device lokal, dll) dan dibutuhkan keahlian dalam proses upgrade OJS ini karena bisa menyebabkan data jurnal Anda tidak terbaca dan database corrupt apabila proses upgradenya bermasalah.

Beberapa pertimbangan yang perlu diketahui sebelum upgrade OJS versi 2 ke OJS versi 3 :

1. Tema dan desain template yang dibuat sebelumnya tidak disupport pada versi OJS yang terbaru
2. Beberapa plugin sudah tidak disupport pada OJS 3 ini termasuk Block untuk review dan dataverse
3. Beberapa data tidak dimasukkan pada proses upgrade antara lain :
   • Plugin, karena OJS versi 3 menggunakan sistem update plugin yang berbeda
   • Layout, karena OJS versi 3 tidak support tema versi OJS 2
   • Detail page untuk editorial member
   • Notes, histori email OJS beberapa bagian data log event, default static page.
   • Payment Integration, dll
4. Pop up yang menunjukkan editorial team. Solusinya adalah dengan cara membuat static page atau custom desain.

Bagaimana Cara Upgrade OJS 2 ke OJS 3

Untuk mengupgrade versi OJS 2 ke OJS 3 perlu ada beberapa hal yang perlu dipertimbangkan seperti informasi sebelumnya agar OJS berjalan dengan normal. Karena berdasarkan pengalaman saya sebelumnya waktu upgrade ini cukup susah, ada beberapa error seperti set karakter yang tidak sesuai, storage engine database, database duplicate entry dsb.
Berikut saya ulas langkah-langkah detailnya.

Dislaimer :
Proses upgrade ini dapat dilakukan oleh orang yang berkompetensi minimal Linux SysAdmin dan database administrator :

• Kenalinux ID tidak bertanggung jawab jika terdapat data yang corrupt
• Semua proses upgrade dan hasilnya akan menjadi tanggung jawab Anda sepenuhnya

Persiapan Upgrade OJS

1. Backup data jurnal dan database saat ini, konfigurasi serverblock/virtualhost (jika menggunakan VPS/Dedicated Hosting)
   a. Data OJS
   b. Direktori Public
   c. File database

Catatan :

• Proses upgrade versi OJS dilakukan secara bertahap
• Langkah upgrade versi OJS secara incremental : Incase (2.4.8.5 -> 3.1.2-4 -> 3.2.1-3 -> 3.3.10)

2. Backup data OJS dengan cara compress data public pada OJS versi 2 Anda saat ini beserta dump/backup file databasenya :
   sudo zip /var/www/html/{nama_file_OJS} -d /home/{nama_user}/{nama_file_OJS}.zip
   Contoh :
   sudo zip /var/www/html/ojs -d /home/centos/ojs.zip

Tunggu proses compress filenya selesai.

sudo mysqldump -u root -p {nama_db} > /home/{nama_user}/{nama_db}.sql
Contoh :
sudo mysqldump -u root -p kenalinux_ojs > /home/centos/kenalinux_ojs.sql

Masukkan password user root sql Anda.
Tunggu prosesnya, nanti akan muncul file {nama_db}.sql pada direktori /home/{nama_user}.
Lalu silakan rename nama direktori OJS saat ini agar nantinya tidak konflik nama direktorinya dengan yang OJS versi baru.
sudo mv /var/www/html/ojs /var/www/html/ojs.bak

Proses Upgrade OJS

Selain backup juga disarankan menggunakan server stagging untuk deploy OJS agar tidak mengganggu OJS yang sudah berjalan (production). Jika sebelumnya belum pernah install OJS bisa mengunjungi artikel sebelumnya disini.

3. Metode yang disarankan untuk upgrade OJS ini yakni melalui Command Line Interface (CLI), karena untuk tracing error lebih mudah daripada menggunakan web-based.
4. Download file OJS versi 3 yang terbaru pada link ini, sebelumnya case yang saya handle menggunakan versi OJS 3.0.11. Silakan disesuaikan dengan kebutuhan Anda.
   Esktrak file OJS versi 3 tersebut ke direktori website Anda, misalnya di /var/www/public/html :

sudo tar -xzvf {file_OJS3}.tar-gz -C /var/www/html
Ubah nama direktori file OJS tersebut menjadi lebih sederhana yakni "ojs" saja :

sudo mv {file_ojs} ojs

5. Masuk ke dalam direktori "ojs" tersebut dan buka file config.inc.php menggunakan teks editor favorit Anda misal vim, nano, dll.
   sudo vim config.inc.php
   Ubah driver mysql menjadi mysqli seperti berikut :

Replace direktori public data OJS sebelumnya ke direktori OJS saat ini.
sudo rm -rf /var/www/htm/ojs/public
sudo rsync -avz /var/www/html/ojs.bak/public /var/www/html/ojs/

Tunggu proses copy selesai.

6. Pastikan Anda berada pada direktori OJS dan jalankan perintah :
   sudo php tools/upgrade.php upgrade

Tunggu proses upgradenya hingga selesai tergantung dari ukuran file database dan OJS Anda sebelumnya, estimasi kurang lebih sekitar 15 menit. Berikut tampilan jika proses upgrade OJS telah selesai.

Berikut hasil evidence OJS 2 yang saya migrate ke OJS 3 :

Verifikasi Hasil Upgrade OJS

Selanjutnya Anda bisa melakukan verifikasi OJS yang terbaru mulai dari tampilan, login, administrasi, submission, data jurnal, dsb.
Jika sudah normal semua, Anda bisa replicate vm stagging ke vm production OJS.

Kesimpulan

Banyak benefit yang disupport pada OJS versi 3 ini, mulai dari fitur perbaikan bug sampai perbaikan level keamanan, selain itu pengguna juga lebih terbiasa dengan desain OJS 3. Oleh karena itu bagi Anda yang masih menggunakan OJS versi 2 disarankan untuk upgrade ke OJS versi 3. Butuh keahlian/kompetensi minimal Linux Sysadmin dan Database Administrator untuk melakukan upgrade OJS ini, jika Anda tidak memiliki basic tersebut nantinya akan kesulitan dalam melakukan troubleshootnya.

Oleh karena itu, jika Anda membutuhkan bantuan untuk melakukan upgrade versi OJS atau migrate data-data OJS dari shared hosting misalnya ke dedicated hosting/ VPS bisa menghubungi kenalinux ID melalui menu kontak menu berikut.

Semoga bermanfaat dan barokah 🙂