Mengatasi Failed to Connect License Daemon saat Instalasi Node MailBox Baru


Pada saat melakukan instalasi Zimbra Multi-Server, saya menemui beberapa kendala, khususnya ketika melakukan instalasi node Mailbox. Seperti yang kita ketahui, dalam arsitektur Zimbra, Mailbox Server memegang peranan yang sangat penting, karena hampir seluruh aktivitas pengguna—mulai dari login webmail, pengiriman dan penerimaan email, hingga proses indexing—bergantung pada layanan ini.

Permasalahannya, kesalahan konfigurasi pada Mailbox Server sering kali tidak langsung terlihat di awal. Bahkan dalam beberapa kasus, error baru muncul tepat saat proses instalasi sedang berjalan, bukan sebelum atau setelahnya. Salah satu error yang saya alami dan cukup membingungkan adalah kegagalan koneksi ke Zimbra License Daemon.


Pemilihan Paket Zimbra pada Mailbox Server

Mengacu pada dokumentasi resmi Zimbra Multi-Server Installation, secara umum pemilihan paket Zimbra untuk node Mailbox Server adalah sebagai berikut:

Install zimbra-ldap [Y] N

Install zimbra-logger [Y] Y

Install zimbra-mta [Y] N

Install zimbra-dnscache [Y] N

Install zimbra-snmp [Y] Y

Install zimbra-license-daemon [Y] N

Have you installed zimbra-license-daemon package on different node: Y

Please enter the zimbra-license-daemon host: <LDS_node_hostname>

Install zimbra-store [Y] Y

Install zimbra-apache [Y] Y

Install zimbra-spell [Y] Y

Install zimbra-convertd [Y] Y

Install zimbra-memcached [Y] N

Install zimbra-proxy [Y] N

Install zimbra-archiving [N] Y

Install zimbra-onlyoffice [N] Y

Install zimbra-patch [Y] Y

Install zimbra-mta-patch [Y] N

Install zimbra-proxy-patch [Y] N

Install zimbra-ldap-patch [Y] N

Konfigurasi di atas sesuai untuk skenario multi-server, di mana:

  • License daemon ditempatkan di node lain (biasanya Mailbox utama atau server khusus)
  • Namun pada kasus saya, saya tempatkan di Mail Box pertama (mbox1)

Pada bagian yang saya garis miring, saat proses instalasi Mailbox berjalan, muncul error berikut:

Failed to connect to http://mbox1.rafiharlianto.co.id:8081/actuator/health license-daemon should be running and healthy.

Sekilas, error ini terkesan menunjukkan bahwa service license-daemon tidak berjalan. Namun pada kenyataannya, service tersebut sudah dalam kondisi running di node yang ditentukan (pada kasus saya ada di mbox1.rafiharlianto.co.id).

Di sinilah letak kebingungannya.


Penjelasan Error Failed to Connect License Daemon

Masalah utamanya : Node Mailbox tidak dapat mengakses License Daemon melalui jaringan (HTTP port 8081)

License daemon di Zimbra Network Edition menyediakan endpoint: http://<license-daemon-host>:8081/actuator/health

Endpoint ini digunakan oleh node lain (Mailbox, MTA, Proxy) untuk memastikan bahwa:

  • License daemon aktif
  • License daemon dapat diakses
  • Statusnya healthy

Jika endpoint ini tidak bisa diakses, installer akan langsung menghentikan proses.


Penyebab Umum Gagal Koneksi License Daemon

Berdasarkan pengalaman saya, penyebabnya biasanya salah satu (atau kombinasi) dari berikut ini:

1. Hostname license-daemon tidak bisa di-resolve

Hostname yang dimasukkan saat installer bertanya:

Please enter the zimbra-license-daemon host:

harus:

  • Menggunakan FQDN
  • Bisa di-resolve oleh Mailbox Server
  • Terdaftar di DNS atau /etc/hosts

Jika tidak, koneksi ke port 8081 pasti gagal.


2. /etc/hosts belum sinkron antar node

Karena installer tidak selalu bergantung pada DNS publik, maka setiap node Zimbra wajib saling mengenal hostname satu sama lain.

Contoh di Mailbox: 172.16.140.12  mbox1.rafiharlianto.co.id  mbox1

Jika entri ini tidak ada atau salah, maka: Failed to connect to http://mbox1:8081 akan muncul walaupun servicenya aktif.


3. Port 8081 tidak bisa diakses

License daemon berjalan di port 8081 (HTTP). Jika:

  • Firewall masih aktif
  • SELinux belum dinonaktifkan
  • Service belum sepenuhnya siap

maka koneksi pasti akan gagal.

Cek cepat di server yang memiliki license: 

$ ss -lntp | grep 8081


4. Service license-daemon belum benar-benar siap

Dalam beberapa kasus, service terlihat Running, tetapi:

  • JVM masih inisialisasi
  • Endpoint /actuator/health belum aktif

Akibatnya installer langsung menganggap service tidak sehat.

Biasanya ini bisa diatasi dengan:

  • Menunggu beberapa menit
  • Atau restart service Zimbra
  • Cara Memastikan License Daemon Sudah Sehat

Di node license-daemon (misalnya mbox1):

$ zmcontrol status | grep license

Pastikan output:

license-daemon    Running

Lalu cek endpoint secara manual:

$ curl http://mbox1.rafiharlianto.co.id:8081/actuator/health

Jika berhasil, akan muncul status UP.

Comments

Post a Comment

Popular posts from this blog

Belajar Zimbra Mail Server

Image
Di era komunikasi digital, email masih menjadi sangat penting untuk komunikasi formal di organisasi. Salah satu solusi email server yang banyak digunakan di lingkungan enterprise dan institusi adalah Zimbra Mail Server. Pada tulisan ini, saya akan membagikan panduan belajar Zimbra Mail Server secara bertahap, ditujukan untuk pemula, peserta magang, maupun sysadmin yang ingin memperdalam pengelolaan email server. Mengenal Cara Kerja Email Server Sebelum mengenalkan apa itu zimbra, penting memahami bagaimana email bekerja. Secara umum, pengiriman email melibatkan beberapa komponen utama seperti SMTP untuk mengirim email, POP3/IMAP untuk mengambil email, serta peran Mail Transfer Agent (MTA), Mail Delivery Agent (MDA), dan Mail User Agent (MUA). Email server juga sangat bergantung pada konfigurasi DNS, seperti record MX, A, PTR, SPF, DKIM, dan DMARC (bisa coba dalami tentang ini). Kesalahan kecil pada DNS kadang menjadi penyebab utama email gagal terkirim atau masuk ke folder spam. La...
Read more

Mendalami tentang Linux (Sejarah dan Pelopor)

Image
Ringkasan Sejarah Linux Linux adalah sistem operasi komputer sumber terbuka yang awalnya dikembangkan untuk dan pada komputer pribadi berbasis Intel x86. Sistem ini kemudian diporting ke daftar platform hardware yang sangat panjang, mulai dari perangkat tertanam berukuran kecil hingga superkomputer terbesar di dunia. Pada bagian ini, kita akan mengikuti sejarah yang mengejutkan tentang bagaimana Linux berkembang dari proyek seorang mahasiswa perguruan tinggi Finlandia menjadi upaya besar yang memiliki dampak besar pada dunia saat ini. Linus Torvalds adalah seorang mahasiswa di Helsinki, Finlandia, pada tahun 1991, ketika ia memulai sebuah proyek: menulis kernel sistem operasi miliknya sendiri. Ia juga mengumpulkan dan/atau mengembangkan komponen-komponen esensial lainnya yang diperlukan untuk membangun sistem operasi lengkap dengan kernelnya sebagai inti. Tidak lama kemudian, ini dikenal sebagai kernel Linux. Pada tahun 1992, Linux dilisensikan ulang menggunakan General Public Licens...
Read more