Installation AINAV Agent

Instalasi AINAV Agent

Dokumentasi ringkas untuk memahami fungsi AINAV Agent dan cara instalasinya pada server Linux atau Virtual Machine (VM) Anda.

Apa itu AINAV Agent?

AINAV Agent adalah daemon pemantau (lightweight monitoring agent) yang dipasang langsung di dalam sistem operasi server (VPS, Cloud VM, atau server baremetal).

Tugas utamanya adalah mengumpulkan telemetri sistem operasi secara real-time dan mengirimkannya secara aman ke AINAV Cloud Platform ([ainav.id](https://ainav.id)) agar status server Anda dapat dipantau dari satu dasboard terpusat.

Metrik & Fungsi Utama:

Pemantauan Resource Real-Time: Penggunaan CPU, konsumsi memori RAM, kapasitas & I/O disk, serta throughput lalu lintas jaringan.
Sistem Peringatan Dini (Alerting): Mendeteksi indikasi lonjakan beban, risiko kehabisan memori (Out of Memory), dan partisi disk yang mendekati batas penuh.
Eksekusi Tugas Terisolasi: Menerima instruksi automasi tugas terenkripsi langsung dari dashboard AINAV tanpa mengharuskan Anda membuka port SSH ke publik.

System Requirements

Sebelum memasang, pastikan server Anda memenuhi persyaratan minimal berikut:

Sistem Operasi:

Linux 64-bit (`x86_64` / `amd64`)
Ubuntu 20.04 LTS s/d 24.04 LTS
Debian 10 / 11 / 12
AlmaLinux / Rocky Linux / RHEL / CentOS 8 atau 9

Sistem Init: `systemd`

Hak Akses: Akun `root` atau memiliki hak akses `sudo`.

Kebutuhan Resource: RAM minimal 512 MB (alokasi agen hanya ~20 MB), CPU 1 Core (idle < 0.5%), disk kosong ~150 MB.

Jaringan: Akses koneksi keluar (outbound) TCP Port 443 ke internet (tidak memerlukan port masuk / inbound open port sama sekali).

Langkah 1: Dapatkan Agent Token

Masuk ke akun Anda di https://ainav.id.
Buka menu Infrastruktur / Server, lalu klik Tambah Server.
Salin Agent Token yang muncul di layar.

Langkah 2: Instalasi

Langkah 3: Verifikasi Instalasi

Pemecahan Masalah Cepat (Troubleshooting)

Kendala	Kemungkinan Penyebab	Tindakan Solusi
Service `auto-restart` terus menerus	Token agen kosong atau format salah di file konfigurasi.	Periksa token di `/opt/ainav/.env`, lalu simpan dan jalankan `sudo systemctl restart ainav-agent`.
Koneksi Timeout saat install	Firewall server memblokir akses keluar port 443.	Pastikan server dapat mengakses URL rilis dengan perintah `curl -I https://get.ainav.id`.
Perintah `ainav-agent` tidak ditemukan	Shortcut CLI belum terpasang di direktori binary sistem.	Jalankan langsung via path penuh: `/opt/ainav/venv/bin/python3 -m router.main --doctor`.

Uninstall AINAV Agent

Jika ingin menghapus AINAV Agent dari server secara bersih:

“`bash
curl -fsSL https://get.ainav.id/uninstall.sh | sudo bash
“`