Pembaruan otomatis - Linux

Proses pembaruan platform Navixy umumnya terdiri dari tiga bagian: memperbarui database, memperbarui berkas layanan Java, dan memperbarui berkas layanan web. Penting untuk mengikuti instruksi pembaruan dengan cermat dan memastikan bahwa setiap bagian pembaruan selesai dengan sukses, dan tidak ada kesalahan yang terjadi sepanjang proses.

Jika terjadi kesalahan atau kesulitan lain selama proses pembaruan, silakan hubungi dukungan teknis Navixy segera. Pembaruan yang dimulai namun tidak lengkap dapat menyebabkan platform berfungsi tidak benar atau menjadi tidak tersedia.

Pemeriksaan prasyarat

Sebelum menginstal, harap pastikan bahwa sistem Anda memenuhi persyaratan prasyarat berikut:

1. Java Development Kit 21 Mulai Maret 2025, platform tidak lagi mendukung versi 17 dan yang lebih lama.

2. MySQL 8.0 Mulai Maret 2024, platform tidak lagi mendukung MySQL 5.7. Versi ini telah mencapai EOL dan tidak lagi didukung.

Ketidakpatuhan terhadap perangkat lunak yang diperlukan akan mengakibatkan versi baru platform tidak dapat dijalankan. Namun, pembaruan prasyarat terlebih dahulu akan menjaga platform agar tetap fungsional.

Awal pembaruan

Ekstrak paket distribusi platform yang diterima dari Navixy, biasanya itu adalah sebuah .tar.gz file.

tar -zxvf $PACKAGENAME

(di mana $PACKAGENAME adalah nama tar.gz file)

Itu akan diekstrak ke /navixy-package direktori, yang berisi semua berkas platform di dalamnya. Selanjutnya ini akan menjadi direktori utama distribusi.

Pembaruan otomatis

Untuk instance yang dihosting pada server Linux, tersedia solusi pembaruan otomatis. Sangat disarankan untuk menggunakan update.sh skrip. Skrip ini melakukan pembaruan langkah demi langkah pada database dan berkas aplikasi, dan Anda tidak perlu melakukan operasi internal secara manual.

Jalankan update.sh skrip dari direktori /navixy-package Jika platform Anda dihosting pada dua server, jalankan skrip pada server aplikasi (tempat layanan Java berjalan).

root@server:/home/navixy-package# ./update.sh

Skrip akan dimulai dengan pembaruan database. Jika database berada pada server terpisah, skrip akan mengambil data koneksi dari konfigurasi layanan Java.

Setelah pembaruan database (yang mungkin membutuhkan waktu), skrip akan memperbarui berkas sistem platform.

Jika instance Anda belum diperbarui untuk beberapa waktu, Anda mungkin melihat pesan berikut selama pembaruan: It seems Navixy services is not under systemd control. Do you want to create systemd services (runit services will be removed)? (y/n) Disarankan agar Anda menjawab ya. Intinya adalah kami menghentikan penggunaan metode runit dalam memulai layanan, dan sekarang menggunakan systemd untuk tujuan ini. Skrip akan melakukan semuanya untuk Anda. Namun, jika Anda menjawab tidak karena suatu alasan, hal itu tidak akan merusak sistem, dan runit akan terus berfungsi. Anda dapat beralih ke systemd pada pembaruan berikutnya.

Pembaruan Database (opsional)

Anda dapat melakukan pembaruan database secara terpisah dari bagian platform lainnya jika diperlukan. Untuk melakukan ini, jalankan update-db.sh skrip dari direktori /navixy-package dari direktori. Ini dapat dilakukan baik di server database (localhost) atau dari server lain, dengan menentukan alamat host. Setelah menjalankan skrip, Anda akan melihat dialog berikut:

Enter mysql host [localhost]:
Enter mysql port [3306]:
Enter mysql user name [root]:
Updating Navixy db..
Enter password:

Parameter default ditampilkan dalam tanda kurung siku. Jika parameter tersebut sama dengan yang sebenarnya (pembaruan dilakukan di dalam server database), Anda tidak perlu memasukkan apa pun - cukup tekan Enter. Jika Anda ingin menentukan host yang berbeda, port kustom, atau pengguna yang berbeda, isi parameter yang sesuai.

Jika ada yang tidak berfungsi dengan baik setelah pembaruan, coba mulai ulang layanan platform menggunakan restart-navixy skrip. Selain itu, bersihkan data browser Anda, atau periksa masalah dalam mode incognito.

---

Pembaruan manual

Pembaruan otomatis untuk platform yang dideploy di Linux adalah solusi yang telah terbukti bekerja dan sangat disarankan untuk digunakan. Oleh karena itu, informasi berikut hanya untuk referensi Anda, dan untuk kasus instalasi non-standar khusus.

Pembaruan Database

Buka navixy-package/db direktori dan jalankan updates.sql file dengan perintah berikut:

mysql -uroot -p$ROOTPASSWORD google < updates.sql

(di mana $ROOTPASSWORD adalah kata sandi root MySQL)

Hapus updates.sql dan google.sql dari folder db.

Ini harus dilakukan agar tidak menimpa database pada langkah berikutnya.

rm updates.sql
rm google.sql

Pastikan berkas-berkas ini dihapus, dan kemudian jalankan semua berkas sql lainnya.

cat *.sql | mysql -uroot -p$ROOTPASSWORD google

Pembaruan layanan Java

Memperbarui layanan Java pada dasarnya berarti mengganti berkas-berkas di direktori layanan di bawah /home/java. Direktori-direktori ini adalah:

• api-server

• sms-server

• tcp-server

Temukan direktori yang sesuai di navixy-package. Anda perlu mengganti semua berkas kecuali config.properties dan db.properties di folder conf Bandingkan berkas config.properties yang ada dengan yang dari distribusi baru. Jika Anda melihat parameter baru - tambahkan ke konfigurasi yang ada.

Pembaruan layanan Web

Lanjutkan ke /var/www direktori. Gantikan semua file di panel-v2 dan pro-ui direktori dengan file dari direktori yang sesuai di paket distribusi. Ini tidak akan merusak pengaturan apa pun, karena file konfigurasi dalam paket dinamai sebagai contoh, dan tidak akan menimpa file yang sudah ada.

Bandingkan berkas-berkas ini:

• panel-v2/Config.js,

• pro-ui/PConfig.js

• pro-ui/static/app_config.js

dengan contoh-contoh dalam paket distribusi.

Jika Anda melihat parameter baru, tambahkan.

Langkah akhir

Mulai ulang layanan Java Navixy. Biasanya ini dilakukan dengan perintah ini:

restart-navixy

Verifikasi bahwa layanan telah berhasil dimulai ulang dan berjalan setidaknya selama satu menit. Ini menunjukkan bahwa proses pembaruan telah selesai.