Pembaruan manual - Windows

Halaman ini menjelaskan proses pembaruan manual platform Navixy On-premise di Windows. Gunakan instruksi ini jika Anda perlu memiliki kontrol penuh atas proses pembaruan atau jika Anda menggunakan jalur layanan kustom. Jika tidak, dalam kebanyakan kasus disarankan untuk menggunakan pembaruan otomatis.

Secara umum, pembaruan platform Navixy terdiri dari tiga bagian:

1. Memperbarui basis data.

2. Memperbarui file layanan java.

3. Memperbarui file layanan web.

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.

Pembaruan tidak akan berhasil pada versi MySQL yang lebih rendah dan akan berakhir dengan kesalahan.

Awal pembaruan

Ekstrak paket distribusi platform yang diterima dari Navixy, biasanya itu adalah sebuah .tar.gz file. Anda dapat menggunakan arsip mana pun yang mampu bekerja dengan file tar.gz, misalnya https://www.7-zip.org/. Di dalam arsip yang telah diekstrak Anda akan menemukan direktori "navixy-package", yang berisi semua file platform di dalamnya. Anda dapat memindahkannya ke tempat lain agar jalur instalasi menjadi lebih pendek. Selanjutnya ini akan menjadi direktori utama distribusi. Sebelum pembaruan, sangat disarankan untuk menghentikan layanan java Navixy di menu "Services". Untuk instansi on-premise Windows, tidak ada skrip pembaruan otomatis. Seluruh pembaruan dilakukan secara manual.

Proses pembaruan

Langkah 1: Pembaruan basis data

Buka command prompt dan arahkan ke folder tempat Anda mengekstrak paket distribusi Navixy. Sebagai contoh, jika Anda mengekstrak paket ke folder Downloads Anda, perintah untuk masuk ke direktori db paket mungkin terlihat seperti ini:

cd C:\Users\Administrator\Downloads\navixy-package\db

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 basis data pada langkah berikutnya.

del updates.sql
del google.sql

Pastikan file-file ini terhapus dan kemudian jalankan semua file sql lainnya:

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

Langkah 2: Pembaruan layanan Java

Memperbarui layanan Java melibatkan penggantian file di direktori layanan yang terletak di C:\java, khususnya api-server, sms-server, dan tcp-server.

Untuk memperbarui layanan ini, temukan direktori yang sesuai di dalam navixy-package dan gantilah semua file di folder conf kecuali config.properties dan db.properties.

Sebelum mengganti config.properties file, bandingkan file yang ada dengan yang dari distribusi baru untuk memastikan bahwa setiap parameter baru ditambahkan ke konfigurasi yang ada.

Langkah 3: Pembaruan layanan Web

Lanjutkan ke C:\nginx\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.

Untuk memastikan konfigurasi yang tepat, bandingkan file-file berikut dengan contoh-contoh di paket distribusi:

• panel-v2\Config.js

• pro-ui\PConfig.js

• pro-ui\static\app_config.js

Jika ada parameter baru dalam contoh, tambahkan ke file yang sesuai di instalasi Navixy Anda.

Konfigurasi layanan Windows

Jika Anda meningkatkan ke Java 21 dari versi sebelumnya, Anda perlu menginstal ulang layanan Navixy karena aplikasi wrapper dari versi sebelumnya tidak akan bekerja dengan Java 21. Untuk melakukan ini, ambil folder Wrapper dari paket instalasi dan ikuti langkah yang sama seperti untuk instalasi awal. Baca selengkapnya: Instal di Windows.

File batch akan memperbarui pengaturan layanan yang ada, sehingga tidak perlu menghapusnya sebelumnya.

Langkah akhir

Untuk menyelesaikan proses pembaruan, mulai ulang layanan Java Navixy di menu "Services". Pastikan bahwa layanan berhasil dimulai ulang dan berjalan selama setidaknya satu menit.