Salah satu hal yang membuat saya cukup lama “linglung” waktu pertama kali memegang Zimbra 10.1 di lab adalah urusan lisensi. Hampir semua tutorial yang berserakan di internet menyebut soal file ZCSLicense.xml di /opt/zimbra/conf/, perintah zmlicense -i untuk install, dan konsep license daemon yang menempel di mailstore. Setelah saya cek langsung di server lab, semua referensi itu ternyata tidak lagi 100% benar. Zimbra 10.1 sudah memperkenalkan mekanisme lisensi yang baru, dan saya rasa ini topik yang perlu saya tulis supaya teman-teman tidak mengulangi kebingungan yang sama.

Apa yang Berubah di Zimbra 10.1

Zimbra 10.1 yang rilis pertengahan 2024 memperkenalkan service baru bernama License Daemon Service atau singkatnya LDS. Service ini adalah komponen wajib di Zimbra Network Edition, dan bertugas menjadi jembatan antara mailbox server kalian dengan server lisensi resmi Zimbra (license.zimbra.com).

Yang lebih signifikan, format lisensinya juga berubah. Kalau dulu kalian terbiasa dengan file XML, sekarang lisensi online menggunakan kunci alfanumerik 18 sampai 26 karakter yang kalian aktivasi via perintah. File XML hanya masih digunakan untuk skenario offline activation, dengan flow yang berbeda dari sebelumnya.

Konsep “license daemon menempel di mailstore” yang banyak ditemui di dokumentasi versi 8 dan 9 sudah tidak berlaku. LDS sekarang adalah service yang berdiri sendiri, dengan package terpisah bernama zimbra-license-daemon.

Dimana LDS Sebaiknya Ditempatkan

Inilah pertanyaan yang menurut saya paling sering bikin bingung waktu instalasi multi-server. Berdasarkan rekomendasi resmi Zimbra, ada tiga opsi penempatan, dengan urutan preferensi sebagai berikut.

• Pilihan pertama dan paling direkomendasikan adalah node dedicated khusus untuk LDS. Ini cocok untuk environment produksi dengan banyak mailbox server. LDS adalah service yang ringan, tidak butuh resource besar, tapi memisahkannya membuat pengelolaan lebih bersih.
• Pilihan kedua, kalau tidak memungkinkan punya node terpisah, LDS bisa ditempatkan di node Proxy atau MTA. Alasannya, dua node ini biasanya memang sudah punya jalur keluar ke internet karena posisinya di edge. Jadi tidak perlu membuka rute baru hanya untuk LDS.

Yang penting untuk kalian ingat, LDS tidak direkomendasikan ditempatkan di mailstore. Ini perubahan mendasar dari konsep lama Zimbra. Mailstore biasanya berada di zona internal yang lebih tertutup, dan menambahkan kebutuhan internet di sana hanya untuk lisensi mencampur tanggung jawab yang sebenarnya bisa dipisah.

Urutan Instalasi yang Benar di Multi-Server

Karena LDS adalah prasyarat untuk mailbox server, urutan instalasi multi-server di Zimbra 10.1 menjadi:

1. Install dan konfigurasi LDAP server
2. Install LDS di node dedicated atau di Proxy/MTA
3. Baru install mailbox server
4. Lanjut ke MTA, Proxy, dan komponen lain

Kalau kalian mencoba install mailbox dulu sebelum LDS, installer akan menolak dengan pesan yang cukup jelas: zimbra-license-daemon should be installed prior to zimbra-store. Saya pernah lupa urutannya dan akhirnya harus mengulang dari awal.

Perintah Dasar yang Perlu Dikenal

Ada dua keluarga perintah yang akan sering kalian pakai. Yang pertama untuk mengelola lisensinya sendiri, yang kedua untuk mengelola service LDS-nya.

Untuk lisensi, gunakan zmlicense sebagai user zimbra:

zmlicense -a <LICENSE-KEY>     # Aktivasi lisensi online (kunci alfanumerik)
zmlicense -A /path/to/license.xml  # Aktivasi lisensi offline (file XML)
zmlicense -p                    # Lihat detail lisensi
zmlicense -c                    # Cek status lisensi
zmlicense -rc                   # Refresh cache lisensi di mailbox

Perhatikan perbedaan antara -a huruf kecil dan -A huruf besar. Yang kecil untuk online, yang besar untuk offline. Saya pernah salah ketik dan menghabiskan waktu cukup lama untuk sadar.

Untuk service LDS-nya, gunakan zmlicensectl:

zmlicensectl --service status       # Cek status service
zmlicensectl --service start        # Start service
zmlicensectl --service stop         # Stop service
zmlicensectl --service setLogLevel=DEBUG  # Set level log untuk troubleshoot
zmlicensectl --clearLicenseWorkDir  # Bersihkan working directory lisensi

Memahami Grace Period

Salah satu hal yang menurut saya cukup elegan di desain baru ini adalah konsep grace period. Mulai dari versi 10.1.10, kalau mailbox server kehilangan koneksi ke LDS selama kurang lebih 12 jam, sistem masuk ke mode grace period. Selama periode ini, mail flow tetap berjalan, tapi ada peringatan di admin console. Ini memberi kalian waktu untuk memperbaiki masalah konektivitas sebelum service benar-benar terganggu.

Buat saya, ini menunjukkan bahwa Zimbra serius dengan reliability. Daripada langsung memutus service ketika ada masalah kecil di sisi lisensi, mereka memberi waktu untuk troubleshoot.

Lokasi File Lisensi di 10.1

Hal terakhir yang ingin saya luruskan. Di Zimbra 10.1, lisensi tidak lagi disimpan sebagai file XML statis di /opt/zimbra/conf/. Sekarang lokasinya di /opt/zimbra/license/store/, dan isinya bukan satu file XML melainkan beberapa file yang dikelola otomatis oleh LDS, seperti APV_secured.txt dan file pendamping lainnya.

Jangan coba edit atau pindahkan file di direktori ini secara manual. Semua manipulasi harus lewat zmlicense dan zmlicensectl, supaya state internal LDS tetap konsisten.

Refleksi Pribadi

Yang saya pelajari dari mencoba memahami arsitektur ini adalah bahwa Zimbra 10.1 sebenarnya membawa Zimbra ke arah yang lebih modern dari sisi licensing. Mekanisme lama dengan file XML yang harus disalin manual antar server, validasi yang serba statis, dan license-daemon yang menempel di mailstore, semua itu adalah peninggalan era yang berbeda. Pendekatan baru dengan LDS sebagai service terpisah, dengan API, dengan grace period, dan dengan key alfanumerik untuk online, jauh lebih sejalan dengan praktik software modern.

Tapi konsekuensinya, kalian harus berhati-hati membaca dokumentasi yang beredar di internet. Banyak artikel dan forum post yang relevan untuk Zimbra 8 atau 9, dan kalau diterapkan begitu saja ke 10.1, hasilnya akan keliru. Sumber paling aman adalah admin guide resmi Zimbra Daffodil v10 di zimbra.github.io/documentation/zimbra-10/. Saya akan menulis catatan lanjutan soal instalasi LDS di node terpisah dan troubleshoot LDS yang tidak running di postingan berikutnya, karena dua topik itu menurut saya cukup berdiri sendiri dan layak dibahas terpisah.

Buat teman-teman yang sedang dalam perjalanan migrasi ke Zimbra 10.1, semoga catatan ini membantu meluruskan beberapa hal dasar sebelum kalian mulai menyentuh installer-nya. Lebih baik paham konsepnya dulu daripada kebingungan di tengah proses instalasi yang sudah berjalan setengah jalan.