Bu sayfa, cihaz ayarlarını Hermetry üzerinden elle veya API aracılığıyla, tek bir cihazda ya da çok sayıda cihazda değiştiren yöneticiler ve entegratörler içindir. Ayarlar sekmesinin arkasındaki kuralları ve bunların güvenle nasıl kullanılacağını açıklar. Sekmenin nasıl açılacağı, baseline’ların nasıl oluşturulacağı ve işlerin nasıl başlatılacağı Uzaktan cihaz ayarları sayfasında; route’lar ise Firmware ve cihaz ayarları API’si sayfasındadır.
Desired ve reported değerler
Hermetry, bir cihazın her ayar bölümü için iki doküman tutar:
- Desired: Hermetry’nin cihazdan en son çalıştırmasını istediği ayarlar; her değişiklikle artan bir revizyon numarası taşır.
- Reported: Cihazın çalıştırdığını bildirdiği ayarlar; uyguladığı revizyonla birlikte.
Her değişiklik, yalnızca değişen anahtarları değil bölümün tamamını cihaza gönderir. Cihaz bir bölümü yalnızca revizyonu uyguladığı son revizyondan yüksekse uygular. Cihazı çok uzun süre bekleyen bir bölüm geri çekilir; cihaz da mevcut ayarlarını korur.
| Ayarlar sekmesindeki durum | Anlamı |
|---|---|
| Yolda | Gönderildi veya cihazın çevrimiçi olması bekleniyor |
| Cihaz deniyor | Cihaz değişikliği deneme amaçlı çalıştırır ve buluta yeniden ulaşamazsa kendi kendine geri alır |
| Uygulandı | Cihaz değişikliği çalıştırıyor |
| Cihaz tarafından geri alındı | Cihaz denedi ve eski haline döndü |
| Cihaz reddetti | Cihaz kabul etmedi |
| Cihaz çevrimdışıydı | Değişiklik çok uzun süre bekledi (tek bir değişiklik için 7 gün) ve geri çekildi |
| Güncelleme sonrası kontrol | Bir firmware güncellemesi bölümün açıklamasını değiştirdi; bir kişinin gözden geçirip kaydetmesi gerekir |
| Cihazda değiştirildi | Drift: cihaz, Hermetry’nin istediğinden farklı değerler çalıştırıyor (aşağıda) |
| Buradan değiştirilmedi | Hermetry bu bölümü hiç ayarlamadı; yalnızca cihazın bildirdiğini gösterir |
Bir değişiklik nasıl oluşturulur
Bir bölümü yazmanın iki yolu vardır ve dışarıda bıraktığınız şeylere farklı davranırlar.
| Yol | Kullanan | Ne gönderirsiniz |
|---|---|---|
| Tüm bölüm | Ayarlar sekmesi, PUT | Bölümün her değeri. Dışarıda bıraktığınız şey yeni bölümün parçası olmaz. |
| Merge patch | PATCH, baseline’lar, ayar işleri | Yalnızca değişenler, JSON merge patch (RFC 7386) olarak |
Bir merge patch tam olarak şu kurallara uyar:
- Nesneler anahtar anahtar birleştirilir. Adını vermediğiniz bir anahtar değerini korur.
nullanahtarı kaldırır.- Diğer her değer eskisinin yerini bütünüyle alır. Liste her zaman bütünüyle değiştirilir: bir listenin tek bir girdisini değiştirmek için listenin tamamını gönderin.
Patch, cihazın bildirdiğine değil, bölümün son desired dokümanına uygulanır. Yalnızca Hermetry bölümü hiç ayarlamadıysa patch reported değerlerden başlar; cihaz bölümü henüz bildirmediyse de yazma reddedilir (section_not_reported).
İyi uygulama:
- Baseline’a yalnızca değiştirmek istediklerinizi koyun. Geri kalan her şey her cihazda olduğu gibi kalır.
- Anahtarın işteki her cihazdan kaybolması gerekmiyorsa baseline’a asla
nullkoymayın. - Cihaza özgü listeleri (örneğin sahaya göre değişen adres listeleri) baseline’lara koymayın: baseline’ın listesi her cihazın listesinin yerini alır.
- Açıklamada yalnızca cihazda değiştirilebilir olarak işaretlenen ayarlar cihazın raporundan korunur. Bunlara yapılan değişiklik reddedilir (
remote_forbidden). - Hiçbir şey gönderilmeden önce bir değişikliğin hangi ayarlara dokunduğunu ve onay gerektirip gerektirmediğini görmek için
?dryRun=true(veya bir işte Kontrol et) kullanın.
Revizyonlar ve If-Match
Bir bölümü okumak, desired revizyonunu W/"7" biçiminde ETag başlığı olarak döndürür. Her yazma bu revizyonu If-Match içinde geri göndermelidir; "7" ve 7 da kabul edilir.
| Yanıt | Anlamı |
|---|---|
428 if_match_required | Yazmada If-Match yoktu |
412 rev_mismatch | Siz okuduktan sonra biri bölümü değiştirdi |
412 durumunda bölümü yeniden okuyun, değişikliğinizi yeni doküman üzerine yeniden oluşturun ve tekrar yazın. Yeni revizyonu başlığa kopyalayıp eski dokümanı yeniden göndermeyin: bu, diğer kişinin değişikliğinin üzerine yazar. Ayarlar sekmesi de aynı kontrolü yapar (“Bu ayarlar siz açtıktan sonra başka biri tarafından değiştirildi. En günceli görmek için yeniden yükleyin.”).
Drift
Cihaz Hermetry’den gelen bir değişikliği uyguladıktan sonra farklı değerler bildiriyorsa, genellikle biri cihazın kendisinde değiştirdiği için, bölüm drift etmiş demektir. Sekme “Cihazda değiştirildi” ifadesini ve nelerin farklı olduğunu gösterir. Hermetry drift’i kendiliğinden düzeltmez. Siz seçersiniz:
| Eylem | Etki |
|---|---|
| Bizimkini yeniden gönder | Hermetry’nin desired değerlerini yeni bir revizyon olarak yeniden gönderir |
| Cihazınkini koru | Cihazın mevcut değerlerini yeni desired değerler olarak kaydeder |
Drift etmiş bir bölümü başka bir yolla değiştirmeden önce drift’i çözün. Bir merge patch ve dolayısıyla bir ayar işi son desired dokümandan başlar; bu yüzden drift eden ayarlar için de Hermetry’nin değerlerini geri gönderir.
Her ayarın kime ait olduğuna karar verin. Sahadaki teknisyenlerin bir şeyi değiştirebilmesi gerekiyorsa onu baseline’ların ve işlerin dışında tutun.
Secret’lar
- Gizli ayarlar (parolalar, anahtarlar) asla gösterilmez veya döndürülmez.
{ "set": true }olarak okunurlar. - Yeni bir secret cihaza tek kullanımlık bir referans olarak iletilir. Cihaz değeri imzalı bir istekle bir kez alır; alınmayan bir referansın süresi 30 gün sonra dolar. Firmware’i referans alamayan bir cihaz hiç secret almaz: değişiklik reddedilir (
secret_ref_unsupported). - Cihazın mevcut secret’ını korumak için alanı değiştirmeden bırakın (API’de
{ "$keep": true }). - Baseline’lar secret içeremez (
secret_not_allowed). Bunları her cihazda ayarlayın. secret_pending: önceki bir değişiklik, cihazın henüz almadığı bir secret taşıyor. Bekleyin veya secret’ı yeniden girin.- Yeniden gönder sırasında
secrets_need_rewrite: değişiklik, cihazın artık alamadığı secret’lar taşıyor. Bunları yeniden girip kaydedin.
Ayar işleri
Bir iş, bir baseline’ı veya tek bir değişikliği birçok cihaza dalgalar halinde uygular. İyi uygulama:
- Test ettiğiniz model ve firmware’e göre seçin. Kontrol et adımı cihazları model ve firmware’e göre ve bir modelde bulunmayan bölümleri gösterir.
- Dalgaları koruyun. Varsayılan %1, sonra %10, sonra geri kalanıdır. İlk dalga, seçilen cihazlardan sabit bir rastgele kesittir.
- Gate’i anlayın. Yanıt veren cihazlar arasında en az %95’i değişikliği uyguladıysa ve en fazla %1’i geri aldıysa dalga geçer (varsayılanlar). Reddeden cihazlar yanıt verenler arasında sayılır, bu yüzden uygulanan payı düşürür. Hâlâ çevrimdışı olan cihazlar sayılmaz. Bir dalga, tüm cihazları yanıt verdiğinde ya da başladıktan 30 dakika sonra (varsayılan) o ana kadar yanıt veren cihazlar üzerinden değerlendirilir; diğerleri arka planda devam eder. Geçen bir dalga sonrakini beklemeden hemen başlatır. Hiçbir cihazın yanıt vermediği bir dalga işi duraklatır.
- Çakışmada ne olacağını seçin. Bir cihazın bölümünde aynı anda yalnızca bir değişiklik sürebilir. İş, başka bir işin değişikliğini bekler (ve 24 saat sonra cihazı atlar) veya cihazı hemen atlar. İş beklerken bir kişinin yaptığı değişiklik geçerli olur.
- Çevrimdışı cihazlar için ne kadar bekleneceğini ayarlayın: varsayılan 7 gün, 1 ile 90 arası.
- İptalin geri almadığını unutmayın. Zaten değişen cihazlar yeni ayarlarını korur.
Bir iş, oluşturanın sahip olduğu izinlerle yazar ve tehlikeli ayarları değiştiren bir iş oluşturulurken onaylanmalıdır. Aynı anda en fazla 5 iş çalışabilir veya duraklatılmış halde bekleyebilir, bir iş en fazla 5.000 cihaz içerir ve dakikada en fazla 200 cihaza değişiklik gönderir.
Firmware güncellemeleri ve eski firmware
- Bir firmware güncellemesinden sonra Hermetry, saklanan istenen değerleri yeni firmware’in ayar tanımına dönüştürür. Güvenli biçimde dönüştürülemeyenler “Güncellemeden sonra kontrol edin” olarak işaretlenir. Bölüm, bir kişi kaydedene kadar bu durumda kalır; cihazdan gelen raporlar bu durumu kapatmaz ve bir job bu tür bir cihazı reddedilmiş sayar.
- Destek penceresi: ayar yazma işlemleri, ayar tanımında kayıtlı olduğu üzere cihaz firmware’inin yayın tarihinden 24 ay sonra durur. Ayarlar okunabilir kalır (“Salt okunur: ayarları değiştirmek için firmware’i güncelleyin”). Bir yazma isteği, pencerenin bittiği tarihle birlikte
409firmware_too_oldyanıtı verir. - Bir job bu tür cihazları önceden dışarıda bırakmaz. Sıraları geldiğinde reddedilirler ve dalganın eşiğine sayılırlar. Önce firmware’lerini güncelleyin ya da bunları seçimin dışında bırakın.
Değişiklik hızı
Settings sekmesinden ve API’den yapılan tekil değişiklikler, Yeniden gönder dahil, kuruluş başına dakikada 600 ile sınırlıdır; bunun üzerinde 429 write_rate_limited döner. Bir job’un kendi cihazlarına yaptığı yazma işlemleri bu sınıra dahil edilmez.

