Netsim System Agent kurulum ve ayar soruları

<< İçindekileri Görüntülemek İçin Tıklayın >>

Yer:  Kurulum İşlemleri (Agent-Firebird-Veritabanı) >

Netsim System Agent kurulum ve ayar soruları

Netsim System Agent (NetsimSystemAgent), N4/T4/İK4'ün sunucuda çalışan yardımcı hizmetidir: lisansı denetler, zamanlanmış görevleri (e-posta ve SMS gönderimi, log aktarımı gibi) çalıştırır, yedek alır, veritabanını yükseltir ve tarayıcıdan açılan bir yönetim arayüzü sunar. Bu sayfa kurulum ve ayar sorularını kısaca yanıtlar; ayrıntılar Teknik Kılavuzlar altındaki Netsim System Agent Kurulum ve Yönetim Kılavuzu ile Netsim System Agent Yönetim Arayüzü Kullanma Kılavuzu'ndadır.

Eski ajan (NSSystemAgent) ve onun NetsimSystemAgent.conf dosyasına veritabanı yolu (connectionString) ve port yazma yöntemi artık kullanılmaz. Bugünkü ajanın ayar dosyası NetsimSystemAgent.conf.json'dır; veritabanları bu dosyaya yazılmaz, ajana kaydedilir (aşağıda).

Ajan nasıl kurulur?

N4'ün kurulum programı (NetsimN4Setup<sürüm>.exe) ajanı N4 ile birlikte kendiliğinden kurar: dosyaları N4 klasörünün Bin alt klasörüne (öndeğer C:\Netsim.N4\Bin) kopyalar, ajanı N4 adlı Windows hizmeti olarak kaydedip başlatır ve NetsimApp.ini'nin [SystemAgent] bölümüne ajanın adresi olarak bilgisayarın adını yazar. N4 yeni sürüme yükseltilirken ajan da güncellenir; ayar dosyası korunur. Ayrıntı: N4 uygulamasının setup dosyasından kurulması.

Ajan N4'ten ayrı bir sunucuya ya da Linux'a kurulacaksa elle kurulur: ajanın bütün dosyaları tek bir klasöre konur (örneğin C:\Netsim\Agent), lisans dosyası NetsimLisans.xml aynı klasöre kopyalanır ve hizmet yönetici komut isteminde NetsimSystemAgent.exe -INSTALL ile kurulup NetsimSystemAgent.exe -START ile başlatılır. Elle kurulan hizmetin öndeğer adı NetsimSystemAgent, Hizmetler ekranındaki görünen adı Netsim System Agent Service'tir. Ön koşullar, Linux kurulumu ve hizmeti belirli bir hesapla kurmak:

Kurulumdan sonra ajanın çalıştığı nasıl anlaşılır?

Hizmetler ekranında ajanın hizmeti (N4 kurulum programıyla kurulduysa N4, elle kurulduysa Netsim System Agent Service) Çalışıyor durumunda olmalı, ajan klasöründeki NetsimSystemAgent.log dosyasının sonunda lisans ya da bağlantı hatası bulunmamalı ve tarayıcıda http://<sunucu>:82/ adresi yönetim arayüzünü açmalıdır. Adımlar: Kurulum sonrası doğrulama. Hizmet başlamıyorsa: Sorun giderme.

Ayar (conf) dosyası nerede, neler ayarlanır?

Ayar dosyası ajanın klasöründeki NetsimSystemAgent.conf.json'dır. Dinleyici adresi ve portu, yönetim arayüzünün klasörü, sertifikalar, giden posta (SMTP) ve günlük ayarları buradadır. Dosyanın yapısı ve kuralları: Yapılandırma, Dosya düzeni, Dosyalar ve varsayılanlar. Değişikliğin hizmeti yeniden başlatmadan geçerli olup olmadığı: Yapılandırmayı yeniden yükleme.

Ajanın portu nasıl değiştirilir?

Ajan öndeğer olarak 82 numaralı porttan yanıt verir. Port, NetsimSystemAgent.conf.json'daki dinleyici tanımında (netServer.listenerList altındaki port) değiştirilir: Dinleyiciler ve sınırlar. Port değişirse N4'ün ajanı bulduğu adres de aynı porta göre düzeltilir (aşağıda "N4 ajana nasıl bağlanır?").

Veritabanı ajana nasıl eklenir? Bağlantı dizesi (connection string) nereye yazılır?

Veritabanının yolu ve bağlantı bilgileri ayar dosyasına yazılmaz; veritabanı çalışan ajana kaydedilir. En kolay yol yönetim arayüzündeki Veritabanı Kaydet düğmesidir: ad (örneğin NETSIM), depolama motoru (Firebird, PostgreSQL ya da SQLite), işlem olarak var olan veritabanı için OPEN ve bağlantı alanları (Firebird'de sunucu, port, dosya yolu, kullanıcı, parola) girilir. Aynı kayıt komut satırından msql ile OPEN DATABASE deyimiyle de yapılır.

N4'ün yapılandırma dosyasına (NetsimApp.ini) yeni bir veritabanı eklendiğinde (Yapılandırma dosyasının düzenlenmesi), zamanlanmış görevler, e-posta/SMS gönderimi ve log aktarımı o veritabanında da çalışacaksa veritabanı ajana da kaydedilir.

N4 ajana nasıl bağlanır?

N4, ajanın adresini programın klasöründeki NetsimApp.ini dosyasının [SystemAgent] bölümünden okur. N4 kurulum programı bu bölüme Host=<bilgisayarın adı> yazar. Bölüm yoksa ajan aynı bilgisayarda, 82 numaralı portta aranır (http://localhost:82). Ajan başka bir makinedeyse ya da portu değiştirildiyse bölüme şu satırlardan biri yazılır:

[SystemAgent]
Host=SUNUCU
Port=82

ya da adresin tamamı:

[SystemAgent]
URL=http://SUNUCU:82

URL yazılmışsa Host ve Port kullanılmaz. Veritabanı sunucusunun ajana ulaşacağı adres istemcininkinden farklıysa aynı bölüme HostForDBServer, PortForDBServer ya da URLForDBServer yazılır; yazılmazsa istemcinin adresi kullanılır.

Aynı bilgisayarda birden çok ajan kuruluysa N4'ün bağlanacağı ajan, NetsimApp.ini'deki port ile ajanın ayar dosyasındaki dinleyici portu karşılaştırılarak bulunur: Aynı makinede birden çok örnek.

E-posta, SMS ve zamanlanmış görevler için ajanda ne gerekir?

E-posta ve SMS gönderimi, log aktarımı gibi işler N4'te tanımlanan zamanlanmış görevlerle yapılır; görevleri ajan çalıştırır. Bunun için ajan çalışıyor, firmanın veritabanı ajana kayıtlı ve o veritabanında görev zamanlayıcı açık olmalıdır (öndeğer kapalıdır).

Görev tanımı ve gönderim adımları N4 tarafında anlatılır: E-posta/SMS mesajı nasıl gönderilir?, Toplu e-posta ile dosya eki nasıl gönderilir?.

Log sistemi için ajanda ne gerekir?

Log veritabanı da ajana kaydedilir ve ana veritabanının log veritabanı olarak bağlanır; log kayıtlarının zamanlanmış görevle aktarılması için görev zamanlayıcının açık olması gerekir. Ayrıntı: Değişiklik kaydı ve log veritabanı, N4 tarafı: Netsim Log Sistemi.

Yönetim arayüzüne nasıl girilir?

Tarayıcıda http://<sunucu>:82/ açılır ve ajanın yönetici hesabıyla girilir. Kurulumla gelen yönetici parolası ilk girişten sonra hemen değiştirilir. Ayrıntı: Giriş, Kullanıcılar, roller ve oturumlar.

Ajan nasıl güncellenir, nasıl kaldırılır?

Günlük (log) dosyası nerede?

Windows'ta ajanın klasöründeki NetsimSystemAgent.log dosyasıdır; Linux'taki yeri ve dosyanın döndürülmesi: Günlük dosyası ve döndürme.