HandyCafe Docs
owner it-admin

Pembaruan Klien

PC klien mendapatkan versi HandyCafe baru dari server Anda sendiri melalui jaringan lokal. Klien tidak pernah mengunduh pembaruan dari internet sendiri. Sebagian besar waktu, proses ini berjalan dengan sendirinya. Jika Anda perlu memasang build tertentu di satu atau beberapa komputer, Anda dapat mengirim paketnya secara manual dari halaman Komputer.

Di Windows, sebuah layanan latar belakang memasang pembaruan dan menjaga klien tetap berjalan. Layanan ini juga menjalankan kembali klien jika pelanggan menutup atau mematikan paksa prosesnya.


Pembaruan Otomatis

Server memeriksa katalog pembaruan HandyCafe setiap lima menit. Server juga memeriksanya saat awan HandyCafe mengumumkan rilis baru. Katalog yang dibaca sesuai dengan kanal rilis server itu sendiri: server beta mengikuti rilis beta dan server stabil mengikuti rilis stabil.

Saat versi klien yang lebih baru diterbitkan:

  1. Komputer yang terhubung melaporkan versi kliennya ke server sebagai bagian dari pembaruan status rutin.
  2. Jika komputer itu tidak sedang menjalankan sesi dan versinya lebih lama dari versi yang diterbitkan, server mengunduh paket untuk sistem operasi komputer tersebut. Unduhan hanya dilakukan sekali lalu disimpan di cache server.
  3. Server menawarkan pembaruan ke komputer. Komputer mengunduh paket dari server melalui jaringan lokal dan memeriksa checksum SHA-256-nya.
  4. Klien memasang pembaruan lalu me-restart dirinya sendiri.

Komputer yang sedang menjalankan sesi tidak pernah ditawari pembaruan. Klien juga menolak tawaran jika sesi dimulai di sela waktu tersebut. Pembaruan menunggu sampai komputer kosong lagi.

Setiap komputer ditawari versi tertentu paling banyak sekali setiap lima menit. Komputer yang melewatkan tawaran akan menerimanya lagi pada pemeriksaan berikutnya.

Untuk melihat versi klien terbaru yang diterbitkan, buka Pengaturan, lalu Tentang. Baris Klien di bawah Versi menampilkan versi terbaru yang diterbitkan. Baris ini menampilkan Katalog tidak tersedia jika server tidak dapat menjangkau katalog pembaruan.


Mengirim Pembaruan Secara Manual

Gunakan pembaruan manual untuk memasang paket tertentu yang Anda simpan di disk. Server memverifikasi paket dan menampilkan hasilnya sebelum apa pun dikirim.

Lokasinya

Di halaman Komputer:

  • Satu komputer. Klik kartu komputer untuk membuka panel detailnya. Di bawah Tindakan Jarak Jauh, klik Perbarui klien.
  • Beberapa komputer. Pilih komputernya, lalu klik Perbarui klien di bilah perintah di bawah bilah alat filter. Tombol ini hanya tersedia jika semua komputer yang dipilih terhubung.
  • Perintah Perbarui klien yang sama juga ada di menu aksi kartu komputer.

Paket yang diterima

Platform Paket
Windows Installer setup (.exe). File tanda tangan .sig yang sesuai harus berada di sebelahnya.
Linux .AppImage
macOS .app.tar.gz

File .msi, .deb dan .dmg tidak diterima karena klien tidak dapat memasangnya secara senyap.

Paket server dan setup all-in-one (HandyCafe_Genesis_Pro_Setup_..., HandyCafe_Genesis_Setup_...) juga tidak diterima. Di Windows, pilih HandyCafe-Client_<version>_update-setup.exe beserta file .sig-nya.

Ukuran paket maksimal 500 MB.

Windows hanya memasang paket bertanda tangan. Letakkan file tanda tangan dengan nama yang sama ditambah .sig di folder yang sama dengan installer. Contohnya, HandyCafe Client_5.1.0_x64-setup.exe.sig diletakkan di sebelah HandyCafe Client_5.1.0_x64-setup.exe. Tanpa file ini, pengiriman diblokir sebelum komputer mana pun mulai mengunduh.

Isi layar konfirmasi

Setelah Anda memilih file, server membaca dan menghitung hash-nya. Dialog Pembaruan klien lalu menampilkan:

Kolom Arti
Nama berkas Paket yang Anda pilih.
Checksum (SHA-256) Sidik jari paket. Komputer mencocokkan hasil unduhan dengan nilai ini.
Versi Dibaca dari nama file. Ditampilkan sebagai Tidak diketahui jika nama file tidak memuat versi, hal yang wajar untuk paket macOS.
Ukuran Ukuran paket.
Versi terpasang Versi klien yang saat ini ada di komputer (satu komputer).

Untuk beberapa komputer, sebuah tabel mencantumkan setiap Komputer, versi Terpasang dan Status-nya:

Status Arti
Siap Akan menerima pembaruan.
Sudah versi terbaru Akan menerima paket, meskipun paket itu tidak lebih baru dari yang terpasang.
Dalam sesi Dilewati. Ada sesi yang berjalan di komputer ini.
Luring Dilewati. Komputer tidak terhubung.
Menjalankan (platform) Dilewati. Paket ditujukan untuk sistem operasi lain.

Komputer yang akan dilewati dicantumkan lebih dulu. Ringkasan menampilkan berapa komputer yang akan diperbarui dan berapa yang dilewati.

Paket yang tidak cocok untuk sebagian komputer tidak memblokir komputer lainnya. Di warnet dengan komputer Windows dan Linux, paket Windows cukup melewati komputer Linux.

Langkah demi langkah

  1. Di halaman Komputer, buka panel detail komputer atau pilih beberapa komputer.
  2. Klik Perbarui klien.
  3. Pilih file paket. Batalkan pemilih file untuk berhenti tanpa mengirim apa pun.
  4. Tunggu hingga Memverifikasi paket selesai.
  5. Periksa nama file, versi dan daftar target.
  6. Klik Kirim pembaruan untuk satu komputer. Untuk beberapa komputer, tombolnya bertuliskan Kirim ke diikuti jumlah komputer.

Server memeriksa ulang setiap target pada saat pengiriman. Komputer yang memulai sesi setelah layar konfirmasi muncul akan dilewati.

Setelah dikirim, sebuah pesan mengonfirmasi berapa komputer yang menerima pembaruan. Setiap komputer mengunduh dan memasang paket, lalu me-restart dirinya sendiri.


Layanan Updater Windows

Di Windows, klien memasang layanan bernama HandyCafe Client Updater. Layanan ini berjalan sebagai SYSTEM dan otomatis dimulai bersama Windows.

Layanan ini memiliki dua tugas.

Memasang pembaruan

Klien mengunduh dan memeriksa paket, lalu menyerahkan installer ke layanan dan menutup diri. Layanan memeriksa tanda tangan rilis sebelum memasang apa pun. Paket yang tidak bertanda tangan atau bertanda tangan salah akan ditolak. Setelah pemasangan, layanan menjalankan klien yang baru.

Menjaga klien tetap berjalan

Selama ada pengguna yang masuk ke Windows, layanan memeriksa sekitar sekali per detik bahwa klien sedang berjalan. Jika klien tidak ada, layanan menjalankannya lagi di sesi milik pengguna yang sedang masuk dengan hak normal pengguna tersebut. Pelanggan dengan akun Windows standar tidak dapat menghentikan layanan SYSTEM. Karena itu, menutup klien dan watchdog-nya sekaligus tidak membuat komputer terbuka tanpa kunci.

Klien yang langsung crash setelah dijalankan tidak di-restart dalam perulangan tanpa jeda. Klien yang mati dalam 15 detik setelah dijalankan dihitung sebagai start yang gagal. Jeda sebelum percobaan berikutnya bertambah setiap kali start gagal berturut-turut: 1, 2, 5, 10 lalu 30 detik. Klien yang bertahan berjalan selama 30 detik mengatur ulang hitungannya.

Layanan tidak me-restart klien setelah keluar secara sah:

  • Keluar admin di klien
  • Tutup Klien yang dikirim dari server
  • Mencopot pemasangan klien

Dalam kasus-kasus tersebut, klien meminta layanan untuk berhenti mengawasi sebelum klien menutup diri. Pengawasan dilanjutkan saat klien dijalankan lagi, juga saat login Windows berikutnya. Jika klien masih berjalan 10 detik setelah permintaan tersebut, proses keluar dianggap batal dan pengawasan dilanjutkan. Ini mencakup, misalnya, pencopotan pemasangan yang dibatalkan di dialog izin Windows.

Selama pembaruan sedang dipasang, layanan menyerahkan urusan menghentikan dan menjalankan klien kepada proses pembaruan.


Izin

Mengirim pembaruan secara manual memerlukan izin Transfer berkas. Atur di Pengaturan, lalu Staf, lalu Peran & Izin. Lihat Peran Kasir.

Pembaruan otomatis tidak memerlukan izin. Pembaruan ini berjalan di latar belakang selama server menyala.


Pemecahan Masalah dan Catatan

Komputer tidak pernah diperbarui secara otomatis. Tawaran otomatis hanya dikirim ke komputer yang terhubung dan tidak sedang menjalankan sesi. Komputer yang selalu dipakai akan menerima pembaruan saat berikutnya komputer itu kosong. Pastikan server dapat menjangkau katalog pembaruan di Pengaturan, lalu Tentang.

"Windows hanya memasang paket bertanda tangan." File .sig tidak ada atau kosong. Salin file tanda tangan yang menyertai installer ke folder yang sama, lalu pilih installer lagi.

"Paket ini dibuat untuk ... Komputer ini menjalankan ...". Paket ditujukan untuk sistem operasi lain. Pilih paket yang sesuai.

"Komputer ini sedang menjalankan sesi." Pembaruan hanya dikirim saat komputer menunggu di layar kunci. Akhiri sesi terlebih dahulu atau kirim pembaruan nanti.

"Versi dalam paket ini tidak lebih baru dari yang terpasang." Ini peringatan, bukan pemblokiran. Mengirimnya akan memasang ulang build yang sama atau yang lebih lama.

"Tidak ada satu pun komputer ini yang dapat menerima paket tersebut saat ini." Semua komputer yang dipilih sedang luring, dalam sesi atau memakai platform lain.

Klien terus muncul kembali setelah saya menutupnya di komputer Windows. Ini adalah layanan updater yang sedang menjalankan tugasnya. Gunakan keluar admin di klien atau Tutup Klien dari server. Keduanya dianggap sah dan layanan berhenti mengawasi.