sys-cmd support

sys-cmd support, WEB-CLI'de TR7 destek ekibinin bir sorunu incelemesi için gereken kanıtları — sistem durumu, servisler, vService durumları, ağ bilgileri, grafik verileri, maskelenmiş yapılandırma ve servis günlükleri — tek bir zip dosyasında toplayan destek paketi komutudur. Paket varsayılan olarak anonimleştirilir: IP adresleri, alan adları, nesne adları ve e-posta adresleri pakette tutarlı takma adlarla yer alır. İki alt komutu vardır: collect paketi üretir, list üretilmiş paketleri listeler.

Komut Özeti

TR7 WEB-CLI · sys-cmd support

# support yazıp Tab

admin@TR7LBWAF01> sys-cmd support

collect  list

 

# collect yazıp iki kez Tab: ilk basış -- yazar, ikincisi alanları listeler

admin@TR7LBWAF01> sys-cmd support collect

--escrow-map  --modules  --pool  --profile  --seal  --since  --skip-vendor

 

admin@TR7LBWAF01> sys-cmd support collect

admin@TR7LBWAF01> sys-cmd support list

admin@TR7LBWAF01>  

Bu komutta zorunlu alan yoktur. support collect tek başına yazıldığında anonim profille, son 7 günün loglarıyla ve bütün modüllerle paket üretir.

sys-cmd support collect

Alanlar

Alan	Ne yapar	Arkasına ne yazılır
--profile	Paketin gizlilik profilini seçer	anon (varsayılan) · minimal · full — aşağıdaki tabloda
--since	Log ve kayıt dosyalarının ne kadar geriye gidileceğini belirler	1–3 basamaklı sayı ve h (saat) ya da d (gün): 12h · 7d · 20d. Varsayılan 7d, en çok 30d
--modules	Yalnız belirtilen modülleri toplar	Virgülle ayrılmış modül adları: system,network. Virgülden sonra boşluk bırakılmaz; bırakılırsa sonraki ad ayrı bir sözcük sayılır ve Command not found hatası verir. Varsayılan: hepsi
--pool	vService durumlarını ve üretici bölmesindeki vService yapılandırmalarını tek bir vService'e daraltır	vService kimliği; harf, rakam, _ ve -, en çok 64 karakter
--skip-vendor	Şifreli üretici bölmesini pakete hiç koymaz	Değer yazılmaz
--seal	Müşteri içeriğini de şifreli bir zarfa koyar; pakette düz metin olarak yalnız manifest ve özet kalır	Değer yazılmaz
--escrow-map	Takma adların gerçek karşılıklarını gösteren tabloyu şifreli üretici bölmesine ekler; önce onay ister	Değer yazılmaz

Alanlar -- önekiyle ve herhangi bir sırada yazılır. vService kimlikleri lb service list çıktısında görülür.

Gizlilik Profilleri

--profile	Pakete ne girer
anon	Bütün modüller toplanır. IP ve MAC adresleri, e-posta adresleri, bilinen host ve nesne adları paket içinde tutarlı takma adlara çevrilir. Trafik hacimleri, zaman desenleri, kimlik numaraları, iç olmayan port numaraları ve serbest metin içindeki kullanıcı adları anonimleştirilmez. Anonimleştirilemeyen ikili dosyalar pakete konmaz.
minimal	Servis günlükleri, bileşen günlükleri, vService günlükleri ve ağ ayrıntısı hiç toplanmaz; yapılandırma yalnız yapı özetine indirilir. Kalan içerik anon gibi anonimleştirilir.
full	Her şey olduğu gibi, anonimleştirilmeden toplanır.

Modüller

Modül	İçerik
system	İşlemci, bellek, disk doluluğu, çalışan süreçler, zaman eşitleme durumu ve sistem uyarıları
services	Servislerin çalışma durumu ve TR7 servis günlüklerinin son satırları
vservices	vService durumları, durum değişikliği kayıtları ve backend sağlık kontrolü kayıtları
network	Cihazın ve route table'ların adresleri, yönlendirmeleri ve bağlantı özetleri
containers	TR7 bileşenlerinin listesi, kaynak kullanımı ve günlüklerinin son satırları
metrics	Son 24 saatin işlemci, bellek, yük ve ağ grafik verileri
config	Parolaları ve gizli değerleri maskelenmiş yapılandırma dosyaları ve cihaz kimliği
journals	Servis günlükleri; --since penceresiyle sınırlı. minimal profilde toplanmaz
vendor	Yalnız TR7 destek ekibinin açabileceği şifreli üretici bölmesi

Modüller her zaman bu tablodaki sırayla toplanır; --modules yalnız hangilerinin toplanacağını belirler.

Örnekler

TR7 WEB-CLI · A) Varsayılan paket

admin@TR7LBWAF01> sys-cmd support collect

collect started (profile=anon, since=7d, modules=system,services,vservices,network,containers,metrics,config,journals,vendor, budget=256MB)

[system] collecting...

[system] ok (…)

…

done: support-<cihaz>-<tarih-saat>.zip (…KB)

Paket hazır: support-<cihaz>-<tarih-saat>.zip (…)

https://<yönetim-adresi>/api/sys_cmd/files/support-<cihaz>-<tarih-saat>.zip

admin@TR7LBWAF01>  

TR7 WEB-CLI · B) Son 12 saat, yalnız sistem, servis ve vService bilgisi

admin@TR7LBWAF01> sys-cmd support collect --since 12h --modules system,services,vservices

admin@TR7LBWAF01>  

TR7 WEB-CLI · C) Tek vService için en az bilgiyle

admin@TR7LBWAF01> sys-cmd support collect --profile minimal --pool <vservice-kimliği>

admin@TR7LBWAF01>  

TR7 WEB-CLI · D) Bütün içerik şifreli zarfta

admin@TR7LBWAF01> sys-cmd support collect --seal

admin@TR7LBWAF01>  

TR7 WEB-CLI · E) Takma ad tablosuyla

admin@TR7LBWAF01> sys-cmd support collect --escrow-map

⚠  Takma ad çözüm tablosunu pakete eklemek üzeresiniz

    Bu tablo, paketteki takma adların (IP, alan adı, nesne adı, e-posta) GERÇEK karşılıklarını içerir ve yalnız şifreli üretici bölmesine (vendor.tr7) yazılır — TR7 destek ekibi paketi anonimlikten çıkarabilir hale gelir. Onaylamazsanız paket haritasız üretilir.

 

Devam etmek için "evet" yazın: evet

admin@TR7LBWAF01>  

sys-cmd support list

Geçici dosya alanındaki destek paketlerini en yenisi üstte olacak biçimde listeler. Tablo sütunları: Dosya adı, Dosya boyutu, Son değiştirme tarihi ve Link. Paket, Link sütunundaki adresten indirilir; indirme işlemi kullanıcı loglarına yazılır.

TR7 WEB-CLI · support list

admin@TR7LBWAF01> sys-cmd support list

# indirilen paketi sil

admin@TR7LBWAF01> sys-cmd file delete support-<cihaz>-<tarih-saat>.zip

admin@TR7LBWAF01>  

Paketin İçeriği

Dosya ya da klasör	İçerik
summary.txt	Cihaz, sürüm, seçenekler, özet bulgular, modül sonuçları ve notlar; düz metin
manifest.json	Paketteki her dosyanın adı, boyutu ve özet değeri, modül süreleri ve notlar; düz metin
overview/	Hızlı inceleme için özet veriler
customer/	Modüllerin topladığı içerik; --seal verildiğinde bu içerik customer.tr7 şifreli zarfına taşınır
vendor.tr7	Şifreli üretici bölmesi; --skip-vendor verildiğinde ya da şifreleme anahtarı bulunmadığında üretilmez

Nasıl Çalışır

Konu	Davranış
Bağlam	Seçili v-device ve route table'dan etkilenmez; her zaman cihazın kendisinden toplar.
İlerleme	Her modül için [modül] collecting... ve sonuç satırı yazılır. Yavaşlayan bir modül süre sınırında (servis günlüklerinde 60, diğerlerinde 20 saniye) atlanır, paket yine üretilir ve durum summary.txt içine not düşülür.
Tek iş	Aynı anda yalnız bir paket üretilir; sürerken ikinci bir collect reddedilir.
Boyut	Pakete eklenen içerik, sıkıştırma öncesinde en çok 256 MB ya da geçici alandaki boş yerin 64 MB eksiği kadar olur; --seal ile sınır 64 MB'tır. Sınıra ulaşılınca kalan dosyalar atlanır ve not düşülür.
Eski paketler	Yeni paket üretilmeden önce en yeni paket dışındaki eski paketler silinir; alanda en çok iki paket kalır.
Zaman aşımı	WEB-CLI paketi en çok 15 dakika bekler.
Kayıt	Komut satırı ve paket seçenekleri kullanıcı loglarına yazılır.

Hata İletileri

İleti	Anlamı ve çözümü
Geçersiz --profile değeri: '…'. Bilinenler: anon, minimal, full	Profil adı yanlış yazıldı
Geçersiz --since değeri: '…'. Örnek: 12h, 7d, 20d	Süre biçimi yanlış; sayı ve h ya da d bitişik yazılır
Geçersiz modül: …. Bilinenler: …	Modül adı yanlış yazıldı
Geçersiz vService kimliği.	--pool değeri izin verilmeyen karakter içeriyor
A support bundle collection is already running	Başka bir paket üretimi sürüyor; bitmesi beklenir
Not enough free space on … Delete files ('file delete') or grow the disk ('file change-size').	Geçici alanda 16 MB'tan az boş yer var; file delete ile yer açılır ya da file disk change-size ile alan büyütülür
--seal requested but the support bundle public key is missing	Şifreli zarf için gereken anahtar cihazda yok; paket üretilmez, komut --seal olmadan yeniden çalıştırılır
Since token too large	--since değeri 30 günü aşıyor
Destek paketi işi zaman aşımına uğradı (15 dk).	WEB-CLI 15 dakika bekledi; paket üretimi arka planda sürebilir ve bir süre sonra support list ile bakılır. Sonraki denemelerde --since kısaltılır ya da --modules ile daraltılır

Bilinmesi Gerekenler

• --since 30 günü aşamaz. 45d gibi bir değer biçim olarak kabul edilse de paket işi Since token too large hatasıyla başlatılmaz.
• --escrow-map her zaman işe yaramaz. full profilde takma ad olmadığı, --skip-vendor ile de üretici bölmesi bulunmadığı için tablo eklenmez; bu durum summary.txt içine not düşülür. Onay ekranındaki Onaylamazsanız paket haritasız üretilir ifadesine karşın, bu sürümde onay verilmezse paket hiç üretilmez; tablo istenmiyorsa komut --escrow-map olmadan yeniden çalıştırılır.
• Paket göndermeden önce summary.txt açılarak hangi modüllerin toplandığı ve hangi notların düşüldüğü görülebilir.
• diag- önekli eski paketler. support list ve yeni paket üretilirken yapılan otomatik temizlik yalnız adı support- ile başlayan paketleri kapsar. Adı diag- ile başlayan eski tanı paketleri bu listede görünmez ve kendiliğinden silinmez; file list ile görülür, file delete ile silinir.
• Paketler geçici dosya alanında tutulur; file komutlarıyla da listelenir, indirilir ve silinir.