Cadangan dan Pembaruan
Cadangan Otomatis
Bila Anda menjawab ya saat pemasangan, pemasang menambahkan dua jadwal ke crontab pengguna itu: cadangan basis data setiap jam pada menit ke-17, dan uji pemulihan setiap Minggu pukul 03.40 (menitnya bisa diubah dengan WT_BACKUP_MINUTE dan WT_RESTORE_TEST_MINUTE). Tanpa perintah crontab, atau bila Anda menjawab tidak, pemasang hanya mencetak kedua baris itu untuk Anda pasang sendiri. Jadwal memanggil ./wiratalk backup --cron, yang dilewati bila cadangan atau pembaruan lain sedang berjalan. Cadangan dienkripsi (GPG, AES-256). Cadangan per jam disimpan 6 jam dan cadangan harian 30 hari di database/backups.
Kunci enkripsinya ada di database/.backup-key. Simpan salinannya di luar server, misalnya di pengelola kata sandi: tanpa kunci itu tidak ada cadangan yang bisa dibuka.
Salinan di Luar Server
Bila Anda mengisi bucket S3 untuk salinan cadangan saat pemasangan, setiap hari mulai pukul 02.00 cadangan harian beserta salinan terenkripsi ENCRYPTION_KEY diunggah ke bucket itu dan disimpan 90 hari. Dengan penyimpanan berkas bawaan, berkas juga disalin ke bucket itu, dan berkas yang dihapus di server ikut dihapus pada salinan berikutnya. Pengaturannya ada di database/offsite.env.
Uji Pemulihan
./wiratalk restore-test
Memulihkan cadangan terbaru ke basis data sementara dan membandingkan jumlah baris setiap tabel. RESTORE TEST PASSED berarti cadangan bisa dipulihkan. Counts differ berarti jumlah baris berbeda dari basis data yang berjalan; itu wajar bila ada tulisan baru sesudah cadangan dibuat, dan perlu diperiksa bila selisihnya besar.
Memulihkan Sesudah Bencana
- Pasang paket versi yang sama di server baru (Panduan pemasangan) dengan ID server dan kunci lisensi yang sama.
- Salin database/.backup-key lama ke folder pemasangan baru, lalu ambil cadangan harian dan berkas kuncinya (wiratalk-YYYYMMDD.dump.gpg dan wiratalk-key-YYYYMMDD.env.gpg) dari bucket salinan.
./wiratalk restore wiratalk-YYYYMMDD.dump.gpg wiratalk-key-YYYYMMDD.env.gpg- Dengan penyimpanan berkas bawaan:
./wiratalk restore-files ./wiratalk status
Perintah restore meminta Anda mengetik PULIHKAN, menghentikan server, membuat cadangan pengaman dari basis data yang ada, lalu memulihkan dalam dua tahap. Pada tahap pertama (disiapkan) satu transaksi mengganti data; selama transaksi itu belum selesai, basis data masih berisi data semula. Begitu transaksi selesai (tahap kedua, terlaksana), data hasil pemulihan sudah menggantikan data semula. Sesudahnya migrasi dijalankan, kunci enkripsi dari berkas kunci dipasang, server dijalankan, dan cadangan pengaman dihapus setelah server sehat. RESTORE_OK berarti selesai. Kegagalan berakhir dengan RESTORE_FAILED diikuti nama langkah: sebelum transaksi selesai (atau di migrasi dan kunci sebelum server sempat berjalan) data semula tetap atau dikembalikan; bila server tidak sehat dalam dua menit (langkah start), data hasil pemulihan tetap dan perintahnya harus dilanjutkan dengan ./wiratalk restore --finish.
Bila perintah terhenti di tengah jalan (sesi SSH putus, server dimulai ulang), ./wiratalk status berakhir dengan kode 3 dan menampilkan Pemulihan belum selesai beserta jalan keluarnya. Terhenti sebelum transaksi selesai: basis data masih berisi data semula, dan Anda menjalankan ./wiratalk restore lagi (dengan berkas cadangan pengaman yang ditampilkan atau berkas lain) atau ./wiratalk restore --abandon untuk membatalkan dan menjalankan server dengan data semula; hasilnya RESTORE_ABANDONED. Terhenti sesudah transaksi selesai: hanya ./wiratalk restore --finish yang bisa dipakai; perintah ini tidak memulihkan apa pun lagi, hanya menyelesaikan sisanya, dan bisa diulang bila gagal. Selama pemulihan berjalan, status menampilkan Pemulihan sedang berjalan.
Selama pemulihan belum selesai, cadangan, pembaruan, rollback, dan restart menolak berjalan (restore-in-progress). Dari perintah compose, hanya ps, logs, config, images, top, version, dan menjalankan basis data (up atau start db) yang bisa dipakai; perintah compose lain menolak. Perintah restore sendiri menolak dengan keterangan committed atau prepared bila tahapnya tidak cocok.
Memperbarui
./wiratalk update 0.6.1
Pembaruan membuat cadangan, mengunduh versi baru, memperbarui berkas paket, menjalankan migrasi basis data, lalu menjalankan server baru. Bila server baru tidak sehat dalam dua menit, perintah ini kembali sendiri ke versi sebelumnya. UPDATE_OK berarti selesai. Daftar versi ada di Referensi API.
Bila pembaruan terputus di tengah jalan, misalnya sesi SSH terputus, ./wiratalk status menampilkan pembaruan yang belum selesai. Jalankan ./wiratalk update lagi dengan versi yang sama. Bila pembaruan gagal sebelum mengubah apa pun, perintah ini berakhir dengan UPDATE_FAILED diikuti nama langkah, dan server tetap berjalan seperti semula.
Migrasi basis data tidak pernah dibatalkan. Untuk kembali ke versi sebelumnya secara manual: ./wiratalk rollback. Perintah ini hanya bisa dipakai sesudah pembaruan yang berhasil, dan kembali ke versi yang berjalan sehat sebelum pembaruan itu. Tanpa pembaruan seperti itu, perintah ini berakhir dengan ROLLBACK_FAILED nothing-to-roll-back dan tidak mengubah apa pun.
Cadangan, pemulihan, pembaruan, dan rollback memakai satu kunci kerja, jadi tidak ada dua yang berjalan bersamaan. Bila yang lain sedang berjalan, perintah menunggu sampai 10 menit, lalu berhenti dengan keterangan busy (misalnya BACKUP_FAILED busy atau UPDATE_FAILED busy).
Bila WiTalk Hub Tidak Bisa Dihubungi
Server tetap berjalan dan karyawan tetap bisa chat. Notifikasi tertunda; yang menunggu lebih dari 15 menit tidak dikirim lagi, tetapi pesannya tetap ada saat aplikasi dibuka. Mengunduh paket (docker login dan docker pull) gagal selama Hub tidak bisa dihubungi, karena registri memeriksa kunci Anda lewat Hub. Pembaruan berakhir dengan UPDATE_FAILED pull tanpa mengubah server yang berjalan. Bila paket sudah terambil, pemasang tetap berjalan sampai akhir dan berakhir dengan INSTALL_INCOMPLETE hub (misalnya hub failing network): server berjalan, tetapi belum terdaftar. Ulangi sesudah Hub kembali.