System Commands

System Commands, WEB-CLI'de sys-cmd ile başlayan komut dalıdır. Cihaz üzerinde önceden tanımlanmış bir araç kümesini çalıştırır: ping, dig, tcpdump, curl gibi ağ tanılama araçları; bellek, veri diski ve yönetim erişim servisi bakımı; destek paketi üretimi ve bu komutların ürettiği geçici dosyaların yönetimi. Serbest bir kabuk değildir: yalnız Tab listesinde görünen komutlar çalışır.

superAdmin

Yalnız tam yetkili kullanıcı

Dal bir kabuk erişimi sayılır; komutlar yalnız superAdmin kullanıcılar için çalışır.

vDevice / Route table

Çalışma bağlamı

Ağ araçları, seçili v-device ve route table içinden çalışır.

User Logs

Her komut kaydedilir

Çalıştırılan komut satırı ve indirilen geçici dosyalar kullanıcı loglarına yazılır.

Pipe

Çıktıyı işleme

Çıktı | ile süzülür, sıralanır ya da to-file ile dosyaya yazılır.

Kısa sözdizimi:

sys-cmd <komut> [parametreler] [ | <pipe-komutu> … ]

Komut Özeti

TR7 WEB-CLI · sys-cmd

# sys-cmd yazıp Tab: dalın bütün komutları

admin@TR7LBWAF01> sys-cmd

curl               debug              dig                extend-data-disk

file               fping              h1load             ip

ipcalc             management-access  memory             netstat

nmap               nslookup           ping               ping6

route-table        ss                 ssldump            sslscan

support            tcpdump            telnet             traceroute

wget               wrk

admin@TR7LBWAF01>  

frr-console bu listede yalnız seçili route table'da dinamik yönlendirme açıkken görünür. debug komutu TR7 destek ekibinin kullandığı hata ayıklama kipini açar ve ayrıca bir hata ayıklama parolası ister; günlük işletimde kullanılmaz.

Komut Grupları

Network Diagnostics

ping · ping6 · traceroute · fping

→

DNS & IP Calculation

dig · nslookup · ipcalc

→

Connection, Port & Scan

ss · netstat · nmap · telnet

→

Packet & TLS Analysis

tcpdump · ssldump · sslscan

→

HTTP & Load Testing

curl · wget · h1load · wrk

→

IP & Interface Status

ip show address · ip show link · ip show route

→

Maintenance & Interactive

memory · extend-data-disk · frr-console · management-access · support

→

Files & Context

file · route-table

→

İki Tür Komut

Dalda iki farklı yazım vardır. Bir komutun hangi türde olduğu, komut adından sonra Tab'a basınca görülür.

Tür	Komutlar	Yazım
Serbest parametreli araçlar	curl · dig · fping · h1load · ipcalc · netstat · nmap · nslookup · ping · ping6 · ss · ssldump · sslscan · tcpdump · telnet · traceroute · wget · wrk	Komut adından sonra yazılan her şey araca olduğu gibi aktarılır. CLI parametreleri denetlemez; Tab yalnız sıradaki parametrenin yerini <ping-parameter-1> biçiminde gösterir. Desteklenen parametreler aracın cihazdaki sürümüne bağlıdır.
Sabit alt komutlu komutlar	extend-data-disk · file · frr-console · ip · management-access · memory · route-table · support	Yalnız Tab'ın listelediği alt komutlar ve alanlar yazılır. Listede olmayan bir sözcük Command not found hatası verir.

API Commands seçenekleri bu dalda yoktur

API Commands dalındaki --info, --output ve --filter seçenekleri sys-cmd komutlarında çalışmaz. Serbest parametreli bir araçta bu sözcükler araca parametre olarak aktarılır; sabit alt komutlu bir komutta Command not found hatası verir. Çıktıyı süzmek, saymak ya da dosyaya yazmak için Pipe Commands kullanılır.

Çalışma Bağlamı

Ağ araçları her zaman bir v-device ve o v-device'a ait bir route table içinden çalışır. WEB-CLI penceresinin başlık çubuğundaki dişli simgeli gösterge bu bağlamı Host device / DEFAULT_ROUTE gibi yazar (komut satırında cihazın kendisi Host olarak yazılır); tıklandığında vDevice ve Route table alanlı küçük bir pencere açılır. Aynı seçim komut satırından da yapılır:

TR7 WEB-CLI · çalışma bağlamı

# geçerli bağlamı göster

admin@TR7LBWAF01> sys-cmd route-table show

# cihazın kendisi ve varsayılan route table; ad Tab listesinden alınır

admin@TR7LBWAF01> sys-cmd route-table set v-device Host route-table <varsayılan-route-table>

# yalıtılmış bir route table

admin@TR7LBWAF01> sys-cmd route-table set v-device Host route-table <route-table>

admin@TR7LBWAF01>  

Komut	Bağlamdan etkilenir mi?
Serbest parametreli araçlar, ip show address, frr-console, extend-data-disk	Evet. Seçili route table içinden çalışır; seçili v-device Host değilse komut o v-device üzerinde çalışır.
memory, management-access, support	Hayır. Her zaman cihazın kendisinde çalışır.
file, route-table	Hayır. Cihazın geçici dosya alanını ve oturumun bağlam ayarını yönetir.

Ayrıntılar: route-table.

Çalıştırma ve Durdurma

Konu	Davranış
Çıktı	Aracın çıktısı geldikçe ekrana akar; aracın hata çıktısı kırmızı gösterilir. Komut bir pipe'a bağlandığında pipe'a yalnız normal çıktı aktarılır, aracın hata çıktısı ekrana gelmez.
Durdurma	Ctrl+C çalışan aracı durdurur. Araç 10 saniye içinde kapanmazsa zorla sonlandırılır. Süresiz çalışan araçlar (ping, tcpdump gibi) ya kendi sayı ya da süre parametresiyle sınırlanır ya da bu tuşla durdurulur.
Etkileşimli komutlar	telnet, frr-console ve extend-data-disk tam bir uçbirim oturumu açar. Ctrl+C, Ctrl+Z, Ctrl+D, Ctrl+L ve Esc tuşları CLI'a değil araca gider; oturumdan aracın kendi çıkış yoluyla çıkılır.
Etkileşimli komutta pipe	Bu üç komuttan sonra | yazılamaz: İnteraktif komutlardan sonra "pipe" operatörüne izin verilmemektedir.
Pipe sınırı	Bir satırda en fazla 8 pipe kullanılır; to-file her zaman son sıradadır.
Bağlantı kopması	WEB-CLI bağlantısı kapandığında o oturumda çalışan komut sonlandırılır.

Onay İsteyen Komutlar

Aşağıdaki komutlar çalışmadan önce bir uyarı ve onay satırı gösterir. Onay için Türkçe arayüzde evet, İngilizce arayüzde yes yazılır. Başka bir şey yazılırsa Onay geçersiz. İşlem iptal edildi. iletisi çıkar; Esc onay ekranını kapatır.

Komut	Onay başlığı
memory drop-page-cache	Sayfa önbelleğini temizlemek üzeresiniz
memory drop-all-caches	Tüm önbellekleri temizlemek üzeresiniz
memory free-swap	Swap alanını temizlemek üzeresiniz
management-access restart	Yönetim erişim servisini yeniden başlatmak üzeresiniz
file disk change-size	Geçici diski … boyutuna büyütmek / küçültmek üzeresiniz
support collect --escrow-map	Takma ad çözüm tablosunu pakete eklemek üzeresiniz
extend-data-disk	Sihirbazın kendi sorusu: Proceed? (y/N):

TR7 WEB-CLI · onay ekranı

admin@TR7LBWAF01> sys-cmd memory drop-page-cache

⚠  Sayfa önbelleğini temizlemek üzeresiniz

    Bu işlem sayfa önbelleğini temizleyecektir. Geçici bir performans düşüşü yaşanabilir.

 

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

Sayfa önbelleği başarıyla temizlendi.

admin@TR7LBWAF01>  

Onay istemeyen geri alınamaz komutlar

file delete ve file clean onay sormadan çalışır; silinen geçici dosyalar geri getirilemez.

Yazım Kuralları ve Kısıtlar

Komut satırı bir kabuk tarafından değil, CLI'ın kendi ayrıştırıcısı tarafından sözcüklere bölünür. Bu yüzden kabuktan alışılan bazı yazımlar farklı sonuç verir.

Kural	Açıklama	Örnek
Boşluklu değer	Tırnak içine alınır.	-H "Host: shop.example.com"
$ işareti	Tırnaksız ya da çift tırnak içinde yazılan $ad boş değere dönüşür. $ içeren değer tek tırnakla yazılır.	-H 'X-Token: $abc'
& işareti	Tırnaksız yazılırsa satır Invalid command hatası verir; sorgu dizgili adresler tek tırnakla yazılır.	'http://10.20.0.15/?a=1&b=2'
| işareti	Tırnak içinde olsa bile pipe ayırıcısı sayılır; bir değerin içinde kullanılamaz.	—
Kabuk işleçleri	>, <, ;, &&, 2>&1 ve $( ) desteklenmez; satır Invalid command hatası verir. Çıktıyı dosyaya yazmak için | to-file kullanılır.	| to-file cikti.txt
tcpdump kısıtı	-w ya da -r ile başlayan parametre reddedilir: -w not allowed for tcpdump. Yakalama dosyası | to-file ile alınır.	| to-file yakalama.pcap
ss kısıtı	-F, --filter, -D, --diag (ve = ile yazılışları) reddedilir: -F is not allowed for ss.	—
Pipe parametreleri	Pipe komutlarında / ya da .. içeren, ~ veya . ile başlayan parametre reddedilir: File path arguments are not allowed in pipe commands.	—
Dosya adı	to-file ile yazılan dosyanın adı yalnız harf, rakam, -, _ ve . içerir; .. ve dizin içeremez: Invalid filename.	waf-443.pcap

Örnek Senaryolar

TR7 WEB-CLI · A) Backend'e doğru route table'dan erişim

# bağlamı backend'in bulunduğu route table'a al

admin@TR7LBWAF01> sys-cmd route-table set v-device Host route-table <route-table>

admin@TR7LBWAF01> sys-cmd ping -c 4 10.20.0.15

admin@TR7LBWAF01> sys-cmd curl -I -k https://10.20.0.15/health

admin@TR7LBWAF01>  

TR7 WEB-CLI · B) VIP yanıt vermiyor

# VIP doğru arayüzde mi, arayüz ayakta mı

admin@TR7LBWAF01> sys-cmd ip show address

# route table'ın yönlendirmeleri

admin@TR7LBWAF01> sys-cmd netstat -rn

# 443 açık mı, filtreleniyor mu

admin@TR7LBWAF01> sys-cmd nmap -Pn -p 443 10.0.7.20

admin@TR7LBWAF01>  

TR7 WEB-CLI · C) TLS sürümleri ve el sıkışma

admin@TR7LBWAF01> sys-cmd sslscan 10.0.7.20:443

admin@TR7LBWAF01> sys-cmd ssldump -n -i any host 10.0.7.20 and port 443

admin@TR7LBWAF01>  

TR7 WEB-CLI · D) 443 trafiğini yakala ve indir

admin@TR7LBWAF01> sys-cmd tcpdump -n -i any -c 500 port 443 | to-file waf-443.pcap

# Link sütunundaki adresten indirilir

admin@TR7LBWAF01> sys-cmd file list

admin@TR7LBWAF01> sys-cmd file delete waf-443.pcap

admin@TR7LBWAF01>  

TR7 WEB-CLI · E) vService yük testi

admin@TR7LBWAF01> sys-cmd wrk -t2 -c50 -d15s http://10.0.7.20/

admin@TR7LBWAF01>  

TR7 WEB-CLI · F) Destek ekibi için tanı paketi

admin@TR7LBWAF01> sys-cmd support collect --since 24h

admin@TR7LBWAF01> sys-cmd support list

admin@TR7LBWAF01>  

Bilinmesi Gerekenler

• Yetki. sys-cmd komutlarını yalnız superAdmin kullanıcılar çalıştırabilir; readOnly ve alan rolleri bu dala erişemez. Ayrıntılar: Web CLI.
• Kayıt. Çalıştırılan her komut User Logs sayfasına Sistem komutu çalıştırıldı: <komut satırı> olarak, geçici dosya indirmeleri "<dosya>" adlı CLI dosyası indirildi olarak yazılır.
• Araç sürümleri. Serbest parametreli araçların sayfalarındaki parametre tabloları sık kullanılan parametreleri özetler; tam liste ve davranış aracın cihazdaki sürümüne bağlıdır.
• Geçici dosyalar. Pipe ile yazılan dosyalar, yakalamalar ve destek paketleri aynı geçici disk alanında tutulur; alan dolduğunda file komutlarıyla temizlenir ya da büyütülür.