Tlos Lite v1.7.0 Kullanıcı Kılavuzu Nisan 2013 r00110ug-tr
Tlos Lite 1.7.0 Kullanıcı Klavuzu 2008-2013, Likya Bilgi Teknolojileri ve İletişim Hizmetleri Ltd. Şti. Tüm hakları saklıdır. Bu kılavuzdaki içerik yalnızca bilgi amacıyla verilmiştir, önceden bildirilmeksizin değiştirilebilir. Likya Bilgi Teknolojileri ve İletişim Hizmetleri Ltd. Şti. bu kılavuzda bulunan bilgi içeriğinde görülebilecek hatalardan veya doğru olmayan şeylerden dolayı hiçbir sorumluluk veya yükümlülük kabul etmez. Bu belgede açıklanan yazılım bir lisans sözleşmesi altında temin edilmiştir. Yazılım ancak sözleşmenin koşullarıyla tam uyum içerisinde kullanılabilir ya da kopyalanabilir. Bu belgenin hiçbir parçası, Likya Bilgi Teknolojileri ve İletişim Hizmetleri Ltd. Şirketinin kesin yazılı izni olmaksızın hiçbir gerekçeyle çoğaltılamaz, elektronik veya diğer hiçbir araçla/araçtan aktarılamaz. Ticari markalar Tlos Likya Bilgi Teknolojileri ve İletişim Hizmetleri Ltd. Şirketinin tescilli ticari markasıdır. Java Oracle Corporation veya bir iştirakinin tescilli ticari markasıdır. Microsoft, Windows, Windows NT, Microsoft şirketinin tescilli ticari markasıdır. AIX is a International Business Machines şirketinin tescilli ticari markasıdır. HP-UX Hewlett-Packard Company şirketinin tescilli ticari markasıdır. Mac OS Apple Inc şirketinin tescilli ticari markasıdır. Diğer tüm ticari markalar kendi sahiplerinin ticari markalarıdır. İletişim bilgileri web: www.likyateknoloji.com E-mail: bilgi@likyateknoloji.com Telefon: 216 471 8155 Faks: 216 661 1492 Adres: Eryılmazlar Sok, No: 4 Ali Kartal Business Centre, 4 th floor, D: 5 Icerenkoy, Ataşehir 34752 Istanbul
İçindekiler 1 Giriş 5 2 Gereksinimler... 5 3 Özellikler... 5 4 Tanımlar... 6 4.1 İş... 6 4.2 Senaryo... 6 4.3 Senaryonun tamamlanması... 6 4.4 İş Statüleri... 6 5 Lisans anahtarı ve Deneme Sürümü... 8 6 Tlos Lite Scheduler Programının Başlatılması ve Durdurulması... 9 6.1 Programın başlatılması... 9 6.2 Yönetim panelinin açılması... 9 6.3 Programın Durdurulması... 11 6.3.1 Komut satırından programın durdurulması... 11 6.3.2 Yönetim paneli kullanılarak programın durdurulması ve bekletilmesi... 11 6.4 Windows İşletim Sisteminde Programın servis olarak başlatılması ve durdurulması... 12 7 İş tanımlama... 13 7.1 Tlos Lite İş ve Senaryo parametreleri yapılandırılması dosyası (senaryobilgileri.xml)... 13 7.2 İş ve Senaryo Parametreleri... 13 7.3 İşlerin başarılı veya başarısız olarak bitmesi... 15 8 Tlos Lite Scheduler Çalışma Parametreleri ve Yapılandırma Dosyası... 16 8.1 Giriş... 16 8.2 Tlos yapılandırma dosyası (tlosconfig.xml)... 16 9 E-Posta Bildirimleri... 20 9.1 E-posta şirfresinin gizlenmesi... 22 10 SMS Bildirimleri... 24 11 İşlerin Web Arabirimi üzerinden izlenmesi ve yönetimi... 25 11.1 Web yönetim paneli... 25 11.2 Bilgi penceresi sütunları... 25 11.3 Senaryo ve İş Yönetimi... 27 11.4 Şifre İşlemleri... 28 11.5 Filtreleme seçenekleri... 29 Tlos Lite 1.7.0 Kullanıcı Klavuzu 3
11.6 Sıralama Seçenekleri... 30 11.7 Yapılandırma Dosyaları ve Log dosyalarının okunması... 31 11.8 İş listesinin kaydedilmesi... 32 11.9 Yardım Ekranı... 33 12 Log Dosyaları... 34 12.1 Giriş... 34 12.2 TlosTrace.log dosyası... 34 12.3 TlosEkran.log... 36 12.4 Çalıştırılan İşlerin Log Dosyaları... 37 13 Komut Satırından Yönetim ve İzleme... 38 13.1 Giriş... 38 13.2 Tlos Lite Scheduler kapatma işlemi... 38 13.3 Başarısız biten bir işin tekrar başlatılması :... 38 13.4 İşlerin statülerinin listelenmesi... 39 14 Tlos Lite Scheduler dosya ve dizin yapısı... 40 Tlos Lite 1.7.0 Kullanıcı Klavuzu 4
1 Giriş Tlos Lite Scheduler, tanımlanmış işlerin tek merkezden web tabanlı bir arayüzle izlenmesi ve yönetilmesi amacıyla geliştirilmiş platformdan bağımsız bir iş yönetimi yazılımıdır. Yine akıllı yük dengeleme özelliği ile herhangibir anda çalışacak iş sayısı minimum ve maksimum olarak belirlenebilir. Tlos Lite kendi içerisinde gömülü bir web sunucusu ile başka herhangi bir web sunucuya ihtiyaç duymaz. XML tabanlı yönetim ve senaryo dosyaları ile herhangi bir veri tabanına gereksinim olmadan çalışır. Tlos Lite yazılımı aşağıdaki platformlar üzerinde test edilmiştir: - Microsoft Windows versions: XP, Vista, Windows 7, Windows 8, Windows Server 2008 R2, Windows Server 2012 - Sun Solaris - HP UX - IBM AIX - Red Hat Enterprise Linux Server - Mac OS 2 Gereksinimler Tlos Lite yazılımını çalıştırmak için Java 1.6.1 veya daha yeni bir sürümüne ihtiyaç vardır. Tlos Lite çalıştırılacak bilgisayarda uygun Java sürümü kurulu değilse http://www.java.com adresinden kullandığınız işletim sistemi için uygun JDK sürümü ücretsiz olarak indirilebilir. JAVA_HOME ortam değişkeni Java nın kurulduğu dizini gösterecek şekilde ayarlanmalıdır. 3 Özellikler - Web tabanlı izleme ve yönetim - Yük dengeleme - Zaman ve iş bağımlılıkları - Periodik iş çalıştırma - Web üzerinden anlık log okuma - Gelişmiş hata yönetimi - Windows tabanlı sistemlerde servis olarak tanımlama seçeneği - Senaryo ağaç yapısı - Opsiyonel olarak SMS plug-in (Firma SMS altyapısı gerektirir) - Opsiyonel yönetim konsolu ile birden çok sayıda Tlos Lite yazılımının tek ekran üzerinden yönetilebilme Tlos Lite 1.7.0 Kullanıcı Klavuzu 5
4 Tanımlar 4.1 İş Çalıştırılacak olan program veya batch dosya. Executable programlar olabileceği gibi komut satırından çalıştırılan komutlar, batch dosyalar, scriptler de olabilir. Job kelimesi de aynı anlamda kullanılmaktadır. 4.2 Senaryo Tlos Lite Scheduler yazılımın çalıştırdığı iş grubu topluca senaryo olarak adlandırılmaktadır. Bir senaryonun çalıştırılma günleri gibi detaylar Senaryo yapılandırma dosyasında (senaryobilgileri.xml) tanımlanır. Senaryo yapılandırma dosyası herhangi bir editör kullanarak doğrudan edit edilerek paremetreler ayarlanabilir. Senaryo bilgileri yapılandırma dosyasında belirtilen çalışma günleri senaryoda tanımlı tüm işler için geçerlidir. Farklı günlerde çalıştırılması gereken işler varsa ayrı bir Tlos Lite Scheduler üzerinde tanımlanmalıdır. Farklı port numaraları kullanılarak aynı makina üzerinde aynı anda istenildiği kadar Tlos Lite Scheduler çalıştırılabilir. Çalışmakta olan birden çok sayıda Tlos Lite Scheduler yazılımlarını opsiyonel Tlos Lite Yönetim Konsolu sayesinde tek bir browser penceresi üzerinden yönetilebilirsiniz. 4.3 Senaryonun tamamlanması Tlos Lite yazılımı senaryoda tanımlı olan tüm işler tamamlandığında senaryoyu başarılı olarak bitmiş kabul eder ve işler bir sonraki çalışma zamanları geldiğinde çalışacak şekilde ayarlanır. Başarılı olarak tamamlanmayan senaryo bir sonraki gün çalışma zamanı gelmiş olsa bile başlatılmaz. Bir başka deyişle senaryo içerisindeki bir işin hatalı olarak bitmesi veya hiç bitmemesi durumunda senaryo tamamlanmış sayılmadığı için Tlos Lite kullanıcı müdahalesini bekler ve senaryo ertesi gün otomatik olarak çalıştırılmaz. Bu durum periyodik işler için geçerli değildir, periyodik işler hata alsa da senaryo işleri bir sonraki güne güne kurulur. Senaryonun bir sonraki periyotta otomatik olarak yeniden çalıştırılması için hatalı biten işler gerekiyorsa başarılı yap komutu ile başarılı bitmiş kabul edilebilir yada Atlat komutu ile senaryo devam ettirilebilir. 4.4 İş Statüleri Tlos Lite Scheduler da bir iş herhangi bir anda 9 farklı statüden birinde olabilir. Durum Icon Açıklama E-Posta Bildirimi Tlos Lite 1.7.0 Kullanıcı Klavuzu 6
seçeneği (*) Başarılı İşlem başarılı bir şekilde veya uyarı mesajı ile bitti. Evet Başarısız İşlem başarısız olarak sonlandı Evet Timeout Timeout süresi doldu Evet Geç (Atlat) Hazır Bekliyor İş pas geçildi İş hazır, belirtilen çalışma zamanının gelmesi bekleniyor Bağımlı olduğu işin bitmesi bekleniyor Çalışıyor İş o anda çalışıyor Evet Durdu Duraklatıldı İş durduruldu İş duraklatıldı Tablo 1: İş Statüleri (*) Tanımlı bir işin yukarıdaki tabloda belirtilen E-Posta bildirimi seçeneği mevcut olan bir statüye geçmesi durumunda istenilen kişilere e-posta uyarısı gönderilmesi mümkündür.. Tlos Lite 1.7.0 Kullanıcı Klavuzu 7
5 Lisans anahtarı ve Deneme Sürümü Tlos Lite Scheduler yazılımını 10 adete kadar işin yönetimi için ücretsiz olarak kullanabilirsiniz. 10 dan fazla iş yönetimi için lisans anahtarı gereklidir. Lisans anahtarı satın almak için Likya Teknoloji ile iletişime geçilmelidir. İhtiyacınıza göre Tlos Lite yazılımını süreli veya süresiz olarak farklı lisanslama modelleri ile satın alabilirsiniz. Lisans ile birlikte seçimli olarak bakım ve destek paketleri de satın alınabilir. Tlos Lite Scheduler server bazında lisanslanmaktadır. Çalıştırılabilecek iş sayısında ve lisans verilen sunucu üzerinde aynı anda çalıştırılabilecek Tlos Lite yazılımı sayısında bir kısıtlama yoktur. Likya Teknoloji iletişim bilgileri: Likya Bilgi Teknolojileri ve İletişim Hizmetleri Ltd. Şti. web: www.likyateknoloji.com E-mail: bilgi@likyateknoloji.com Telefon : 0 216 471 81 55 Fax : 0 216 661 14 92 Adres Eryılmazlar Sok, No:4 Ali Kartal İş Merkezi, Kat 4, D:5 İçerenköy, Ataşehir 34752 İstanbul Tlos Lite 1.7.0 Kullanıcı Klavuzu 8
6 Tlos Lite Scheduler Programının Başlatılması ve Durdurulması 6.1 Programın başlatılması Yazılım başlatılmadan önce yapılandırma dosyaları uygun şekilde ayarlanmalıdır. Windows tabanlı işletim sistemlerinde Programın kurulu olduğu dizindeki starttlosserver.bat isimli batch dosya çalıştırılır. Bu dosyanın içeriği şu şekildedir: java -Duser.country=TR -Duser.language=tr -jar TlosLite_V1.7.0_bxxx.jar Unix ve Linux tabanlı işletim sistemlerinde Programın kurulu olduğu dizindeki starttlosserver.sh isimli batch dosya çalıştırılır. Bu dosyanın içeriği şu şekildedir: java -Duser.country=TR -Duser.language=tr -jar TlosLite_V1.7.0_bxxx.jar starttlosserver.sh yerine startnohup.sh komutu kullanılırsa Tlos Lite Scheduler arka planda çalışmaya başlar. İlgili dosyayı komut satırından çalıştırdığımızda Tlos Lite Scheduler çalışmaya başlar ve yapılandırma dosyalarındaki tanımlamalara göre işleri çalıştırır. 6.2 Yönetim panelinin açılması Yönetim paneli bir browser aracılığı ile Tlos Lite Scheduler ın port numarası belirtilerek açılabilir. Örneğin; http://127.0.0.1:3000 Port numarası yapılandırma dosyalarında tanımlanmaktadır. Aynı makina üzerinde birden çok Tlos Lite Scheduler farklı portlar tanımlanarak birbirlerini etkilemeksizin çalıştırılabilirler. Açılan ekrandan kullanıcı adı ve şifre girilerek yönetim paneli başlatılır. Kullanıcı adı olarak tlos girilmelidir. Program ilk çalıştırıldığında default şifre tlos olarak belirlenmiştir. Güvenlik menüsündeki Şifre değiştirme adımı kullanılarak yeni şifre belirlenebilir. Tlos Lite 1.7.0 Kullanıcı Klavuzu 9
Tlos Lite Scheduler da tek kullanıcı tanımlanabilmektedir ve kullanıcı adı tlos tur. Farklı kullanıcılar ve yetkilendirmelerin gerektiği durumlar için Tlos SW dağıtık iş yükü yönetimi yazılımı önerilir. Şekil 1: Log in ekranı Giriş yapıldıktan sonra gelen tipik bir ekran görüntüsü aşağıda verilmektedir. Şekil 2: Tipik bir yönetim ekranı görüntüsü Tlos Lite 1.7.0 Kullanıcı Klavuzu 10
6.3 Programın Durdurulması 6.3.1 Komut satırından programın durdurulması Windows tabanlı işletim sistemlerinde; Tlos Lite Scheduler ın kurulu olduğu dizinde yer alan stopftlos.bat ve stopntlos.bat isimli dosyalar çalıştırılarak program durdurulabilir. stopntlos.bat senaryonun tamamlanmasını bekleyip programı durdurur. stopftlos.bat programın çalışmasını hemen durdurur. Unix ve Linux tabanlı işletim sistemlerinde; Tlos Lite Scheduler ın kurulu olduğu dizinde yer alan stopftlos.sh ve stopntlos.sh dosyalar çalıştırılarak program durdurulabilir. stopntlos.sh senaryonun tamamlanmasını bekleyip programı durdurur. stopftlos.sh programın çalışmasını hemen durdurur. isimli 6.3.2 Yönetim paneli kullanılarak programın durdurulması ve bekletilmesi Yönetim menüsündeki Normal Kapat seçeneği seçildiğinde çalışan işler bittikten sonra program durur. Yönetim Menüsündeki Hemen Kapat seçeneği seçildiğinde çalışan işlerin bitmesi beklenmeden program durur. Yönetim Menüsündeki Beklet seçeneği seçildiğinde senaryonun işletilmesi durdurulur. O anda çalışmakta olan işler çalışmaya devam ederler fakat yeni iş başlatılmaz. Bekletme modunda iken menüdeki Devam Ettir seçeneği seçildiğinde senaryo tekrar kaldığı yerden çalıştırılır. Menü seçenekleri aşağıda ki gösterilmiştir. Tlos Lite 1.7.0 Kullanıcı Klavuzu 11
Şekil 3: Yönetim ekranı menü seçenekleri 6.4 Windows İşletim Sisteminde Programın servis olarak başlatılması ve durdurulması Başlat -> Denetim Masası -> Yönetimsel Araçlar penceresinden Hizmetler kısayolu çalıştırılır. Açılan pencerede listelenen servisler listesinde Tlos Lite sağ tıklanarak Başlat seçeneği tıklanarak Tlos Lite ın çalışması başlatılmış olur. Tlos Lite arka planda çalışarak senaryo yapılandırma dosyalarında tanımlandığı şekli ile işleri çalıştırır. Yönetim panelinin bir browser kullanılarak nasıl açılacağı Bölüm 6.2 de açıklanmıştır. Yazılımın çalışmasını durdurmak için ise benzer şekilde Başlat -> Denetim Masası -> Yönetimsel Araçlar penceresinden Hizmetler kısayolu çalıştırılarak açılan pencerede listelenen servisler listesinde Tlos Lite sağ tıklanarak Durdur seçeneği tıklanarak yazılımın çalışması durdurulabilir. Tlos Lite 1.7.0 Kullanıcı Klavuzu 12
7 İş tanımlama 7.1 Tlos Lite İş ve Senaryo parametreleri yapılandırılması dosyası (senaryobilgileri.xml) Tlos Lite Scheduler da çalıştırılacak işler ve ilgili parametreler SenaryoBilgileri.xml isimli dosyada saklanmaktadır. Çalıştırılacak her bir işin detayları bu dosyada tanımlanmalıdır. Bu dosya xml formatında olup Tlos Lite dizininde yer alır. Dosya doğrudan herhangi bir editor kullanılarak güncellenebilir. 7.2 İş ve Senaryo Parametreleri Senaryo bilgileri yapılandırma dosyasında Tlos Lite tarafından çalıştırılacak her bir iş için tüm detayların belirtildiği bir kayıt bulunur. Bu kayıtın formatı şu şekildedir: <entry key="iş_id">grup_id, iş_komutu, iş_tipi, Log_dosyası, Bağımlılık, Çalışma_Tipi, Başlangıç_Tarih_Saat, Timeout, AutoRetry, Bitiş_Kodu, YenidenBaşlatılabilir, Hata_Metni </entry> Parametreler aralarına virgül konularak ayrılır. Buradaki parametrelerin açıklamaları aşağıdaki tabloda verilmiştir: Tlos Lite Scheduler Senaryo Yapılandırma Dosyasında yer alan İş Parametreleri Parametre Açıklama iş_id İşe verilen tekil isim Grup_ID İşin bağlı olduğu grubun ismi iş_komutu İşin çalıştırılacağı komut iş_tipi İşin türü Log_dosyası İşin log dosyasının adı. İşe ait bir log dosyası mevcut değilse boş girilebilir. (opsiyonel) Bu parametre sadece log dosyasını görüntüleme amacıyla kullanılmaktadır. Bağımlılık İşin bağımlı olduğu işler. Birden çok işe bağımlılık tanımlanabilir. Bu durumda aralarına işareti konulmalıdır. İşlerin çalıştırılmasında öncelik bağımlılık ilişkisindedir, daha sonra çalışma zamanı gelmektedir. Başka bir işe bağlı olan bir iş bağlı olduğu iş bitmeden çalıştırılmaz. Bir iş in bağımlı olduğu işler bitmiş ise ve tanımlı zamana da gelinmiş ise o iş çalıştırılır. Çalışma Tipi Günde bir kez çalışan işler (Standart iş) S, tekrarlı işler için saniye cinsinden periyot değeri girilir. Tekrarlı işler belirtilen süre geçtikten sonra tekrar çalıştırılır. Çalışma tipi tekrarlı iş ise başlangıç saatinin Başlangıç_Tarih_Saa t Timeout yanında (-) ile ayrılarak bitiş saati de girilmelidir. Başlangıç tarih ve zamanı. gg/aa/yyyy ss:dd:sn formatında verilmelidir. Tarih belirtilmeden sadece saat belirtilirse çalıştırıldığı gün olarak kabul edilir. Başka bir işe bağlı olan bir iş bağlı olduğu iş bitmeden çalıştırılmaz. İşin çalışma tipi tekrarlı iş ise başlangıç saatinin yanında (-) ile ayrılarak bitiş saati de girilmelidir. İşin başarısız kabul edilmesi için geçmesi gereken süre (saniye). Aşağıda açıklandığı üzere AutoRetry parametresinin aldığı değere farklı şekillerde Tlos Lite 1.7.0 Kullanıcı Klavuzu 13
AutoRetry yorumlanır. True ise ve iş başlatıldıktan sonra Timeout süresi geçene kadar başarılı yada başarısız olarak sonuçlanmazsa aşağıdakiler gerçekleşir: İşi çalıştıran proses kill edilip, iş yeniden başlatılır. İşin Statüsü, önce Başarısız olup hemen arkasından Çalışıyor durumuna geçer. Bu arada bilgilendirme mesajı gönderilmez. Yeniden başlatılan iş için artık Timeout kontrolü yapılmaz ve iş başarılı yada başarısız olarak sonuçlanana kadar çalıştırılmaya devam eder. Periyodik işlerde ise Timeout süresi aşıldığında iş tekrar çalıştırılmaz, statüsü Başarısız olur. False ise ve iş başlatıldıktan sonra Timeout süresi geçene kadar başarılı yada başarısız olarak sonuçlanmazsa aşağıdakiler gerçekleşir: İş statüsü Timeout olur Eğer istenmişse bilgilendirme mesajı gönderilir İşi başlatan proses için bir işlem yapılmaz, iş başarılı yada başarısız olarak sonuçlanana kadar çalışmaya devam eder. Bu süreçte kullanıcı tarafından durdurulması mümkündür. Periyodik işler açısından da durum aynıdır. Bitiş_Kodu Burada belirtilen bitiş kodu ile biten işler başarılı kabul edilir. Araya karakteri konularak birden çok kod belirtilebilir. Örneğin 0 4 5 Sıfır (0) bu rada belirtilmese bile daima başarılı olarak kabul edilir. YenidenBaşlatılabilir Hata_Metni True ise iş yeniden başlatılabilir Buraya yazılan ifade eğer işin log dosyasında mevcut ise başarısız olarak kabul edilir. Böylece bitiş kodu haricinde de özel durumlar için akış kontrolü sağlanabilmektedir. Bu kontrolün yapılmaması isteniyorsa \null değeri girilmelidir. Tablo 2: İş ve Senaryo Parametreleri Aşağıda örnek bir senaryo yapılandırma dosyası yer almaktadır: <!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd"> <properties> <comment> </comment> <entry key="version">v1.7.0</entry> <entry key="job1">grup A,C:\Users\ender\Desktop\Tlos1.7\job1.bat,system,C:\Users\ender\Desktop\Tlos1.7\logs\job1.log,yok, S,20/02/2012 09:00:00-23:00:00,3000,false,0,1,\null</entry> <entry key="job2">grup B,C:\Users\ender\Desktop\Tlos1.7\job2.bat,system,C:\Users\ender\Desktop\Tlos1.7\logs\job2.log,yok,S,20/02/2012 09:00:00,3000,false,0,1,\null</entry> <entry key="job3">grup C,C:\Users\ender\Desktop\Tlos1.7\job3.bat,system,C:\Users\ender\Desktop\Tlos1.7\logs\job3.log,yok,S,20/02/2012 09:00:00,3000,false,0,1,\null</entry> <entry key="job4">grup B,C:\Users\ender\Desktop\Tlos1.7\job4.bat,system,C:\Users\ender\Desktop\Tlos1.7\logs\job4.log,job2, S,20/02/2012 09:00:00,3000,false,0,1,\null</entry> Tlos Lite 1.7.0 Kullanıcı Klavuzu 14
<entry key="job5">grup C,C:\Users\ender\Desktop\Tlos1.7\job5.bat,system,C:\Users\ender\Desktop\Tlos1.7\logs\job5.log,job3, S,20/02/2012 09:00:00,3000,false,0,1,\null</entry> <entry key="job6">grup B,C:\Users\ender\Desktop\Tlos1.7\job6.bat,system,C:\Users\ender\Desktop\Tlos1.7\logs\job6.log,job4, S,20/02/2012 09:00:00,3000,false,0,1,\null</entry> <entry key="job7">grup B,C:\Users\ender\Desktop\Tlos1.7\job7.bat,system,C:\Users\ender\Desktop\Tlos1.7\logs\job7.log,job4, S,20/02/2012 09:00:00,3000,false,0,1,\null</entry> <entry key="job8">grup C,C:\Users\ender\Desktop\Tlos1.7\job8.bat,system,C:\Users\ender\Desktop\Tlos1.7\logs\job8.log,job5, S,20/02/2012 09:00:00,3000,false,0,1,\null</entry> <entry key="job9">grup B,C:\Users\ender\Desktop\Tlos1.7\job9.bat,system,C:\Users\ender\Desktop\Tlos1.7\logs\job9.log,job6, S,20/02/2012 09:00:00,3000,false,0,1,\null</entry> <entry key="job10">grup B,C:\Users\ender\Desktop\Tlos1.7\job10.bat,system,C:\Users\ender\Desktop\Tlos1.7\logs\job10.log,jo b7,s,20/02/2012 09:00:00,3000,false,0,1,\null</entry> <entry key="job11">grup B,C:\Users\ender\Desktop\Tlos1.7\job11.bat,system,C:\Users\ender\Desktop\Tlos1.7\logs\job11.log,jo b10,s,20/02/2012 09:00:00,3000,false,0,1,\null</entry> </properties> 7.3 İşlerin başarılı veya başarısız olarak bitmesi Tlos Lite Scheduler çalışması sonlanan bir işin başarılı yada başarısız olarak bittiğini bitiş koduna göre ve eğer özellikle belirtilmiş ise senaryo yapılandırma dosyasında Hata_Metni olarak girilmiş parametrenin yer alıp almadığına bakarak karar verir. Senaryo dosyasındaki Bitiş_Kodu parametresinde yer alan değerlere sahip bitiş kodları ile sonlanan işler ve 0 kodu ile biten işler başarılı olarak bitmiş kabul edilir. Bu değerler dışındaki bitiş kodları ile sonlanan işler ise başarısız kabul edilir. Birden çok başarılı bitiş kodu parametresi girilmek isteniyorsa araya karakteri konulmalıdır. Buna ek olarak Hata_Metni parametresinde belirtilen ifade işin log dosyasında yer alıyorsa o işin, bitiş kodu ne olursa olsun başarısız olarak sonlandığı kabul edilir. Buraya yazılacak parametre birden çok kelimeden oluşabilir. Ifadenin log dosyasında tamamen aynısının yer alıp almadığına bakılacaktır (exact match). Eğer hata metni kontrolünün yapılması istenmiyorsa Hata_Metni parametresinin yerine \null değeri yazılmalıdır. Tlos Lite 1.7.0 Kullanıcı Klavuzu 15
8 Tlos Lite Scheduler Çalışma Parametreleri ve Yapılandırma Dosyası 8.1 Giriş Tlos Lite Scheduler yazılımının çalışma parametreleri XML formatında tlosconfig.xml isimli bir dosyada tutulur. Bu dosya herhangi bir editör kullanılarak güncellenebilir. 8.2 Tlos yapılandırma dosyası (tlosconfig.xml) Program parametrelerinin belirlendiği XML yapılandırma dosyasında aşağıdaki parametreler yer almaktadır. Bu dosya herhangi bir metin editörü ile edit edilebilir. Parametrelerin açıklamaları aşağıdaki tabloda verilmiştir. Tlosconfig.xml yapılandırma dosyası parametreleri Parametre Açıklama version Yazılımın versiyon numarası. Bu parametre değiştirilmemelidir. scenarioname Senaryoya verilen isim, yönetim ekranında görüntülenir. scenariofile Senaryo yapılandırma dosyasının ismi. Bu alan değiştirilmemelidir. normalize Günlük öteleme parametresi. Program çalışmaya başladığında ya da kuyruğu yeniden baslatmak istediğinde, kuyrukta bir tarama yapar, ve Eğer normalize parametresi True ise eski tarihli işleri bir sonraki çalışma zamanına öteler, Normalize parametresi False ise başlangıç zamanı geçmiş işleri hemen çalıştırır. ispersistent Programın herhangi bir şekilde sonlanması ve arkasından yeniden başlatılması durumunda önceki çalışmada senaryonun kaldığı yerden devam etmesi isteniyorsa true seçilmeli, aksi halde false seçilmelidir. True olması durumunda tlos.recover dosyası oluşturulur. Sistemin kaldığı yerden başlaması için bu dosya kullanılır. schedulerfrequency Scheduler çalışma sıklığı (sn). Tlos Lite Scheduler burada belirtilen sıklıkta iş kuyruğunu tarayarak işlerin çalışma zamanının gelip gelmediğini kontrol eder. scheduleddays Çalışma günleri, İşler burada listelenen günlerde çalıştırılır, onun dışındaki günlerde çalıştırılmaz. (Pazar[1]-Cumartesi[7]) schedulerhigherthreshold Aynı anda çalıştırılacak maksimum iş sayısını belirtir. Yük dengelemesinde kullanılmaktadır. schedulerlowerthreshold Aynı anda çalıştırılacak minimum iş sayısını belirtir. Yük dengelemesinde kullanılmaktadır. usemail Alarmlar için e-mail kullanılacaksa true, e-mail istenmiyorsa false değerini almalıdır. Tlos Lite 1.7.0 Kullanıcı Klavuzu 16
statuslistformail Hangi durumlar için e-posta raporu gönderileceğini belirtir. Araya virgül konularak birden çok seçenek seçilebilir. 2:Çalışıyor 3:Başarılı 4:Başarısız 5:Timeout emaildestinationlist e-posta alıcılarının listesini belirtir. Birden çok e-posta adresi araya noktalı virgül (;) konularak girilebilir. emailusername Eposta sunucusu kullanıcı adı emailpassword e-posta şifresi. Encrypt edilmiş şekilde girilmelidir. Encrypt işlemi Bölüm 9.1 te anlatılmıştır. smtpserver Smtp sunucusu smtpport Smtp port numarası usesms SMS gönderilmesi isteniyorsa true, istenmiyorsa false değerini almalıdır. smsclassname SMS ayarlarının yapıldığı Java sınıfın adı girilir. Kullanılan SMS altyapısı için özel bir eklenti gerekmektedir. SMS kullanımı için Likya Teknoloji ile iletişime geçiniz. statuslistforsms Hangi durumlar için SMS bildirimi gönderileceğini belirtir. Araya virgül konularak birden çok seçenek seçilebilir. 2:Çalışıyor 3:Başarılı 4:Başarısız 5:Timeout logfile Ekran mesajlarının yazıldığı log dosyasının ismi usejobnamesforlog True olur ise job isminin arkasına addjobnamesforlog parametre değeri eklenir. addjobnamesforlog Job isminin yanına eklenecek kelime. Usejobnamesforlog parametresi true olmalıdır. usegloballogpath Tüm log dosyalarının aynı dizinde oluşturulması istendiğinde true değerini almalıdır. globallogpath Tüm job log dosyalarının bulunduğu dizin burada belirtilir. Addjobnamesforlog parametresi true olmalıdır. httphostname Web arabirimi için Tlos Lite Scheduler ın kurulu olduğu makinanın IP adresi. Örneğin 127.0.0.1 veya localhost httpaccessport Web arabirimi için TCP portu. Gömülü HTTP sunucu bu portta çalıştırılır dolayısı ile web arabirimine bu port üzerinden erişilir. useterminalmanagement Tlos Lite Scheduler komut satırından yönetilebilmesi için bu parametre true olmalıdır. Komut satırından yönetim için Bölüm 12 e bakınız. terminalport Komut satırından yönetim için kullanılacak port numarası usejmxmanagement Tlos Lite Yönetim Konsolu kullanılmak istendiğinde bu değer true girilmelidir. jmxip Tlos ile Yönetim Konsolu'nun haberleşmesinin sağlanacağı IP adresi girilir. Örneğin 192.168.1.31 jmxport Tlos ile Yönetim Konsolu'nun haberleşmesinin sağlanacağı port numarası. Tablo 3 Tlos Lite Parametreleri Tlos Lite 1.7.0 Kullanıcı Klavuzu 17
ispersistent parametresinin true olması durumunda program sonlandığında Tlos.recover dosyası oluşturulur. Programın bir sonraki çalıştırılmasında işler kaldığı yerden çalışmaya devam eder. Eğer işlerin en baştan itibaren çalıştırılması isteniyorsa yazılım tekrar çalıştırılmadan önce Tlos.recover dosyası silinmelidir. normalize parametresi true ise program başlatıldığı anda zamanı geçmiş işler var ise onlar bir sonraki çalışma zamanına kurulur, hemen çalıştırılmazlar. Eğer normalize parametresi false olarak ayarlanmış ise program başlatıldığı anda tüm zamanı geçmiş olan işler de çalışmaya başlar ve her bir iş bittiğinde bir sonraki çalışma zamanına kurulur. Bu durumda da ispersistent parametresi kontrol edilmelidir. Tüm işler bittiğinde ispersistent true ise ve Tlos.recover dosyası silinmiş ise tüm işlerin zamanı geçtiği için yeni baştan çalışmaya başlar. Böyle bir durumda; çalışıp biten işlerin aynı gün içerisinde tekrar çalışmasını engellemek için işlerin çalışma zamanları uygun şekilde düzenlenmelidir. Aşağıda örnek bir yapılandırma dosyası yer almaktadır: <properties> <comment> </comment> <entry key="version">v1.7</entry> <entry key="scenarioname">tloslitedemo</entry> <entry key="scenariofile">senaryobilgileri.xml</entry> <entry key="normalize">false</entry> <entry key="ispersistent">false</entry> <entry key="schedulerfrequency">1</entry> <entry key="scheduleddays">1,2,3,4,5,6,7</entry> <entry key="schedulerhigherthreshold">150</entry> <entry key="schedulerlowerthreshold">1</entry> <entry key="usemail">false</entry> <!-- entry key="statuslistformail">2:working, 3:SUCCESS, 4:FAIL, 5:TIMEOUT</entry --> <entry key="statuslistformail">3</entry> <entry key="emaildestinationlist"></entry> <entry key="emailusername">ender.oztas@likyateknoloji.com</entry> <entry key="emailpassword"></entry> <entry key="smtpserver">mail.likyateknoloji.com</entry> <entry key="smtpport">587</entry> <!-- SMS kullanilalacak ise asagidaki kisimlar doldurulmali --> <entry key="usesms">false</entry> <entry key="smsclassname">vodafonesmshandler</entry> <entry key="statuslistforsms">timeout</entry> <entry key="logfile">tlosekran.log</entry> <!-- job loglari ile ilgili ayarlar icin asagidaki kisimlar doldurulmali --> <entry key="usejobnamesforlog">false</entry> <entry key="addjobnamesforlog">.log</entry> <!-- log dizinleri ile ilgili ayarlar icin asagidaki kisimlar doldurulmali --> <entry key="usegloballogpath">false</entry> <entry key="globallogpath">logs</entry> Tlos Lite 1.7.0 Kullanıcı Klavuzu 18
<entry key="httphostname">127.0.0.1</entry> <entry key="httpaccessport">3000</entry> <entry key="useterminalmanagement">true</entry> <entry key="terminalport">3001</entry> <entry key="usejmxmanagement">true</entry> <entry key="jmxip">127.0.0.1</entry> <entry key="jmxport">3002</entry> </properties> Tlos Lite 1.7.0 Kullanıcı Klavuzu 19
9 E-Posta Bildirimleri Tlos Lite Scheduler uygulaması senaryo işletilmeye başlandığında, işlerin yürütülmesi aşamasında bazı durum değişikliklerinde ve senaryo tamamlandığında e-posta ile bilgilendirme yapabilmektedir. E-posta ayarları tlosconfig.xml yapılandırma dosyasında yer alan usemail, statuslistformail, emaildestinationlist, emailusername, emailpassword, smtpserver ve smtpport parametreleri aracılığı ile yapılır. Başlangıç e-postasında senaryoda yer alan tüm işlerin bir listesi, bağımlılık ve çalışma zamanları yer alır. İlk e-posta programın başlangıcında gönderilir. Benzer şekilde senaryo tamamlandığında da bir bilgilendirme e-postası gönderilmektedir. İşlerin aşağıdaki statülerden birine geçmesi durumunda da istenirse e-posta bildirimi yapılmaktadır: Çalışıyor Başarılı Başarısız Timeout Hangi statüler için e-posta gönderileceği statuslistformail parametresi ile belirtilir. Belirtilen statü mesajları senaryodaki tüm işler için gönderilir. Yapılandırma dosyasındaki emaildestinationlist kısmına e-posta gönderilmek istenilen kişilerin e-posta adresleri girilir. E-posta adreslerinin arasına noktalı virgül (;) konularak birden fazla sayıda e-posta adresi girilebilir. Aşağıda eposta mesajlarından bazı örnekler verilmiştir: Tlos Lite 1.7.0 Kullanıcı Klavuzu 20
Şekil 4: Senaryo başlangıcında gönderilen e-posta mesajı örneği Şekil 5: Başarısız biten bir iş için e-posta bildirimi örneği Tlos Lite 1.7.0 Kullanıcı Klavuzu 21
Şekil 6: Başarılı biten bir iş için e-posta bildirimi örneği Şekil 7: Senaryo tamamlandığında gönderilen e-posta bildirimi örneği 9.1 E-posta şirfresinin gizlenmesi Tlos Lite Scheduler yapılandırma dosyasında e-posta bildirimleri için kullanılacak e-posta hesabının şifresi encrypt edilmiş şekilde saklanmalıdır. Bu amaçla Tlos Lite Scheduler yazılımının kurulu olduğu dizinde bir komut penceresi açılarak encryptpassword.bat isimli dosya çalıştırılır. Program kullanıcıya şifre yi sorar ve encript edilmiş bir kod oluşturur. Tlosconfig.xml isimli yapılandırma dosyasında e-posta şifresi için bu kod kullanılmalıdır. Şifre en fazla 8 karakter uzunluğunda olabilir. Tlos Lite 1.7.0 Kullanıcı Klavuzu 22
Şekil 8: Komut satırı penceresinde e-posta şifresinin gizlenmesi Tlos Lite 1.7.0 Kullanıcı Klavuzu 23
10 SMS Bildirimleri İşletmenizde SMS altyapısı mevcut ise Tlos Lite Scheduler ile e-posta bildirimlerinde olduğu gibi SMS bildirimleri gönderilmesi de mümkündür. Kullanılan SMS altyapısına özel bir eklenti geliştirilmesi gerektiğinden SMS kullanımı için Likya Teknoloji ile iletişime geçiniz. SMS bildirimleri yapılıp yapılmayacağı ve hangi statüler için SMS gönderileceği tlosconfig.xml yapılandırma dosyasında yer alan usesms, smsclassname ve statuslistforsms parametreleri ile belirtilir. Tlos Lite 1.7.0 Kullanıcı Klavuzu 24