# Edge Gateway sorunlarını giderme

> Edge Gateway durumları ve kurulum mesajları, Edge Gateway'in neden çevrim dışı kaldığı ya da reddedildiği ve ara belleğin veriyi nasıl tuttuğu.

Kaynak: https://proxus.io/tr/docs/troubleshoot/gateways

Edge Gateway, cihazları okur ve verilerini merkez sunucuya gönderir. Edge Gateway bağlı değilse ona bağlı cihazlar, alarm
kuralları, fonksiyonlar ve işlem akışları merkez sunucuya veri gönderemez. Bu sayfa, her Edge Gateway durumunun ve
kurulum mesajının ne anlama geldiğini açıklar.

## Edge Gateway durumu

**Bağlantılar > Edge Gateway'ler** ekranında her Edge Gateway'in durumu görünür:

| Durum | Anlamı | Kontrol edilecekler |
| --- | --- | --- |
| **Çevrim içi (<süre>)** | Edge Gateway bağlı ve son bir dakika içinde ölçüm verilerini gönderdi. | |
| **Hiç bağlanmadı** | Edge Gateway merkez sunucuda oluşturuldu, ancak hiç bağlanmadı. | Edge Gateway'i kurun. Bkz. [Edge Gateway kurun](https://proxus.io/tr/docs/connect/edge-gateways/install-a-gateway). |
| **Son görülme: <süre> önce** | Bağlantı kapandı. Ayrıntıda nedeni yazar, örneğin `Bağlantı <tarih> tarihinde koptu: yanıt vermeyi bıraktı (ağ ya da makine kapalı). Makineyi ve merkez sunucuya 7422 portundan ulaşabildiğini kontrol edin.` | Makinenin ve Edge Gateway konteynerinin çalıştığını (`docker ps`), makinenin merkez sunucuya 7422 portundan ulaşabildiğini kontrol edin. |
| **Yanıt vermiyor** | `Merkez sunucu bağlantısı açık ama Edge Gateway veri göndermiyor. Nedeni makinedeki günlüklerinde (docker logs).` | Edge Gateway'in kurulu olduğu makinede, Edge Gateway konteynerinin `docker logs` çıktısına bakın. |
| **Bağlantı reddediliyor** | Ağdaki bir makine, merkez sunucunun kabul etmediği bir anahtarla bu Edge Gateway adına bağlanmaya çalışıyor. | Bkz. [Reddedilen bağlantılar](#bağlantı-reddediliyor). |
| **Erişim iptal edildi** | `Erişim <tarih> tarihinde <kullanıcı> tarafından iptal edildi.` | Edge Gateway'i yeniden bağlamak için **Kur**'u seçin ve yeni komutu Edge Gateway'in makinesinde çalıştırın. |

Son raporu 60 saniyeden eski olmayan Edge Gateway bağlı sayılır. Edge Gateway'ler 10 saniyede bir rapor gönderir
(`[EdgeGateway] EdgeMetricsTransmissionInterval`).

Bağlantı koptuğunda ayrıntıda şu nedenlerden biri yazar:

| Neden | Anlamı |
| --- | --- |
| `Edge Gateway kapattı (durduruldu ya da yeniden başlatıldı)` | Güncelleme ya da yeniden başlatma sırasında normaldir. |
| `yanıt vermeyi bıraktı (ağ ya da makine kapalı)` | Makine kapandı ya da ağ bağlantısı kesildi. |
| `ağ hatası` | Bağlantı koptu. |
| `erişimi iptal edildi` | Merkez sunucuda biri Edge Gateway'in erişimini iptal etti. |
| `kimlik bilgilerinin süresi doldu` | Edge Gateway'in kimlik bilgilerinin süresi doldu. Edge Gateway'i yeni bir komutla yeniden kurun. |
| `merkez sunucunun NATS sunucusu durdu` | Sorun merkez sunucuda. `hub-server` konteynerini kontrol edin. |

## Edge Gateway 2.0.0'a yükseltmeden sonra bağlanmıyor

2.0.0 sürümünden itibaren merkez sunucunun NATS sunucusu yalnızca TLS bağlantılarını kabul eder ve bu bağlantıları
platform CA'sına göre doğrular. 2.0.0'dan önce kurulmuş Edge Gateway'lerde bu ayarlar bulunmadığı için bağlantı kurulamaz.

1. **Bağlantılar > Edge Gateway'ler** ekranında Edge Gateway'i açın ve **Kur**'u seçin.
2. Yeni komutu Edge Gateway'in makinesinde çalıştırın.

Edge Gateway bu süre boyunca cihazlarını okumaya devam eder. Bağlantı kurulunca ara bellekte bekleyen veriyi gönderir
(bkz. [Ara bellek](#edge-gateway-merkez-sunucuya-ulaşamıyor)).

Ayrıca merkez sunucunun NATS sunucusunun yükseltmeden sonra bir kez yeniden başlatıldığından emin olun
(`docker restart hub-server` ya da Kubernetes'te `hub-server` pod'ları). Bkz. [Yükseltme](https://proxus.io/tr/docs/operate/upgrade#200a-yükseltme).

## Edge Gateway, merkez sunucuya sertifikada olmayan bir adresle bağlanıyor

Edge Gateway, merkez sunucunun NATS sertifikasının kendi bağlandığı adresi kapsayıp kapsamadığını kontrol eder. Kurulum
komutunu oluştururken seçtiğiniz adres bu sertifikaya kendiliğinden eklenir. Edge Gateway'ler merkez sunucuya başka bir
adla ulaşıyorsa (örneğin bir DNS takma adıyla ya da sonradan eklenen bir NAT adresiyle) TLS doğrulaması başarısız
olur ve Edge Gateway bağlanamaz.

Bu adı, merkez sunucunun [yapılandırmasında](https://proxus.io/tr/docs/administer/configuration) `[NATS]` `TlsHostNames` ya da
`[Service]` `PublicHostNames` ayarına ekleyin. Birden çok adı virgülle ayırın, ardından merkez sunucuyu yeniden
başlatın. Bunun yerine o adres için yeni bir kurulum komutu da oluşturabilirsiniz.

## Bağlantı reddediliyor

- `<adres> adresindeki makine iptal edilmiş ya da yenilenmiş bir anahtarla bağlanmaya çalışıyor (<n> deneme). Yeni bir
  komutla yeniden kurun ya da durdurun.` Bu Edge Gateway'in eski bir kurulumu hâlâ bir yerde çalışıyor. Bu durum
  genellikle Edge Gateway başka bir makineye yeniden kurulduğunda ortaya çıkar. Eski kurulumu durdurun.
- `<adres> adresindeki bir makine bu Edge Gateway adına merkez sunucunun tanımadığı bir anahtarla bağlanmaya çalışıyor
  (<n> deneme).` Adresi verilen makineyi kontrol edin. Edge Gateway'i o makineye kurmak istiyorsanız **Kur**'u seçin.

## Edge Gateway kurulamıyor

**Kur** ile oluşturulan kurulum komutu yalnızca bir kez ve bir saat içinde kullanılabilir. Kurulum penceresi,
makinedeki ilerlemeyi şu aşamalarla gösterir: `Kurulum betiği makineye indirildi`, `Edge Gateway'in anahtarı merkez
sunucuya kaydedildi`, `Edge Gateway imajı indirildi`, `Edge Gateway başlatıldı`, `Bu merkez sunucuya bağlandı`.

Makinede şunlar bulunmalıdır: Compose eklentisiyle birlikte Docker 20.10 ya da üstü, boşta 8083, 1883 ve 8883
portları ve merkez sunucuya 7422 ile 8443 portlarından erişim (merkez sunucuda HTTPS kapalıysa 8443 yerine HTTP
portu 8080).

| Mesaj | Anlamı | Ne yapılmalı |
| --- | --- | --- |
| `Proxus: This install link was already used.` | Komut daha önce çalıştırılmış. | Merkez sunucuda **Edge Gateway'ler** ekranında **Kur**'u seçerek yeni bir komut oluşturun. |
| `Proxus: This install link has expired.` | Komut oluşturulalı bir saatten fazla zaman geçmiş. | Yeni bir komut oluşturun. |
| `Proxus: This install link is not valid.` | Bağlantı yanlış yazılmış ya da kesilmiş. | Komutun tamamını yeniden kopyalayın. |
| `Docker is not installed. Install Docker 20.10 or later and run the command again.` | | Docker'ı kurun. |
| `Docker is installed but not running, or this user cannot use it. Start Docker, or run the command with sudo.` | | Docker'ı başlatın ya da komutu `sudo` ile çalıştırın. |
| `Docker Compose is not available. Install the Docker Compose plugin and run the command again.` | | Compose eklentisini kurun. |
| `Port <port> is already used by the container <name> on this host.` ya da `...by another program on this host.` | 8083, 1883 ya da 8883 portu kullanımda. Portu çoğunlukla daha önce kurulmuş bir Edge Gateway kullanır. | Portu kullanan konteyneri ya da programı durdurun veya kaldırın. Ardından merkez sunucuda yeni bir komut oluşturup çalıştırın. |
| `curl`, sabitlenmiş ortak anahtarla (pinned public key) ilgili bir hata veriyor. | Komut, merkez sunucunun HTTPS anahtarına sabitlenmiştir ve komut oluşturulduktan sonra merkez sunucunun HTTPS sertifikası değişmiştir (örneğin **Varsayılan yap** ya da **Yenile** sonrasında). | Yeni bir komut oluşturun. |
| `The image could not be downloaded. Check that this host can reach Docker Hub.` | Makinenin internet erişimi yok ya da bir proxy erişimi engelliyor. | Docker Hub'a erişime izin verin ya da imajları önceden yükleyin: bkz. [İnternet erişimi olmadan kurulum](https://proxus.io/tr/docs/operate/offline-install#kapalı-ağa-edge-gateway-kurun). |
| `The gateway key could not be created.` ya da `The hub did not accept this gateway. Create a new command in the hub and run it again.` | Edge Gateway merkez sunucuya kaydedilemedi. Bunun nedeni genellikle komutun daha önce kullanılmış ya da süresinin dolmuş olmasıdır. | Yeni bir komut oluşturun. |
| `The containers could not be started. The output above shows why.` | | Makinedeki terminal çıktısını okuyun. |

Kurulum başarılı olduğunda makinedeki terminalde `Proxus: edge gateway started. It appears as connected in the hub within a minute.`
satırı görünür. Kurulum penceresi bundan sonra `Edge Gateway başlatıldı` aşamasında kalıyorsa makine merkez sunucuya
7422 portundan ulaşamıyor demektir.

## Edge Gateway merkez sunucuya ulaşamıyor

Edge Gateway, merkez sunucuyla bağlantısı kesildiğinde de cihazlarını okumaya devam eder. Gönderemediği veriyi kendi
diskinde saklar ve bağlantı geri gelince gönderir.

- Edge Gateway'deki **Ara bellek saklama süresi (saat)** ayarı, gönderilemeyen verinin ne kadar süre tutulacağını belirler.
  Değer 1 ile 720 saat arasındadır, varsayılanı 48'dir. Yer gerektiğinde önce en eski veri silinir. Edge Gateway'in
  diskinde bu süre boyunca biriken veriye yetecek kadar boş alan olmalıdır.
- Değeri düşürürseniz ara bellekte yeni süreden daha eski olan veri silinir.
- Bu ayar, merkez sunucunun yanında çalışan yerleşik **SYSTEM** Edge Gateway'i için gösterilmez.

Edge Gateway'in doğrudan veri gönderdiği veri hedeflerinin kendi ara belleği vardır. Bkz.
[Veri hedefleri](https://proxus.io/tr/docs/reference/outbound-targets#ara-bellek).

## Yapılandırma Edge Gateway'e ulaşmıyor

Bir cihazı, alarm kuralını, fonksiyonu ya da işlem akışını değiştirdiğinizde merkez sunucu değişikliği Edge Gateway'e
gönderir ve onay bekler. Her nesnenin sonucunu [İlişki haritası](https://proxus.io/tr/docs/organize/operational-graph)
ve [Çalışma durumu denetimleri](https://proxus.io/tr/docs/organize/health-checks) ekranlarında görebilirsiniz:

| Görünen | Anlamı |
| --- | --- |
| **Eşit** | Edge Gateway, yapılandırılan sürümü çalıştırıyor. |
| **Bekliyor, Edge Gateway çevrim dışı** | Değişiklik, Edge Gateway bağlandığında uygulanacak. |
| **Yayınlandı, hiç uygulanmadı** | Değişiklik gönderildi, ancak Edge Gateway onaylamadı. Edge Gateway'in çevrim içi olduğunu kontrol edin ve günlüklerine bakın. |
| **Saha tarafında farklı revizyon çalışıyor** | Edge Gateway daha eski ya da daha yeni bir revizyonu çalıştırıyor. Yeniden dağıtın. |
| **Uygulanamadı** | Edge Gateway değişikliği reddetti. Hata, nesnenin üzerinde görünür. |
| **Kısmen uygulandı**, **Saha tarafı onaylamadı** | Bazı parçalar onaylandı, diğerleri henüz onaylanmadı. |

## Sonraki adımlar

- [Edge Gateway'leri yönetme](https://proxus.io/tr/docs/connect/edge-gateways/manage-gateways): durum, günlükler, ara bellek süresi, yeniden kurulum ve erişim iptali.
- [Ağ portları ve uç noktalar](https://proxus.io/tr/docs/reference/ports): güvenlik duvarında açılması gereken portlar.
- [Veri sorunlarını giderme](https://proxus.io/tr/docs/troubleshoot/data): Edge Gateway bağlı ama veri beklenen yere ulaşmıyorsa.
