Kurulumu

Kickidler 1.0 · Kurulum kılavuzu · Güncelleme: 30 Ekim 2026

Bu kılavuz, Kickidler 1.0 Sunucu, Grabber ve Viewer bileşenlerinin kurulumunu açıklar. Lisansınıza uygun bileşenleri seçin, ardından işletim sisteminize ait talimatları izleyin. KeepActive 2.0 mı kullanıyorsunuz? Ayrı kurulum kılavuzuna bakın.

Başlamadan önce. Kickidler 1.0 sistem gereksinimlerini kontrol edin; Kişisel Hesabınızdan aldığınız etkinleştirme anahtarını hazır bulundurun ve yazılım kurma yetkisiyle oturum açın. Standart bir kurulum için internet erişimi gerekir. İnternetten yalıtılmış bir ağ için İnternetten yalıtılmış ağda kurulum bölümüne bakın.

İşletim sisteminize ait bölümle başlayın. Linux komutları, veritabanı yapılandırması ve yönlendirici değişiklikleri bir yönetici tarafından uygulanmalıdır; yardıma ihtiyacınız varsa bu kılavuzu yöneticinize iletebilirsiniz.

1. Bileşenlerinizi seçin

Sunucu verileri alır ve depolar; Grabber bu verileri çalışanın bilgisayarında toplar; Viewer ise Employee Monitoring (EM) özelliklerini sunar. TimeTracker (TT) sürümünde raporlara ve ayarlara web arayüzünden erişilir; Viewer gerekmez.

Hem EM hem de TT için Sunucu gerekir. Sunucuyu uygun bir ofis bilgisayarına, özel bir sunucuya, sanal makineye veya kiralık bir VPS'ye (sanal özel sunucu) kurabilirsiniz. Önce Sunucuyu, ardından bir test bilgisayarına Grabber'ı ve EM için Viewer'ı kurun. Test başarılı olduktan sonra Grabber'ı kalan bilgisayarlara kurun.

Kickidler 1.0 Sunucu, Windows veya GNU/Linux üzerinde çalışır. macOS bilgisayarlarını izlemek için de bu işletim sistemlerinden birinde çalışan bir Sunucu gerekir.

Bileşenlerinizin sistem gereksinimlerini kontrol edin. İşletim sistemi sürümünüz listede yoksa kurulumdan önce ilgili derleme ile uyumluluğunu doğrulayın.

2. macOS'a kurulum

Kickidler 1.0, macOS 11–27 sürümlerini destekler. Apple silicon (M serisi) çipli bir Mac'te Grabber veya Viewer'ı kurmadan önce Rosetta'yı elle kurun. Intel tabanlı Mac'lerde Rosetta gerekmez.

Mac'inizi ve yükleyiciyi hazırlayın

1. Apple menüsü → Bu Mac Hakkında yolunu açın. macOS sürümünüzü ve Mac'in Intel işlemci mi yoksa Apple silicon çip mi kullandığını kontrol edin.
2. Aşağıdaki bağlantılardan lisansınıza uygun güncel macOS paketini indirin.

Apple silicon: Rosetta'yı elle kurun

M serisi bir Mac'te Kickidler 1.0 yükleyicisini çalıştırmadan önce bu adımı tamamlayın. Intel tabanlı bir Mac'te bu adımı atlayın.

1. Mac'inizi internete bağlayın.
2. Finder → Uygulamalar → İzlenceler → Terminal yolunu açın.
3. Bu komutu çalıştırın ve kurulum ile lisans istemlerini izleyin:

softwareupdate --install-rosetta

Rosetta kurulumu tamamlanana kadar bekleyin, ardından Kickidler yükleyicisiyle devam edin. Ayrıntılar için Apple'ın Rosetta kılavuzuna bakın.

Bileşeni kurun

1. İndirilen .pkg dosyasını açın ve kurulum sihirbazındaki adımları izleyin.
2. İstendiğinde etkinleştirme anahtarınızı girin. macOS'un görüntülediği istemlerde gerekli işlemleri onaylayın.
3. Kurulumu tamamlayın. Grabber için aşağıda açıklanan izinleri yapılandırın. Viewer için uygulamayı açın ve verilerinize erişilebildiğini kontrol edin.

macOS uygulamayı engellerse. Aldığınız uyarıyı Apple'ın uygulamaları güvenle açma kılavuzunda bulun. macOS uygulamanın hasarlı olduğunu veya kötü amaçlı yazılım içerdiğini bildirirse tam mesajı, yükleyici sürümünü ve indirme kaynağını destek ekibine gönderin.

Grabber'a izinleri verin

Sistem Ayarları → Gizlilik ve Güvenlik yolunu açın. macOS 11–12 sürümlerinde Sistem Tercihleri → Güvenlik ve Gizlilik → Gizlilik yolunu kullanın. Sistem istemlerinde adı belirtilen Grabber bileşenleri için şunları kontrol edin:

• Erişilebilirlik — erişim isteyen bileşene izin verin.
• Ekran Kaydı / Ekran ve Sistem Sesi Kaydı — ekran yakalamaya izin verin.
• Otomasyon — Grabber web etkinliğini toplamak için tarayıcıya erişim isterse izin verin.

Listede görünen öğenin adı derlemeye bağlıdır; macOS isteminde gösterilen adı kullanın. macOS uygulamayı yeniden başlatmanızı isterse bunu yapın. Beklenen bir öğe yoksa destek ekibi için ekran görüntüsü alın ve derleme numarasını not edin.

Sonucu kontrol edin. Bilgisayar, Kickidler sisteminizde görünmeli ve yeni etkinlik ile web verileri göndermelidir. EM için ekran görüntüsünü de kontrol edin. Mac'i yeniden başlattıktan sonra kontrolü tekrarlayın.

3. Windows'a kurulum

Yükleyicileri indirin

Desteklenen Windows sürümleri arasında Windows 10, Windows 11 ve Windows Server 2016, 2019, 2022 veya 2025 bulunur. x64 seçeneğini 64 bit bir sistem için, x86 seçeneğini ise 32 bit Windows 10 için kullanın ve lisansınızı seçin: EM veya TT.

Yükleyicileri yönetici yetkileriyle çalıştırın. Proxy kullanıyorsanız adresini, bağlantı noktasını, protokolünü ve kimlik bilgilerini hazır bulundurun. Ayrıntılar için Proxy yapılandırma bölümüne bakın.

Sunucuyu kurun

1. Verileri depolayacak bilgisayarda şu Sunucu paketini çalıştırın: node.x64.msi veya node.x32.msi.
2. Lisans sözleşmesini okuyup kabul edin, ardından etkinleştirme anahtarınızı girin.
3. Doğrudan internet bağlantısını seçin veya bir proxy yapılandırın.
4. Veritabanını seçin: paketle gelen PostgreSQL veya önceden hazırlanmış harici bir PostgreSQL örneği.
5. Harici veritabanı için adresi, bağlantı noktasını, kullanıcı adını, parolayı ve veritabanı adını girin. Test düğmesine tıklayın ve bağlantı kontrolünün başarılı olmasını bekleyin. Başarısız olursa Edit düğmesine tıklayın, ayarları düzeltin ve yeniden test edin.
6. Önerilen kurulum klasörünü kullanın veya Latin karakterlerden oluşan başka bir yol seçin.
7. Kurulumu onaylayın ve tamamlanmasını bekleyin.

Veritabanı seçimi. Paketle gelen PostgreSQL, yeni bir kurulum için kullanılabilir. Harici veritabanını bir yönetici hazırlamalıdır: sürümü, kimlik doğrulama yöntemi ve kullanıcı izinleri Sunucu derlemenizle uyumlu olmalıdır.

Sunucunun çalıştığını ve bağlantı noktasına Grabber ağından erişilebildiğini kontrol edin. Ardından web arayüzünü açın ve varsayılan parolayı değiştirin. Birden fazla Sunucunuz varsa Kişisel Hesabınızda uygun Merkezi Sunucuyu seçin.

Grabber'ı kurmadan önce: Windows hizmetini kontrol edin

Hizmetler uygulamasını açın. Uzak Masaüstü Hizmetleri hizmetini (eski sistemlerde Terminal Hizmetleri) bulun ve durdurulmuşsa başlatın. Bir ilke bunu engelliyorsa yöneticinize başvurun. Dışarıdan RDP bağlantılarına izin vermeniz gerekmez.

Grabber'ı kurun

1. Çalışanın bilgisayarında lisansınıza uygun Grabber paketini çalıştırın: EM veya TT.
2. Lisans sözleşmesini kabul edin ve etkinleştirme anahtarınızı girin.
3. Doğru lisans türünün seçili olduğunu kontrol edin: EM veya TT.
4. İnternete nasıl bağlanılacağını seçin ve gerekiyorsa proxy yapılandırın.
5. Sihirbaz bu seçenekleri sunuyorsa Grabber çalışma modunu ve kurulum klasörünü seçin.
6. Kurulumu tamamlayın ve bilgisayarın Sunucuya bağlantısını kontrol edin.

EM için Viewer'ı kurun

1. Yöneticinin veya sistem yöneticisinin bilgisayarında viewer.x64.msi veya viewer.x32.msi dosyasını çalıştırın.
2. Lisans sözleşmesini kabul edin ve etkinleştirme anahtarınızı girin.
3. Gerekiyorsa proxy yapılandırın.
4. Kurulumu tamamlayın, Viewer'ı açın ve gerekli bilgisayarlara ve verilere erişilebildiğini kontrol edin.

TT için Merkezi Sunucunun web arayüzünü kullanın; Viewer gerekmez.

Windows uyumluluğunu kontrol edin

Sistem gereksinimlerine bakın. Windows sürümünüz listede yoksa kurulumdan önce Destek ekibine başvurun.

4. GNU/Linux'a kurulum

Debian 11, Ubuntu 20.04/22.04 LTS ve Linux Mint 20 için aşağıdaki APT adımlarını; Fedora 38 için RPM adımlarını kullanın. Astra Linux 1.8 SE de desteklenir; yöneticinizden güvenlik ayarlarını kontrol etmesini isteyin. Güncel işletim sistemlerinin tam listesine bakın.

Linux masaüstü gereksinimi: Grabber ve Viewer, yerel bir X.Org/X11 masaüstü oturumu gerektirir. Bu 1.0 masaüstü bileşenlerinde Wayland ve XWayland desteklenmez. Grafik arayüzü olmadan çalışan Sunucu için grafik oturumu gerekmez.

Linux dağıtımınızı ve sürümünü kontrol etmek için:

lsb_release -a

Bu komut kullanılamıyorsa işletim sisteminin hakkında sayfasını kontrol edin veya yöneticinize danışın. Aşağıdaki kurulum adımları bir yönetici tarafından uygulanmalıdır.

Aşağıdaki her terminal bloğu tek bir tam komut içerir. Blokları ayrı ayrı, verilen sırayla ve aynı root kabuğunda çalıştırın. Yükleyici istemlerini tamamlayın ve sonraki bloğu çalıştırmadan önce komut isteminin geri gelmesini bekleyin. Bir komut başarısız olursa durun, çıktısını kaydedin ve devam etmeden önce hatayı giderin.

Debian ve Ubuntu: APT deposunu ekleyin

Gerekirse curl ve gpg paketlerini dağıtımınızın deposundan kurun. Bu adımlar Kickidler deposunu ilk kez yapılandırmak içindir; depo zaten varsa ikinci bir kayıt eklemeyin. İşlem boyunca aynı root terminalini açık tutun.

1. Depo anahtarını indirin ve kontrol edin. Geçici bir dizin oluşturun:

kickidler_key_dir="$(mktemp -d)"

Anahtarı indirin:

curl -fsSL http://deb.kickidler.com/generic/repo.gpg -o "$kickidler_key_dir/repo.gpg"

Parmak izini görüntüleyin:

gpg --with-fingerprint "$kickidler_key_dir/repo.gpg"

Yayımlanan anahtar adresi HTTP kullanır. Anahtarın tam parmak izini, güvenilir bir kanal üzerinden Destek ekibiyle anahtarı içe aktarmadan önce doğrulayın. Eşleşmiyorsa durun.

2. Anahtarı ve depoyu ekleyin. Aşağıdaki yöntemlerden birini seçin; ikisini birden uygulamayın.

Önerilen APT yöntemi: ayrı bir anahtar halkası ve depoya özgü signed-by ayarını kullanın.

gpg --dearmor --output "$kickidler_key_dir/kickidler.gpg" "$kickidler_key_dir/repo.gpg"

Anahtar halkasını kurun:

install -m 0644 "$kickidler_key_dir/kickidler.gpg" /usr/share/keyrings/kickidler.gpg

Depo kaydını oluşturun:

echo "deb [signed-by=/usr/share/keyrings/kickidler.gpg] http://deb.kickidler.com/generic stable non-free" > /etc/apt/sources.list.d/kickidler.list

Yalnızca eski APT sürümleri: dağıtımınız signed-by ayarını desteklemiyor ve apt-key aracını sağlıyorsa modern yöntem yerine bu iki komutu kullanın. apt-key artık eskimiş bir araçtır ve yeni sürümlerde kurulum yöntemi olarak kullanılmamalıdır.

apt-key add "$kickidler_key_dir/repo.gpg"

Eski yöntem için depo kaydını oluşturun:

echo "deb http://deb.kickidler.com/generic stable non-free" > /etc/apt/sources.list.d/kickidler.list

3. Paket listesini güncelleyin:

apt-get update

4. Gerekli bileşenleri kurun. Yalnızca bu bilgisayarda gerekli olan komutları çalıştırın.

Sunucu:

apt-get install kickidlernode

Grabber:

apt-get install kickidlergrabber

EM için Viewer:

apt-get install kickidlerviewer

İstendiğinde etkinleştirme anahtarınızı girin. Sunucu için veritabanı seçeneğini Veritabanı seçimi bölümünde açıklandığı şekilde belirleyin. Viewer için erişim izni verilecek kullanıcıları seçin.

RPM: CentOS, RHEL ve Fedora

Fedora 38 için Fedora adımlarını kullanın. Aşağıdaki CentOS/RHEL seçenekleri, mevcut uyumlu 1.0 kurulumları içindir; yeni bir CentOS/RHEL kurulumu yapmadan önce Destek ekibine başvurun. PostgreSQL yalnızca Sunucu için gereklidir.

1. Kickidler deposunu ekleyin. Bu seçeneklerden birini kullanın.

CentOS/RHEL: depo yönetim aracını kurun:

yum install yum-utils

Depoyu ekleyin:

yum-config-manager --add-repo http://rpm.kickidler.com/kickidler.repo

Fedora 38: DNF eklentisini kurun:

dnf install dnf-plugins-core

Depoyu ekleyin:

dnf config-manager --add-repo http://rpm.kickidler.com/kickidler.repo

Paket imzası denetimini etkin bırakın. Yeni bir anahtarı kabul etmeden önce depo ve imzalama anahtarı ayrıntılarını Destek ekibiyle doğrulayın. Eski işletim sistemleri, dağıtımlarının arşivlenmiş bağımlılık depolarına ihtiyaç duyabilir.

Yalnızca Grabber veya yalnızca Viewer bulunan bir bilgisayarda PostgreSQL ve Sunucu adımlarını atlayın ve doğrudan aşağıdaki ilgili bileşene geçin.

2. PostgreSQL'i hazırlayın — yalnızca Sunucu bilgisayarında. Kickidler 1.0 paketinizle uyumlu, 9.3 veya daha yeni bir PostgreSQL sürümü kullanın. Yeni bir kurulumda PostgreSQL 9.3 yerine bakımı devam eden uyumlu bir sürüm seçin. İşletim sisteminiz ve PostgreSQL sürümünüz için resmî RPM kurulum talimatlarını veritabanını ilklendirme ve başlatma adımları dahil olmak üzere izleyin. Mevcut bir veritabanı dizinini asla yeniden ilklendirmeyin.

CentOS/RHEL'de Sunucu bağımlılıkları için EPEL de gerekebilir. İlgili sürüme uygun epel-release paketi varsa şu komutla kurun:

yum install epel-release

Paket yoksa bir yönetici tam olarak o işletim sistemi sürümüne uygun EPEL deposunu etkinleştirmelidir; başka bir sürüme ait depoyu kullanmayın.

3. Sunucunun veritabanı hesabını ve veritabanını oluşturun. Aşağıdaki işlem yeni bir kurulum içindir. kickidler_node zaten varsa yeniden oluşturmak veya silmek yerine mevcut yapılandırmayı kontrol edin. PostgreSQL'i kendi yönetici hesabıyla açın:

su - postgres -c "psql -d postgres"

Sonraki komutlar Linux kabuğuna değil, psql istemine girilir. PostgreSQL varsayılan olmayan bir bağlantı noktası veya örnek kullanıyorsa o örneğe bağlanın.

Hesabı oluşturun:

CREATE ROLE kickidler_node LOGIN;

MD5 kimlik doğrulaması gerektiren bir Kickidler 1.0 istemcisi için parola kodlamasını yalnızca bu oturum için ayarlayın. PostgreSQL 10 veya üzeri sürümlerde:

SET password_encryption = 'md5';

PostgreSQL 9.3–9.6 sürümlerinde eski ayarı bunun yerine kullanın:

SET password_encryption = on;

Güçlü bir parola belirleyin ve Sunucu yapılandırmasında kullanmak üzere güvenli biçimde saklayın:

\password kickidler_node

UTF-8 veritabanını oluşturun:

CREATE DATABASE kickidler_node OWNER kickidler_node ENCODING 'UTF8' TEMPLATE template0;

Bu PostgreSQL örneğinin kimlik doğrulama yapılandırma dosyasını bulun:

SHOW hba_file;

PostgreSQL'den çıkıp root kabuğuna dönün:

\q

4. Yerel veritabanı erişimini yapılandırın. Yukarıda belirlenen pg_hba.conf dosyasını yedekleyin. Yerel veritabanı ve MD5 gerektiren Kickidler 1.0 istemcisi için bu kayıtları localhost için daha geniş kapsamlı kurallardan önce ekleyin. Bu kurallar yalnızca Kickidler veritabanı hesabına ve veritabanına uygulanır. İlgisiz kuralları değiştirmeyin.

Dosya içeriği — terminal komutları değildir:

host    kickidler_node    kickidler_node    127.0.0.1/32    md5
host    kickidler_node    kickidler_node    ::1/128         md5

Örneğin eski bir PostgreSQL 9.3 RPM kurulumu /var/lib/pgsql/9.3/data/pg_hba.conf yolunu kullanabilir; kendi örneğinizin döndürdüğü yolu kullanın. MD5, diğer veritabanı kullanıcıları için bir öneri değil, eski istemcilerle uyumluluk ayarıdır. trust kullanmayın ve PostgreSQL'i internete açmayın.

Bu erişim kurallarını uygulamak için PostgreSQL yapılandırmasını yeniden yükleyin:

su - postgres -c "psql -d postgres -c 'SELECT pg_reload_conf();'"

Ardından uygulamanın veritabanına parola ile yeni bir bağlantıyı test edin. İstendiğinde yukarıda belirlediğiniz parolayı girin. Veritabanınız varsayılan olmayan bir bağlantı noktası veya başka bir örnek kullanıyorsa hem yeniden yükleme hem de test komutlarını o örneği hedefleyecek şekilde uyarlayın:

psql -h 127.0.0.1 -U kickidler_node -d kickidler_node -W -c 'SELECT current_user, current_database();'

Sonuçta hem kullanıcı hem de veritabanı adı olarak kickidler_node görünmelidir. Sunucuyu kurmadan veya başlatmadan önce kimlik doğrulama hatalarını giderin.

5. Sunucuyu kurun ve yapılandırın. CentOS/RHEL'de:

yum install kickidlernode

Fedora'da bunun yerine şu komutu kullanın:

dnf install kickidlernode

Yapılandırma aracını çalıştırın ve ekrandaki istemleri tamamlayın:

/opt/KickidlerNode/bin/configure.sh

Yapılandırma aracı kapandıktan sonra /opt/KickidlerNode/config/node.ini dosyasını kontrol edin. Yukarıda hazırlanan yerel veritabanı için veritabanı sunucusu adresini 127.0.0.1 veya localhost olarak ayarlayın. Bağlantı noktası, veritabanı adı, kullanıcı adı ve parola, başarılı bağlantı testinde kullanılan değerlerle eşleşmelidir.

systemd kullanan sistemler: Sunucunun sistem açılışında başlamasını etkinleştirin:

systemctl enable kickidlernode.service

Sunucu hizmetini başlatın:

systemctl start kickidlernode.service

SysVinit kullanan mevcut kurulumlar: bunun yerine şu iki komutu kullanın. Sunucunun sistem açılışında başlamasını etkinleştirin:

chkconfig kickidlernode on

Sunucuyu başlatın:

service kickidlernode start

6. Grabber'ı kurun — yalnızca desteklenen masaüstü sistemlerinde. Uyumlu bir CentOS/RHEL kurulumunda:

yum install kickidlergrabber

Fedora'da bunun yerine şu komutu kullanın:

dnf install kickidlergrabber

Yapılandırma aracını çalıştırın ve ekrandaki istemleri tamamlayın:

/opt/TeleLinkSoftHelper/bin/configure.sh

Yapılandırma aracı başarıyla kapandıktan sonra Grabber hizmetinin sistem açılışında başlamasını etkinleştirin:

systemctl enable kickidlergrabber.service

Grabber hizmetini başlatın:

systemctl start kickidlergrabber.service

7. EM için Viewer'ı kurun — yalnızca desteklenen masaüstü sistemlerinde. Uyumlu bir CentOS/RHEL kurulumunda:

yum install kickidlerviewer

Fedora'da bunun yerine şu komutu kullanın:

dnf install kickidlerviewer

Yapılandırma aracını çalıştırın ve ekrandaki istemleri tamamlayın:

/opt/KickidlerViewer/bin/configure.sh

Viewer'ı uygulamalar menüsünden, genellikle İnternet bölümünden açın. Alternatif olarak aşağıdaki komutu oturum açmış kullanıcının yerel X.Org oturumunda, root kabuğunda değil, çalıştırın:

kickidlerviewer

SCRAM kimlik doğrulama hatası. SCRAM authentication requires libpq version 10 or above QPSQL hatasını görürseniz PostgreSQL istemcisi seçili kimlik doğrulama yöntemini kullanamıyor demektir. Hem hesabın kayıtlı parola biçimi hem de onunla eşleşen erişim kuralı uyumlu olmalıdır. İngilizce sorun giderme makalesine bakın veya her iki sürümü de belirterek Destek ekibiyle iletişime geçin. Değişiklikleri yalnızca etkilenen hesaba ve veritabanına uygulayın.

5. Sunucu bağlantısını yapılandırın

Web arayüzünü açın ve ilk oturum açma işlemini güvenli hale getirin

1. Merkezi Sunucunun bulunduğu bilgisayarda, tarayıcıda http://localhost:8123 adresini açın. Güvenilen yerel ağdaki veya VPN üzerindeki başka bir bilgisayardan http://SERVER_ADDRESS:8123 adresini kullanın; SERVER_ADDRESS yerine Sunucunun adresini yazın. Yapılandırdığınız adres ve bağlantı noktası farklıysa bunları kullanın.
2. Yeni bir kurulumda kullanıcı adı olarak admin ve parola olarak admin girerek oturum açın. Mevcut bir kurulumda geçerli kimlik bilgilerini kullanın.
3. Configuration → Accounts bölümünü açın, yönetici hesabını seçin ve Edit account düğmesine tıklayın. Her iki parola alanına da benzersiz bir parola girin ve OK düğmesine tıklayın.

Uzaktan erişime izin vermeden önce varsayılan parolayı değiştirin. Web erişimini VPN içinde tutun veya arayüzü internete açmadan önce yöneticinizden HTTPS ve kısıtlı erişim yapılandırmasını isteyin.

Çalışan bilgisayarlarını ve Viewer'ları bağlayın

Çalışan bilgisayarlarının ve Viewer'ın Sunucuya bağlanması gerekir. Uzaktan çalışma için yöneticinizle birlikte aşağıdaki düzenlemelerden birini seçin:

• VPN: Uzak bilgisayarları, Sunucunun dahili adresine erişebilmeleri için ofis ağına bağlayın.
• Sabit genel IP ve bağlantı noktası yönlendirme: İnternet sağlayıcınızdan sabit bir genel IP alın ve ofis yönlendiricisindeki gerekli TCP bağlantı noktasını Sunucuya yönlendirin. Sunucunun ayrıca sabit bir dahili adrese ve uygun güvenlik duvarı kurallarına ihtiyacı vardır. Sağlayıcının paylaşımlı NAT arkasındaki bir adresi yeterli değildir.
• VPS: Sunucuyu uygun kaynaklara sahip kiralık bir Windows veya Linux sanal özel sunucusuna kurun. Çalışan bilgisayarlarını VPN veya güvenli biçimde yapılandırılmış, genel erişime açık bir uç nokta üzerinden bağlayın.

Sunucunun adresini ve bağlantı noktasını Grabber veya Viewer'ın çalıştığı bilgisayardan test edin. Web sitesi ve veritabanı erişimi ayrı ayrı yapılandırılır; veritabanını genel erişime açmayın.

Bunlar varsayılan bağlantı noktalarıdır. Güvenlik duvarlarını ve yönlendirmeyi ayarlarken mevcut yapılandırmanızdaki değerleri kullanın.

1. Gerekli ağlardan Sunucunun kullandığı gerçek bağlantı noktasına bağlantıya izin verin.
2. Başka bir ağdaki bileşenler için yukarıda seçtiğiniz VPN, sabit genel IP veya VPS düzenlemesini kullanın.
3. NAT kullanırken harici TCP bağlantı noktasını Sunucunun bulunduğu bilgisayara ve dinlediği gerçek bağlantı noktasına yönlendirin. Başka bir ağdan web arayüzüne erişim gerekiyorsa bunu ayrıca yapılandırın.
4. Sunucunun, bileşenlerin kendi ağlarından erişebilecekleri bir adres bildirdiğini kontrol edin.

Windows'ta ek bir Sunucu adresi bildirin

Sunucu, bileşenlerin ihtiyaç duyduğu adresi bildirmiyorsa bu adresi extra_declare_hosts parametresine ekleyin. Örneğin NAT kullanılırken bu parametre harici bir adres belirtebilir.

1. Sunucu hizmetini durdurun ve yapılandırmasını yedekleyin.
2. Yönetici ayrıcalıklarıyla C:\Program Files\KickidlerNode\config\node.ini dosyasını açın.
3. Ek adresi ve bağlantı noktasını extra_declare_hosts parametresinde ayarlayın. Parametre yoksa kullandığınız derlemenin yapılandırma biçimine uygun yere ekleyin.
4. Dosyayı kaydedin, Sunucuyu başlatın ve bildirilen adresleri günlüklerinden kontrol edin.
5. Grabber veya Viewer'ın bulunduğu ağdan bağlantıyı yeniden test edin.

Dosya içeriğidir; terminal komutu değildir. Bu ayarı node.ini dosyasına ekleyin veya düzenleyin; yer tutucuları Sunucunun adresi ve bağlantı noktasıyla değiştirin:

extra_declare_hosts=PUBLIC_OR_INTERNAL_IP:SERVER_PORT

Birden fazla adresi | işaretiyle ayırın. Bu istemcilerin erişebileceği adresi ve bağlantı noktasını bildirin. Yönlendirici, 17906 numaralı genel bağlantı noktasını Sunucunun 7906 numaralı dahili bağlantı noktasına yönlendiriyorsa harici istemcilere PUBLIC_IP:17906 adresini bildirin; Sunucu yine 7906 numaralı bağlantı noktasını dinler. extra_declare_hosts bağlantı adreslerini bildirirken hosts yerel dinleme arayüzlerini belirtir. Yönlendirmeyi ve güvenlik duvarı kurallarını ayrıca yapılandırın.

6. Grabber'ı birden fazla Windows bilgisayarına dağıtın

msiexec komutunu SYSTEM hesabıyla çağıran bir CMD betiği çalıştırın. Bu yöntemi GPO ve uç nokta yönetim araçlarıyla kullanın. GPO Software Installation üzerinden doğrudan MSI ataması veya bir yönetim aracının MSI paket modu bu prosedür için uygun değildir.

Adım 1. MSI dosyasını ve ağ paylaşımını hazırlayın

1. Uzaktan dağıtım için Grabber MSI dosyasını Kişisel Hesabınızdan indirin. Lisans türünü (EM veya TT) ve Windows mimarisini kontrol edin.
2. MSI dosyasını hedef bilgisayarların erişebileceği bir ağ paylaşımına yerleştirin. Örneğin \\SERVER\Software\grabber.msi gibi bir UNC yolu kullanın.
3. Bilgisayarlara paylaşımda Read (okuma) izni, NTFS üzerinde ise Read & Execute (okuma ve çalıştırma) izni verin. Etki alanında Domain Computers grubunu kullanabilirsiniz.
4. Bir test bilgisayarında, MSI dosyasına SYSTEM hesabıyla erişilebildiğini doğrulayın: Kurulum, oturum açmış yönetici olarak değil, bilgisayar hesabıyla çalışır.

Adım 2. CMD betiğini oluşturun

Dosya içeriğidir; bloğun tamamını kopyalayın. install_grabber.cmd adıyla kaydedin; bu satırları terminalde tek tek çalıştırmayın. MSI yolunu ve etkinleştirme anahtarını değiştirin. TT için LICENSE_TYPE="TT" değerini ayarlayın; EM için LICENSE_TYPE="EM" değerini koruyun. msiexec komutunu tek satırda tutun.

@echo off
msiexec /i "\\SERVER\Software\grabber.msi" INVITE="YOUR_INVITE_KEY" LICENSE_TYPE="EM" /qn /norestart /L*V "%WINDIR%\Temp\kickidler-grabber-install.log"
exit /b %errorlevel%

/qn yükleyiciyi kullanıcı arayüzü olmadan çalıştırır, /norestart otomatik yeniden başlatmayı engeller ve /L*V hedef bilgisayardaki %WINDIR%\Temp\kickidler-grabber-install.log dosyasına ayrıntılı bir günlük yazar. Günlük yolunu değiştirirseniz mevcut ve SYSTEM hesabının yazma iznine sahip olduğu bir klasör seçin. Anahtarı içeren betiğe ve kurulum günlüğüne erişimi kısıtlayın.

Proxy kullanmak için PROXY="http://PROXY_HOST:PROXY_PORT" özelliğini msiexec komutuna ekleyin. Virgülle ayrılmış istisnaları PROXY_BYPASS özelliğinde ayarlayın. /qn kullanıldığında bu özellikleri açıkça belirtin: Proxy iletişim kutusundaki alanlar işlenmez.

Adım 3. Betiği GPO üzerinden çalıştırın

1. Bir GPO oluşturun ve test bilgisayarlarınızı içeren OU ile ilişkilendirin.
2. Computer Configuration → Policies → Windows Settings → Scripts (Startup/Shutdown) → Startup yolunu izleyerek bilgisayarın başlangıç betikleri bölümüne gidin ve CMD betiğini ekleyin.
3. Computer Configuration → Policies → Administrative Templates → System → Logon altında Bilgisayar Başlatma ve Oturum Açma Sırasında Ağı Her Zaman Bekle ilkesini etkinleştirin.
4. GPO kapsamının ve filtrelerinin hedef bilgisayarları içerdiğini kontrol edin.
5. Test bilgisayarında Komut İstemi’ni yönetici olarak açın, Grup İlkesi’ni güncelleyin ve ardından bilgisayarı yeniden başlatın:

gpupdate /force

Yeniden başlatmanın ardından Komut İstemi’ni tekrar yönetici olarak açın ve kurulum ilkesinin uygulanan ilkeler listesinde yer aldığını kontrol edin:

gpresult /scope computer /r

Dağıtım başarılı olduktan sonra bu tek seferlik kurulum başlangıç görevini kaldırın veya MSI dosyasını çalıştırmadan önce yüklü sürümü kontrol eden, kuruluşunuza ait dağıtım betiğini kullanın. Yukarıdaki örnek bu kontrolü kendisi yapmaz.

KSC, UEM, RMM veya EDR üzerinden dağıtın

install_grabber.cmd dosyasını LocalSystem hesabıyla çalıştıran bir görev oluşturun. Bu hesabın MSI dosyasına erişimini doğrulayın ve görevi bir test grubunda çalıştırın.

Dağıtımı doğrulayın

İki veya üç test bilgisayarında kurulumu, lisansı, bağlantıyı ve yeni verilerin gelişini kontrol edin. Bu kontroller başarılı olduktan sonra dağıtımı genişletin.

7. Proxy yapılandırın

Protokolü ve kurulum yöntemini seçin

Kickidler 1.0, HTTP ve SOCKS5 proxy’lerini destekler. HTTPS proxy’leri desteklenmez. Proxy türünü http:// veya socks5:// olarak belirtin.

Windows kurulum sihirbazında aşağıdaki seçeneklerden birini seçin:

• Without additional settings — doğrudan bağlanın.
• Use system proxy — proxy’yi işletim sistemi ayarlarından algılayın.
• Manual proxy settings — HTTP veya SOCKS5 protokolünü, adresi ve bağlantı noktasını belirtin. Kimlik doğrulama gerekiyorsa etkinleştirin ve UIN ile PWD alanlarını doldurun.

Doğrudan bağlanması gereken adresleri virgülle ayrılmış istisnalar olarak ekleyin. Kurulumdan sonra bağlantıyı test edin: Kullanıcının proxy ayarları, hizmetin erişebildiği ayarlardan farklı olabilir.

Grabber ve Viewer'ı yapılandırın

Windows'ta proxy’yi kurulum sırasında yapılandırabilirsiniz. macOS ve Linux'ta kurulumdan sonra [network] bölümünü kullanın; bu bölümün bulunduğu dosya: unit.*.stable.ini. Windows'ta ayarları değiştirmek için de bu dosyayı kullanabilirsiniz. Önce dosyayı yedekleyin; konumu ve değişiklikleri uygulama adımları derlemeye bağlıdır.

Dosya içeriğidir; terminal komutları değildir. Yapılandırma dosyasında [network] bölümünü kullanın ve aşağıdaki proxy ana makinesini ve bağlantı noktasını değiştirin. Bu bölüm zaten varsa aynı bölümü tekrar eklemek yerine mevcut ayarını güncelleyin:

[network]
proxy=http://PROXY_HOST:PROXY_PORT

Kimlik doğrulama için protocol://username:password@hostname:port biçimini kullanın. none değeri proxy’yi devre dışı bırakır; auto değeri ise işletim sistemi ayarlarından algılamayı etkinleştirir.

proxyByPass virgülle ayrılmış istisnaları listeler: IP adresleri, etki alanları ve ağlar; örneğin 192.168.8.15,192.168.0.0/16. İki nokta üst üste işaretinden sonra bir bağlantı noktası belirtebilirsiniz.

heartBeat bağlantıyı açık tutmak için kullanılan paketler arasındaki yaklaşık aralığı saniye cinsinden ayarlar. 0 değeri bu paketleri devre dışı bırakır. Kesilen bağlantıların sorunlarını giderirken aralığı proxy yöneticinizle birlikte ayarlayın.

Proxy’nin bağlantılara etkisi

Sunucu, proxy’yi yalnızca giden bağlantılar için kullanır; Sunucuya ağ erişimi ayrıca yapılandırılmalıdır. Grabber ve Viewer, yapılandırılmış istisnalara tabi olarak bağlantıları için proxy’yi kullanır.

8. Yalıtılmış bir ağda kurulum yapın

İnternet erişimi olmadan çalışmak için yerel lisans sunucusu ve özel etkinleştirme anahtarları içeren ayrı bir dağıtım gerekir. Kurulumdan önce bileşenler, işletim sistemi ve donanım gereksinimleri ile güncelleme prosedürünü hesap yöneticinizle kararlaştırın. Bu dağıtım için sağlanan talimatları izleyin; standart kurulum yapıp ardından internet bağlantısını kesmek uygun değildir.

9. Kurulumu doğrulayın

1. Sunucu. Başladığını, doğru Merkezi Sunucunun seçildiğini ve TCP bağlantı noktasına Grabber'ın ağından erişilebildiğini kontrol edin.
2. Grabber. Lisans türünü kontrol edin ve bilgisayarın Kickidler sisteminizde göründüğünü doğrulayın. Birkaç normal işlem yapın ve yeni etkinlik ile web verilerinin gelip gelmediğini kontrol edin.
3. Verilere erişim. Web arayüzünü açın. EM için Viewer'ı ve ekran görüntüsünü de kontrol edin.
4. Kontrolü tekrarlayın. Mac'te yeniden başlatmanın ardından veri toplamayı kontrol edin. Daha geniş dağıtımdan önce kullanılan işletim sistemlerini, ağ ayarlarını ve ilkeleri temsil eden bilgisayarlarda test yapın.

Kurulum, bileşenler başladığında, Kickidler sisteminize bağlandığında ve yeni verileri gönderdiğinde veya görüntülediğinde tamamlanmış olur.

10. Kurulum sorunlarını giderin

Destek ekibine gönderilecek bilgiler

Bileşeni ve sürümünü, işletim sistemini ve mimariyi, ayrıca lisans türünü (EM veya TT) belirtin. Hatanın saatini saat dilimiyle birlikte, iletinin tam metnini, hatayı yeniden oluşturma adımlarını ve yakın zamanda yapılan değişiklikleri ekleyin. Etkilenen bileşenin tüm log klasörünü, bütün alt klasörleri ve hem güncel hem de döndürülmüş günlük dosyalarıyla birlikte toplayın. Yalnızca en son dosyayı veya yalnızca node, grabber ya da viewer alt klasörünü göndermeyin.

Viewer günlükleri için Viewer'ı çalıştıran hesabı kullanın: %LOCALAPPDATA% ve $HOME bu kullanıcının profiline karşılık gelir. Özel bir kurulum yolu kullanılıyorsa ona karşılık gelen log klasörünün tamamını toplayın.

Linux’ta döndürülmüş günlükler: Aynı üst dizinde yer alan log.old klasörü varsa onun da tamamını toplayın: Sunucu için /opt/KickidlerNode/log.old, Grabber için /opt/TeleLinkSoftHelper/log.old veya Viewer için /opt/KickidlerViewer/log.old. Arşivde her iki klasörün adını da koruyun. Kurulum dizininin tamamını arşivlemeyin.

Windows'ta güncel gizli Grabber kurulumu için C:\ProgramData\E891C8F2-6D3B-5E17-7F3C-9A1D4E2B8C60\log yolunu kullanın. Daha eski Grabber kurulumlarında C:\Windows\System32\wmi\log veya C:\Program Files\TeleLinkSoftHelper\log kullanılabilir. Dizini bulamıyorsanız destek talebinize kurulum yöntemini ve bileşen sürümünü ekleyin.

PostgreSQL hataları için onun günlüklerini de ekleyin: Windows'ta paketle birlikte gelen PostgreSQL için C:\Program Files\KickidlerNode\pgsql\data\pg_log; Linux'ta, veritabanınız günlükleri bu konuma yazacak şekilde yapılandırılmışsa /var/log/postgresql.

Özgün günlükleri değiştirmeyin. Tüm log klasörünü dizin yapısıyla birlikte arşivleyin. Arşivin açıldığını ve tüm dosya ve alt klasörleri içerdiğini kontrol edin, ardından kararlaştırılan destek kanalı üzerinden gönderin. Paylaşmadan önce hassas bilgiler açısından bir kopyayı inceleyin; etkin günlükleri değiştirmeyin ve etkinleştirme anahtarlarını, parolaları veya günlükleri herkese açık olarak paylaşmayın.

İlgili sayfalar: Kickidler 1.0 sistem gereksinimleri · KeepActive 2.0 kurulumu.