Panduan konfigurasi
Platform Navixy menawarkan wizard konfigurasi yang dapat digunakan pengguna untuk mengonfigurasi platform pada awalnya atau mengubah beberapa pengaturan umum. Meskipun semua pengaturan yang dijelaskan di bawah ini dapat diterapkan langsung ke konfigurasi basis data dan layanan, melakukannya dapat berisiko jika tidak ditangani dengan hati-hati. Untuk menghindari potensi risiko, sangat disarankan untuk menggunakan configurator.
Menjalankan wizard konfigurasi
Untuk menjalankan wizard, buka direktori /navixy-package dan jalankan ./configure.sh
Anda akan disambut oleh menu utama:
Di bawah ini adalah penjelasan untuk setiap menu dan sub-menu:
1. Pengaturan nama domain dan SSL
1.1. Nama domain
Satu-satunya opsi di sini adalah mengubah nama domain dan SSL.
Configuration Wizard memungkinkan Anda melakukan konfigurasi dengan menggunakan satu nama domain untuk seluruh platform atau dengan tiga nama domain - terpisah untuk API, untuk panel admin dan untuk antarmuka pengguna.
Dalam kasus satu nama domain, Anda hanya perlu menentukan domain untuk layanan Anda pada langkah pertama, biarkan dua domain lainnya kosong. Dalam kasus ini, API dan panel admin akan dikonfigurasi sebagai subdirektori (ini dilakukan secara otomatis). Contoh:
Jika Anda melakukan konfigurasi tiga nama domain , Anda perlu menentukan secara berurutan:
Domain layanan (digunakan untuk antarmuka pengguna dan aktivasi perangkat). Contoh: my.domain.com
Domain API (digunakan untuk semua operasi API). Contoh: api.domain.com
Domain panel admin (digunakan untuk mengakses panel Admin). Contoh: panel.domain.com
Setelah semua domain ditentukan, wizard akan menunjukkan hasil konfigurasi Anda. Jika Anda perlu mengubah sesuatu, jalankan wizard sekali lagi
Anda dapat mempelajari informasi lebih lanjut tentang nama domain di halaman ini: Domains
1.2. Sertifikat SSL
Setelah nama domain dikonfigurasi, Anda akan melihat menu instalasi sertifikat SSL.
Jika Anda memilih Yes, platform Anda akan dikonfigurasi untuk menggunakan HTTPS.
Selanjutnya, skrip akan menanyakan apakah Anda akan menggunakan sertifikat SSL gratis dari Letsencrypt, atau Anda ingin menggunakan sertifikat Anda sendiri.
Let's Encrypt free certificate
Pilih Yes untuk menginstal sertifikat SSL gratis Let's Encrypt untuk domain Anda. Ini juga akan mengatur pembaruan otomatis sertifikat sehingga Anda tidak perlu memperbaruinya secara manual.
Skrip akan menginstal perangkat lunak yang dibutuhkan untuk menerbitkan sertifikat (ini mungkin memerlukan beberapa waktu).
Anda akan diminta untuk menentukan alamat email Anda. Ini tidak wajib tetapi disarankan.
Skrip akan secara otomatis mengenali nama domain (mengambilnya dari konfigurasi), menghasilkan dan menginstal sertifikat. Setelah itu skrip akan berhenti.
Sekarang Anda telah mengonfigurasi nama domain, dan situs web Anda dilindungi oleh SSL.
Sertifikat SSL milik Anda sendiri
Memilih opsi No sebagai jawaban atas pertanyaan tentang sertifikat SSL Let's Encrypt akan membawa Anda ke menu untuk menginstal sertifikat SSL Anda sendiri. Untuk melanjutkan, Anda harus memiliki sertifikat full-chain yang valid serta kunci privatnya. Tempatkan keduanya di suatu lokasi di server Anda. Lokasi standar adalah /etc/nginx/ssl.
Pertama Anda perlu menentukan path ke file sertifikat:
Selanjutnya, tentukan path ke file kunci privat dari sertifikat SSL Anda:
Path ke sertifikat Anda akan dimasukkan ke konfigurasi Nginx.
Sertifikat sekarang terpasang, dan domain Anda terlindungi oleh SSL.
2. Pengaturan SMS
Di sini Anda dapat menerapkan pengaturan SMS-gateway Anda, dan juga menentukan kredensial pengirim SMS layanan.
2.1. Konfigurasi SMS gateway
Opsi pertama dalam menu ini memungkinkan Anda menonaktifkan SMS gateway jika Anda sudah memiliki satu yang terpasang dan tidak lagi perlu menggunakannya.
Opsi lainnya memungkinkan Anda menerapkan pengaturan untuk penyedia layanan SMS gateway tertentu.
Opsi terakhir memungkinkan Anda menghubungkan SMS gateway melalui protokol SMPP. Opsi ini juga cocok jika penyedia gateway Anda tidak ada dalam daftar, tetapi mendukung SMPP di pihak mereka.
Anda dapat mempelajari lebih lanjut tentang SMS gateways di halaman Messaging gateways.
Konfigurasikan 'from name' dan 'sender phone number'
Dalam menu ini Anda dapat menentukan nomor dan nama pengirim pesan SMS layanan, jika perlu.
3. Pengaturan gateway email
Di sini Anda hanya dapat mengonfigurasi pengaturan email feedback. Perlu diperhatikan: Pengaturan utama gateway email dikonfigurasi dari panel admin (Messaging gateways).
Skrip akan meminta Anda menentukan alamat email untuk menerima umpan balik pengguna dari bagian bantuan (alamat email TO).
Kemudian Anda akan ditanya tentang substitusi email pengguna.
Pilih YES untuk menggunakan alamat email pengguna untuk mengirim permintaan umpan balik.
Pilih NO untuk mengganti alamat email pengirim dengan alamat tertentu. Dalam kasus ini, skrip akan meminta Anda menentukan alamat email ini (alamat email FROM).
4. Pengaturan Google Maps API
Di sini Anda dapat menentukan kunci Google Maps API jika Anda tidak membeli paket Premium GIS dari Navixy, tetapi memilih untuk menggunakan kunci yang Anda beli sendiri (GIS)
Pertama, Anda perlu menentukan Google API JavaScript key (diperlukan agar peta tersedia).
Selanjutnya, terapkan Google API server key (diperlukan untuk operasi geocoding).
5. Navixy License Key
Bagian ini berisi dua opsi.
5.1. Ubah license key
Di sini Anda dapat menentukan license key untuk instance On-premise Anda. License key diterapkan selama instalasi awal platform, atau jika hilang atau rusak karena beberapa alasan (biasanya akibat manipulasi pada basis data). License key diterbitkan dan disediakan oleh dukungan teknis.
Setelah memilih opsi ini, Anda akan melihat peringatan bahwa mengubah license key secara ceroboh dapat menyebabkan platform menjadi tidak dapat berfungsi.
Setelah itu Anda perlu menerapkan license key yang Anda terima. Ini adalah kombinasi karakter yang cukup panjang, sehingga bisa cukup sulit untuk dimasukkan secara manual. Anda dapat menempelkan kunci dari clipboard dengan menggunakan kombinasi Shift+Insert Sebagai alternatif, Anda dapat menahan Shift dan menggunakan mouse right click.
Kunci akan dimasukkan ke dalam basis data, dan instance Anda akan memiliki license yang valid.
5.2. Meminta trial key
Opsi ini hanya dapat digunakan untuk mendapatkan trial key satu kali. Kunci berlaku selama 30 hari. Jangan gunakan opsi ini jika Anda sudah memiliki kunci yang valid.
Anda tidak dapat menerbitkan ulang atau memperbarui trial key dengan cara ini.
Anda tidak dapat mengembalikan kunci yang hilang dengan cara ini.
Anda tidak dapat memulihkan license yang dinonaktifkan dengan cara ini.
Setelah masa percobaan Anda berakhir dan Anda ingin melanjutkan penggunaan instance On-premise Anda, silakan hubungi tim customer success kami untuk license key komersial.
6. Pengaturan plugin
Plugin memungkinkan memodifikasi atau mengaktifkan berbagai fungsi platform. Karena configurator dirancang untuk konfigurasi dasar platform, Anda hanya akan menemukan tiga plugin di menu ini.
6.1. Pengaturan kode aktivasi
Di sini Anda dapat mengaktifkan atau menonaktifkan penggunaan kode aktivasi wajib untuk pendaftaran perangkat. Jika opsi "Mandatory" diaktifkan, pengguna tidak akan dapat mendaftarkan perangkat tanpa kode aktivasi.
6.2. Pengaturan logo kustom
Di sini Anda dapat mengatur logo khusus untuk pengguna individual.
Perlu diperhatikan: logo untuk seluruh platform disesuaikan di panel admin.
Wizard konfigurasi akan meminta Anda menentukan user ID (dapat ditemukan di panel admin atau di antarmuka pengguna)
Selanjutnya, Anda perlu menentukan tautan ke logo pengguna. Logo dapat ditempatkan di sumber eksternal, atau secara lokal di server dalam direktori situs web. Logo harus dalam format PNG, ukuran yang direkomendasikan adalah 400x400.
Logo akan diterapkan pada antarmuka pengguna dan pada laporan.
6.3. Pengaturan bagian bantuan
Di sini Anda dapat memilih apakah akan menyembunyikan atau menampilkan bagian bantuan di antarmuka pengguna (ditampilkan secara default). Bagian bantuan mengarah ke situs web Navixy, jadi menonaktifkannya mungkin berguna untuk white labeling.
7. Pengaturan penyimpanan berkas
Bagian ini memungkinkan Anda mengaktifkan dan menonaktifkan penyimpanan berkas.
Ini digunakan untuk menyimpan lampiran berkas dan gambar pada formulir tugas dan pekerjaan pemeliharaan. Direktori default untuk menyimpan berkas adalah /home/java/api-server/files.
Last updated
Was this helpful?