Tlos Lite v1.7.0 Kurulum Kılavuzu Nisan 2013

Tlos Lite v1.7.0 Kurulum Kılavuzu Nisan 2013 r00110ig-tr

Tlos Lite 1.7.0 Kurulum 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 Türkiye Tlos Lite 1.7.0 Kurulum Klavuzu 2

İçindekiler 1 Giriş 4 2 Yazılım ve dokümanların indirilmesi... 4 3 Gereksinimler... 4 4 Lisans anahtarı ve Deneme Sürümü... 5 5 Tlos Lite Scheduler Kurulumu... 6 5.1 Tlos Lite Kurulumu... 6 5.2 Windows İşletim Sisteminde Servis olarak tanıtılması... 6 5.3 Linux işletim sistemlerinde Deamon olarak çalıştırma... 8 6 Tlos Lite Scheduler dosya ve dizin yapısı... 10 7 Tlos Lite Scheduler Programının Başlatılması ve Durdurulması... 12 7.1 Programın başlatılması... 12 7.2 Yönetim panelinin açılması... 12 7.3 Programın Durdurulması... 14 7.3.1 Komut satırından programın durdurulması... 14 7.3.2 Yönetim paneli kullanılarak programın durdurulması ve bekletilmesi... 14 7.3.3 Windows İşletim Sisteminde Programın servis olarak başlatılması ve durdurulması... 14 8 Tlos Lite yazılımının kaldırılması... 15 Tlos Lite 1.7.0 Kurulum Klavuzu 3

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 Bu dokümanda Tlos Lite Scheduler yazılımının kurulumu ve kaldırılması anlatılmaktadır. Yazılımın ayarlarının yapılması ve kullanımı için Kullanıcı Klavuzu dokümanına başvurunuz. 2 Yazılım ve dokümanların indirilmesi Tlos Lite Scheduler yazılımını ve dokümanlarını http://www.tlos.com.tr web sitesindenücretsiz olarak indirebilirsiniz. 3 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. Tlos Lite 1.7.0 Kurulum Klavuzu 4

4 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. 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 Kurulum Klavuzu 5

5 Tlos Lite Scheduler Kurulumu 5.1 Tlos Lite Kurulumu Öncelikle Tlos Lite yazılımının kurulacağı dizin oluşturulmalıdır (örneğin D:\TlosLite). Tlos Lite yazılımı ve yazılımın çalışması için gerekli kütüphaneler ile yapılandırma dosyalarının tamamı bir sıkıştırılmış dosya içerisinde yer alır (örneğin TlosLiteTrial_1.7.0.zip). Bu dosyanın içeriği oluşturulan kurulum dizinine açılmalıdır. Bu işlem gerçekleştirildiğinde Şekil 1 de görülen dosya yapısı oluşmuş olur. 5.2 Windows İşletim Sisteminde Servis olarak tanıtılması Tlos Lite Scheduler yazılımının windows tabanlı işletim sistemlerinde makinenin kapatılıp açılma durumlarında herhangi bir kullanıcı login olmadan dahi her zaman otomatik olarak çalıştırılmasının istendiği durumlarda yazılım bir windows servisi olarak çalıştırılmalıdır. Bu bölümde Tlos Lite Scheduler yazılımının nasıl windows servisi olarak tanıtılacağı açıklanmaktadır. Windows işletim sistemi kullanan makinelerde çalışan servislere Türkçe versiyonlarda : Denetim Masası\Tüm Denetim Masası Öğeleri\Yönetimsel Araçlar İngilizce versiyonlarda : Control Panel\All Control Panel Items\Administrative Tools Sayfalarından erişilebilir. Bu ekranlarda services (hizmetler) yönetim sayfası vardır. Bu sayfa içerisinde görülen liste, işletim sistemi üzerinde çalışan servislerin listesidir. Yeni bir servis tanımladığınızda bu listede yer alır. Servisi başlatmak, durdurmak için de bu yönetim ekranı kullanılır. Herhangi bir servisin isminin üzerine sağ tıkladığınızda eğer servis çalışır durumda ise durdur ; çalışmıyor durumda ise başlat yazıları görünecektir. Tlos Lite Scheduler ın servis olarak tanımlanması için bir dizi script komutu çalıştıran install.bat dosyası kullanılır. Bu install.bat dosyası önceden hazırlanmış olup Tlos Lite ana dizini ne kopyalanmalıdır. Tlos Lite Scheduler un çalışacağı dizin bundan sonra Tlos Lite ana dizini olarak anılacaktır. Servisin kaldırılması için de aynı maksatla hazırlanmış uninstall.bat dosyası kullanılacaktır. Java uygulamalarını windows servisi olarak çalıştırmak amacıyla açık kaynak kodlu bir kütüphane olan JavaService kütüphanesi kullanılmaktadır. Bu kütüphaneye http://forge.ow2.org/projects/javaservice/ adresinden erişebilirsiniz. Kullanılan işletim sistemi mimarisi için uygun versiyon indirilmelidir (versiyon 2.0.10 sayfasında 64 bit işletim sistemi için JavaService_2_0_10-amd64.zip, 32 bit işletim sistemi için JavaService-2.0.10.zip). Tlos Lite 1.7.0 Kurulum Klavuzu 6

Aşağıda adım adım yapılması gereken işlemler gösterilmiştir: 1- Kullanılacak olan sistem mimarisi (32-64 bit, Windows versiyonu) için uygun kütüphane http://forge.ow2.org/projects/javaservice/ sitesinden javaservice_bin zip dosyası olarak indirilir. 2- İndirilen zip dosya açılır. 3- Açılan zip dosyasının içerisindeki JavaService.exe dosyasının adı TlosLite_v1.7.0_Service.exe olarak değiştirilir. 4- İsmi değiştirilen dosya Tlos ana dizine taşınır 5- Install.bat dosyası servis tanımlama işlemi için kullanılacaktır. Likya yetkilileri tarafından sağlanacaktır Bu dosyanın içeriği şu şekildedir: TlosLite_v1.7.0_Service.exe -install TlosLite_v1.7.0_Service^ "D:\dev\Java\jdk1.6.0_25\jre\bin\server\jvm.dll"^ - Djava.class.path="D:\dev\Java\jdk1.6.0_25\lib\tools.jar;D:\WORK\TEST\tlos_1.7.0_servisk urtest\tloslite_v1.7.0_b77.jar"^ -Xms64M -Xmx256M -start com.likya.tlos.tlos -stop com.likya.tlos.tlosremotemanager^ -params "-port 3001" "-host localhost" "-fterminate"^ -out D:\WORK\ TEST\tlos_1.7.0_serviskurtest \stdout.log^ -err D:\WORK\ TEST\tlos_1.7.0_serviskurtest \stderr.log^ -current D:\WORK\TEST\tlos_1.7.0_serviskurtest^ -append Bu dosyanın içeriği Tlos Lite ın servis olarak tanıtılacağı makinede yüklü olan java bilgilerine göre düzenlenecektir: i) Java'nın jvm.dll dosyasinin yüklü oldugu dizin bulunur, install.bat dosyasında bu path yazilir. Örneğin: "D:\dev\Java\jdk1.6.0_24\jre\bin\server\jvm.dll"^ ii) Djava.class.path= ile başlayan dizinin devamında tools.jar dosyasının dizini ve uygulamanın çalıştıracağı jar dosyasının dizini verilir. -Djava.class.path="D:\dev\Java\jdk1.6.0_24\lib\tools.jar; D:\WORK\TEST\tlos_1.7.0_serviskurtest \TlosLite_V1.7.0_b112.jar"^ iii) install.bat dosyasinda -params satirindaki port numarasi stoptlos icinde verilen port numarası olmalıdır. iv) log dosyalari icin pathler verilir. out ve err ile başlayan satırların devamında log dosyasının oluşturulacağı dizin ve log dosyası adı verilir. Örn: -out D:\WORK\TEST\tlos_1.7.0_serviskurtest \stdout.log^ Örn: -err D:\WORK\TEST\tlos_1.7.0_serviskurtest \stderr.log^ v) -current uygulamanın kurulmuş olduğu dizin verilir. 6- Dosyanin düzenleme işlemi tamamlandıktan sonra, komut satırından install.bat dosyasının bulunduğu dizine gidilir ve install.bat çalıştırılır. 7- Install.bat çalıştırıldıktan sonra normal olarak TlosLite ın windows servisleri arasında yer alması beklenir. Tlos Lite 1.7.0 Kurulum Klavuzu 7

8- Servisi kullanacak kullanıcı hesabının belirlenmesi: i) Servisler'den Tlos Lite Scheduler servisin uzerinde sağ tık ile özellikler seçilir ii) Logon tabına geçilir, iii) Default olarak Local system account seçilidir, bunun yerine This account seçilir ve buraya servisi çalıştıracak olan (işlerinizi çalıştırma yetkisine sahip) kullanıcı girilir. Burada kullanıcı icin doğru konum (server)seçilmezse kullanıcıyı bulamazsınız. 5.3 Linux işletim sistemlerinde Deamon olarak çalıştırma Aşağıdaki adımlar Fedora Linux için anlatılmıştır. 1) http://forum.likyateknoloji.com/download/file.php?id=3&sid=505e85c7a501e6140d8c74d4b4768a1 3 adresinden run_as_deamon.rar isimli dosyayı indirip tloslite ve tloslite.config isimli dosyalarını çıkartınız. 2) Bu iki dosyayı edit ederek, Tlos Lite uygulama adı, uygulamanın kurulu olduğu dizin, port numarası, IP ve Java nın kurulu olduğu dizin parametrelerini uygun şekilde güncelleyiniz. 3) Root kullanıcısı ile; tloslite dosyasını /etc/rc.d/init.d dizinine tloslite.config dosyasını /etc dizinine kopyalayın. 4) Eğer tloslite and tloslite.config dosyalarını Windows tabanlı bir işletim sisteminden Linux a taşıdıysanız aşağıdaki komutu çalıştırın. dos2unix /etc/rc.d/init.d/tloslite 5) İzin parametrelerini aşağıdaki gibi ayarlayın. chmod +x /etc/rc.d/init.d/tloslite 6) Tlos Lite yazılımını deamon olarak çalıştırmak için chkconfig --add tloslite 7) Tlos Lite ın durumunu kontrol etmek için chkconfig --list örnek bir çıktı şu şekilde olabilir Tlos Lite 1.7.0 Kurulum Klavuzu 8

[likya@patarafedora tloslite$ chkconfig --list grep -i tlos tloslite 0:off 1:off 2:off 3:on 4:off 5:on 6:off 8) Başlatmak, durdurmak, yeniden başlatmak ve statü durumunu almak için /etc/rc.d/init.d/tloslite (start stop restart status) 9) Çalışan Tlos Lite yazılımlarını görmek için ps -ef grep -i tlos Tlos Lite 1.7.0 Kurulum Klavuzu 9

6 Tlos Lite Scheduler dosya ve dizin yapısı Tipik bir dizin yapısında aşağıdaki dosyalar bulunur. Dosya/Dizin /lib /logs encryptpassword.bat job1.bat job2.bat license.tlos license_other_en.rtf license_other_tr.rtf license_tlos_en.rtf license_tlos_tr.rtf senaryobilgileri.xml starttlosserver.bat starttlosserver.sh stopftlos.bat stopftlos.sh stopntlos.bat stopntlos.sh Tlos.authorization TlosConfig.xml TlosEkran.log TlosLite_V1.7.0_bxxx.jar TlosTestJobjar.jar TlosTrace.log Tlos.recover Tlos Lite Scheduler dosya ve dizin yapısı Açıklama Tlos Lite Scheduler ın kullandığı java kütüphaneler İşlere ait log dosyalarının tutulduğu dizin Email raporlarında kullanıcı şifrelerini şifreli olarak saklamak için kullanılır. Örnek işler Lisans anahtarı dosyası. Bu dosya mevcut olmadığında deneme amaçlı olarak kısıtlı sayıda iş çalıştırılabilir. Türkçe ve İngilizce olrak son kullanıcı lisans anlaşmaları Senaryo bilgilerini (bağımlılık, işler ve çalışma zamanları vb) içeren yapılandırma dosyası Tlos Lite Scheduler ı başlatmak için kullanılan dosya. sh uzantılı dosyalar linux ve unix işletim sistemleri içindir. Tlos Lite Scheduler ı hemen kapatmak için kullanılan dosya. sh uzantılı olanlar unix ve linux işletim sistemleri içindir. Tlos Lite Scheduler ı normal olarak kapatmak için kullanılan dosya. sh uzantılı olanlar unix ve linux işletim sistemleri içindir. Kullanıcı adı ve şifrenin tutulduğu dosya Çeşitli program parametrelerinin tanımlı olduğu dosya Tlos Lite Scheduler ekran mesajlarının yazıldığı log dosyası Tlos Lite Scheduler jar dosyası. starttlosserver tarafından çağrılır. Test işi jar dosyası Tlos çalışma log dosyası TlosConfig de ispersistent değeri true ise bu dosya oluşturulur. Tlos Lite Scheduler programı herhangi bir kapatılma ya da kapanma sonrası, kaldığı yerden devam edebilme özelliğine sahiptir. Bu dosya sayesinde son durumu diskten okuyup, kaldığı yerden çalışmaya devam eder. Tablo 1: Tlos Lite dizin yapısı ve dosyalar Tlos Lite 1.7.0 Kurulum Klavuzu 10

Şekil 1: Örnek dosya ve dizin yapısı Tlos Lite 1.7.0 Kurulum Klavuzu 11

7 Tlos Lite Scheduler Programının Başlatılması ve Durdurulması 7.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. 7.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 Kurulum Klavuzu 12

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 2: Log in ekranı Giriş yapıldıktan sonra gelen tipik bir ekran görüntüsü aşağıda verilmektedir. Şekil 3: Tipik bir yönetim ekranı görüntüsü Tlos Lite 1.7.0 Kurulum Klavuzu 13

7.3 Programın Durdurulması 7.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 7.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. 7.3.3 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 7.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 Kurulum Klavuzu 14

8 Tlos Lite yazılımının kaldırılması Tlos Lite yazılımı kaldırılmadan önce çalışan hizmetlerin durdurulması gerekir Eğer yazılım Windows servis olarak tanımlanmış ise kaldırılmadan önce Windows Servis Listesinden çıkarılmalıdır. Çalışan servisler durdurulduktan sonra yazılımın kurulmuş olduğu dizin silinerek kaldırma işlemi tamamlanabilir. Tlos Lite dizini içerisinde tüm yapılandırma ve iş tanımları ve çalışma log dosyaları da yer aldığından ileride ihtiyaç olma ihtimaline karşı gerekiyorsa silme işleminden önce bu dosyaların yedeklerini alınız. Tlos Lite 1.7.0 Kurulum Klavuzu 15

Bütün hakları saklıdır. Likya Bilgi Teknolojileri ve İletişim Hizmetleri Ltd. Şti. Nisan 2013 r00110ig-tr Tlos Lite 1.7.0 Kurulum Klavuzu 16