Status ve Doctor

ironflock status, bir makinede IronFlock’tan nelerin bulunduğunu ve çalışıp çalışmadığını gösterir. ironflock doctor, bir makinenin cihaz ajanını çalıştırıp çalıştıramayacağını ve ajanın iletişim kurduğu ana bilgisayarlara erişip erişemediğini denetler. Bu komutları bir makineyi bağlamadan önce ve bir cihaz çevrimiçi olmadığında kullanın.

İki komut da hiçbir şeyi değiştirmez ve hiçbir şey sormaz. Linux ve macOS’ta root olmadan çalışırlar, root olarak daha fazlasını okurlar. --host ile başka bir makinede, aynı anda birkaç makinede de çalışırlar (SSH Üzerinden Uzak Makineler). Orada SSH kullanıcısı root olduğunda ya da sudo komutunu parola ve terminal olmadan kullanabildiğinde root olarak çalışırlar; aksi hâlde soru sormadan SSH kullanıcısı olarak çalışırlar ve ipuçları komutu --host root@machine ile belirtir.

ironflock status

Bu makinenin cihaz ajanını, Appliance’ını ve işletim sistemini gösterir: neyin kurulu olduğunu, sürümünü, hizmetinin çalışıp çalışmadığını, cihazı ve projesini ve ajanın son kendi kendini güncellemesini. Appliance, sahadaki bir makinede çalışan eksiksiz IronFlock sistemidir (IronFlock Appliance); bir Appliance için komut ayrıca arayüzünün adresini, lisansını, hizmetlerinin sağlığını ve bekleyen bir güncellemeyi gösterir (Appliance Komutları). IronFlockOS’ta komut ayrıca kök yuvalarını ve ilgilenilmesi gereken durumları gösterir.

ironflock status [flags]

Çalıştığı sistemler: Linux; macOS’ta sistemi ve hiçbir şeyin kurulu olmadığını gösterir. Root: gerekmez; birkaç bilgi için gerekir. Sorular: yok.

Komutun kendine ait bayrağı yoktur. Genel bayrakları kabul eder (Genel Bayraklar).

Root olmadan bazı bilgiler okunamaz: ajanın .flock dosyasını yalnızca root okuyabildiği için cihaz ve projesi; /opt/ironflock klasörü root’a ait olan bir Appliance’ta ayrıca sürümler, Appliance’ın URL’si, lisansı ve güncellemesi ile ajanın güncellemesi. Appliance hizmetlerinin sağlığı root ya da docker grubu gerektirir. Bunlar unknown (needs root) olarak görünür, needs_root JSON alanı bunları listeler ve sudo ironflock status bunları okur.

# Bu makinede neler var, kendi kullanıcınızla okunur
ironflock status
# Her şey, JSON olarak
sudo ironflock status --json
# Başka bir makinenin durumu, SSH üzerinden
ironflock --host pi@device-17 status

Metin Çıktısı

$ ironflock status
Agent:         installed in /opt/ironflock/device-agent
  Version:     1.6.9
  Service:     running (ironflock-device-agent.service)
  Connection:  unknown (this agent does not report it)
  Device:      unknown (needs root)
  Swarm:       unknown (needs root)
  Update:      none pending
Appliance:     not installed
System:        Debian GNU/Linux 12 (bookworm)

Run 'sudo ironflock status' to read what needs root.

Swarm, cihazın projesidir. Çalışan bir ajan için Connection değeri unknown olur: şimdiye kadar yayımlanan ajanlar bağlantılarını makinede bildirmez.

IronFlockOS’ta

Sistem satırı görüntüyü ve iki kök yuvasını gösterir (Kök Yuvaları ve Veri Bölümü):

System:        IronFlockOS 0.13.0 (amd64-efi, base)
  Image:       ironflockos-amd64-efi-base (build 20261105T120000Z-g1a2b3c4)
  Slot A:      inactive, good
  Slot B:      booted, good, 0.13.0 installed 2026-11-05T14:00:00Z
  Next boot:   slot B

Bir IronFlockOS cihazının ajanı, cihaz kaydolduğunda görüntünün kurduğu ajandır; /data üzerinde /opt/ironflock/device-agent klasöründe bulunur ve diğer sistemlerdeki gibi gösterilir. Henüz kaydolmamış bir cihazın ajanı yoktur; görüntü bir ajan taşır ve satır cihazın nasıl kaydolacağını söyler (aşağıdaki ilk satır). /data bu açılışta bağlanamadıysa ajanın klasörü de, cihaz kaydolmuş olsun ya da olmasın, görünmez ve satır bunun yerine bunu söyler (ikinci satır):

Agent:         not enrolled yet: the device enrolls with a .flock on its IRONFLOCKOS partition at its next start, or now with 'sudo ironflock agent configure -c <file>'
Agent:         not to be seen: /data, which holds the agent and its .flock, could not be mounted (below); a .flock on the IRONFLOCKOS partition enrolls the device at its next start for as long as /data is missing

Sistemin altında, her biri için bir satır yalnızca IronFlockOS’un söyleyecek bir şeyi olduğunda görünür:

  Last reset:  gave up after 3 attempts at 2026-11-11T09:00:00Z: the data partition is not the partition named data on the disk of the root slot; /data holds the old data; left of the old owner: the data partition, the booted root slot, the other root slot
  Reset hold:  wait: a reset is open; a .flock or proxy.conf on the IRONFLOCKOS partition is not taken while the old owner's data may be on /data
  /data:       NOT MOUNTED: the device runs on the root slot's own folders; Docker and the apps do not run, and what is written now is lost with the next update
  /apps:       not the data partition's folder: the apps run, but lose their data at the next OS update

Bir sıfırlamanın başarısız bir denemesi, bekletme wait veya copy iken attempt 1 of 3 failed at <time>: <reason>; /data holds the old data; the next start tries again, bekletme yokken no request is open now olarak görünür. Root olmadan gösterilen sıfırlama kaydı, çalışan yuvadaki kopyasıdır, çünkü IRONFLOCKOS bölümü root’a aittir.

Son os install

EFI değişkenleri olan her Linux’ta OS install: satırı, son ironflock os install çalıştırmasının IronFlock’un IronFlockInstall EFI değişkenine kaydettiğini, değişken varsa gösterir. Her kullanıcı değişkeni okuyabilir. Değişkenin okunamadığı yerde ya da makinede EFI değişkenleri yoksa satır da uyarı da yoktur; ayrıştırılamayan bir değer uyarıya yol açar.

System:        Debian GNU/Linux 13 (trixie)
  OS install:  'ironflock os install' stopped at 2026-11-11T10:00:00Z before it wrote the disk: the disk /dev/sda is not the plan's: its size changed from 64.0 GB to 32.0 GB; nothing was changed, and this system runs as before

Kayıt hiçbir zaman silinmez. Satır, bir sonraki os install onu değiştirene kadar kalır; dönüştürülmüş bir cihazda da sistemin bu şekilde kurulduğuna dair not olarak kalır.

JSON Sonucu

--json aynı bilgileri tek bir JSON nesnesi olarak yazar; nesne burada birkaç satırda gösterilmiştir, komut onu tek satırda yazar.

{
  "agent": {
    "installed": true,
    "layout": "current",
    "dir": "/opt/ironflock/device-agent",
    "version": "1.6.9",
    "service": {"unit": "ironflock-device-agent.service", "state": "running"},
    "connection": "unknown",
    "device": "demo-device",
    "swarm": "demo_swarm",
    "update": {"state": "none"}
  },
  "appliance": {"installed": false},
  "os": {"name": "Debian GNU/Linux 12 (bookworm)", "id": "debian", "version": "12", "ironflockos": false},
  "needs_root": []
}

Okunamayan bir bilgi unknown olur; nedeni root değilse stderr’deki bir uyarı nedenini söyler.

Çıkış Kodu

Genel bakış yazıldığında çıkış kodu her zaman 0’dır; durdurulmuş bir ajan, geri alınmış bir güncelleme veya hatalı bir yuva gösterdiğinde de: status raporlar, yargılamaz; alanları bir betik okur. Genel bakış yazılamadığında 1’dir. Diğer çıkış kodları için bkz. Çıkış Kodları.

ironflock doctor

Bu makinenin cihaz ajanını çalıştırıp çalıştıramayacağını ve ajanın iletişim kurduğu ana bilgisayarlara erişip erişemediğini denetler: sistem, systemd, Docker, boş disk alanı, saat, DNS, proxy, indirme sunucusu ve cihazın .flock dosyasının belirttiği ana bilgisayarlar.

ironflock doctor [flags]

Çalıştığı sistemler: Linux ve macOS. Root: gerekmez; root olmadan bakamayan bir denetim skipped olur ve bunu söyler. Sorular: yok.

agent install, herhangi bir şeyi değiştirmeden önce bu denetimleri privileges ve docker dışında çalıştırır ve system, systemd, disk_space veya download_tree başarısız olduğunda durur.

# Bu makineyi kendi kullanıcınızla denetleyin
ironflock doctor
# Her şeyi root olarak denetleyin, JSON olarak
sudo ironflock doctor --json
# Bir .flock dosyasının ana bilgisayarlarını, dosyayı kurmadan önce denetleyin
ironflock doctor -c device.flock

Sonuçlar

Her denetimin bir kimliği, bir sonucu ve tek satırlık bir bulgusu vardır. ok dışındaki bir sonuç, ne yapılacağını söyleyen bir ipucuyla gelir.

Denetimler

Denetimler, gösterildikleri sırayla aşağıdadır. Bir denetim kimliğini korur; yeni bir denetim yeni bir kimlik alır.

İndirme sunucusu, agent install komutunun kullandığı sunucudur: --download-base, yoksa IRONFLOCK_DL_BASE ortam değişkeni, yoksa .flock dosyasının belirttiği Appliance’ın indirme yansısı (update_url değeri IronFlock bulutunun bir ana bilgisayarı değilse) ve yansının vermedikleri için bulut, o da yoksa IronFlock bulutu (Ajan Nereden Gelir). Bir cihazın erişmesi gereken ana bilgisayarlar Ağ Gereksinimleri sayfasında listelenir.

-c ve Root Varken ve Yokken

Son üç denetim bir .flock dosyası gerektirir: -c ile verilen, yoksa kurulu ajanınki.

Root olmadan ayrıca docker, docker grubunun dışında skipped olur; kurulum proxy’yi kaydettiyse proxy da skipped olur. Bu durumda ana bilgisayarı yanıt vermeyen bir ağ denetimi de skipped olur (dns için çözümlenmeyen bir ad), çünkü kayıtlı proxy üzerinden yanıt alabilir. privileges bakamayan her denetimi belirtir ve sudo ironflock doctor bunları çalıştırır.

Ağ Denetimleri Nasıl Karar Verir

• Durum kodu ne olursa olsun bir HTTP yanıtı geldiğinde ana bilgisayar yanıt vermiş sayılır. Proxy üzerinden yapılan düz bir HTTP isteğine gelen 502, 503 veya 504 yanıt sayılmaz: proxy bunları ana bilgisayara erişemediğinde verir.
• TLS’nin reddettiği bir sertifika yanıt sayılmaz. Tek istisna, .flock dosyası bir appliance_domain belirttiğinde bir Appliance’ın kendi CA’sının sertifikasıdır: ajan ona güvenir.
• Denetimler proxy denetiminin proxy’si üzerinden, indirmelerin uyduğu HTTPS_PROXY, HTTP_PROXY ve NO_PROXY kurallarına göre, bir yönlendirmenin her isteği için de, gider ve yanıt için 20 sn bekler.
• NO_PROXY içindeki bir girdinin proxy dışında tuttuğu bir ana bilgisayara doğrudan gidilir. O yoldan yanıt gelmezse bulgu girdiyi belirtir, örneğin (directly: instance-registry.ironflock.com is in NO_PROXY); ipucu da girdiyi çıkarmanızı söyler ve ayar kurulumun kaydıysa bunu yapan agent configure --no-proxy komutunu verir.

Çıktı

$ sudo ironflock doctor
Download base: https://instance-registry.ironflock.com/dl
Device file:   /opt/ironflock/device-agent/device-config.flock

CHECK            RESULT  FINDING
privileges       ok      runs as root
system           ok      Debian GNU/Linux 12 (bookworm), amd64
systemd          ok      systemd runs this system
docker           ok      Docker 27.3.1 runs
disk_space       ok      50.0 GB free for /opt and /var
clock            ok      within 10 s of the download server's clock
dns              ok      resolves instance-registry.ironflock.com, cbw.ironflock.com, europe-docker.pkg.dev
proxy            ok      none: the connections go direct
download_tree    ok      https://instance-registry.ironflock.com/dl has the agent 1.6.9 for amd64
device_endpoint  ok      cbw.ironflock.com answers
docker_registry  failed  europe-docker.pkg.dev cannot be reached: no answer within 20 s
update_server    ok      https://instance-registry.ironflock.com/dl has the agent's updates

What to do:
  docker_registry: the device pulls its apps' images from there: let this machine reach europe-docker.pkg.dev on port 443, directly or through the proxy

Failed: docker_registry.

.flock dosyasındaki Appliance yansısıyla ilk satır bunu söyler:

Download base: http://10.0.0.5:15002/dl (the appliance's mirror of the .flock; the IronFlock cloud for what it does not give)

--json ile çıktı, burada kısaltılmış ve birkaç satırda gösterilmiştir; komut tek satır yazar.

{
  "result": "failed",
  "checks": [
    {"id": "privileges", "result": "ok", "finding": "runs as root"},
    {"id": "docker_registry", "result": "failed", "finding": "europe-docker.pkg.dev cannot be reached: no answer within 20 s", "hint": "the device pulls its apps' images from there: let this machine reach europe-docker.pkg.dev on port 443, directly or through the proxy"}
  ],
  "download_base": "https://instance-registry.ironflock.com/dl",
  "flock": "/opt/ironflock/device-agent/device-config.flock"
}

Hiçbir çıktı gizli bir bilgiyi göstermez: denetimler bir .flock dosyasından yalnızca ana bilgisayarları okur, bir proxy’nin parolası da xxxxx olarak görünür.

Çıkış Kodu

Hiçbir denetim başarısız olmadığında çıkış kodu 0’dır; bir uyarı başarısızlık sayılmaz. Bir denetim başarısız olduğunda 1’dir: sonuç hangisi olduğunu söyler, ardından hata satırı gelmez ve --json ile stdout’ta hata nesnesi değil sonuç bulunur. -c ile verilen .flock dosyası okunamadığında bir hatayla birlikte 1’dir. Diğer çıkış kodları için bkz. Çıkış Kodları.