Panduan Lengkap: Cara Downgrade atau Mengganti Versi NGINX Unit

by

NGINX Unit adalah server aplikasi yang fleksibel dan mendukung berbagai bahasa pemrograman, seperti PHP, Python, dan lainnya. Namun, terkadang Anda mungkin perlu mengganti atau men-downgrade versi NGINX Unit ke versi sebelumnya karena alasan seperti bug, stabilitas, atau kompatibilitas aplikasi.

Artikel ini akan menjelaskan langkah-langkah untuk melakukan downgrade NGINX Unit dengan aman, seperti yang kita lakukan untuk mengganti dari versi 1.34.0 ke 1.33.0.

Mengapa Melakukan Downgrade?

Ada beberapa alasan untuk melakukan downgrade versi NGINX Unit:

  1. Bug pada Versi Baru: Versi terbaru mungkin memiliki bug yang mengganggu aplikasi Anda.
  2. Ketidakcocokan Konfigurasi: Konfigurasi lama Anda mungkin tidak kompatibel dengan versi terbaru.
  3. Stabilitas: Versi sebelumnya mungkin lebih stabil untuk kebutuhan produksi.

Langkah-Langkah Downgrade NGINX Unit

1. Cek Versi yang Saat Ini Terinstal

Sebelum melakukan downgrade, pastikan Anda mengetahui versi NGINX Unit yang terinstal:

unitd --version

Outputnya akan menunjukkan versi NGINX Unit yang aktif, misalnya:

1.34.0

2. Unduh Paket Versi Lama

Kunjungi repositori resmi NGINX Unit untuk mengunduh paket versi sebelumnya:

Untuk versi 1.33.0, Anda dapat langsung menggunakan perintah berikut untuk mengunduh:

wget https://packages.nginx.org/unit/ubuntu/pool/unit/u/unit/unit_1.33.0-1~noble_amd64.deb
wget https://packages.nginx.org/unit/ubuntu/pool/unit/u/unit-php/unit-php_1.33.0-1~noble_amd64.deb

3. Hapus Versi Saat Ini (Opsional)

Meskipun tidak wajib, Anda dapat menghapus versi NGINX Unit yang ada untuk memastikan instalasi bersih:

sudo apt remove --purge unit unit-php
sudo apt autoremove

4. Instal Paket Versi Lama

Gunakan perintah berikut untuk menginstal paket versi 1.33.0 yang telah diunduh:

Instal NGINX Unit:

sudo dpkg -i unit_1.33.0-1~noble_amd64.deb

Instal Modul PHP untuk Unit:

sudo dpkg -i unit-php_1.33.0-1~noble_amd64.deb

Perbaiki dependensi jika diperlukan:

sudo apt-get install -f

5. Restart Layanan NGINX Unit

Setelah instalasi selesai, restart layanan NGINX Unit untuk memuat modul yang baru:

sudo systemctl restart unit

6. Verifikasi Instalasi

Pastikan NGINX Unit telah menggunakan versi yang Anda inginkan:

unitd --version

Outputnya seharusnya menunjukkan versi 1.33.0.

Periksa Versi unit-php dengan

dpkg -l | grep unit-php

Tips untuk Downgrade yang Aman

Backup Konfigurasi: Sebelum melakukan downgrade, buat cadangan file konfigurasi yang terletak di /var/lib/unit/conf.json:

cp /var/lib/unit/conf.json /path/to/backup/conf.json

Periksa Log Setelah Instalasi: Setelah downgrade, periksa log untuk memastikan tidak ada error:

sudo journalctl -u unit

Kunci Versi agar Tidak Di-update Secara Otomatis: Tambahkan aturan pinning untuk mencegah APT memperbarui versi NGINX Unit secara otomatis:

sudo nano /etc/apt/preferences.d/unit

Isi file:

Package: unit*
Pin: version 1.33.0-1~noble
Pin-Priority: 1001

Kesimpulan

Proses downgrade NGINX Unit dapat dilakukan dengan mudah menggunakan paket .deb versi sebelumnya. Langkah-langkah ini memastikan Anda tetap dapat menjalankan aplikasi dengan stabil tanpa masalah yang disebabkan oleh versi terbaru. Selalu simpan konfigurasi dan lakukan backup sebelum melakukan perubahan besar.

Jika Anda membutuhkan bantuan lebih lanjut, jangan ragu untuk bertanya atau merujuk ke dokumentasi resmi NGINX Unit.