Lewati ke konten

Instal MKController Agent di MikroTik

Ringkasan MKController Agent adalah aplikasi desktop ringan yang memindai jaringan lokal Anda, menemukan perangkat MikroTik, dan memungkinkan Anda mengadopsinya ke MKController hanya dengan satu klik — menggantikan eksekusi skrip manual untuk penerapan di lokasi. Panduan ini menjelaskan fungsi agent, cara menginstalnya di Windows, macOS, dan Linux, serta cara menangani peringatan sertifikat yang muncul saat instalasi.

Apa Itu MKController Agent?

MKController Agent adalah aplikasi desktop ringan yang menjembatani jaringan lokal Anda dengan platform cloud MKController. Aplikasi ini berjalan di komputer Anda, memindai LAN untuk menemukan perangkat MikroTik yang kompatibel, lalu menampilkannya dalam alur adopsi platform dengan tombol Adopt satu klik — sehingga Anda tidak perlu menyalin dan menjalankan skrip adopsi secara manual di setiap perangkat.

Bagi tim yang sudah familiar dengan UniFi Device Discovery Tool atau alat serupa dari vendor lain, alur kerjanya sangat mirip: proses lokal menangani penemuan, sementara platform cloud menangani manajemen.

Perbedaan utama: penemuan dan adopsi adalah dua tindakan terpisah. Agent menemukan perangkat yang memenuhi syarat dan menampilkannya kepada Anda — ia tidak secara otomatis mengadopsi atau mengubah apa pun. Setiap adopsi memerlukan konfirmasi eksplisit dari Anda.

Kapan Sebaiknya Menggunakan Agent vs. Metode Manual?

SkenarioMetode yang direkomendasikan
Penerapan pertama di lokasi baru dengan beberapa perangkatAgent — menemukan semua perangkat yang kompatibel sekaligus
Adopsi jarak jauh perangkat yang sudah onlineSkrip manual via WebFig, Winbox, atau SSH
Persiapan lab sebelum pengiriman ke lokasi klienAgent
Satu perangkat, teknisi sudah memiliki akses CLISkrip manual
Kunjungan rutin ke lokasi pelangganAgent mempercepat proses onboarding berulang

Di Mana Agent Muncul di MKController?

Pada akun baru tanpa perangkat, MKController menyorot dua jalur orientasi: instal agent atau gunakan skrip manual.

Halaman daftar perangkat MKController yang menampilkan tombol Adoption Assistant dan opsi skrip manual untuk pengguna baru

Pada akun yang sudah memiliki perangkat, menu Tambah Perangkat menyertakan opsi Adoption Assistant.

Menu Tambah Perangkat MKController yang menampilkan opsi Adoption Assistant untuk menambahkan perangkat baru ke akun yang sudah ada

Indikator status di sudut kiri bawah platform menunjukkan apakah agent sedang Aktif (hijau), Menunggu, atau Tidak Aktif — sehingga Anda selalu tahu apakah aplikasi desktop siap untuk memindai.

Bagaimana Cara Menginstal dan Menghubungkan Agent?

Alur instalasi terdiri dari tiga langkah: unduh, pasangkan, konfirmasi.

Layar instalasi agent terpandu MKController yang menampilkan tiga langkah: unduh, salin kode, dan tunggu koneksi
  1. Klik Unduh Agent di MKController.
  2. Jalankan penginstal yang diunduh di komputer Anda.
  3. Salin kode pairing yang ditampilkan di platform.
  4. Tempelkan kode tersebut ke aplikasi desktop.
  5. Tunggu hingga platform mengonfirmasi koneksi — tidak diperlukan konfigurasi manual.
Agent desktop MKController meminta kode keamanan untuk menghubungkan agent lokal ke akun MKController

Setelah kode dimasukkan, koneksi terbentuk secara otomatis. Tidak ada aturan penemuan, tidak ada perintah terminal, tidak ada pengecualian firewall yang diperlukan.

Agent desktop MKController berjalan dan sudah masuk, menampilkan pengguna yang login di komputer lokal

Mengapa OS Menampilkan Peringatan Sertifikat?

Sertifikat MKController saat ini sedang dalam proses persetujuan. Selama periode ini, Windows, macOS, dan Linux mungkin menampilkan peringatan keamanan saat Anda menjalankan penginstal. Ini adalah perilaku yang diharapkan untuk perangkat lunak yang baru didistribusikan sambil menunggu persetujuan sertifikat — bukan indikasi bahwa agent tidak aman.

Windows: Jika sistem menampilkan peringatan aplikasi terproteksi, klik Informasi selengkapnya dan izinkan instalasi. Lingkungan perusahaan mungkin memerlukan persetujuan satu kali dari administrator TI.

macOS: Jika macOS memblokir penginstal, buka Pengaturan Sistem → Privasi & Keamanan, gulir ke bawah, dan setujui aplikasi yang diblokir. Kemudian jalankan ulang penginstal.

Linux: Pastikan file yang diunduh memiliki izin eksekusi. Di lingkungan terbatas, administrator Anda mungkin perlu menyetujui sumber paket.

Bagaimana Cara Memastikan Agent Sudah Online?

Saat agent terinstal dan berjalan, MKController menampilkan statusnya sebagai Aktif dengan warna hijau di sudut kiri bawah platform.

Dasbor MKController dengan status agent ditampilkan sebagai Aktif dalam warna hijau, mengonfirmasi bahwa aplikasi desktop terhubung

Pada titik ini, Adoption Assistant dapat memindai jaringan Anda dan menampilkan perangkat yang dapat ditemukan.

Bagaimana Cara Memindai dan Mengadopsi Perangkat?

Dengan agent online, MKController memindai jaringan lokal dan menampilkan perangkat yang kompatibel dengan tombol Adopt di sebelah masing-masing.

Adoption Assistant MKController sedang memindai jaringan dan menampilkan perangkat yang ditemukan dengan tombol Ignore dan Adopt

Beberapa catatan praktis:

  • Pemindaian menjangkau perangkat di jaringan tempat komputer agent berjalan.
  • Perangkat harus dapat diakses pada segmen jaringan tersebut.
  • Koneksi internet tetap diperlukan, karena alur kerja adopsi dikoordinasikan oleh platform MKController.

Setelah adopsi, perangkat dapat dipindahkan secara fisik ke jaringan mana pun yang memiliki akses internet dan tetap dapat dikelola melalui MKController.

Apa yang Terjadi Saat Agent Offline?

Jika aplikasi desktop berhenti berjalan atau kehilangan akses internet, MKController menampilkan statusnya sebagai offline dan menyediakan jalur pemulihan.

Platform MKController menampilkan agent sebagai offline dengan tombol untuk membuka pengaturan agent Layar Agent Desktop Terputus dengan opsi Uji Agent dan Konfigurasikan Agent Lagi

Langkah pemulihan:

  1. Buka kembali aplikasi desktop jika sudah ditutup.
  2. Verifikasi bahwa komputer memiliki akses internet.
  3. Gunakan Uji Agent atau Konfigurasikan Agent Lagi jika diminta.
  4. Kembali ke MKController dan tunggu hingga indikator status berubah menjadi hijau.

Butuh bantuan instalasi? Hubungi tim kami di WhatsApp — kami siap memandu Anda mengatasi masalah yang spesifik pada sistem operasi Anda.