Güncelleme kanalınızdan ya da çevrimdışı bir paketten imzalı bir cihaz sürümü kurun, uygulanışını izleyin, geri alın ve ana makine ajanının en son neyi onardığını okuyun.

Sistem Güncellemeleri, imzalı cihaz sürümlerini kurar. Sayfa kendini doğru tarif eder: Install signed appliance updates and roll back if needed. Updates are verified and applied by the host updater. Konuştuğunuz ağ geçidi hiçbir şey kurmaz — isteğinizi kaydeder ve işi ana makinedeki ayrıcalıklı bir arka plan servisi yapar; çünkü ağ geçidinin kendi kapsayıcısını değiştirmek, aksi hâlde güncellemeyi yürüten süreci öldürürdü.

Neye ihtiyacım var?

Lisans: Any
Rol: admin_user

Ön koşullar

Cihaz ilk açılış sihirbazını tamamlamış olmalıdır.
Güncelleyici arka plan servisi cihazın ana makinesinde çalışıyor olmalıdır. Pano işi kuyruğa alır; o olmadan hiçbir şey yürütülmez.
Çevrimiçi kurulum için: cihazda yapılandırılmış bir güncelleme kanalı ve SYSTEM_UPDATE_ALLOWED_HOSTS içinde sabitlenmiş güncelleme sunucusu. Boş bir izin listesi her çevrimiçi kurulumu reddeder.
Çevrimdışı kurulum için: sürümünüze ait .cidupd paketi, müşteri portalına erişebilen bir makinede indirilmiş olmalıdır.
Güncel bir yedek ya da otomatik geri almanın yeterli olacağına dair güven. Geçişler, yeni imajlar başlamadan önce çalışır.

Screenshot pendingKurulum kartının üzerinde kurulu sürüm, güncelleme mevcut, kanal ve son güncelleme kutucuklarını gösteren Sistem Güncellemeleri sayfası/assets/screenshots/system-update@0.4.png

Kutucuklar size ne söyler

Kutucuk	Ne tutar
Installed version	Çalışan sürüm ve geri dönülebilecek bir öncekinin bulunup bulunmadığı.
Update available	Kanalın sunduğu sürüm ya da up to date.
Kanal	Kurulu sürümün geldiği kanal ve getirildiği sunucu. Bugün yalnızca `stable` vardır.
Last update	Bu oturumdaki en son koşu, from → to biçiminde ve sonucuyla.

Denetimi cihaz değil tarayıcınız yapar: sayfa yapılandırılmış kanal URL'sini okur ve bildirimi kendisi getirir. Ağdan yalıtılmış bir makinede bu getirme sessizce başarısız olur ve sayfa bunun yerine çevrimdışı yönergeleri gösterir. Hiçbir şey zamanlayıcıyla dışarıya bilgi göndermez — çevrimiçi kurulum yalnızca siz düğmeye bastığınızda çalışır ve sayfa bunu söyler.

Güncelleme kanalından kurun

Güncelleme sayfasını açın

Sistem Güncellemeleri öğesini seçin.

Daha yeni bir sürüm sunuluyorsa bir şerit, uygulanabileceği en düşük sürüm, kanal ve signed release bilgisiyle birlikte Update available: sürüm yazar.

Ne kuracağınızı okuyun

Şeridin altındaki tahmini okuyun.

Dakika cinsinden bir aralık, kaç geçişin beklediği ve bunları ölçtüğü veritabanının boyutu verilir ve yazmaların bloke olmasının beklenip beklenmediği belirtilir. Tahmin bir kez hesaplanır ve güncelleme sürerken kaymaz.

Kurulumu başlatın

Check & install öğesini ya da şeritteki düğmeyi seçin. Cihazda yapılandırılmış bir kanal varsa düğme Install sürüm, bildirim URL'sini kendiniz verdiyseniz Fetch & install sürüm yazar.

Arka plan servisi, hiçbir şey hazırlanmadan önce bildirim imzasını cihazın güven çıpalarına karşı doğrular. İmzasız ya da yanlış imzalanmış bir sürüm hiçbir zaman diske ulaşmaz.

Uygulanışını izleyin

Update in progress kutucuğunu izleyin.

Aşamayı ve iletiyi canlı akıtır: doğrulama, hazırlama, yedekleme, geçişler, yeni servislerin devreye alınması, sağlık, sonra duman testleri. Akış, ağ geçidinin güncelleme ortasında kendini yeniden başlatmasından sağ çıkar ve yaklaşık beş dakikaya kadar yeniden bağlanır.

Sonucu doğrulayın

Son aşamayı bekleyin.

Başarı done ile biter ve bir bildirim Updated to sürüm der. Installed version artık yeni sürümün adını verir ve Last update geçişi gösterir.

Çevrimdışı bir paketten kurun

Sayfa bunun için No internet? Updating an air-gapped appliance başlığı altında kendi üç adımlı özetini taşır.

Kurulu sürümü not edin

Installed version değerini okuyun.

İhtiyacınız olan paket bu sürümden uygulanabilir olmalıdır — bir sürüm, yükseltilebileceği en düşük sürümü bildirebilir.

Paketi başka bir yerde indirin

Bağlantılı bir makinede, sürüme ait .cidupd dosyasını müşteri portalından indirin.

Yalnızca bu uzantı kabul edilir.

Yükleyin

Upload bundle sekmesinde Choose bundle (.cidupd) öğesini seçin ve dosyayı seçin.

Yükleme parçalıdır ve sürdürülebilir; bir ilerleme yüzdesi gösterilir. Büyük paketler kesintisiz tek bir istek gerektirmez.

Karar vermeden önce doğrulayın

Beliren sürüm önizlemesini okuyun.

Sürümü, kanalını, uygulanabileceği en düşük sürümü, kaç servisi değiştirdiğini ve kaç geçiş taşıdığını verir. Doğrulama, kurmaya karar vermenizden önce yapılır.

Kurun

Install sürüm öğesini seçin.

Çevrimiçi kurulumdaki aynı aşamalar çalışır.

Geri alın

Danger

Geri alma, önceki sürümün imajlarını ve veritabanı anlık görüntüsünü geri yükler. Son güncellemeden bu yana yazılan veriler kaybolabilir. Onay penceresi tam olarak bunu söyler.

Önceki bir sürümün varlığını doğrulayın

Installed version değerini okuyun. Alt satırı rollback available der ve başlıktaki düğme sürümün adını verir.

Kayıtlı bir önceki sürüm yoksa düğme devre dışıdır ve arka plan servisi no previous release recorded to roll back to ile reddederdi.

Geri alın

Roll back to sürüm öğesini seçin, sonra onaylayın.

Arka plan servisi önce mevcut veritabanının anlık görüntüsünü alır, önceki sürümü ve onun anlık görüntüsünü geri yükler ve başlatır. Bir bildirim Rolled back to sürüm der.

Başarısız bir kurulum, istenmeden kendiliğinden geri alınır ve Update failed — rolled back to the previous version bildirir. Kesintiye uğramış bir güncelleme sonraki açılışta saptanır ve aynı biçimde kurtarılır.

Ana makine onarım durumunu okuyun

Bazı onarımları imzalı bir sürüm kendine yapamaz: güncelleyicinin kendi kodu, istekleri izleyen ana makine birimi, dağıtım profili ve cihazın ortam dosyasında eksik olan anahtarlar. Bunları bir ana makine ajanı yapar ve bu sayfa en son ne yaptığını bildirir.

Host repair kutucuğu, ajan sürümünü ve karşısında çalıştığı makine sürümünü verir, ardından her ana makine geçişini durumuyla — uygulandı, bekliyor, başarısız ya da atlandı — ve envanterinden gelen uyarılarla listeler. Ajanın hiç çalışmadığı bir kurulumda kutucuk gizlidir.

Note

Burada bir düğme yoktur. Ajan kendi ritminde çalışır: başlangıçtan kısa süre sonra, makinenin sürümü değiştiğinde yeniden, aksi hâlde 30 dakikada bir ve bekleyen bir şey varken dakikada bir. Herhangi bir şeye dokunmadan önce güncelleyicinin boşta olmasını bekler.

Dağıtım kipini değiştirin

Cihaz bir dağıtım kipi kaydettiğinde sayfa bunu burada sunar.

Seçenek	Sayfanın açıklaması
AI Gateway	Chat + API proxy to LLM providers with guardrails.
Inline inspection (SWG/ICAP)	Inspect browser/SWG traffic; starts cid-inline-proxy.
Both	Gateway and inline inspection together.

Bir kip seçin, sonra Apply mode öğesini seçin. Bir bildirim Deployment mode set to kip — the host is recreating the stack der ve API kısa süre yeniden başlar. Aynı anda yalnızca bir ana makine uzlaştırması çalışır; ikincisi a host reconcile is already pending; wait for it to finish ile reddedilir.

Lisansın değiştirdiği servisleri inceleyin

Lisans yüklemesinden sonra Services this license changes, ana makine profilinde etkin olan servislerle geçerli imzalı lisansın hak verdiği servisleri karşılaştırır.

Adds, yeni hak kazanılmış fakat etkin olmayan servisleri listeler. Her satır beyan edilen gereksinimi ve Suitable, Degraded, Unsuitable ya da Unknown donanım kararını taşır.
Removes, artık hak kazanılmayan etkin isteğe bağlı servisleri listeler. Ana makine ajanı bu kapsayıcıları yalnızca hak anlık görüntüsü geçerli imzalı lisans kaynağı taşıdığında durdurup kaldırır; adlandırılmış birimler ve veritabanı satırları korunur.
Unchanged, denetim ve destek için API yanıtında kalır; panel ekleme ve kaldırmalara odaklanır.

Warning

0.4 panelinde eklenen servisi kuran bir düğme henüz yoktur. İlk açılış seçimlerini Packages adımı uygular ve kaldırmalar otomatik uzlaştırılır; kurulum sonrası ekleme hâlâ desteklenen sürüm/uzlaştırma yordamını gerektirir. Ana makine profilini elle düzenlemeyin. Ana makine profili yoksa panel bütün hak kazanılmış isteğe bağlı servisleri aday olarak gösterir; bu geliştirme makinelerinde yararlıdır ancak hepsinin yerelde çalışması gerektiğini kanıtlamaz.

Panelin API'si GET /admin/system-update/service-diff yoludur. Bir satır Unknown ise ilk açılışın /etc/cid/hardware.json dosyasını yazdığını denetleyin; bilinmeyeni uygun saymayın. Birden çok servis eklemeden önce birleşik ana makine gereksinimini hesaplamak için İsteğe bağlı servisler sayfasını kullanın.

Alan başvurusu

Ayar	Nerede durur	Etkisi
`SYSTEM_UPDATE_CHANNEL_URL`	Cihaz ortamı	Tarayıcının neyin sunulduğunu öğrenmek için getirdiği bildirim. Ayarlı değilse çevrimiçi denetim yoktur.
`SYSTEM_UPDATE_ALLOWED_HOSTS`	Cihaz ortamı	Çevrimiçi bir kurulumun getirme yapabileceği sunucular. Boş olması her çevrimiçi kurulumu reddeder.
`SYSTEM_UPDATE_MAX_BYTES`	Cihaz ortamı	Aktarılan paketlere boyut üst sınırı.
`SYSTEM_UPDATE_PUBLISHER`	Cihaz ortamı	Bu kurulumu sürüm kaynağı olarak işaretler. Böyle bir makine kendi kayıt defterinden kurulum yapamaz.
`CID_VERSION`	İmaj ortamı	Ne sürüm bildirimi ne de sürüm dosyası yanıt verdiğinde gösterilen sürüm.
`CID_UPDATE_ROOT`	Cihaz ortamı	Ağ geçidi ile arka plan servisinin istek ve durum alışverişi yaptığı paylaşılan durum ağacı.

Sayfada gösterilen sürümün bir öncelik sırası vardır: etkin sürüm bildirimi, sonra güncelleyicinin uygulamada yazdığı sürüm dosyası, sonra imaja gömülü sürüm, sonra son çare temel değer.

Kayıt panelinde göreceğiniz güncelleme aşamaları: queued, trust, verifying, staging, backup, migrating, swapping, applying, restarting, adopting, health, smoke ve sonunda done, verified, failed, rollback, rolledback ya da recovering. Pano done, verified, failed ve rolledback aşamalarını son aşama sayar.

Warning

Bir güncelleme Olay Günlükleri sayfasına hiçbir satır yazmaz. Kalıcı kayıt, cihazın güncelleme durum dizinindeki arka plan servisinin kendi durum ve kayıt dosyaları ile ana makine ajanının defteridir. Değişiklik yönetimi süreciniz güncelleme kanıtı istiyorsa bunları toplayın.

Doğrulama

Installed version kurduğunuz sürümün adını verir ve alt satırı, rollback available ifadesiyle birlikte geldiğiniz sürümü verir.
Update available up to date okunur ya da yalnızca az önce kurduğunuzdan yeni bir sürüm sunar.
Last update kutucuğu from → to · ok gösterir.
Oturumu kapatıp yeniden açın, sonra bir sohbet isteği yapın ve iki yönetim sayfası açın. Üçü de başarılı olur — duman aşaması sağlığı denetler, ama dağıtımı kanıtlayan yalnızca kendi trafiğinizdir.
Varsa Host repair kutucuğu her geçişi uygulandı ya da atlandı olarak bildirir ve hiçbir başarısızlık göstermez.

Başarısız olursa

Sayfa 0.0.0 sürümünü gösteriyor ya da güncelleme düğmeleri hata döndürüyor:

Çalışma kitabıupdates