Instalasi manual - Windows

Halaman ini menjelaskan proses instalasi manual solusi Navixy On-premise pada Windows. Kami merekomendasikan penggunaan Windows Server 2016 atau yang lebih baru. Jika Anda ingin menginstal platform pada versi Windows lainnya, misalnya versi desktop, Anda masih dapat menerapkan panduan ini, karena prinsip dasar dan perangkat lunaknya sama. Namun, hanya versi server yang dianggap sebagai solusi yang andal.

Instalasi Navixy On-premise sepenuhnya manual untuk Windows disediakan bagi klien yang membutuhkan kontrol penuh atas proses instalasi atau yang memiliki kebutuhan konfigurasi khusus. Secara umum, disarankan untuk melakukan instalasi otomatis pada Linux, karena jauh lebih mudah dan lebih fleksibel tidak hanya untuk instalasi awal, tetapi juga untuk administrasi dan pemeliharaan di masa depan. Instruksi instalasi Windows tersedia untuk pelanggan yang fokus menggunakan OS ini secara eksklusif karena persyaratan korporat atau alasan internal lainnya.

Meskipun platform menggunakan perangkat lunak pihak ketiga yang sama pada Linux dan Windows, perbedaan utama dalam operasinya adalah bagaimana layanan berjalan di Windows:

• Layanan Java dikonversi menjadi layanan Windows menggunakan perangkat lunak YAJSW.

• Nginx bukanlah sebuah layanan tetapi program biasa yang berjalan di latar belakang.

Untuk melakukan instalasi, Anda memerlukan akun Windows dengan hak administrator. Tidak masalah apakah itu akun lokal atau domain karena platform sama sekali tidak terkait dengan infrastruktur domain. Anda hanya memerlukan hak yang cukup untuk menginstalnya.

Instal perangkat lunak prasyarat

Unduh dan instal prasyarat yang dijelaskan dalam Perangkat lunak server dokumen. Pada dasarnya, Anda akan membutuhkan komponen-komponen ini untuk menjalankan platform:

• MySQL 8.0 - hanya Server yang diperlukan, komponen lain bersifat opsional;

  • Microsoft Visual C++ mungkin diperlukan untuk instalasi. Wizard pemasangan akan memberi tahu Anda tentang hal ini.

• Java SE Development Kit 21;

• Nginx - versi terbaru apa pun (tidak perlu instalasi, cukup ekstrak);

Selain komponen dasar, juga disarankan untuk menginstal perangkat lunak berikut agar pekerjaan selanjutnya menjadi lebih mudah:

• Arsipator apa pun yang mampu mengekstrak file tar.gz - misalnya 7-Zip.

• Editor teks lanjutan untuk bekerja dengan konfigurasi dan file log besar - misalnya Notepad++.

Sangat disarankan untuk menginstal perangkat lunak pihak ketiga hanya dari sumber resmi - sebaiknya dari tautan di atas. Jika perangkat lunak diinstal dari sumber yang tidak dapat diandalkan, operasi tidak dijamin.

Konfigurasi MySQL

Setelah menginstal MySQL Server, Anda perlu menerapkan perubahan pada konfigurasinya agar platform Navixy bekerja dengan benar dengan database. Konfigurasi ditentukan dalam my.ini file yang terletak pada jalur berikut:

C:\ProgramData\MySQL\MySQL Server 8.0\my.ini

Dalam file ini Anda perlu mengatur parameter di bawah ini di bawah [mysqld] bagian. Jika parameter sudah ada - ubah sesuai.

default-time-zone='+00:00'
sql-mode="NO_ENGINE_SUBSTITUTION"
innodb_buffer_pool_size=10G

Parameter innodb_buffer_pool_size parameter adalah jumlah RAM yang dialokasikan untuk MySQL. Sangat disarankan untuk mengatur parameter ini menjadi 70% dari total RAM pada server Anda (dalam gigabyte).

Setelah konfigurasi diubah, simpan file dan mulai ulang MySQL dari snap-in Windows Services (services.msc) untuk menerapkan perubahan.

Variabel lingkungan

Java dan MySQL bin folder harus ditentukan di Windows PATH variabel lingkungan sistem. Folder-folder ini adalah (secara default) sebagai berikut:

• C:\Program Files\Java\jdk-21\bin

• C:\Program Files\MySQL\MySQL Server 8.0\bin

Folder instalasi Java juga harus ditambahkan ke JAVA_HOME variabel sistem baru. Ini diperlukan agar layanan backend berfungsi dengan baik

Nama folder dapat berbeda dari versi ke versi, jadi periksa jalur aktual terlebih dahulu.

Anda dapat memperbarui variabel lingkungan dengan perintah berikut dari command line:

setx /m Path "%PATH%;C:\Program Files\Java\jdk-21\bin;C:\Program Files\MySQL\MySQL Server 8.0\bin"
setx /m JAVA_HOME "C:\Program Files\Java\jdk-21"

Ini akan membuat nilai yang diperlukan.

Anda juga dapat memperbarui Path dan JAVA_HOME variabel lingkungan secara manual di properti sistem.

Sebagai hasilnya, Anda harus memiliki hal berikut:

Variabel lingkungan

Setelah variabel disimpan, buka command line dan periksa versi perangkat lunak dengan perintah berikut:

mysql -V
java -version

Jika versi ditampilkan, maka variabel dikonfigurasi dengan benar.

Versi perangkat lunak

Jika Anda melihat kesalahan seperti tidak dikenali sebagai perintah internal atau eksternal, periksa jalur yang Anda tentukan sebelumnya.

Ekstrak platform

Paket distribusi Navixy disediakan sebagai arsip .tar.gz. Versi terbaru selalu tersedia untuk diunduh di tautan berikut:

⬇️ Unduh paket Navixy On-premise

Tempatkan ke folder mana pun di server Anda dan ekstrak.

Paket memiliki banyak folder bersarang, jadi berhati-hatilah agar tidak melebihi batas Windows sebesar 255 simbol pada jalur file.

Tempatkan navixy-package folder dari arsip ke direktori seperti: C:\distrib\navixy-package

Mulai sekarang ini akan menjadi folder utama dari distribusi. Selanjutnya dalam instruksi ini Anda dapat menemukan jalur seperti ...navixy-package/db, yang berarti bahwa operasi harus dilakukan dari folder ini dan subfoldernya.

Setelah mengekstrak platform dan menyiapkan semua prasyarat, Anda siap untuk memulai instalasi platform Navixy.

Database Navixy

Pertama, Anda perlu melakukan konfigurasi database MySQL. Disarankan untuk bekerja dengan MySQL dari command line. Sambungkan ke MySQL sebagai root pengguna dengan kata sandi yang Anda tetapkan selama instalasi MySQL:

mysql -uroot -p

Jalankan blok kueri di bawah ini. Ganti <PASSWORD> dengan kata sandi baru untuk navixy pengguna, ingatlah, Anda akan membutuhkannya nanti.

CREATE USER navixy@'%' IDENTIFIED BY '<PASSWORD>' WITH MAX_QUERIES_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_USER_CONNECTIONS 0;
CREATE DATABASE google CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE DATABASE tracking CHARACTER SET utf8 COLLATE utf8_general_ci;
GRANT USAGE ON *.* to navixy@'%';
GRANT ALL PRIVILEGES ON google.* TO navixy@'%';
GRANT ALL PRIVILEGES ON tracking.* TO navixy@'%';

Ini akan membuat database kosong untuk penggunaan selanjutnya.

Keluar dari MySQL dan kembali ke command line.

Konten database

Ubah direktori di command line ke ...navixy-package\db.

Jalankan perintah berikut untuk mengimpor struktur tabel data bisnis:

mysql -uroot -p google < google.sql

Setelah itu, hapus updates.sql dan google.sql file-file dengan perintah berikut, karena tidak diperlukan pada langkah berikutnya:

del updates.sql
del google.sql

Sekarang impor file yang tersisa ke dalam database menggunakan perintah ini:

type *.sql | mysql -uroot -p google

Server berkas

Sambungkan kembali ke MySQL dan jalankan kueri SQL di bawah ini. Ini akan memungkinkan mengunggah file dari aplikasi seluler dan antarmuka web ke server Anda, yang diperlukan saat bekerja dengan formulir layanan lapangan, pemeliharaan kendaraan dan fitur lainnya. Ubah api.domain.com ke domain API Anda, dan ubah https ke http jika Anda tidak menggunakan SSL.

INSERT INTO google.file_storages (id, engine, config) values (1, 'local_fs', '{"base_path":"./files/","base_upload_url":"https://api.domain.com/file/upload","base_download_url":"https://api.domain.com/file/dl","secret":"s3cCr3Et","upload_credentials_ttl":"10m","is_dynamic_preview_enabled": true,"dynamic_preview_pattern":"(.+)/file/dl/(.+)","dynamic_preview_replace":"$1/file/preview/$2","security_module":{"type":"hashid","salt":"S4lTh45hV4lu3","ttl":"7d","min_length":8}}');

Nilai dari secret dan salt disarankan merupakan hash acak dari huruf dan angka.

Kunci Lisensi

Terakhir, terapkan kunci lisensi (fingerprint), yang harus disediakan oleh Navixy. Itu terlihat seperti string panjang simbol acak.

Masukkan fingerprint ke dalam database dengan kueri di bawah ini. Ganti <FINGERPRINT> dengan nilai yang diterima):

UPDATE google.variables SET value='<FINGERPRINT>' WHERE var='fingerprint';

Fingerprint bersifat dinamis. Ia diperbarui setiap kali server Anda terhubung ke auth.navixy.com server lisensi. Ini terjadi setiap 3 hari dan pada setiap startup layanan. Jadi Anda tidak perlu menyimpannya secara terpisah dari platform karena terus berubah. Juga karena alasan ini Anda tidak dapat menggunakannya pada beberapa instance. Kunci hanya dapat digunakan untuk satu instance Navixy On-premise.

Frontend

Langkah berikutnya adalah menyiapkan frontend platform Navixy On-premise - mengonfigurasi web server Nginx dan file statis antarmuka pengguna.

Create nginx folder di disk C:.

md nginx

Salin distribusi Nginx yang telah diekstrak ke C:\nginx.

Folder Nginx

File statis

Buat folder bernama www di C:\nginx. Salin panel-v2 dan pro-ui folder dari navixy-package ke dalamnya. Ini adalah folder yang berisi file statis situs web Navixy - sesungguhnya, semua konten yang terlihat. Sekarang Anda perlu mengganti nama file konfigurasi:

• Buka \panel-v2 folder dan ubah nama file PConfig.example.sa.js ke PConfig.js.

• Buka \pro-ui dan ubah nama Config.example.sa.js ke Config.js.

• Buka \pro-ui\static dan ubah nama app_config.example.sa.js ke app_config.js.

Dalam semua langkah di atas, cukup hapus .example.sa entri dari nama file. Berhati-hatilah agar tidak membingungkan file dengan nama serupa di folder.

Nginx

Tambahkan baris-baris berikut ke http blok dari C:\nginx\conf\nginx.conf file:

include conf.d/*.conf;
server_names_hash_bucket_size 64;

Salin folder bernama include from ...navixy-package\windows\nginx ke C:\nginx\conf folder.

Buat folder bernama conf.d di C:\nginx\conf. Folder ini akan berisi konfigurasi untuk situs platform.

Salin file-file ini dari ...navixy-package\windows\nginx ke C:\nginx\conf\conf.d folder yang baru dibuat:

• map.conf

• navixy.conf

Jika Anda akan menggunakan proteksi SSL di server Anda, sehingga situs web Anda terbuka melalui HTTPS, juga salin file ini:

• navixy_ssl.conf

Sekarang, konfigurasikan navixy.conf dan navixy_ssl.conf sesuai Konfigurasi Nginx halaman. Ini adalah file konfigurasi utama untuk web server, jadi berhati-hatilah saat mengeditnya.

Untuk mengonfigurasi platform agar bekerja melalui HTTPS, Anda akan memerlukan sertifikat SSL yang sah yang diterbitkan untuk domain Anda, beserta kunci privatnya. Tanpa sertifikat dan kunci privat yang cocok, web server dengan opsi “443 ssl” tidak akan berjalan. Untuk mempelajari lebih lanjut tentang sertifikat SSL dan operasinya pada platform, silakan merujuk ke instalasi sertifikat SSL halaman.

Setelah semua hal di atas selesai - jalankan nginx.exe sebagai administrator. Pastikan ia berjalan di Task manager (biasanya memiliki dua atau lebih proses). Jika berhenti bekerja, periksa C:\nginx\logs\error.log untuk melihat kesalahan dan bertindak sesuai.

Nginx berjalan

Backend

Bagian ini terdiri dari dua langkah: mengonfigurasi layanan Java dan mengonversinya menjadi layanan Windows.

Layanan Java - pra-konfigurasi

Create java folder di disk C:.

md java

Salin folder-folder berikut dari ...navixy-package ke C:\java:

• api-server

• sms-server

• tcp-server

Di masing-masing folder ini, pindahkan conf subfolder dari subdirektori dist ke folder service. Gunakan perintah berikut di command line untuk mempermudah.

move C:\java\api-server\dist\conf C:\java\api-server\
move C:\java\sms-server\dist\conf C:\java\sms-server\
move C:\java\tcp-server\dist\conf C:\java\tcp-server\

Buka setiap dari tiga conf subfolder satu per satu dan temukan db.properties file-file di dalamnya. Ini adalah file untuk mengonfigurasi layanan platform agar terhubung ke database. Untuk memastikan setiap layanan berfungsi dengan benar, Anda perlu memperbarui kredensial koneksi database untuk masing-masing. Edit baris-baris berikut dalam file konfigurasi (<PASSWORD> mengacu pada kata sandi yang sebelumnya Anda buat untuk pengguna "navixy")

db.username=navixy
db.password=<PASSWORD>

Jika database Anda dihosting di server terpisah, Anda juga perlu mengubah db.connectionString baris dalam file yang sama. Tentukan alamat aktual server database Anda menggantikan localhost, tetapi jangan mengubah apa pun lainnya dalam string ini.

Layanan Java - API-server

Buka file C:\java\api-server\conf\config.properties.

Edit baris-baris berikut:

• api.externalBaseUrl= - URL domain API Anda (dengan http:// atau https:// di awal). i

• feedback.toEmail=test@localhost - alamat untuk menerima permintaan umpan balik/bantuan dari pengguna.

• feedback.defaultFromEmail=do-not-reply@localhsot - pengirim default untuk email bantuan.

• feedback.substituteFromEmail=false - mengalihkan apakah pesan bantuan dikirim dari pengirim default (false) atau dari alamat email pribadi pengguna (true).

Jika Anda tidak memiliki domain khusus untuk API, domain dasar Anda ditentukan di sini dengan /api ditambahkan, misalnya: https://my.domain.com/api

Layanan Java - SMS-server

Layanan ini tidak memerlukan konfigurasi dan menggunakan pengaturan default.

Layanan Java - TCP-server

Buka file C:\java\tcp-server\conf\config.properties.

Edit baris-baris berikut:

• externalIP=127.0.0.1 - tentukan alamat IP antarmuka pengguna Anda menggantikan 127.0.0.1.

• externalHostname=myhost.ru - tentukan domain antarmuka pengguna Anda menggantikan myhost.ru.

Pengaturan di atas akan digunakan untuk aktivasi otomatis perangkat.

Layanan Java - konversi menjadi layanan Windows

Pada tahap ini, digunakan perangkat lunak pihak ketiga - yang disebut YAJSW (Yet Another Java Service Wrapper). Ini adalah freeware yang digunakan untuk menjalankan aplikasi Java sebagai layanan Windows. Informasi lebih lanjut dapat ditemukan di halaman web proyek. Perangkat lunak itu sendiri sudah disertakan dalam paket Navixy.

Salin folder bernama wrapper from ...navixy-package\windows ke C:\java.

Jalankan command line sebagai administrator dan ubah direktori ke berikut ini:

cd C:\java\wrapper\bat

Jalankan setenv.bat dari direktori ini di command line.

setenv.bat

Jalankan perintah-perintah berikut, satu per satu:

wrapper.bat -i ../conf/wrapper.api-server.conf
wrapper.bat -i ../conf/wrapper.sms-server.conf
wrapper.bat -i ../conf/wrapper.tcp-server.conf

Ini akan menginstal layanan Java platform sebagai layanan Windows biasa.

Buka berkas "Services" snap-in. Anda dapat mencarinya di menu mulai, atau jalankan saja berikut ini di cmd:

services.msc

Gulir daftar layanan dan temukan layanan Navixy yang baru diinstal. Jalankan mereka satu per satu.

• Navixy api-server

• Navixy sms-server

• Navixy tcp-server

Layanan Windows Navixy

Pastikan bahwa layanan tetap bekerja dari waktu ke waktu - mereka harus memiliki status “Running” secara konstan. Jika ada yang crash, periksa log mereka untuk kemungkinan kesalahan.

Langkah akhir

Mengakses panel Admin

Setelah semuanya diinstal dan dijalankan, Anda perlu memeriksa ketersediaan domain panel Admin Anda di browser. Ketika Anda memasukkannya di bar alamat, Anda harus diarahkan ke halaman login. Jika domain tidak mengarahkan Anda ke halaman yang benar, periksa kembali pengaturan konfigurasi web server Anda untuk memastikan semuanya benar.

Pertimbangkan untuk mengganti kata sandi panel Admin segera setelah Anda masuk ke sistem, karena kredensial bersifat default:

• nama pengguna: admin

• kata sandi: admin

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.