Contents x
        Servis Yönetimi
        • 25 Sep 2024
        • 7 Minutes to read
        • Dark
          Light
        Contents

        Servis Yönetimi

        • Updated on 25 Sep 2024
        • 7 Minutes to read
        • Dark
          Light
        Article summary

        PaperWork çok katmanlı bir mimariye sahiptir. Tüm iş mantığı orta katmanda bulunan windows servisler aracılığı ile istemcilere açılır. Aynı zamanda sunucu tarafında bazı işlevleri yerine getiren bir dizi servis de bulunur.

        PaperWork Content Server

        Bu servis tüm sistemin ana servisidir. Tüm iş mantığı bu servis üzerinde metodlar halinde bulunur. Temel işlevleri şunlardır;

        1. Tüm iş mantığının metodlar olarak dışarı açılmasını sağlar.
        2. İki değişik geliştirme (SDK) katmanını içerir. Tüm ara yüzler doğasına göre ihtiyaç duyduğu katman ile işlem yapar.
          1. SOAP 1.2 uyumlu web servisleri
          2. .NET kütüphaneleri
        3. Kullanıcı session yönetimi bu servis üzerinde sağlanır. Tüm servisler, kullanıcılar, geliştirme katmanı bağlantıları çalışma esnasında bu servis üzerinde session oluşturarak işlem yapar.
        4. Yük dengeleme (Load Balancing) ve kümeleme (Clustering) özellikleri bulunur. Birden fazla kurarak kullanıcı yükünü dengeleyebilir. Ayrıca yüksek erişilebilirlik sağlar.(High availability) Bu özellikleri başka uygulamalar ile değil kendi mimarisi aracılığı ile sağlar.
        5. Tüm saklama birimlerini bu servis yönetir. Sisteme dahil edilen belgelerin saklanması, görüntülenmesi gibi işlevleri bu servis gerçekleştirir. Depolama birimlerinin tanımlanması için şu sayfayı inceleyebilirsiniz.
        6. Açıldığı zaman veri tabanına bağlantı havuzu oluşturur. (Connection Pool) Metodların çalışması esnasında ihtiyaç duyduğu veri tabanı bağlantısını havuzdan alıp işlemini gerçekleştirir ve tekrar havuza bırakır.
        7. DBPlugin, SMSPlugin, UserPlugin, FilePlugIn yapılarını yönetir.
        8. Tanımlı işlerin çalıştırılmasını sağlar.
        9. Eğer Aktif Dizin (Active Directory) tanımı var ise tüm girişlerde AD doğrulamasını sağlar.
        10. Dış entegrasyonlarda çağrılacak tüm web servis çağrılarını yapar. Web servis tanımları için şu sayfa incelenebilir.
        11. Konnektör mimarisi bu servis aracılığı ile yönetilir. SAP ve Logo konnektörleri için ilgili sayfaları inceleyebilirsiniz.
        Servislerin Başlatılması
        Servislerin kapatılması esnasında Content Server en son kapatılmalıdır. Açılma esnasında ise ilk açılmalıdır.
        Servisler ara yüzlerden de yönetilebilir. Yönetim için şu sayfayı inceleyebilirsiniz.
        Tarihçe
        Content server tarihçe dosyaları Content ile başlar ve default olarak C:\PaperWork\Logs dizini altında bulunur. Eski günlere ait dosyalar ise yine aynı dizin altındaki Backups\Content dizini altında sıkıştırılmış bir şekilde tarih ile beraber saklanır. Daha fazla bilgi için Tarihçe dosyaları bölümü incelenebilir.
        Dil
        Content Server servisinin çalıştığı sunucu dil ayarı İngilizce olmalıdır.

        PaperWork CAS Server

        CAS (Computer Adressed Storage) mimarisinin yönetildiği servistir. Normal şartlarda belgeler verilen disk üzerinde klasörler içinde bulunurlar. Depolama Birimleri tanımında belgelerin hangi klasör yolunda saklanacağı belirtilir. Bu klasör yolu her türlü lokal, SAN, NAS, bulut diskler olabilir.

        CAS mimarisinde her 10.000 doküman tek bir dosya içerisinde 512 bit şifrelenmiş olarak saklanır. Saklama kayıt sırasına göre yapıldığı için her yeni 10.000 belgede yeni bir dosya oluşturulur. Bu dosyaları PaperWork mimarisi haricinde açmak mümkün değildir. Bu nedenle belge güvenliğinin çok yüksek olduğu durumlarda tavsiye edilir. Ayrıca yedekleme konusunda kolaylık sağlar. eski CAS dosyalarına yeni belge atılmadığı için son dosya hariç diğerlerini tek sefer yedeklemek, son dosyayı günlük yedeklemek yeterlidir. Disk üzerinde CAS dosyaları aşağıdaki gibi görünür.

        CAS depolama biriminin de Depolama Birimleri ekranından tanımlandığı unutulmamalıdır.

        Lisans
        CAS mimarisi ayrı bir lisans olarak pozisyonlanmaktadır. Eğer lisans yok ise bu servis sistemde yer almaz.
        Tarihçe
        CAS servisi tarihçe dosyaları Cas ile başlar ve default olarak C:\PaperWork\Logs dizini altında bulunur. Eski günlere ait dosyalar ise yine aynı dizin altındaki Backups\Cas dizini altında sıkıştırılmış bir şekilde tarih ile beraber saklanır. Daha fazla bilgi için Tarihçe dosyaları bölümü incelenebilir.
        Servis Başlatma
        Eğer hata alıp kapanırsa tekrar başladığında birikmiş işlerini tamamlar. Content Server çalışırken açılmalıdır. Mecbur kalındığında servis kill edilebilir. 

        PaperWork Indeks Server

        Indeks Servisi arşivlenen tüm belgelerin, akış verisinin ve belge alanlarının indekslendiği servistir. Indeksleme sonucunda oluşan veri ara yüzlerde tam metin arama (Full Text Search) için kullanılabilir. Aramaların detayı için şu sayfa incelenebilir.

        Veri Tabanı
        Tam metin arama için basit bir lokal veri tabanı kullanılır. Bu veri tabanının yedeklenmesi için şu sayfa incelenebilir.

        Sisteme dahil edilen belgeler 3'e ayrılırlar;

        1. İmaj belgeler: Bu belgeler üzerinde OCR işlemi yapılır. OCR işlemi CPU yoğun çalışır. Çalıştığı sunucu üzerinde kaç CPU olursa olsun büyük kısmını işlem yaptığı süre boyunca kullanır. Bu nedenle Indeks Server kurulumunun ayrı bir sunucuya kurulması tavsiye edilir. OCR işleminde okuma free-format yapılır. Yani kolonlar halindeki bir belge kolonlara ayrılarak okunmaz. Burada oluşan veri tam metin arama için planlanmıştır ve ara yüzlerden erişilemez.
        2. Text tabanlı belgeler: Bu belge tipleri için çeşitli yazı alma işlemleri gerçekleştirilir. Bunun sonucunda oluşan yazı, tam metin aramaya dahil edilir.
        3. Diğer belge tipleri: Bu belge tiplerinde belgenin ilk 1 Gb. boyutundaki verisi içerik olarak (binary) tam metin aramaya dahil edilir.

        Tam Metin aramaya giren dosya formatları şu sayfadan incelenebilir.

        OCR Lisansı
        OCR için ayrı bir lisansa ihtiyaç bulunmaz. Sınırsız sayıda belge OCR işlemine girebilir. Burada kullanılan OCR motoru başka amaçlar ile kullanılamaz. Sadece belgelerin tam metin arama mimarisine dahil olması için kullanılabilir.
        İşlem Sırası
        İndeks Server 20 şerlik gruplar halinde sıradan işlem yapar. İşlem esnasında son kaydedilen belgeyi ilk önce indeksler.
        Port Bilgisi
        Content ve Indeks servisin farklı sunucularda olması durumunda belge çevrimi yapılabilmesi için Indeks sunucusunda 8095 portunun açık olması gerekmektedir. Bu portun açık olmaması halinde kabinet içerisinden DOCX belge PDF seçimi yapılarak e-posta eki olarak gönderildiğinde e-postada belge eki gönderimi yapılamamaktadır. 
        Tarihçe
        Indeks servisi tarihçe dosyaları Index ile başlar ve default olarak C:\PaperWork\Logs dizini altında bulunur. Eski günlere ait dosyalar ise yine aynı dizin altındaki Backups\Index dizini altında sıkıştırılmış bir şekilde tarih ile beraber saklanır. Daha fazla bilgi için Tarihçe dosyaları bölümü incelenebilir.
        Dil
        İndeks Servisinin çalıştığı sunucunun dili İngilizce olmalıdır.
        Servisin Başlatılması
        İndeks Server OCR işlemi yapar ve OCR işlemi CPU üzerinde fazla kaynak tüketebilir. Bu nedenle ayrı sunucu üzerinde konumlandırılır. Sıradan işlem yaptığı için herhangi bir zamanda kapatılıp açılmasında sorun yaşamaz. Content Server çalışırken açılmalıdır. Mecbur kalındığında servis kill edilebilir.

        PaperWork Metod Server

        Mimaride geliştirilen tüm metotların çalıştırılmasını sağlayan servistir. Metotlar şu sayfa kullanılarak geliştirilirler.

        Tarihçe
        Metot servisi tarihçe dosyaları Method ile başlar ve default olarak C:\PaperWork\Logs dizini altında bulunur. Eski günlere ait dosyalar ise yine aynı dizin altındaki Backups\Method dizini altında sıkıştırılmış bir şekilde tarih ile beraber saklanır. Daha fazla bilgi için Tarihçe dosyaları bölümü incelenebilir.
        Servisin Başlatılması
        Zaman bazlı sistem ve kullanıcı metodlarını çalıştıran servis ilk başlatıldığında çalışma zamanı gelip çalışmamış metodların hepsini çalıştırır. Content Server çalışırken açılmalıdır. Mecbur kalındığında servis kill edilebilir. 

        PaperWork Report Server

        Bu servis sistemde oluşturulan her türlü raporun ve gösterge panelinin çalışması için gereken veriyi veri tabanından alarak rapor kullanıcısına gönderilmesini sağlar. Eğer alınan rapor verisi fazla ise anlık olarak bu servisin RAM miktarı yükselir, belli bir müddet sonra yavaş yavaş düşer.

        Tarihçe
        Report servisi tarihçe dosyaları Report ile başlar ve default olarak C:\PaperWork\Logs dizini altında bulunur. Eski günlere ait dosyalar ise yine aynı dizin altındaki Backups\Report dizini altında sıkıştırılmış bir şekilde tarih ile beraber saklanır. Daha fazla bilgi için Tarihçe dosyaları bölümü incelenebilir.
        Servisin Başlatılması
        Kullanıcılar tarafında çalıştırılan raporların verilerini oluşturan servistir. Content Server çalışırken açılmalıdır. Mecbur kalındığında servis kill edilebilir.

        PaperWork TextControl

        Ara yüzlerde bulunan MS Word benzeri editörü yöneten servistir. Editör için detaylı bilgiye şu sayfadan erişebilirsiniz.

        Servisin Başlatılması
        Kullanıcılar tarafında kullanılan MS Word benzeri editörün çalışması için gereklidir.  Mecbur kalındığında servis kill edilebilir. 

        PaperWork Transfer Server

        3 değişik rolü bulunur;

        1. Dış sistemlerden, yapılan tanımlamalar yardımı ile toplu belge arşivlemek için kullanılır. Tanımlar için şu sayfa incelenebilir.
        2. Yapılan tanımlamalar ile toplu akış başlatmak için kullanılır. Tanımlar için şu sayfa incelenebilir.
        3. Gelen eFaturaların arşivlenmesi ve otomatik olarak iş akışı başlatılması için kullanılabilir. eFatura tanımları için şu sayfa incelenebilir. 
        Tarihçe
        Transfer servisi tarihçe dosyaları Transfer ile başlar ve default olarak C:\PaperWork\Logs dizini altında bulunur. Eski günlere ait dosyalar ise yine aynı dizin altındaki Backups\Transfer dizini altında sıkıştırılmış bir şekilde tarih ile beraber saklanır. Daha fazla bilgi için Tarihçe dosyaları bölümü incelenebilir.
        Servisin Başlatılması
        Yukarıda tanımlanan fonksiyonlar için çalışır. Herhangi bir zamanda durdurulabilir. Content Server çalışırken açılmalıdır. Mecbur kalındığında servis kill edilebilir. Çalıştığında kaldığı yerden devam edebilir. 

        PaperWork Workflow Server

        Sistemdeki tüm akışların yapılan tanımlara göre çalıştırılmasını sağlar. Kendine ait InstanceDB adı verilen bir veri tabanına sahiptir. InstanceDB üzerinde servis persistancy (kalıcılık) işlemini gerçekleştirir. Akış adetlerine göre işlem süreleri uzun ve CPU yoğundur. 

        Bu veri tabanı ilk etapta biraz büyür, daha sonra hep aynı boyutta kalır. İş akışı ilk başladığında bu veri tabanına yazma işlemi gerçekleşir, akış bittiğinde veya iptal edildiğinde bu veri tabanından silinir. Yedekleme esnasında bu veri tabanının da yedeklenmesi gerekir.

        Performans
        İş akışı adetlerinin yoğun, iş adımlarının fazla olduğu durumlarda WorkFlow servisinin %70-80 CPU kullandığı gözlemlenir. Bu durumda 2nci bir WorkFlow servisi konumlandırmak gerekir. WorkFlow servisi yük dengeleme modunda çalışabilir. Performans ile ilgili tüm bilgiye şu sayfadan erişebilirsiniz.
        Tarihçe
        WorkFlow servisi tarihçe dosyaları WorkFlow ile başlar ve default olarak C:\PaperWork\Logs dizini altında bulunur. Eski günlere ait dosyalar ise yine aynı dizin altındaki Backups\WorkFlow dizini altında sıkıştırılmış bir şekilde tarih ile beraber saklanır. Daha fazla bilgi için Tarihçe dosyaları bölümü incelenebilir.
        Servisin Başlatılması
        Bu servis hem PaperWork veri tabanı üzerinde hem de Microsoft WorkFlow Engine veri tabanı üzerinde yoğun işlem yapar. Normal kapatılması, kill edilmemesi tavsiye edilir. Aksi durumda akışlar bozulabilir. Content Server çalışırken açılmalıdır. 

        PaperWork ISDD ™ Server

        Belgeler üzerinde KVKK kapsamındaki bölümlerin maskelemesini yapan servistir. Index Server servisi ile aynı sunucu üzerinde kurulu olması tavsiye edilir. PaperWork yapay zeka motoru çalışır. Normalde yapay zeka motoru GPU üzerinde çalışabilir. Eğer GPU kullanılıyor ise 8 Core yeterlidir. Eğer CPU kullanılacak ise 16 Core kullanılması tavsiye edilir. 

        ** ISDD™ modülünün olduğu durumda kullanılan core miktarı ile çalışacak uygulama adedi parametreler ekranından belirlenmelidir. Bu işlem için ISDD_QUEUE_SIZE parametresi kullanılır. Core-6 olarak ayarlanması uygundur.   

        Servis Bildirim Mimarisi

        Sistemde çalışan tüm servisler her 10 dakikada 1 kendilerinin aktif olup olmadıklarını bildirirler. Bu durumda Servis Yönetimi ekranı aracılığı ile servislerin çalışıp çalışmadığı takip edilebilir. Ayrıca servislerin hangi zaman aralıklarında CPU ve RAM miktarlarının ne olduğu incelenebilir, servisler yeniden başlatılabilir.

        Eğer servisler 2 periyot boyunca aktif olduklarını bildirmezler ise Content Server servisin çalışmadığına dair sistem yöneticisine elektronik posta gönderir. Ayrıca fazla RAM kullanımında da elektronik posta ile uyarı gönderimi yapılır. Bu sayfa üzerinden gönderilecek elektronik posta şablonu değiştirilebilir ve elektronik postaların kimlere gideceği belirlenebilir.

        Bildirim Adresi
        Servislerde herhangi bir sorun olduğunda problem elektronik posta ile bildirilir. Postanın kimlere gönderileceği parametre Tanımları ekranında bulunan SYS_REPORT_MAILS parametresi ile belirlenir.

        Performans Yönetimi

        Sistemin performans yönetimi için şu sayfa incelenebilir.

        Web Ara Yüzü Tarihçesi
        Servislerden ayrı olarak web ara yüzü tarihçeleri de yine aynı dizinde oluşurlar. Tarihçe dosyaları Paperwork.Web ile başlar ve default olarak C:\PaperWork\Logs dizini altında bulunur. Eski günlere ait dosyalar ise yine aynı dizin altındaki Backups\HTMLService dizini altında sıkıştırılmış bir şekilde tarih ile beraber saklanır. Daha fazla bilgi için Tarihçe dosyaları bölümü incelenebilir.
        What's Next