Instalasi otomatis - Windows

Panduan ini menjelaskan instalasi platform Navixy On-Premise menggunakan skrip otomatis. Jenis instalasi ini dirancang untuk server Windows.

Untuk server Linux, silakan gunakan petunjuk yang sesuai.

Prasyarat instalasi

Pertama, Anda perlu memiliki hal-hal berikut sebelum memulai instalasi:

• Sebuah server (atau beberapa server) yang memenuhi semua Perangkat keras server persyaratan. Harap dicatat bahwa server Windows umumnya lebih boros sumber daya, jadi disarankan untuk menyediakan RAM dan sumber daya CPU tambahan.

• Windows Server versi terbaru yang tersedia untuk Anda. Skrip instalasi dikembangkan di Windows Server 2025, tetapi menggunakan Powershell, sehingga dapat diterapkan pada versi OS yang mutakhir.

• Paket perangkat lunak Navixy dan kunci Lisensi yang disediakan oleh tim Navixy.

• Nama domain terdaftar yang akan Anda gunakan untuk instance Navixy Anda.

Jika Anda tidak berencana menggunakan domain terpisah untuk API dan panel admin, konfigurator akan mengonfigurasi akses ke komponen tersebut sebagai subdirektori dari domain dasar.

Proses otomatis ini akan menginstal semua prasyarat perangkat lunak yang tercantum dalam Perangkat lunak server dokumen yang berarti Anda tidak perlu menginstalnya secara manual. Namun, untuk Windows, disarankan menggunakan perangkat lunak pihak ketiga seperti:

• Editor teks lanjutan untuk menangani konfigurasi dan file log berukuran besar (seperti Notepad++).

• Any archiver capable of working with tar.gz archives (such as 7zip). Versi Windows terbaru mampu menangani jenis arsip ini secara native sehingga archiver pihak ketiga mungkin tidak diperlukan.

Seluruh proses instalasi harus dilakukan sebagai administrator.

Konfigurasi jaringan

Tergantung pada pengaturan awal server Anda, mungkin saja port-port yang diperlukan untuk fungsi normal platform belum terbuka. Anda mungkin perlu secara eksplisit membuka port-port ini di firewall Windows.

Ini biasanya mencakup port-port seperti:

• Port HTTP/HTTPS 80 dan 443.

• Port 32233 untuk verifikasi lisensi.

• Port khusus apa pun untuk menghubungkan perangkat pelacak.

• Port 3306 untuk bekerja dengan basis data pada server terdedikasi.

Untuk informasi lebih lanjut, periksa halaman Jaringan dalam petunjuk kami.

Paket Navixy

Paket distribusi Navixy On-premise selalu tersedia untuk diunduh melalui tautan langsung:

⬇️ Unduh paket Navixy

Peramban Anda mungkin memperingatkan bahwa unduhan tidak aman - ini normal untuk arsip tar.gz. Abaikan peringatan dan unduh arsip dengan aman.

Ekstrak arsip yang baru diunduh dan buka folder bernama \navixy-package. Ini akan menjadi folder utama yang digunakan petunjuk ini, dan jalur-jalur berulang akan merujuk padanya kecuali ditentukan secara eksplisit.

Skrip instalasi

Lanjutkan ke \navixy-package\windows folder dan jalankan NavixyInstaller.ps1 skrip dengan Powershell:

Jalankan dengan Posershell

Ini akan memulai proses instalasi, dan Anda akan melihat menu pemilihan jenis instalasi:

Menu Installer

Anda dapat memilih untuk menginstal semua komponen pada satu server atau menyebarkan basis data dan aplikasi pada server terdedikasi.

Langkah selanjutnya akan bergantung pada jenis instalasi yang Anda pilih.

Semua komponen pada satu server

Untuk menyebarkan seluruh platform pada satu server, pilih Install All Components (Full Installation) - ketik nomor yang sesuai 1 dan tekan Enter.

Jika Anda akan menyebarkan basis data pada server terdedikasi terpisah dari aplikasi, lewati bagian ini dan lanjutkan ke Dua server bagian di bawah.

Skrip akan meminta nilai-nilai berikut:

• Kunci Lisensi - masukkan kombinasi karakter yang diterima dari Dukungan Teknis Navixy. Jika Anda tidak memiliki kunci lisensi, hentikan instalasi dan hubungi Account Manager atau Dukungan Teknis Anda.

• Kata sandi database - kata sandi ini akan diberikan kepada pengguna database navixy dan akan digunakan oleh layanan backend untuk mengakses database.

• Domain layanan - domain dasar instance Anda. Akan digunakan oleh klien Anda untuk mengakses layanan pelacakan.

• Domain API (opsional) - jika ditentukan, akan digunakan untuk mengakses API. Jika tidak diperlukan, tekan Enter untuk melewati.

• Domain panel (opsional) - jika ditentukan, akan digunakan untuk mengakses Panel Admin. Jika tidak diperlukan, tekan Enter untuk melewati.

• Konfigurasi SSL - y untuk HTTPS, n untuk HTTP.

• Jalur sertifikat SSL - jalur lengkap ke sertifikat (dalam format crt ) dan kunci privat (dalam format key ) untuk masing-masing domain yang ditentukan. Berkas sertifikat dan kunci privat harus berada di folder mana pun di server.

Windows - AiO

Setelah menentukan parameter yang diperlukan, skrip akan menginstal platform dan semua perangkat lunak yang diperlukan. Di sini Anda perlu menunggu beberapa waktu. Berikut tindakan otomatis yang akan Anda lihat di antarmuka Powershell:

1. Instalasi JDK

2. Unduhan Nginx

3. Instalasi MySQL

4. Konfigurasi MySQL

5. Pemuatan struktur database

6. Konfigurasi situs web

7. Konfigurasi layanan backend

Tidak diperlukan partisipasi aktif dari pihak Anda. Jika skrip menemukan kesalahan, skrip akan memberi tahu Anda.

Pada titik ini, instalasi selesai. Lanjutkan ke bagian Langkah akhir untuk memeriksa operasi platform.

Instalasi dua-server

Bagian ini menjelaskan instalasi platform yang dibagi menjadi dua server - server database terdedikasi dan server aplikasi terdedikasi. Di sini Anda perlu mengekstrak /navixy-package pada kedua server dan mulai dengan menyebarkan database.

Server database

Jalankan NavixyInstaller.ps1 skrip dengan Powershell dan pilih Install Database Only - ketik nomor yang sesuai 2 dan tekan Enter.

Skrip akan meminta nilai-nilai berikut:

• Kunci Lisensi - masukkan kombinasi karakter yang diterima dari Dukungan Teknis Navixy. Jika Anda tidak memiliki kunci lisensi, hentikan instalasi dan hubungi Account Manager atau Dukungan Teknis Anda.

• Kata sandi database - kata sandi ini akan diberikan kepada pengguna database navixy dan akan digunakan oleh layanan backend untuk mengakses database. Simpan kata sandi ini!

Windows - server DB

Setelah menentukan parameter yang diperlukan, skrip akan menginstal MySQL, mengimpor struktur database dan mengisinya dengan nilai default. Tunggu beberapa waktu sampai skrip menyelesaikan operasinya.

Simpan nilai-nilai berikut:

• Alamat IP server

• Kata sandi database

Anda akan memerlukan nilai-nilai ini pada tahap berikutnya.

Server aplikasi

Jalankan NavixyInstaller.ps1 skrip dengan Powershell dan pilih Instal Frontend dan Backend - ketik nomor yang sesuai 3 dan tekan Enter.

Skrip akan meminta nilai-nilai berikut:

• Alamat server database - masukkan alamat IP server database Anda. Ini dapat berupa IP privat atau publik tergantung pada konfigurasi jaringan dan firewall Anda.

• Port database - port default adalah 3306, jadi jika Anda tidak mengubahnya secara sengaja saat menginstal database, Anda dapat melewati langkah ini dengan menekan Enter.

• Kata sandi database - kata sandi ini akan diberikan kepada pengguna database navixy dan akan digunakan oleh layanan backend untuk mengakses database.

• Domain layanan - domain dasar instance Anda. Akan digunakan oleh klien Anda untuk mengakses layanan pelacakan.

• Domain API (opsional) - jika ditentukan, akan digunakan untuk mengakses API. Jika tidak diperlukan, tekan Enter untuk melewati.

• Domain panel (opsional) - jika ditentukan, akan digunakan untuk mengakses Panel Admin. Jika tidak diperlukan, tekan Enter untuk melewati.

• Konfigurasi SSL - y untuk HTTPS, n untuk HTTP.

• Jalur sertifikat SSL - jalur lengkap ke sertifikat (dalam format crt ) dan kunci privat (dalam format key ) untuk masing-masing domain yang ditentukan. Berkas sertifikat dan kunci privat harus berada di folder mana pun di server.

Windows - server Apl

Setelah parameter yang diperlukan ditentukan, skrip akan menginstal platform dan semua perangkat lunak yang diperlukan. Tunggu beberapa waktu sampai skrip menginstal JDK dan Nginx lalu mengonfigurasi aplikasi. Jika skrip menemukan kesalahan, skrip akan memberi tahu Anda.

Pada titik ini, instalasi selesai. Lanjutkan ke bagian Langkah akhir.

Langkah akhir

Setelah skrip menyelesaikan penyebaran aplikasi, jendela Windows Services akan terbuka. Tunggu beberapa menit, segarkan jendela dan periksa status layanan Navixy:

• Navixy api-server

• Navixy sms-server

• Navixy tcp-server

Ketiganya harus aktif (running), seperti pada tangkapan layar di bawah:

Layanan Windows

Jika Navixy tcp-server berhenti, ini biasanya merupakan indikasi kunci lisensi yang salah. Hubungi dukungan teknis Navixy untuk instruksi lebih lanjut.

Akses panel admin

Setelah semuanya terpasang dan layanan berfungsi, Anda perlu memeriksa ketersediaan domain Panel Admin Anda di peramban. Ketika Anda menentukannya di bar alamat, Anda harus diarahkan ke halaman login.

Kredensial login adalah default:

• nama pengguna: admin

• kata sandi: admin

Pertimbangkan untuk mengubah kata sandi Panel Admin segera setelah login demi alasan keamanan.

Mengakses antarmuka pengguna

Agar antarmuka pengguna tersedia, Anda perlu menentukan domainnya terlebih dahulu di Admin panel → Service Preferences, seperti yang dijelaskan dalam dokumen ini: Nama domain.

Jika hal di atas tidak dilakukan, antarmuka pengguna tidak akan dapat dibuka.

Pembaruan

Untuk memperbarui Navixy yang dipasang pada sistem Windows ke versi terbaru, silakan merujuk ke dokumen ini: Update on Windows

Pemecahan masalah

Jika Anda mengalami masalah selama proses instalasi atau konfigurasi, silakan merujuk ke Pemecahan masalah halaman untuk kemungkinan solusi.