CloudPDKS Edge — Linux
======================

Edge, okuyucularınızla (PDKS cihazları) aynı yerel ağdaki bir bilgisayarda çalışır,
cihazlardaki okutmaları okuyup CloudPDKS'e iletir. Bilgisayara .NET kurmanız gerekmez.

Desteklenen sürümler
--------------------
Ubuntu 22.04, Debian 12, RHEL/Rocky/Alma 9 ve sonrası (glibc 2.34 veya üzeri),
64 bit x64 ya da ARM64 (Raspberry Pi 4/5 dahil). Alpine gibi musl tabanlı dağıtımlar
desteklenmez.

Başlamadan önce
---------------
- CloudPDKS'in size verdiği bağlantı anahtarını (token) hazır tutun.
- Bilgisayar okuyuculara ağ üzerinden erişebilmeli (ZKTeco için TCP 4370).
- Bilgisayarın internete çıkışı olmalı (https://t1.cloudpdks.com, 443).

Kurulum — Ubuntu / Debian (önerilen)
------------------------------------
  sudo apt install ./cloudpdks-edge_<sürüm>_amd64.deb      (Raspberry Pi: _arm64.deb)

Paket gerekenleri (OpenSSL, ICU) kendisi kurar, "cloudpdks-edge" hizmetini kaydeder ve
başlatır: açılışta kendiliğinden çalışır, beklenmedik şekilde kapanırsa yeniden başlar.
Yeni sürüm aynı komutla üzerine kurulur; anahtar ve kuyruk korunur.

Durum / günlük:   systemctl status cloudpdks-edge      journalctl -u cloudpdks-edge -f
Kaldırma:         sudo apt remove cloudpdks-edge   — kuyruk ve anahtar bilgisayarda kalır
                  sudo apt purge cloudpdks-edge    — kuyruk ve anahtar da silinir
                  (gönderilmemiş okutma varsa kaybolur)

Kurulum — diğer dağıtımlar (tar.gz)
-----------------------------------
Gerekenler: OpenSSL ve ICU (RHEL ailesi: sudo dnf install openssl libicu).

  tar xzf cloudpdks-edge-<sürüm>-linux-x64.tar.gz
  sudo mkdir -p /opt/cloudpdks-edge
  sudo cp cloudpdks-edge/PDKSV9.Edge.Host cloudpdks-edge/libe_sqlite3.so /opt/cloudpdks-edge/
  sudo chmod +x /opt/cloudpdks-edge/PDKSV9.Edge.Host

Açılışta kendiliğinden çalışsın:
  sudo tee /etc/systemd/system/cloudpdks-edge.service >/dev/null <<'UNIT'
[Unit]
Description=CloudPDKS Edge
After=network-online.target
Wants=network-online.target

[Service]
Type=notify
ExecStart=/opt/cloudpdks-edge/PDKSV9.Edge.Host
WorkingDirectory=/opt/cloudpdks-edge
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
UNIT
  sudo systemctl daemon-reload
  sudo systemctl enable --now cloudpdks-edge

Kaldırma:  sudo systemctl disable --now cloudpdks-edge
           sudo rm -r /etc/systemd/system/cloudpdks-edge.service /opt/cloudpdks-edge
           (veriler de silinsin: sudo rm -r /var/lib/cloudpdks-edge)

Ekran
-----
Edge çalışırken aynı bilgisayarda tarayıcıdan açın:  http://localhost:35595
Ekranı olmayan sunucuda, kendi bilgisayarınızdan SSH tüneliyle:
  ssh -L 35595:localhost:35595 kullanici@sunucu      sonra tarayıcıda http://localhost:35595

1. "Bağlantı anahtarı" alanına anahtarı yapıştırın, "Kaydet ve bağlan"a basın.
   Anahtar merkezde doğrulanır; yanlışsa ekranda söylenir.
2. "Durum" bölümünde "Merkez bağlantısı: Bağlı" görmelisiniz.
3. Cihazlar, CloudPDKS panelinde bu Edge'e atandıkça "Cihazlar" listesinde görünür.
4. "Durdur" / "Başlat" ile okumayı durdurup başlatabilirsiniz. Edge bilgisayar yeniden
   açıldığında son bıraktığınız durumda devam eder.
5. Yeni sürüm yayınlandığında ekranın üstünde "Yeni sürüm var" yazar.

Ekran yalnız bu bilgisayardan açılır; ağdaki başka bir makineden erişilemez.
Merkez adresini yalnız destek ekibi isterse "Gelişmiş" bölümünden değiştirin.

Veriler
-------
Kuyruk, ayarlar ve anahtar:  /var/lib/cloudpdks-edge   (anahtar yalnız root okuyabilir)

Sorun olursa
------------
- Ekrandaki "Günlük" bölümünü ya da journalctl çıktısını destek ekibine iletin.
- Edge kapalıyken okutmalar kaybolmaz: cihaz kendi kaydında tutar, Edge açılınca okunur.
- Destek: +90 850 302 04 73 · info@borina.com.tr
