Pendahuluan

Menjaga Carbonio tetap menggunakan versi terbaru merupakan salah satu langkah penting untuk mendapatkan fitur terbaru, peningkatan performa, perbaikan bug, serta pembaruan keamanan. Mulai Carbonio 26.6.x, Zextras menyediakan mekanisme upgrade yang lebih terstruktur menggunakan Ansible, sehingga proses pembaruan dapat dilakukan secara konsisten baik pada deployment single-node maupun multi-node.

Berbeda dengan aplikasi yang memiliki installer terpisah, Carbonio melakukan upgrade melalui pembaruan package sistem. Oleh karena itu, proses upgrade dilakukan menggunakan Ansible Playbook yang akan memperbarui seluruh paket Carbonio dari repository resmi Zextras ke versi terbaru yang tersedia. Dokumentasi resmi juga menjelaskan bahwa prosedur ini dapat digunakan untuk melakukan upgrade dari versi Carbonio yang masih didukung menuju versi terbaru tanpa harus melewati setiap versi satu per satu. Sebelum memulai upgrade, Zextras sangat menyarankan untuk membuat backup dan snapshot seluruh node sebagai langkah mitigasi apabila terjadi kendala selama proses upgrade.

---

Persyaratan

Sebelum menjalankan proses upgrade, pastikan beberapa persyaratan berikut telah dipenuhi:

• Sudah melakukan backup seluruh data Carbonio.
• Membuat snapshot seluruh virtual machine (jika menggunakan virtualisasi).
• Seluruh repository Carbonio telah dikonfigurasi dengan benar.
• Ansible dapat melakukan koneksi SSH ke seluruh node.
• File inventory Ansible masih sesuai dengan kondisi infrastruktur Carbonio.
• Hanya repository yang ingin digunakan untuk upgrade yang dalam kondisi aktif. Repository lain sebaiknya dinonaktifkan agar tidak ikut memperbarui package yang tidak diinginkan.

---

Install atau Update Collection Carbonio Upgrade

Sebelum menjalankan playbook upgrade, pastikan collection zxbot.carbonio_upgrade telah terpasang atau diperbarui ke versi terbaru.

Jalankan perintah berikut:

ansible-galaxy collection install zxbot.carbonio_upgrade -U

Parameter -U berfungsi untuk:

• menginstal collection apabila belum tersedia,
• atau memperbarui collection ke versi terbaru apabila sudah pernah diinstal sebelumnya.

Collection inilah yang berisi seluruh playbook yang digunakan untuk melakukan upgrade Carbonio.

---

Pastikan File Inventory

Ansible akan menggunakan file inventory yang sebelumnya digunakan saat instalasi.

Contoh:

carbonio-inventory

Pastikan seluruh hostname, FQDN, dan pembagian service masih sesuai dengan kondisi server saat ini.

Jika sebelumnya Carbonio diinstal secara manual, inventory tetap dapat digunakan selama seluruh node dan komponennya telah diisikan dengan benar.

---

Jalankan Upgrade

Masuk ke direktori tempat inventory berada, kemudian jalankan:

ansible-playbook zxbot.carbonio_upgrade.carbonio_upgrade \
-u root \
-i carbonio-inventory

Playbook akan melakukan proses upgrade seluruh package Carbonio yang berasal dari repository resmi Zextras.

Dokumentasi resmi menjelaskan bahwa versi Carbonio yang saat ini terpasang tidak memengaruhi prosedur upgrade. Selama berasal dari versi yang masih didukung, sistem akan diperbarui ke release terbaru yang tersedia pada repository.

---

Mencegah Auto Remove Package

Secara default, playbook akan menjalankan proses autoremove terhadap dependency yang dianggap sudah tidak digunakan.

Apabila Anda ingin menonaktifkan perilaku tersebut, gunakan parameter berikut:

ansible-playbook zxbot.carbonio_upgrade.carbonio_upgrade \
-u root \
-i carbonio-inventory \
--extra-vars skip_autoremove=1

Opsi ini cukup berguna apabila Anda ingin melakukan verifikasi terlebih dahulu sebelum menghapus package yang tidak lagi digunakan.

Perlu diperhatikan bahwa package yang dipasang secara manual dan tidak digunakan oleh Carbonio tidak akan dihapus secara otomatis, sehingga administrator tetap perlu melakukan pembersihan apabila diperlukan.

---

Jika Upgrade Gagal

Apabila proses upgrade berhenti karena suatu error, Anda tidak perlu mengulang seluruh proses dari awal.

Cukup jalankan kembali playbook yang sama:

ansible-playbook zxbot.carbonio_upgrade.carbonio_upgrade \
-u root \
-i carbonio-inventory

Ansible akan mengenali task yang telah berhasil dijalankan sebelumnya dan hanya mengeksekusi task yang gagal atau belum selesai. Mekanisme ini membantu mempercepat proses recovery tanpa harus mengulang keseluruhan upgrade.

---

Catatan Khusus Upgrade dari Versi Lama

Bagi administrator yang melakukan upgrade dari Carbonio versi lama, terdapat beberapa penyesuaian pada file inventory.

Upgrade dari Carbonio 24.12

Jika menggunakan Carbonio 24.12, pastikan inventory telah memiliki section:

[workStreamServers]

Jika sebelumnya menggunakan komponen Chats, tambahkan hostname node Chats pada section tersebut sebelum menjalankan upgrade.

Upgrade dari Carbonio 24.9 atau Lebih Lama

Untuk deployment yang berasal dari Carbonio 24.9 atau versi yang lebih lama, section berikut tetap harus ada pada inventory selama proses upgrade:

[dbsConnectorServers]

Walaupun komponen DB Connector telah dihapus pada versi terbaru, keberadaan section tersebut masih diperlukan agar Ansible dapat melakukan migrasi package dengan benar. Setelah proses upgrade selesai, section tersebut dapat dikosongkan sesuai rekomendasi dokumentasi.

---

Hal Pasca Upgrade

Mulai Carbonio 26.6.x, Zextras memperkenalkan Unified Quota.

Perubahan ini menggabungkan quota Mail, Files, dan Chat menjadi satu quota penyimpanan per pengguna.

Penting untuk diketahui bahwa konfigurasi quota lama tidak dimigrasikan secara otomatis. Setelah upgrade, seluruh akun akan memiliki quota Unlimited hingga administrator menetapkan quota baru.

Oleh karena itu, administrator disarankan untuk:

• meninjau kembali penggunaan storage,
• menentukan kebijakan quota baru,
• menjalankan migration script Unified Quota yang tersedia melalui Partner Portal apabila diperlukan.

---

Kesimpulan

Upgrade Carbonio menggunakan Ansible merupakan metode resmi yang direkomendasikan oleh Zextras karena mampu melakukan pembaruan secara konsisten pada seluruh node dalam infrastruktur. Proses upgrade cukup sederhana, yaitu memperbarui collection Ansible, memastikan inventory telah sesuai, kemudian menjalankan playbook upgrade.

Sebelum memulai proses, jangan lupa melakukan backup dan snapshot seluruh server. Selain itu, apabila Anda melakukan upgrade ke Carbonio 26.6.x, pastikan untuk meninjau perubahan Unified Quota karena konfigurasi quota lama tidak akan dimigrasikan secara otomatis dan memerlukan tindakan administrator setelah proses upgrade selesai.

---

Referensi

• Zextras. Upgrade to Carbonio 26.6.0.
  https://docs.zextras.com/carbonio/html/upgrade/toc.html
• Zextras. Upgrade Using Ansible.
  https://docs.zextras.com/carbonio/html/upgrade/ansible.html
• Upgrade Using Ansible from Older Versions.
  https://docs.zextras.com/carbonio/html/upgrade/ansible-older.html
• Prepare the Ansible Environment.
  https://galaxy.ansible.com/ui/repo/published/zxbot/carbonio_upgrade/docs/