FABREKA YAZILIM ELEKTRONİK DANIŞMANLIK TİC. LTD. ŞTİ.

Transkript

1 FABREKA YAZILIM ELEKTRONİK DANIŞMANLIK TİC. LTD. ŞTİ. VEBIAN V1.5 SİSTEM YÖNETİCİSİ DOKÜMANI

2 İçindekiler Amaç ve Kapsam... 2 Yazılım Bileşenleri... 3 Vebian Studio... 3 Analitik Veri Tabanı... 4 Rapor Portali... 4 Görev Servisleri... 4 Konfigürasyon Seçenekleri... 5 Uygulama Konfigürasyonu... 5 Analitik Veritabanı Bağlantı Konfigürasyonu... 7 İlk Kurulumda Gereken Ayarlar... 7 Veri Kaynağı Sağlayıcısı Tanımı... 9 Genel Mimari Kullanıcı Yönetimi ve Yetkilendirme Toplu Kullanıcı Aktarımı Yeni Kullanıcı Ekleme Tekil Oturum Açma (Single Sign On) FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 1

3 Amaç ve Kapsam Bu belgenin amacı, sistem yöneticileri için Vebian yazılımı kurulum ve konfigürasyon bilgilerinin sunulmasıdır. Sistemin bileşenleri, genel mimarisi, kurulum seçenekleri, ilk kurulum için gerekli ayarlar, önerilen kurulum seçenekleri, gereksinimlere uygun konfigürasyon seçenekleri, kullanıcı yönetimi ve yetkilendirme bu dokümanın kapsamındadır. FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 2

4 Yazılım Bileşenleri RAPOR TASARLAMA BİLEŞENLERİ Rapor Portalı RAPOR SUNUM BİLEŞENLERİ Fabreka BI Studio Görev Servisleri Analitik Veritabanı Vebian; Analitik veri tabanı, Görev servisleri, Raporlama portalı ve tüm bunların yönetiminin ve rapor tasarımlarının yapıldığı Vebian Studio olarak 4 ana bileşenden oluşmaktadır. Bu bileşenler dışında çok sayıda kullanıcının düzenli kullandığı durumlarda, yoğun yük altında performanslı çalışmanın sürdürülebilmesi için dağıtık mimari ile tasarlanmış ön bellek modülü de ayarlanarak kullanıma alınabilir. Vebian Studio Vebian Studio, rapor tasarımlarının ve sistem yönetiminin yapıldığı bileşendir. Rapor tasarlama kullanıcıları tarafından kullanılır. Bu bileşen üzerinden yapılan işlemler genel olarak şu şekildedir: - Veri kaynaklarına bağlanma - Veri seti tasarımı - Rapor Tasarımı - Ayar ve Görevlerin yönetimi - Portal üzerinde yayınlama FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 3

5 Rapor tasarlayan kullanıcıların bilgisayarına kurulacak olan Vebian Studio, analiz yapılacak veri kaynaklarına ve sistem analitik veri tabanına ulaşabilecek şekilde kurum/kuruluş iç ağı içinde bulunmalıdır. Analitik Veri Tabanı Sistemin veri tabanı altyapısını sunmaktadır. - Verilerin hızlı bir şekilde sorgulanması - Yeni veri setlerinin oluşturulması Genel olarak kullanıcı sayısı az dahi olsa ayrı bir sunucu üzerine kurulması önerilir. Yüksek kullanıcı sayısı ve yoğun yük altında birden fazla sunucu üzerinde cluster mimarisi ile kurulumu gerçekleştirilebilir. Rapor Portali Sistem son kullanıcılarının görüldüğü bileşenidir. Bu bileşen üzerinden yapılan işlemler: - Rapor gösterimi - Rollerin ve kullanıcıların yönetimi - Raporların rollere göre yetkilendirilmesi Görev Servisleri Sistemin otomatik görevlerinin çalıştırılmasını sağlayan modüldür: - Verilerin belirlenmiş aralıklarda tekrar aktarımı - Raporların e-posta ile tanımlanmış kullanıcılara gönderimi Ayrı bir sunucuya kurulumu yapılabileceği gibi Rapor portali sunucusu üzerine de kurulumu yapılabilir. FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 4

6 Konfigürasyon Seçenekleri Uygulama Konfigürasyonu Seçenek Varsayılan Açıklama DebugMode False Windows uygulamasında oluşabilecek hataların son kullanıcıya ayrıntılı olarak gösterilip gösterilmeyeceğini belirler. Varsayılan olarak hatalar gösterilmemektedir. DefaultTimePattern * * * Yazılımın varsayılan olarak kullanıcıya önereceği görev çalıştırma zamanı. Değiştirilmesine gerek yoktur. CronTab formatında girilir: Aylar Günler HaftanınGünleri Saatler Dakikalar Saniyler JobServiceCheckInterval Görev Yönetim servislerinin, yeni eklenen ya da değişen görev olup olmadığını kontrol etme aralığı. Varsayılan olarak yani 10 dakika olarak ayarlanmıştır. DefaultStringDataType VARCHAR (500) SQL destekleyen veri kaynakları haricinde Excel, CSV, SharePoint gibi veri kaynaklarından veri alınırken sütunun en büyük değeri tablo şeması üzerinde döndürülmediği durumlarda, varsayılan olarak kullanılacak veri tipini belirtir. Burada belirtilenden daha büyük veriler DefaultStringLimit değerine göre otomatik olarak kesilerek analitik veri tabanına aktarılır. Değerin olabildiğince küçük tutulması yazılım performansını arttıracaktır. DefaultStringLimit 500 SQL destekleyen veri kaynakları haricinde Excel, CSV, SharePoint gibi veri kaynaklarından veri alınırken sütunun en büyük değeri tablo şeması üzerinde döndürülmediği durumlarda, ilgili sütundaki verinin en fazla büyüklüğünün tanımlanmasını sağlar. Bu değerden büyük string verileri kesilerek sistem veri tabanına içine aktarılır. UseAuthorizationForWebApplication True LDAP ya da Active Directory üzerinde tanımlı tüm kullanıcıların yetkilendirme gerekmeksizin raporlama portaline giriş FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 5

7 yapabilmeleri için bu değer False olarak belirlenmelidir. True durumundayken raporlama portaline girebilecek her kullanıcı, kullanıcı yönetiminden portale eklenmelidir. ExportInsertCacheCount 1000 Verilerin veri kaynağından aktarılırken kaçarlı gruplar halinde sisteme atılacağını belirler. Daha yüksek değer daha hızlı aktarım sağlar ancak aktarılan kayıt sayısı ile ilgili kullanıcı bilgilendirmesini o oranda azaltır. Bu değerin yüksek tutulması, veri tabanı klasöründe bulunan my.ini dosyasındaki max_allowed_packet değerinin aşılmasına sebep olabilir. VebianSkin Office 2013 Rapor tasarlama aracının hangi Light Gray görünüm ile çalışacağını belirler. DashboardSkin Dark Rapor portali üzerinde gösterilen panellerin siyah ya da beyaz arka planda gösterileceğini belirler. Seçilebilecek değerler: Dark, Light ApplicationCultureString tr-tr Vebian Studio Uygulaması arayüz dilini belirler. Seçenekler: tr-tr, en VebianStorageEngine BRIGHTHOUSE Raporlama veri tabanı saklama motoru seçenekleri. Bu değeri değiştirmeye gerek yoktur. VebianCollate utf8_turkish_ci Analitik veri tabanında bulunan tablolarda sıralama işlemi yapılırken kullanılacak dil seçeneği SiteURL Otomatik işlemlerin gerçekleştirilmesi sırasında kullanılmak üzere raporlama portalinin DNS tarafından belirlenen ismi ya da IP adresi. Örnek: SMTP_Server localhost Yazılımın e-posta gönderirken kullanacağı SMTP sunucu adresi SMTP_Port 25 Yazılımın e-posta gönderirken kullanacağı SMTP sunucu portu SMTP_UserName SMTP sunucusu kullanıcı adı şifre gerektiriyorsa Kullanıcı adı bilgisi SMTP_Password SMTP sunucusu kullanıcı adı şifre gerektiriyorsa şifre bilgisi SMTP_Sender rapor@fabreka. com.tr e-posta gönderilirken kullanılacak gönderici e-posta bilgisi FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 6

8 SMTP_SenderName Rapor Sunucusu e-posta gönderilirken kullanılacak görünen gönderici adı SMTP_UseSSL False SMTP sunucusu SSL gerektiriyorsa True olarak ayarlanır. SMS_URL m.com.tr/bulkht tppost.asp?user code=user&pass word=pass&msg header=mesajb aslik&gsmno={p hone}&msg={m essage}&dil=tr SMS sağlayıcınızdan alacağınız HTTP API adresini bu alana girebilirsiniz. Adreste mesajın girileceği bölüme {message}, telefon numaralarının girileceği bölüme {phone} yazılmalıdır. Analitik Veritabanı Bağlantı Konfigürasyonu Seçenek Varsayılan Açıklama VebianSchema <add name="vebianschema" connectionstring="server= ; port=3306;user id=root; Persist Security Info=True; database=vebian; CharSet=utf8;" providername= "MySql.Data.MySqlClient"/> Rapor tasarımlarının tutulduğu veri tabanının bağlantı bilgileri VebianAnalytic ADConnectionString <add name="vebiananalytic" connectionstring="server= ; port=3306; database=vebian_analytic;user id=root; Persist Security Info=True; ConvertZeroDateTime=True; CharSet=utf8;" providername= "MySql.Data.MySqlClient"/> <add name="adconnectionstring" connectionstring= "LDAP:// :389" /> Aktarılmış rapor verilerinin tutulduğu veri tabanı bağlantı bilgileri Active Directory ya da LDAP için bağlantı bilgileri İlk Kurulumda Gereken Ayarlar İlk kurulum yapıldıktan sonra Güvenlik, Veri tabanı, LDAP ve SMTP ayarları yazılımın sağlıklı çalışması için yapılmalıdır. Ayarlar Web uygulaması ve Job Service konfigürasyon dosyalarınının (Web.config ve VebianJobService.exe.config) ikisi için de yapılmalıdır. Buna göre belirlenmesi gereken ayarlar: - VebianSchema - VebianAnalytic - ADConnectionString - UseAuthorizationForWebApplication - SiteURL FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 7

9 - SMTP_Server - SMTP_Port - SMTP_UserName - SMTP_Password - SMTP_Sender - SMTP_SenderName - SMTP_UseSSL - SMS_Url Bu ayarları kurulumda masaüstüne kısa yolu eklenen Vebian Server Configurator aracı ile de kolaylıkla yapabilirsiniz. FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 8

10 Veri Kaynağı Sağlayıcısı Tanımı Vebian ADO.NET arayüzü sağlayan herhangi bir veri kaynağı ile çalışma olanağı sağlamaktadır. Sistemde ön tanımlı sağlayıcılardan başka bir sağlayıcı kullanmak için. İlgili ADO.NET sağlayıcısı kurulumu veri kaynağı internet sitesinden indirilerek kurulur ve Vebian veri tabanı tablolarından provider içine tanımları girilir. - ProviderName: Veri sağlayıcı seçim ekranında görünecek ad - ProviderType: Ado.Net sağlayıcı tam ismi. - ConnectionString: Veri kaynağı bağlantı dizesi. - UIElements: Veri kaynağı bağlantı dizesi oluşturulurken kullanılacak arayüz bileşenleri. (File,Server, Database, User, Password olabilir) - SqlQuery: Veri tabanı tabloları ilk çekilirken kullanılacak sql cümlesi. Dize içinde kullanılacak {Table} ifadesi gerçek tablo adı ile değiştirilecektir. - SqlObjectIdentifier: Tablo, Görünüm ya da kolon isimleri sorgu içinde kullanılırken ne şekilde yazılacağını belirtir. {0} ifadesi gerçek nesne ile değiştirilir. - FileTypes: Excel ya da embeded veri tabanları gibi dosya seçmek gereken veri tabanlarında kullanılır. Örnekler: Ayrıca eklenen sağlayıcının Data Provider bilgisi config dosyalarına aşağıda örnekte görüldüğü şekilde tanımlamak gerekebilir: <add name="mysql Data Provider" invariant="mysql.data.mysqlclient" description=".net Framework Data Provider for MySQL" type="mysql.data.mysqlclient.mysqlclientfactory, MySql.Data, Version= , Culture=neutral, PublicKeyToken=c5687fc88969c44d" /> FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 9

11 Genel Mimari Rapor Sunum Bileşenleri Portal Sunucuları Veri Tabanı Sunucuları Görev Servis Sunucusu LDAP Raporlama portali, dikey ve yatay olarak ölçeklenebilecek bir mimari ile geliştirilmiştir. Çok kullanıcı ile yoğun yük altında sürekli kullanım için portal, görev servisleri, veri tabanı bileşenleri ayrı sunucular üzerine kurulumu yapılabilir. Tüm yazılım bileşenleri tek bir sunucu üzerine kurulabileceği gibi, yukardaki şekilde görüldüğü gibi farklı sunucular üzerine de kurulabilir ancak analitik veri tabanının tüm kurulum şekillerinde farklı bir sunucu üzerinde bulunması önerilir. FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 10

12 Kullanıcı Yönetimi ve Yetkilendirme Web uygulaması varsayılan olarak kurulduğunda sunucu üzerinden adresi üzerinden ulaşılabilir ve Yönetici varsayılan şifreleri şu şekildedir; - Kullanıcı adı: admin, Şifre: admin Daha sonra web uygulaması üzerinden şifrenizi değiştirebilirsiniz. Sistemde tanımlı kullanıcıları ve yetkilerini yönetmek için Yönetim bölümü kullanılır. Rolleri ve her rolün görebileceği raporları tanımlamak için Roller ya da Yetkilendirme bölümü kullanılmaktadır. Kullanıcı tanımlamak ve kullanıcıları belirlenmiş rollere atamak için Kullanıcılar bölümü kullanılır. FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 11

13 Toplu Kullanıcı Aktarımı Kullanıcılarınızı toplu olarak tanımlamak ya da başka bir yazılımdan otomatik olarak almak için Veri Kaynağından Kullanıcı Aktar bağlantısını kullanabilirsiniz. Veri kaynağınızda bulunan alanları Vebian kullanıcı alanları ile eşleştirmek için ilgili alanın yanındaki açılır kutuları kullanabilirsiniz. Veri kaynağınızda bulunan diğer alanları kullanıcı özelliği olarak kaydetmek için Diğer veri sütunlarını ek kullanıcı özellikleri olarak kullan. seçeneğini kullanabilirsiniz. FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 12

14 Yeni Kullanıcı Ekleme Yönetici Mi? : Eklenen kullanıcının kullanıcı ve yetki yönetimi yapıp yapamayacağını belirler. Domain Kullanıcısı Mı? : Active Directory ya da herhangi bir LDAP sağlayıcı üzerinden kullanıcıyı doğrulamak için kullanılır. Bu kutu işaretlenirse şifre belirlenmez ve Kullanıcı Adı alanına Domain kullanıcı adı girilir. Aktif Mi? : Kullanıcının sisteme girişini geçici olarak kaldırmak için kullanılabilir. Sisteme tanımlanan kullanıcılara sisteme nasıl giriş yapabileceklerini belirten bir e-posta gönderilir. Eğer oluşturulan kullanıcı Domain kullanıcı olarak belirlenmemişse ilk girişte yeni şifre belirlemesi istenir. FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 13

15 Yeni şifre oluşturulduktan sonra kullanıcı sisteme giriş yapabilir. Eğer kullanıcı Domain kullanıcısı olarak tanımlanmışsa sisteme kendi kullanıcı adı şifresi ile giriş yapabileceğinin bilgisi verilir. FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 14

16 Tekil Oturum Açma (Single Sign On) Vebian web uygulamasına girmeden raporlarınızı kendi uygulamalarınızda görüntülemek için tekil oturum açma sistemini kullanabilirsiniz. Bunun için; uygulamanızda kullanıcı giriş formunun bulunduğu sayfanızın en altına aşağıdaki kodu yapıştırın. Burada sarı ile işaretlenmiş olan user yerine formunuzda kullanıcı adının girildiği metin kutusunun id değerini, pass yerine formunuzda şifrenin girildiği metin kutusunun id değerini, yerine vebian web uygulamanızın adresinizi yazmalısınız. ÖNEMLİ: Tekil oturum açmanın doğru şekilde çalışabilmesi için uygulamanızdaki kullanıcıları vebian web uygulamanızın Yönetim bölümünde bulunan Veri Kaynağından Kullanıcı Aktar seçeneği ile sisteminizdeki kullanıcıları aktarmış olmalısınız. <script type="text/javascript"> var submited = false; document.forms[0].onsubmit = function () { if (submited) return true; var u = document.getelementbyid("user").value; var p = document.getelementbyid("pass").value; var url = " + encodeuricomponent(u) + "&p=" + encodeuricomponent(p); document.getelementbyid("vebianlogin").src = url; submited = true; settimeout(function(){ document.forms[0].submit(); }, 500); return false; } </script> <iframe id="vebianlogin" name="vebianlogin" src=" width="1px" height="1px" frameborder="0" scrolling="no"></iframe> FABREKA Yazılım Elektronik Danışmanlık Tic. Ltd. Şti. 15