Bu kılavuz, SignLogger cihazında karşılaşılan sorunları komut satırı arayüzünden (CLI) adım adım çözmeyi anlatır. Komutların ayrıntılı açıklaması için SignLogger CLI Kullanım Kılavuzu'na bakın.

Bu kılavuz nasıl kullanılır

Sorununuzu en sondaki Belirti → bölüm tablosunda bulun ya da içindekilerden ilgili bölüme gidin.
Her sorun dört parçadan oluşur: - Belirti: Ne görüyorsunuz? - Kontrol: Hangi komutla bakacaksınız? - Olası neden: Bu neden olur? - Çözüm: Adım adım ne yapacaksınız?
Kod kutularındaki komutları olduğu gibi yazın. < > içindeki yerlere kendi değerinizi yazın; < ve > işaretlerini yazmayın.
Değişiklik yapan komutlardan önce enable yazarak yazma kipine geçin. Yapılandırma değişiklikleri execute commit ile uygulanır.

0. Başlamadan önce

0.1 Nereden bağlanmalı

Ağ ayarı bozulduysa ya da SSH açılmıyorsa hipervizör konsolundan ya da cihazın ekran-klavye bağlantısından girin. Konsol ağdan bağımsızdır.
Konsol girişinde de panel yönetici hesabınızı ve parolanızı kullanırsınız.
Zorunlu parola değişikliği SSH girişini engeller ama konsol girişini engellemez.

0.2 Okuma kipi ve yazma kipi

İstem > ile bitiyorsa okuma kipindesiniz. get, show ve çoğu diagnose komutu burada çalışır.
execute komutları ve yapılandırma yazımı için enable yazın; istem # olur.
bu komut için privileged mode gereklidir hatası görürseniz enable yazıp komutu yineleyin.

0.3 Ayar değişikliği = aday + commit

config … end ile yaptığınız değişiklik hemen uygulanmaz; aday yapılandırmaya yazılır. Uygulamak için:

get system config pending
execute commit <açıklama>

"Değiştirdim ama olmadı" durumlarının en sık nedeni commit'in unutulmasıdır.

0.4 İlk beş dakika (her arızada)

get system status
diagnose health
diagnose health scan
get system service list
get hardware disk usage
get system config pending

Bu çıktılar sorunun hangi katmanda olduğunu çoğunlukla gösterir: ağ, servis, disk ya da bekleyen bir yapılandırma.

1. Bağlantı ve giriş

1.1 SSH bağlantısı kurulamıyor

Belirti: ssh zaman aşımına düşüyor ya da bağlantı reddediliyor; parola sorulmuyor.

Kontrol (konsoldan):

diagnose ip address list
diagnose ip route list
get system session listen
get router status
get router zone list

Olası neden:

Cihazın IP adresi yanlış ya da arayüz kapalı.
Ağ geçidi modülü (router kipi) açıksa, bağlandığınız arayüzün zone'unda SSH hizmeti kapalı.
Yanlış ağdan bağlanıyorsunuz ya da arada SSH'ı engelleyen bir güvenlik duvarı var.

Çözüm:

diagnose ip address list ile bağlandığınız adresin cihazda olduğunu ve arayüzün UP olduğunu doğrulayın. Adres yanlışsa 2.1'e geçin.
get router status çıktısında Durum AKTİF ise get router zone list ile zone'ların CİHAZA İZİNLİ HİZMETLER sütununda SSH olup olmadığına bakın. Yoksa zone'da SSH'ı açın:
```
enable
config system zone
edit <zone-no>
set svc-ssh enable
next
end
execute commit Zone SSH erişimi açıldı
```
Cihaz SSH'ı dinliyor mu? get system session listen çıktısında :22 görünmelidir.

1.2 Parola kabul edilmiyor

Belirti: SSH ya da konsol girişinde parola reddediliyor.

Kontrol: Giriş sırasında görünen ileti (SSH istemcinize bağlı olarak gösterilir). Panelde giriş kayıtlarına bakın; hesabın durumunu yetkili bir hesapla get system admin list ile görün.

Olası neden ve çözüm:

İleti	Neden	Çözüm
`Kullanıcı adı ya da parola yanlış`	Parola hatalı, ya da kullanıcı adı yanlış türetildi.	CLI kullanıcı adı panel kullanıcı adından türetilir: e-posta ise `@` öncesi, küçük harf (ör. `Ali.Veli@firma.com` → `ali.veli`). Parola paneldekiyle aynıdır.
`Çok fazla hatalı deneme; hesap geçici olarak kilitli`	Deneme sınırı aşıldı (sayaç web girişiyle ortaktır).	Kilit süresinin dolmasını bekleyin.
`Hesap devre dışı`	Panel hesabı kapalı.	Yetkili bir yönetici panelde hesabı etkinleştirsin.
`Bu hesabın komut satırı erişimi kapalı`	Hesabın CLI erişimi kapatılmış.	Destek ekibinize başvurun ya da başka bir yetkili hesap kullanın.

İki panel hesabı aynı CLI adına düşüyorsa (ör. ali@firma.com ve ali@baska.com) bu adla giriş yapılamaz. Panelde hesaplardan birinin kullanıcı adını değiştirin.

1.3 "Parolanızı önce web panelinden değiştirin"

Belirti: SSH girişi bu iletiyle reddediliyor.

Olası neden: Kurulumdaki varsayılan parola kullanılıyor, parola değişikliği zorunlu tutulmuş ya da parolanın süresi dolmuş.

Çözüm:

Web paneline girin ve Profilim sayfasından parolanızı değiştirin.
SSH ile yeni parolayla bağlanın.
Panele ulaşamıyorsanız konsoldan girin; konsol bu kuraldan muaftır.

1.4 "Kimlik doğrulama hizmetine ulaşılamıyor"

Belirti: SSH girişinde Kimlik doğrulama hizmetine ulaşılamıyor; daha sonra yeniden deneyin. iletisi.

Olası neden: Parolayı doğrulayan yönetim servisi (panel) çalışmıyor ya da yeniden başlıyor.

Çözüm:

Bir dakika bekleyip yeniden deneyin (güncelleme ya da yeniden başlatma sürüyor olabilir).
Sürerse konsoldan girin ve 3.2'yi uygulayın.

1.5 Giriş yapılıyor ama oturum hemen kapanıyor

Belirti: Parola kabul ediliyor, ardından şu iletiyle bağlantı kapanıyor:

Erişim reddedildi: bu cihazda CLI yalnız etkin panel yöneticileri içindir; hesabın panel kaydı yok ya da hesap/CLI erişimi kapalı (<kullanıcı>)

Olası neden: Hesabın panel kaydı yok, kapalı ya da rolünde CLI'ın tanıdığı hiçbir izin yok.

Çözüm: Yetkili bir yöneticiye hesabın etkin olduğunu ve rolünün en az bir izin taşıdığını denetletin. Rol sınıfları için kullanım kılavuzunun Yetkiler bölümüne bakın.

1.6 Bir süre sonra her komut hata veriyor

Belirti: Hata: yetki denetlenemedi: session suresi doldu: idle-timeout (ya da session bulunamadi).

Olası neden: Oturum 30 dakika boşta kaldı ya da 12 saatlik en uzun süreye ulaştı.

Çözüm: exit yazın ve yeniden bağlanın.

1.7 Panel içi CLI Konsolu açılmıyor

Belirti: Üst çubukta CLI Konsolu düğmesi yok ya da konsol bir hata iletisi gösteriyor.

Görülen	Neden	Çözüm
Düğme görünmüyor	Hesabın `edit_security_settings` izni yok.	SSH ya da konsol kullanın veya rolünüze izni ekletin.
`Hesabınızın CLI erişimi kapalı.`	Hesabın CLI erişimi kapatılmış.	Destek ekibinize başvurun.
`CLI kullanmadan önce Profilim sayfasında parolanızı değiştirin. …`	Parola değişikliği zorunlu.	Profilim'den parolayı değiştirip Yeniden bağlan'a basın.
`Konsol oturumu sınırına ulaşıldı. Daha sonra deneyin.`	Cihazda 20 konsol açık.	Kullanılmayan konsolları kapatın, sonra yeniden deneyin.
`Konsol oturumu sona erdi. Yeniden bağlanın.`	15 dakika işlem yapılmadı ya da panel oturumu bitti.	Yeniden bağlan.
`CLI başlatılamadı. Sistem yöneticinize başvurun.`	CLI başlatılamadı.	SSH ya da konsoldan girip 3.2'yi uygulayın.
`Tek satır ve en fazla 4096 bayt uzunluğunda komut girin.`	Satır çok uzun ya da birden çok satır yapıştırıldı.	Komutları tek tek gönderin.

1.8 Komut "yetki yok" ya da "privileged mode" hatası veriyor

Belirti:

Hata: bu komut için privileged mode gereklidir. 'enable' komutu ile yetki yükseltin
Hata: yetki yok: <komut> (hesabın <izin> izni yok)
Hata: yetki yok: <komut> (hesabın yazma izni yok (salt görüntüleme))
Hata: yetki yok: <komut> (rol bu komut icin yetkili degil)
Hata: privileged mode dogrulamasi basarisiz
Hata: yetki reddedildi (…): …

Kontrol:

get system auth me
get system admin-role permissions <rol-adı>

Çözüm:

privileged mode gereklidir → enable yazın.
privileged mode dogrulamasi basarisiz → hesabınızda hiç yazma izni (edit_…, create_…, delete_…) yok; yazma kipine geçemezsiniz.
hesabın <izin> izni yok → parantezdeki izni rolünüze ekletin.
rol bu komut icin yetkili degil → komut daha üst bir rol sınıfı istiyor (ör. execute reboot yönetim sınıfı ister).
yetki reddedildi (…) → CLI izin verdi ama panel işlemi reddetti; iletideki nedeni okuyun. Bazı işlemler yalnız kök domaindeki hesaplarla yapılır.

2. Ağ

2.1 Cihazın IP adresi yok ya da yanlış

Belirti: Cihaza ping atılamıyor, panel ve SSH açılmıyor.

Kontrol (konsoldan):

diagnose ip address list
get system interface
diagnose hardware nic

Olası neden: Arayüze adres verilmemiş, yanlış adres verilmiş, kablo takılı değil ya da sanal makinede ağ kartı bağlı değil.

Çözüm:

diagnose ip address list çıktısında Çekirdekte hiç ağ arayüzü yok (yalnız lo). yazıyorsa sanal makinenin ağ kartı ayarlarını hipervizörde denetleyin.
Arayüz DOWN ise kablo ya da sanal anahtar bağlantısını denetleyin (diagnose hardware nic bağlantı durumunu ve hata sayaçlarını gösterir).

Adres yanlışsa düzeltin:

enable
config system interface
edit <port>
set addr-mode static
set ip <ip-adresi>
set prefix <önek>
set gateway <ağ-geçidi>
next
end
get system config pending
execute commit Yönetim adresi düzeltildi

edit yazıp TAB'a basın; cihazdaki portlar önerilir. DHCP için set addr-mode dhcp. 4. diagnose ip address list ile yeni adresi doğrulayın.

Hâlâ olmuyorsa: Commit sonucunda uyarı ya da hata varsa get system commit list ve get system commit show <no> ile adımlara bakın. VLAN ya da yeni arayüz bu yolla oluşturulamaz; panelin Ağ Ayarları ekranını kullanın.

2.2 Ağ geçidine ya da başka bir ağa ulaşılamıyor

Kontrol:

diagnose test ping
diagnose ip route list
diagnose netlink route <hedef-ip>
diagnose netlink arp
diagnose hardware nic

Olası neden ve çözüm:

diagnose test ping → default gateway bulunamadı: varsayılan rota yok. config system interface içinde set gateway <ağ-geçidi> ya da config router static ile rota ekleyin, ardından execute commit.
Ağ geçidi FAILED/INCOMPLETE görünüyor (diagnose netlink arp): ağ geçidi yanıt vermiyor; kapalı, başka VLAN'da ya da yanlış alt ağda. Adres/önek ve VLAN ayarını denetleyin.
diagnose hardware nic hata sayaçları sıfırdan büyükse kablo, SFP ya da duplex uyumsuzluğundan şüphelenin.
Belirli bir ağa ulaşılamıyorsa diagnose netlink route <hedef-ip> ile seçilen rotaya bakın; yanlışsa config router static ile düzeltin.

ARP tablosunu temizleyip yeniden denemek için: enable ve execute clear system arp table.

2.3 Ad çözülemiyor (DNS)

Belirti: DNS lookup başarısız, güncelleme ya da lisans sunucusuna ad ile ulaşılamıyor; diagnose health scan DNS calismiyor bildiriyor.

Kontrol:

get system dns
diagnose test dns <alan-adı>
diagnose test dns <alan-adı> <dns-sunucusu>

Olası neden: DNS sunucusu tanımlı değil, yanlış ya da DNS sunucusuna erişim engelli.

Çözüm:

Belirli bir sunucuyla çözülüyor ama sistem çözücüsüyle çözülmüyorsa cihazın DNS ayarını düzeltin:
```
enable
config system dns
set primary <dns-1>
set secondary <dns-2>
end
execute commit DNS düzeltildi
```
Hiçbir sunucuyla çözülmüyorsa DNS sunucusuna erişimi sınayın: diagnose test port <dns-sunucusu> 53 (TCP) ve ağ yolu için diagnose test path <dns-sunucusu>.

Not: diagnose health scan DNS denetiminde sabit bir genel alan adı kullanır. İnternete kapalı ağlarda bu bulgu yanıltıcı olabilir; kendi alan adınızla diagnose test dns çalıştırın.

2.4 Uzak bir sunucuya (TCP) bağlanılamıyor

Örnek: güncelleme sunucusu, KAMU SM, SMTP, LDAP, harici syslog.

Kontrol:

diagnose test port <sunucu> <port>
diagnose test path <sunucu> <port>
diagnose ssl connection <sunucu>:<port>

Sonuçları okumak:

`diagnose test port` sonucu	Anlamı
`AÇIK (<ms> ms)`	Bağlantı kuruldu. Sorun uygulama katmanında (kimlik, sertifika, ayar).
`BAŞARISIZ: bağlantı reddedildi (port kapalı)`	Hedef ulaşılabilir ama o portta hizmet yok.
`BAŞARISIZ: zaman aşımı (süzülüyor ya da ulaşılamıyor)`	Arada bir güvenlik duvarı paketi düşürüyor ya da hedef kapalı.
`BAŞARISIZ: hedefe yol yok`	Cihazda bu hedefe rota yok. 2.2.

diagnose test path adımları sırayla sınar ve Ilk kopan halka: <adım> ile ilk sorunlu adımı söyler. ICMP adımının HATA vermesi tek başına arıza değildir; TCP adımı başarılıysa hizmete ulaşılıyordur.

TLS sorunlarında diagnose ssl connection sertifika zincirini ve geçerlilik tarihlerini gösterir.

Kaynak adresi belirli bir arayüzden çıkmalıysa önce kaynak adresi ayarlayın: execute ping-options source <adres> ya da execute traceroute-options source <adres> (yazma kipi gerekir).

2.5 Küçük sayfalar açılıyor, büyükler asılıyor

Kontrol:

diagnose test mtu <hedef>

Olası neden: Yol MTU'su 1500'den küçük (PPPoE, VPN) ve büyük paketler parçalanamıyor.

Çözüm: Olculen yol MTU 1500'den küçükse, aradaki ağ cihazında TCP MSS kırpmayı açın ya da arayüz MTU'sunu yol MTU'suna göre ayarlayın. Hicbir boyut gecmedi uyarısı hedefin ICMP'yi engellediğini gösterebilir; başka bir hedefle deneyin.

2.6 Saat yanlış ya da NTP eşitlenmiyor

Belirti: Log zaman damgaları kaymış, imzalama ya da TLS bağlantıları saat hatası veriyor.

Kontrol:

get system time
diagnose sys ntp status
get system ntp

Olası neden ve çözüm:

ntpsync kapalı (saat elle ayarlanmış): execute time set NTP'yi kapatır. Yeniden açın:

enable
config system ntp
set ntpsync enable
set server <ntp-1> <ntp-2>
end
execute commit NTP açıldı

Kaynaklar ulaşılamıyor: NTP sunucusuna UDP 123 erişimini ağ tarafında denetleyin; sunucu adını diagnose test dns <sunucu> ile sınayın.
zaman servisi sorgulanamadı: zaman servisi yanıt vermiyor; get system service status chronyd ile durumuna bakın ve destek ekibine bildirin.
Saat dilimi yanlışsa: config system global → set timezone Europe/Istanbul → end → execute commit.

2.7 Panel açılmıyor, SSH çalışıyor

Kontrol:

get system trusted-host list
get router zone list
get system component panel

Olası neden:

Güvenilir adres listesi bağlandığınız adresi kapsamıyor. Liste boş değilse yalnız listedeki adresler panele erişir.
Router kipi açıksa zone'da HTTPS kapalı.
Panel servisi çalışmıyor (3.2).

Çözüm (güvenilir adres):

enable
config system trusted-host
edit <boş-bir-no>
set address <sizin-ip-adresiniz>/32
set comment "Yönetici"
next
end
execute commit Güvenilir adres eklendi

Zone'da HTTPS'i açmak için config system zone → edit <no> → set svc-https enable → next → end → execute commit.

2.8 Bir değişiklikten sonra cihaza erişim kesildi

Çözüm:

Konsoldan bağlanın.

Son commit işlerine bakın:

get system commit list
get system commit show <no>

En hızlı yol, önceki sürüme dönmektir:

get system config revisions
get system config diff <sürüm>
enable
execute config revert <sürüm>
execute commit Erişim geri getirildi

Ya da nedeni doğrudan düzeltin: arayüz adresi (2.1), zone erişimi (1.1), güvenilir adresler (2.7).

3. Servisler ve yönetim paneli

3.1 Bir servis çalışmıyor

Kontrol:

get system service list
get system service status <servis>
get log service <servis> 100
diagnose sys failed-units

Olası neden: Servis hata verip durdu, yapılandırması hatalı, bağımlı olduğu kaynak (disk, bellek, ağ) yetersiz ya da özellik kapalı.

Çözüm:

Durum sütununu okuyun: - tasarım gereği kapalı, · özellik kapalı, bu cihazda yok, · lisans yok: servis bu kurulumda beklenen şekilde çalışmıyor; arıza değildir. - HATA (…) ya da ÇALIŞMIYOR: devam edin. - · <n> kez yeniden başladı: servis sürekli çöküyor; kayıtlara bakmadan yeniden başlatmayın.
Kayıtlara bakın: get log service <servis> 200 ya da canlı izleme için diagnose log service <servis> (Ctrl+C ile çıkın).
Kaynak sorunu var mı? get hardware disk usage, get system performance status, diagnose sys oom.

Yeniden başlatın:

enable
execute restart <servis>
get system service status <servis>

DHCP/DNS sunucusu (ağ geçidi modülü) düşmüşse execute service start sljs-dnsmasq de kullanılabilir.

Hâlâ olmuyorsa: diagnose debug application <servis> servis birimi, son hatalar ve log dosyalarını tek ekranda verir. Çıktıyı destek ekibine iletin.

3.2 Yönetim paneli açılmıyor

Belirti: Tarayıcı paneli açmıyor; CLI komutları yonetim servisine ulasilamadi (…) hatası veriyor.

Kontrol:

get system component panel
get system service status server_settings
get log service server_settings 200
diagnose test healthz server-settings

Çözüm:

Servis çalışıyor görünüyor ama panel açılmıyorsa ağ tarafını denetleyin (2.7).
Servis çalışmıyorsa Super User hesabıyla yeniden başlatın:
```
enable
execute restart server_settings
```

Panel birkaç saniye yanıt vermez; panele dayanan komutları biraz sonra yineleyin. 3. Yalnız web sertifikasını yenilediyseniz servisi yeniden başlatmak yerine execute reload panel yeterlidir.

Not: execute restart server_settings yalnız Super User hesabıyla çalışır. Yetkiniz yoksa Super User yetkili bir yöneticiye başvurun.

3.3 CLI komutları yavaş ya da zaman aşımına düşüyor

Belirti: Komutlar uzun sürüyor; yonetim servisi yanit vermiyor: … (ayrinti: diagnose cli timing) hatası.

Kontrol:

diagnose cli timing
diagnose cli timing probe
diagnose cli timing history
get system performance status
diagnose sys top

Okuma:

diagnose cli timing son komutun süresinin nerede geçtiğini (yönetim servisi, iç bileşen, denetim kaydı, yerel işlem) gösterir ve en uzun aşamayı söyler.
diagnose cli timing probe bağımlılıkları sınar; YAVAŞ, ÇOK YAVAŞ ya da HATA satırları sorunlu katmanı gösterir. Örneğin ÇOK YAVAŞ — disk G/Ç bekletiliyor disk darboğazı, HATA — panel kanalı açmamış (servis çalışmıyor ya da açılışı sürüyor) yönetim servisinin hazır olmadığı anlamına gelir.
Sistem yükü yüksekse diagnose sys top ile en çok kaynak kullanan süreçleri bulun.

Çözüm: Sorunlu katmana göre 3.2, 6.1 ya da 6.4 bölümüne geçin.

3.4 Ayrıcalıklı işlemler çalışmıyor

Belirti: execute reboot, execute restart, paket yakalama gibi komutlar privileged worker kullanilamiyor: … ya da benzeri bir hata veriyor.

Kontrol:

get system control-plane
get system worker-status
get system service status signlogger-privileged

Çözüm: Durum : UNAVAILABLE ise Super User hesabıyla iç bileşeni yeniden başlatın:

enable
execute restart signlogger-privileged
get system control-plane

Sorun sürerse cihazı yeniden başlatın (execute reboot) ya da destek ekibine başvurun.

4. Log Arama DB

4.1 Log Arama DB durumu UYARI ya da SORUN

Kontrol:

get log store status --refresh
get system service status logsearch
get log service logsearch 200
get hardware disk usage
get hardware memory

Okuma:

Durum	Anlamı
`SAĞLIKLI`	Normal.
`UYARI (eksik kopya)`	Bazı veri kopyaları atanmamış; arama çalışır ama yedeklilik eksik.
`SORUN (eksik parça)`	Bazı veri parçaları atanmamış; bazı kayıtlar aramada görünmeyebilir.

Çıktının sonundaki Not satırları depo için önerilerdir; önce onları uygulayın.

Olası neden: Veri diski dolu, bellek yetersiz, servis yeniden başlıyor ya da parça sayısı sınırına yaklaşıldı.

Çözüm:

Disk %90'ın üzerindeyse 6.1'i uygulayın.
Servis çalışmıyorsa:
```
enable
execute restart logsearch
```

Servisin toparlanması birkaç dakika sürebilir; get log store status --refresh ile izleyin. 3. Bellek yetersizliği belirtisi için diagnose sys oom çıktısına bakın. 4. Aylık birleştirme (rollup) ve bellek ayarları config system es-tuning bölümündedir. Bu ayarları destek ekibiyle birlikte değiştirin.

4.2 "Depoya ulaşılamadı"

Belirti: get log store status → Depoya ulaşılamadı: …; panelde log araması sonuç vermiyor.

Çözüm:

get system service status logsearch ile servis durumuna bakın. ÇALIŞMIYOR ya da HATA ise 4.1 adım 2'yi uygulayın.
Servis çalışıyorsa açılışı sürüyor olabilir; birkaç dakika sonra yineleyin.
Kayıtları inceleyin: get log service logsearch 300.

Not: get log store status yalnız kök domaindeki hesaplarla çalışır. Başka domaindeki bir hesapla yetki reddedildi hatası alınır.

4.3 Log arama yavaş

Kontrol: get system performance status, diagnose sys top-mem, diagnose sys disk io, get log store status.

Çözüm: Disk G/Ç ve bellek baskısını denetleyin. En büyük indeksler tablosundaki boyutlar ve öneriler, saklama süresinin ya da birleştirme ayarının gözden geçirilmesi gerekip gerekmediğini gösterir (config log setting, config system es-tuning).

5. Log alımı ve imzalama

5.1 Bir cihazdan log gelmiyor

Belirti: Firewall ya da başka bir log kaynağının logları panelde görünmüyor.

Kontrol:

get log device list
get log rsyslog status
get system service status rsyslog
get router status
diagnose sniffer packet <arayüz> sn=30 host <cihaz-ip> port 514

Olası neden:

Kaynak cihaz logları göndermiyor ya da yanlış adrese/porta gönderiyor.
Syslog alıcısı çalışmıyor.
Ağ geçidi modülü (router kipi) açık ve log alınan zone'da syslog hizmeti kapalı.
Cihaz kaydı yok ya da lisansı geçersiz.

Çözüm:

get log rsyslog status → Syslog servisi calismiyor ise enable ve execute restart rsyslog.
Paket yakalamada (izin: edit_network_settings) cihazın IP'sinden paket görünüyor mu? - Paket yok: sorun kaynak cihazda ya da arada. Kaynak cihazın syslog hedefini ve ağ yolunu denetleyin. - Paket var ama log yok: devam edin.
get router status çıktısında Durum AKTİF ise logların geldiği zone'da syslog hizmetinin açık olduğunu denetleyin:
```
get system zone <zone-no>
```

svc-syslog disable ise:

enable
config system zone
edit <zone-no>
set svc-syslog enable
next
end
execute commit Zone syslog alımı açıldı

Cihaz kaydını ve lisansını denetleyin: get log device list (5.3).
Son gelen kayıtlara bakın: get log rsyslog files ve get log rsyslog view <no>.

5.2 Log kaynağı "BAĞLANTI YOK" görünüyor

Belirti: get log device list → DURUM BAĞLANTI YOK.

Açıklama: Bu sütun, cihazın log kaynağına yönetim bağlantısıyla (SSH, HTTPS, API) ulaşıp ulaşamadığını gösterir. Log alımından ayrıdır.

Kontrol ve çözüm:

show system device <no>
diagnose test port <cihaz-ip> <port>
diagnose test path <cihaz-ip>

Port kapalıysa ya da zaman aşımı varsa kaynak cihazda yönetim erişimini ve aradaki güvenlik duvarını denetleyin.
Bağlantı açık ama durum düzelmiyorsa kayıttaki bağlantı türünü, kullanıcıyı ve anahtarı panelden güncelleyin.

5.3 Log kaynağının lisansı süresi dolmuş

Belirti: get log device list → LİSANS SÜRESİ DOLDU ya da GEÇERSİZ.

Kontrol: get system license status, get log device list.

Çözüm: Lisansı yenileyin ve panelde lisans ekranından yükleyin. Lisans eşleşmesi cihaz adına göre yapılır; cihaz kaydındaki ad lisanstakiyle aynı olmalıdır.

5.4 Loglar imzalanmıyor (5651)

Kontrol:

get log signing status
get log signing list
get log signing list <cihaz-seri> 20

Okuma:

Son imzalı arşivler ve get log signing list tablolarında DURUM ve HATA sütunları imzalamanın sonucunu gösterir.
KAMU SM zaman damgası : açık ise imzalama KAMU SM zaman damgası sunucusunu kullanır. kapalı (yerel imza) ise cihazın kendi imzası kullanılır.

Olası neden ve çözüm:

KAMU SM erişimi: KAMU SM sunucusuna erişimi sınayın:

show log setting
diagnose test port <kamu-sm-sunucusu> <port>
diagnose test path <kamu-sm-sunucusu>

get log signing status çıktısındaki KAMU SM erişimi : ERİŞİLEMİYOR satırı, sunucu adresi http:// önekiyle kayıtlıysa erişilebilir bir sunucu için de görünebilir. Asıl sonucu diagnose test port ile ve arşivlerin HATA sütunuyla doğrulayın. 2. KAMU SM kimlik bilgisi: config log setting içindeki public-sm-username ve public-sm-password alanlarını denetleyin (parola gösterilmez; yeniden yazmak için set public-sm-password <parola>), ardından execute commit. 3. Bekleyen logları hemen imzalamak: enable ve execute log sign now. Bu manuel işlem cihazın sunucu sertifikasıyla imzalar; KAMU SM zaman damgası zamanlanmış imzalamada kullanılır. 4. Kök domain dışındaki hesaplar execute log sign now ile device_serials zorunlu hatası alır; imzalamayı panelden cihaz seçerek yapın.

5.5 İmzalı arşivin doğrulaması başarısız

Kontrol:

get log signing list
execute log verify <arşivin-tam-yolu>.zip

Okuma: Sonuç : doğrulandı arşivin bütünlüğünü onaylar. Sonuç : BAŞARISIZ arşivin değiştirilmiş, eksik ya da bozuk olduğunu gösterebilir; ayrıntı çıktının üst kısmındadır.

forbidden: doğrulama yalnız imzalı log dizinlerinde: … hatası, arşivin izin verilen dizinlerin dışında olduğunu gösterir; iletideki dizinlerden birindeki arşivi belirtin.

5.6 Harici syslog sunucusuna log iletilmiyor

Kontrol:

diagnose log syslog
diagnose log syslog test <sunucu-no>
diagnose test port <sunucu-ip> <port>

Okuma: diagnose log syslog sunucuları (adres, taşıma, durum) ve iletilen modülleri listeler. test seçili sunucuya tek bir gerçek sınama iletisi gönderir ve Sonuç : BAŞARILI|BAŞARISIZ yazar.

Çözüm:

DURUM kapalı ise config log syslog → edit <no> → set status enable → next → end → execute commit.
Modül DURUM sütunu kapalıysa ilgili modül iletilmez; modül ayarı panelde Log Ayarları ekranındadır.
Sınama başarılı ama SIEM'de kayıt yoksa SIEM tarafındaki alıcıyı ve süzgeçleri denetleyin. UDP iletimde başarı yalnız gönderimi gösterir; teslimi garanti etmez.

6. Disk ve bellek

6.1 Disk dolu

Belirti: diagnose health → disk:/data WARN/FAIL; Log Arama DB ya da servisler hata veriyor.

Kontrol:

get hardware disk usage
diagnose health scan
diagnose sys disk usage-top /data 2
diagnose sys disk inodes

Olası neden: Log saklama süresi disk kapasitesine göre uzun, temizlik kapalı ya da disk büyümesi planlanandan hızlı.

Çözüm:

Saklama ve otomatik temizlik ayarlarını gözden geçirin:
```
get log setting
```

İlgili alanlar: log-retention-days, signed-file-retention-days, general-log-retention-days, enable-disk-cleanup, disk-usage-threshold, disk-cleanup-min-free-gb.

Uyarı: İmzalı loglar 5651 kapsamında yasal delildir. Saklama sürelerini kısaltmadan önce yasal yükümlülüklerinizi denetleyin.

Değiştirmek için:

enable
config log setting
set enable-disk-cleanup enable
set disk-usage-threshold 85
end
execute commit Disk temizlik ayarı

Kalıcı çözüm için sanal makinede diski büyütün (6.2).

CLI'dan log ya da veri dosyası silinemez; bu, delil bütünlüğü için bilinçli bir kısıttır.

6.2 Disk büyütüldü ama yeni alan görünmüyor

Kontrol:

get hardware disk unused
get hardware disk layout

Okuma: get hardware disk unused şu bulguları verir:

disk sonunda ~<boyut> bolumlenmemis alan var → disk büyütülmüş, bölüm genişletilmemiş.
~<boyut> alan dosya sistemi tarafindan kullanilmiyor (FS genisletilmemis olabilir) → bölüm büyümüş, dosya sistemi genişletilmemiş.
VG <ad>: <boyut> GB ayrilmamis alan var → mantıksal birim grubunda dağıtılmamış alan var.
disk tamamen kullanilmiyor → eklenen yeni disk hiç kullanılmıyor.

Çözüm: Genişletme işlemini panelin disk yönetimi ekranından yapın. Otomatik genişletme ayarı config system disk-extend bölümündedir. CLI'da doğrudan disk genişletme komutu yoktur.

6.3 Disk sağlığından şüpheleniyorum

Kontrol:

get hardware disk info
get hardware storage smart <disk>
diagnose sys kernel 500 | grep -i error
diagnose sys disk io

Çözüm: Diskte G/Ç hatası sayıldı; disk değişimi değerlendirilmeli. ya da Disk çalışır durumda değil uyarısı varsa disk değişimini planlayın. Sanal disklerde sağlık bilgisi hipervizörde izlenir.

6.4 Bellek yetersiz ya da süreçler sonlandırılıyor

Kontrol:

get hardware memory
get system performance status
diagnose sys top-mem 20
diagnose sys oom

Okuma: diagnose sys oom bellek yetmezliği nedeniyle sonlandırılan süreçleri gösterir. diagnose health scan bellek azaldığında Available memory N% (OOM riski yakin) bulgusu verir.

Çözüm: En çok bellek kullanan servisi belirleyin. Sanal makineye bellek eklemek en kalıcı çözümdür. Log Arama DB bellek kipi config system es-tuning bölümündedir; destek ekibiyle değiştirin.

7. NAC ve RADIUS

7.1 Kullanıcılar ağa giriş yapamıyor (RADIUS)

Kontrol:

get system service status radiusd
get system service status radius-nac-daemon
get log service radiusd 200
get user radius-client
get user online stats

Olası neden:

RADIUS servisi ya da NAC politika servisi çalışmıyor.
İstek gönderen ağ cihazı (NAS) RADIUS istemcisi olarak tanımlı değil ya da paylaşılan sır uyuşmuyor.
Ağ geçidi modülü açıksa zone'da RADIUS hizmeti kapalı.
Kullanıcının kimlik kaynağına (LDAP/AD) ulaşılamıyor.

Çözüm:

Servisler çalışmıyorsa: enable, execute restart radiusd, execute restart radius-nac-daemon.
NAS'ın kayıtlı olduğunu denetleyin: get user radius-client listesinde cihazın adresi var mı? Yoksa panelden ya da config user radius-client ile ekleyin. Paylaşılan sırrı (secret) iki tarafta aynı yapın, ardından execute commit.

İstekler cihaza geliyor mu?

diagnose sniffer packet any sn=30 host <nas-ip> port 1812

Paket yoksa sorun NAS'ta ya da arada. Router kipi açıksa zone'da svc-radius alanını enable yapın (5.1 adım 3'teki yöntemle). 4. Kimlik LDAP/AD'den geliyorsa 7.2'ye geçin.

7.2 LDAP ya da Active Directory doğrulaması çalışmıyor

Kontrol:

get user ldap list
execute ldap test <no>
get system service status winbind
diagnose test port <ldap-sunucusu> 389
diagnose ssl connection <ldap-sunucusu>:636

Çözüm:

LDAP bağlantı testi başarısız: <ayrıntı> → ayrıntıyı okuyun: zaman aşımı ağ sorununu, kimlik hatası yanlış bağlama (bind) bilgisini gösterir.
Bağlama bilgilerini config system ldap → edit <no> içinde güncelleyin (bind-dn, bind-password, base-dn), ardından execute commit.
LDAPS/STARTTLS kullanılıyorsa diagnose ssl connection ile sertifikanın geçerliliğini denetleyin.
Active Directory bağlantısı (802.1X) kullanılıyorsa winbind servisinin çalıştığını doğrulayın; gerekirse execute restart winbind.

7.3 Bir kullanıcının oturumu düşürülemiyor

Kontrol:

get user online list <kullanıcı>

Çözüm:

enable
execute user logout <kullanıcı>

Oturum kaydı kapatıldı ancak cihaza aktif çıkış (deauth) ULAŞTIRILAMADI — … uyarısı, ağ cihazına çıkış komutunun ulaşmadığını gösterir. NAS kaydının sırrını, CoA/Disconnect desteğini ve cihazın CLI'a erişimini denetleyin.
Ağ geçidi modülünün hotspot oturumları bu listede olmayabilir; onlar için 8.4.

7.4 İki adımlı doğrulama SMS'i gitmiyor

Kontrol:

get system sms-provider list
get user two-factor
enable
execute sms test <sağlayıcı> --to <numara>

Çözüm: execute sms test hata verirse iletideki sağlayıcı yanıtını okuyun (kimlik bilgisi, kontör, numara biçimi). Sağlayıcı ayarı config sms provider bölümündedir. Numara süzgeçleri için get sms filter ve get sms number-filter.

8. Captive portal

8.1 Portal sayfası açılmıyor

Kontrol:

get system component captive-portal
get system service status captive-portal
get log service captive-portal 200
diagnose test healthz captive-portal

Çözüm:

Servis çalışmıyorsa enable ve execute reload captive-portal (servisi yeniden başlatır; portal kısa süre yanıt vermez).
Servis çalışıyor ama istemciler sayfaya yönlenmiyorsa yönlendirmeyi yapan firewall'daki portal ayarını ve config captive portal içindeki firewall-ip, fqdn, https alanlarını denetleyin.
Ağ geçidi modülünün hotspot'u kullanılıyorsa: get router status, zone'da captive-enabled ve svc-captive alanları (get system zone <no>).

8.2 SMS ya da e-posta doğrulama kodu gitmiyor

Kontrol:

get system sms-provider list
get system mail-server list
enable
execute sms test <sağlayıcı> --to <numara>
execute mail test <no> --to <adres>

Çözüm: Testler başarılıysa portal kaydında doğru sağlayıcının ve e-posta sunucusunun seçili olduğunu denetleyin (show captive portal <ssid> → sms-provider, mail-server). Testler başarısızsa hata iletisindeki sağlayıcı ya da SMTP yanıtını okuyun.

8.3 Kullanıcı ya da yönetici onayı çalışmıyor

Kontrol:

get captive-portal approval-method
get captive approver

Çözüm: Portalın onay yöntemi doğru mu (Kullanıcı onayı, Yönetici onayı, Girişten önce)? Yönetici onayında onaylayacak kişilerin e-posta adresleri ve durumları config captive approver bölümündedir. E-posta gönderimini execute mail test ile sınayın.

8.4 Ağ geçidi hotspot kullanıcısını düşürmek

get router hotspot list
enable
execute router hotspot-logout <ip>

Yalnız IPv4 adresi kabul edilir. Komut, o adreste oturum olmasa da Oturum düşürüldü yanıtı verir; sonucu get router hotspot list ile doğrulayın.

9. Güncelleme

9.1 Güncelleme görünmüyor ya da başlamıyor

Kontrol:

get system update status
get system update history
get system license status
diagnose test dns <güncelleme-sunucusu>
diagnose test port <güncelleme-sunucusu> <port>

Olası neden ve çözüm:

İleti	Çözüm
`Lisansınız bulunamadı. Güncelleme sistemi kullanılamıyor. …`	Cihaz lisansını denetleyin (`get system license status`).
`Sıralı güncelleme gerekli. Önce önceki güncellemeleri tamamlamanız gerekiyor.`	Bekleyen güncellemeleri sırayla kurun.
`yetki reddedildi (…)`	Hesabın `edit_update_management` izni yok ya da hesap kök domainde değil.
Denetim ileti vermeden başarısız	DNS ve güncelleme sunucusuna erişimi sınayın (2.3, 2.4).

Güncellemeyi başlatmak için: enable ve execute update start. Kurulum sırasında yönetim paneli ve ilgili servisler yeniden başlar; panele dayanan komutlar birkaç dakika hata verebilir. Sonucu get system update history ile izleyin.

10. Yapılandırma ve commit

10.1 `end` ya da `next` "yazılamadı" diyor

Belirti: yazılamadı: config <bölüm>: <neden>.

Açıklama: Değişiklikleriniz doğrulamadan geçemedi; hiçbir şey yazılmadı, değişiklikler oturumunuzda bekliyor.

Çözüm: Nedeni düzeltin (ör. set server … ekleyin) ve yeniden end yazın, ya da abort ile bekleyen değişiklikleri atın. Alanların kuralları için bölüm içinde ? yazın.

Sık nedenler:

Neden	Çözüm
`zorunlu alan eksik: <alan>`	Alanı `set` ile yazın.
`server: NTP açıkken en az bir sunucu gerekli`	NTP sunucusu ekleyin ya da `set ntpsync disable`.
`secondary: birincil DNS boşken ikincil verilemez`	Önce `primary` yazın.
`hostname: geçersiz ana makine adı: …`	Harf, rakam ve kısa çizgi kullanın.
`timezone: bilinmeyen saat dilimi: …`	IANA adı kullanın (ör. `Europe/Istanbul`).
`<port>: geçerli bir IPv4 adresi gerekli`	`ip`, `prefix` ve `gateway` alanlarını denetleyin.

10.2 Commit başarısız oldu

Kontrol:

get system commit list
get system commit show <no>
get system config pending

Okuma: get system commit show uygulama adımlarını (tamam, UYARI, HATA) ve hata iletilerini gösterir. Başarısız commit'te çalışan yapılandırma önceki hâline döner; değişiklikleriniz adayda kalır.

Çözüm: Hatalı adıma ait ayarı düzeltip yeniden execute commit, ya da adayı atmak için execute config discard.

10.3 Commit edilmiş bir değişikliği geri almak

get system config revisions
get system config diff <sürüm>
enable
execute config revert <sürüm>
get system config pending
execute commit Geri alındı

execute config revert sürümü yalnız adaya yükler; execute commit olmadan uygulanmaz.

10.4 `exit` bölümden çıkmıyor

Belirti: <n> bekleyen degisiklik var. Yazmak icin `end`, atmak icin `abort`.

Çözüm: Değişiklikleri yazmak için end, atmak için abort yazın.

11. Tanılama bilgisi toplamak

Destek ekibine başvurmadan önce aşağıdaki çıktıları toplayın. SSH ile tek komutta bir dosyaya alabilirsiniz:

ssh <kullanıcı>@<cihaz-ip> "get system status; get system version; get system performance status; diagnose health; diagnose health scan; get system service list; get hardware disk usage; get log store status; get system commit list" > tanilama.txt

Soruna özgü ek çıktılar:

Sorun	Ek komutlar
Servis	`get system service status <servis>`, `get log service <servis> 300`, `diagnose debug application <servis>`
Ağ	`diagnose ip address list`, `diagnose ip route list`, `diagnose netlink summary`, `diagnose test path <hedef>`
Log alımı	`get log device list`, `get log rsyslog status`, `diagnose log syslog`
İmzalama	`get log signing status`, `get log signing list`
Yavaşlık	`diagnose cli timing probe`, `diagnose sys top`, `diagnose sys disk io`
Sistem kayıtları	`diagnose sys errors 120`, `diagnose sys warnings 60`, `diagnose sys failed-units`

Betikle işlemek isterseniz komutların sonuna --output json ekleyin.
Trafik incelemesi gerekiyorsa diagnose sniffer file <arayüz> sn=60 <süzgeç> ile pcap dosyası alın ve dosyayı panelde Ağ Tanılama › Paket Yakalama sekmesinden indirin. Yakalanan paketler kişisel veri içerebilir; dosyayı paylaşmadan önce kurum politikanızı uygulayın.

Ek. Belirti → bölüm tablosu

Belirti	Bölüm
SSH zaman aşımı / bağlantı reddedildi	1.1
Parola kabul edilmiyor, hesap kilitli	1.2
"Parolanızı önce web panelinden değiştirin"	1.3
"Kimlik doğrulama hizmetine ulaşılamıyor"	1.4
"Erişim reddedildi: bu cihazda CLI yalnız etkin panel yöneticileri içindir"	1.5
"session suresi doldu"	1.6
Panel içi CLI Konsolu açılmıyor	1.7
"yetki yok", "privileged mode gereklidir"	1.8
Cihaza ping atılamıyor, adres yanlış	2.1
Ağ geçidine ulaşılamıyor	2.2
Ad çözülemiyor	2.3
Uzak sunucuya bağlanılamıyor	2.4
Büyük sayfalar asılıyor	2.5
Saat yanlış	2.6
Panel açılmıyor, SSH çalışıyor	2.7
Değişiklikten sonra erişim kesildi	2.8
Servis çalışmıyor	3.1
"yonetim servisine ulasilamadi"	3.2
Komutlar yavaş	3.3
"privileged worker kullanilamiyor"	3.4
Log Arama DB UYARI/SORUN	4.1
"Depoya ulaşılamadı"	4.2
Log arama yavaş	4.3
Cihazdan log gelmiyor	5.1
Log kaynağı "BAĞLANTI YOK"	5.2
Lisans "SÜRESİ DOLDU"	5.3
Loglar imzalanmıyor	5.4
Arşiv doğrulaması başarısız	5.5
Harici syslog iletimi çalışmıyor	5.6
Disk dolu	6.1
Disk büyütüldü, alan görünmüyor	6.2
Disk hatası şüphesi	6.3
Bellek yetersiz	6.4
RADIUS girişleri başarısız	7.1
LDAP/AD doğrulaması başarısız	7.2
Kullanıcı oturumu düşürülemiyor	7.3
2FA SMS'i gitmiyor	7.4
Captive portal açılmıyor	8.1
Portal kodu gitmiyor	8.2
Portal onayı çalışmıyor	8.3
Hotspot kullanıcısını düşürmek	8.4
Güncelleme başlamıyor	9.1
"yazılamadı: config …"	10.1
Commit başarısız	10.2
Değişikliği geri almak	10.3
`exit` bölümden çıkmıyor	10.4
Destek için bilgi toplamak	11

Bu kılavuz nasıl kullanılır

0. Başlamadan önce

0.1 Nereden bağlanmalı

0.2 Okuma kipi ve yazma kipi

0.3 Ayar değişikliği = aday + commit

0.4 İlk beş dakika (her arızada)

1. Bağlantı ve giriş

1.1 SSH bağlantısı kurulamıyor

1.2 Parola kabul edilmiyor

1.3 "Parolanızı önce web panelinden değiştirin"

1.4 "Kimlik doğrulama hizmetine ulaşılamıyor"

1.5 Giriş yapılıyor ama oturum hemen kapanıyor

1.6 Bir süre sonra her komut hata veriyor

1.7 Panel içi CLI Konsolu açılmıyor

1.8 Komut "yetki yok" ya da "privileged mode" hatası veriyor

2. Ağ

2.1 Cihazın IP adresi yok ya da yanlış

2.2 Ağ geçidine ya da başka bir ağa ulaşılamıyor

2.3 Ad çözülemiyor (DNS)

2.4 Uzak bir sunucuya (TCP) bağlanılamıyor

2.5 Küçük sayfalar açılıyor, büyükler asılıyor

2.6 Saat yanlış ya da NTP eşitlenmiyor

2.7 Panel açılmıyor, SSH çalışıyor

2.8 Bir değişiklikten sonra cihaza erişim kesildi

3. Servisler ve yönetim paneli

3.1 Bir servis çalışmıyor

3.2 Yönetim paneli açılmıyor

3.3 CLI komutları yavaş ya da zaman aşımına düşüyor

3.4 Ayrıcalıklı işlemler çalışmıyor

4. Log Arama DB

4.1 Log Arama DB durumu UYARI ya da SORUN

4.2 "Depoya ulaşılamadı"

4.3 Log arama yavaş

5. Log alımı ve imzalama

5.1 Bir cihazdan log gelmiyor

5.2 Log kaynağı "BAĞLANTI YOK" görünüyor

5.3 Log kaynağının lisansı süresi dolmuş

5.4 Loglar imzalanmıyor (5651)

5.5 İmzalı arşivin doğrulaması başarısız

5.6 Harici syslog sunucusuna log iletilmiyor

6. Disk ve bellek

6.1 Disk dolu

6.2 Disk büyütüldü ama yeni alan görünmüyor

6.3 Disk sağlığından şüpheleniyorum

6.4 Bellek yetersiz ya da süreçler sonlandırılıyor

7. NAC ve RADIUS

7.1 Kullanıcılar ağa giriş yapamıyor (RADIUS)

7.2 LDAP ya da Active Directory doğrulaması çalışmıyor

7.3 Bir kullanıcının oturumu düşürülemiyor

7.4 İki adımlı doğrulama SMS'i gitmiyor

8. Captive portal

8.1 Portal sayfası açılmıyor

8.2 SMS ya da e-posta doğrulama kodu gitmiyor

8.3 Kullanıcı ya da yönetici onayı çalışmıyor

8.4 Ağ geçidi hotspot kullanıcısını düşürmek

9. Güncelleme

9.1 Güncelleme görünmüyor ya da başlamıyor

10. Yapılandırma ve commit

10.1 end ya da next "yazılamadı" diyor

10.2 Commit başarısız oldu

10.3 Commit edilmiş bir değişikliği geri almak

10.4 exit bölümden çıkmıyor

11. Tanılama bilgisi toplamak

Ek. Belirti → bölüm tablosu

10.1 `end` ya da `next` "yazılamadı" diyor

10.4 `exit` bölümden çıkmıyor