Dosya Arşivi

← Search Documentation
↑ Müşteri için

Dosya Arşivi nedir?

Dosya Arşivi, Kickidler yazılımların yeni bir bileşenidir ve ajanlar tarafından toplanan çifte verileri (video ve ses) merkezi veritabanı dışında depolamak için tasarlanmıştır. Yerel diskte çalışır ve sistemin devamlılığını ve performansını büyük ölçüde artırır.

Dosya Arşivinin Katkıları:

  • Kickidler ajanı tarafından kaydedilen tüm video ve ses dosyalarının depolanmasını,
  • PostgreSQL'in büyük çifte verilerden arındırılmasını,
  • çok sayıda ajanla çalışırken ölçeklenebilirliğin artırılmasını.

Saklanan veri türleri:

  • screen/ — ekran video kayıtları,
  • audio/ — ses kayıtları.

Depolama yapısı

Veriler aşağıdaki yapıya göre depolanır:

yıl/ay/gün/tip/

Bu metod esneklik ve yönetimi kolaylığı sağlar.

Veri Silme

Sistem otomatik olarak eski verileri siler:

  • 10 dakikada bir kontrol yapılır,
  • silme işlemi günlük klasörler bazında gerçekleştirilir,
  • saklama süresi web arayüzünden yapılandırılabilir.

Kurulum ve güncelleme

Yeni kurulumda:

  • kullanıcı depolama yolunu belirtir

Güncellemede:

  • veritabanındaki mevcut veriler kalır,
  • yeni video ve ses kayıtları harici depolama alanına kaydedilir,
  • geriye dönük uyumluluk sağlanır: sistem eski verileri veritabanından okumaya devam eder.

Özellikler ve Sınırlamalar

  • ayn anda 1000'den fazla ajan desteklenir,
  • .blob boyutu sınırı yok (9 GB'a kadar),
  • bağlantı kesildiğinde veri yeniden gönderilir,
  • benzersiz anahtarlar çoğaltmayı önler,
  • güvenlik OS erişim izinleriyle sağlanır (dosyalar şifrelenmez).

Varsayılan depo konumu

Windows:

C:\ProgramData\ki-data

Linux:

/var/opt/ki

Önemli: konum dizileri sunucu kurulumu sonrasında otomatik olarak oluşturulur.

Depo yolunu değiştirme

Depo yolu node.ini yapılandırma dosyasından değiştirilebilir.

Yol değiştirme talimatları:

  1. KickidlerNode hizmetini durdurun (nns):

    Windows'ta "Hizmetler" (services.msc) veya komut istemi/terminal ile:

    net stop nns
    Linux'ta: 
    systemctl stop kickidlernode

  2. Yapılandırma dosyasını açın:

    Windows'ta C:\Program Files\KickidlerNode\config\, Linux'ta /opt/KickidlerNode/ klasörüne gidin

    node.ini dosyasını bir metin editörüyle açın (Notepad, Notepad++, Vim, Nano vb.)

  3. Yeni yolu belirtin:

    satırını bulun

    fileStoragePath=

    Satır varsa: = sonrasına yeni hedef depo dizininin mutlak yolunu yazın.

    Satır yoksa: dosyanın sonuna ekleyin:

    fileStoragePath=<New_Path>

    Yol formatı:

    Yöntemde Unix tarzı ileri eğik çizgiler (/) kullanın, Windows'ta bile.

    Windows örneği: fileStoragePath=D:/KickidlerData/ veya fileStoragePath=E:/Monitoring/Records/

    Linux örneği: fileStoragePath=/mnt/storage/kickidler_data/

    Yolun / ile bitmesine dikkat edin.

  4. node.ini dosyasını kaydedin.

  5. KickidlerNode hizmetini yeniden başlatın (nns):

    Windows 
    net start nns
    Linux 
    systemctl start kickidlernode

  6. Mevcut verilerin taşınması

    Eğer eski klasörde (C:\ProgramData\ki-data veya /var/opt/ki) bulunan kayıtları kullanmanız gerekliyse, yeni ayarlarla hizmeti başlattıktan sonra tüm içeriği manuel olarak fileStoragePath= ile belirtilen yeni klasöre kopyalayın veya taşıyın.

    Yeni klasörün içinde eski yapı (Yıl/Ay/Gün/screen/, Yıl/Ay/Gün/audio/) ile uyumlu olmasına dikkat edin.

    Yol değiştirmede dikkat edilmesi gerekenler:

    Erişim izinleri: nns hizmetinin (KickidlerNode) çalıştığı hesabın, yeni hedef dizin ve alt dizinlerde tam izinlere (okuma/yazma/değiştirme) sahip olduğundan emin olun.

    Yeterli disk alanı: Yeni disk depolama için yeterli boş alana sahip olmalıdır.

    Hizmeti durdurmak zorunludur: Yapı değişikliği hizmet durmadan yapılmamalı; desteklenmez ve hatalara neden olabilir.

Depo içi veri yapısı

Veriler tarih sıralamasına göre hiyerarşik olarak düzenlenir:

   Yıl (YYYY)/

       Ay (MM)/

           Gün (DD)/

               screen/ (video dosyalar klasörü)

               audio/ (ses dosyalar klasörü)

Dosya formatları (screen/ ve audio/ içinde):

  • <Numara>.lock
  • <Numara>.blob
  • <Numara>.key

Önemli: Bu dosyalar standart video/ses formatlarında değildir (.mp4, .wav vb.). Üçüncü taraf oynatıcılarla doğrudan açılamaz. Sadece Kickidler Viewer içindeki oynatıcı kullanır. Bu dosyalar silinirse ilgili kayıtlar Viewer'da görüntülenemez.

Saklama süresi yönetimi ve veri silme

Otomatik silme: Mayıs 2025 itibarıyla saklama süresi dolunca video (ve ilişkili ses) dosyalarının otomatik silinmesini sağlayan özellik eklenmiştir.

Saklama süresi ayarı:

  1. Kickidler Yönetici web arayüzünü açın.
  2. Yapılandırma→ Bileşeneler ve Koordinasyon→ Server bölümüne gidin.
  3. Video Saklama Süresi ayarını bulun.
  4. Kayıtların Node’da saklanacağı gün sayısını (örneğin 7, 14, 30) ayarlayın.
  5. Sunucu yapılandırma değişikliklerini kaydedin.

Nasıl çalışır:

Belirlenen “Video Retention Period” dolduktan sonra (kayıt tarihinden itibaren):

  1. Kayıtlar merkezi sunucu veritabanından silinir.
  2. Node’daki yerel depolamada .lock, .blob, .key dosyaları otomatik olarak silinir.

Saklama süresi dolmadan manuel dosya silme gerekmez ve önerilmez; çünkü erken silinen dosyalar Viewer’da oynatılamaz hale gelir, süresi geçen dosyalar ise otomatik silinir.

Manuel veri silme

Günlük yönetim için önerilmez; otomatik silme bu görevi karşılamaktadır.

Yalnızca aşağıdaki durumlarda kullanın:

  • Şu anda hemen disk alanı boşaltmak gerektiğinde.
  • Belirli bir döneme ait verileri “Video Retention Period” süresi dolmadan silmeniz gerektiğinde.

Manuel silme adımları:

  1. KickidlerNode hizmetini durdurun (nns).

    Windows'ta "Hizmetler" (services.msc) veya komut istemi/terminal ile: net stop nns

  2. Yerel depolama klasörüne (varsayılan veya değiştirilmiş) gidin.
  3. Silmek istediğiniz Yıl/Ay/Gün klasörlerini silin.

  4. KickidlerNode hizmetini başlatın (nns).

    Windows'ta "Hizmetler" (services.msc) veya komut istemi/terminal ile: net start nns

Klasörleri/dosyaları elle silmek ilgili kayıtların Kickidler Viewer’da oynatılamamasına sebep olur. Sunucu veritabanında veri otomatik silinmez ve eksik dosyalara referans veren hatalı kayıtlar oluşabilir.

Yönetici tarafından özet:

  1. Depo yolu

    Hizmet durdurulduktan sonra node.ini → fileStoragePath (Unix stili) ile yapılandırılır. İzinleri kontrol edin!

  2. Yapı:

    Yıl/Ay/Gün/screen|audio/ içinde .lock, .blob, .key dosyaları. Gerekmedikçe elle değişiklik yapmayın.

  3. Temizlik:

    Web arayüzünde (Configuration → Components & Coordination → Server) Video Retention Period ayarlanarak otomatik dosya ve veritabanı silme sağlanır. Manuel temizleme son çare olmalıdır.

↑ Müşteri için