Apache Tomcat / J-Guar Setup License Installation Logo Eylül 2014
İçindekiler Apache Tomcat / J-Guar Setup/License Installation... 2 Kurulum Öncesi Dikkat Edilmesi Gereken Noktalar... 2 JDK Kurulumu... 2 Apache Tomcat Kurulumu... 3 Apache Tomcat Ayarları... 5 Tomcat Üzerine EAR Kurulumu... 8 Yükleme Sonrası Yapılacak Ayar ve İşlemler... 12 Lisans Kurulum İşlemleri... 13 Aktivasyon İşlemleri... 13 Lisans Yenileme işlemleri... 20 Debug Opsiyonlarının açılıp /kapatılması... 21 Web Application Status... 22 Versiyon Değişim İşlemleri... 24 1
Apache Tomcat / J-Guar Setup/License Installation Kurulum Öncesi Dikkat Edilmesi Gereken Noktalar Öncelikle aşağıda kurulum esnasında anlatacağımız ve kurulması gereken programlar içerisinden mutlaka sisteminize uygun olanları indiriniz. Yani 32 bit makineler için 32 bit versiyonları 64 bit makineler için 64 bit versiyonlarını kurmanız gerekmektedir. Bu yüzden kuruluma başlamadan önce kurulum yapacağınız bilgisayarın özelliklerini öğreniniz. Kurulum öncesi mutlaka Jguar Sistem İhtiyaçları dökümanını inceleyiniz, kurulum yapacağınız bilgisayarın Jguar sistem ihtiyaçlarını karşıladığından emin olunuz. (http://support.logo.com.tr/index.php/tr/jguar/javadokumanarsivi) Aşağıda kurulumunu bahsedeceğimiz Jdk uygulamasının mutlaka application server (Tomcat in Kurulu olacağı bilgisayar) olarak kullanacağınız bilgisayar üzerine kurmalısınız. Database Server ı ve Application Server ı ayrı Bilgisayarlara kurmanızda bir sakınca yoktur, yalnız uygulama sunucusu olarak kullanacağınız bilgisayarda mutlaka Jdk Kurulu olması gerekmektedir. JDK Kurulumu Oracle internet sitesinden Java SE Development Kit 7 indirilir ve kurulur. Jdk kurulumu sonrası Program files/java klasörü içerisinde Jdk7 ve Jre7 nin kurulmuş olduğu teyit edilir.!dikkat! 64 bit için 64 bit setup 32 bit için 32 bit setup indirilmelidir 2
Apache Tomcat Kurulumu Apache Tomcat uygulama sunucusunda J-Guar ürününü kullanabilmek için öncelikle Apache Tomcat'in desteklenen sürümü (Tomcat 7 ailesinin en günceli) indirilir. Apache Tomcat uygulama sunucusunu Tomcat'in internet sayfasından (http://tomcat.apache.org/download-70.cgi) sayfasından edinebilirsiniz.!dikkat! 64 bit için 64 bit setup 32 bit için 32 bit setup indirilmelidir. Setup çalıştırılarak kuruluma başlanır. Tomcat'in Windows işletim sistemine bir uygulama olarak kurulmasını sağlayan bir sihirbazı açılır. Sihirbaz içerisindeki Configuration bölümünde Tomcat Manager a Login olabilmek için belirlemiz için gerekli olan Username ve Password yazılır. Buradaki Windows Service Name kurulum sonrası windows içersindeki services penceresinde tomcatimizin hangi isimle yer alacağını ifade eder. HTTP/1.1 Connector Port ise kurulum sonrası Jguar uygulamamızı hangi port üzerinden kullanıcığımızı belirlemek için kullanılır. Biz kurulum dökümanımız için 8080 portunu kullanacağız. Ilgili bilgiler doldurulup Next tıklanır.!dikkat! Bu ekranda Default olarak Http: 8080 portu gelir. Bir sunucuya birden fazla tomcat kurmamız gereken durumda yukarıdaki ekran görüntüsünde bulunan Server Shutdown Port ve Ajp Connector portlarında değiştirilmesi gerekemektedir. Bunun sebebi ise iki farklı http porta tomcat kurulumu sonrası port çakışması olabilir ve tomcatiniz çalışmayabilir. 3
Java Virtual Machine ayarları bölümünde tomcat bizden kullancağımız java uygulamasını seçmemizi istiyor. Burada kurulumunu önceki adımlarda yaptığımız Jdk uygulamasını Java uygulamamız olarak seçiyoruz. Next diyerek kurulumu tamamlıyoruz.!dikkat! Bu ekranda Default olarak Jre uygulamasının kataloğu gelir, bunun mutlaka Jdk ile değiştirilmesi gerekmektedir. Bu şekilde kurulan Tomcat uygulama sunucusu bir Windows Service'i olarak kurulur ve Control Panel > Administrative Tools > Services sayfasında listelenir: Bu Tomcat sunucusunu başlatıp durdurmak için listedeki Service'i başlatıp durdurmak gerekir. Bu şekilde kurulan Apache Tomcat C:\Program Files\Apache Software Foundation\Tomcat 7.0 dizinine kurulmuş olur. 4
Apache Tomcat Ayarları Tomcat in kurulumu sonrası gereken bazı ayarlar vardır. Sırası ile bu ayarları şu şekilde gerçekleştirmek gerekir. \Program Files\Apache Software Foundation\Tomcat 7.0\webapps\manager\WEB-INF altındaki web.xml. dosyası edit edilmeli aşağıdaki bölüm içindeki değer >2147483648< ile değiştirip service restart edilmelidir. <multipart-config> <! 2048MB max > <max-file-size>52428800</max-file-size> <max-request-size>52428800</max-request-size> <file-size-threshold>0</file-size-threshold> </multipart-config>!dikkat! Bu dosyayı değiştirdikten sonra kayıt ederken hata alırsanız web.xml dosyasını farklı klasöre kopyalayıp,değişikliği yaptıktan sonra orjinal dosya üzerine yapıştırabilirsiniz. Sihirbaz ile kurulan Tomcat sunucusunun hangi Jvm'i (Java Virtual Machine) kullanacağı bilgisini sihirbaz kurulumu yaparken seçmiştik ve Tomcat o Jvm ile çalışır. Bu yüzden bu şekilde kurulan Tomcat sunucusu için elle bir Jvm ayarlamak gerekmez. Ama bu Tomcat sunucusunda j- guar uygulamasının sorunsuz çalışması için yine JVM hafıza ayarları yapılmalıdır. Bunun için Başlangıç menüsünden Apache Tomcat 7.0 klasörü bulunur ve bu klasördeki Configure Tomcat menü seçeneği seçilir: Eğer başlangıç menüsünde bu seçenek bulunmuyorsa o zaman Tomcat kurulum dizininde bulunan bin dizinindeki tomcat6w.exe dosyası çalıştırılır. 5
Açılan ayarlama uygulamasında Java sayfasına geçilir ve sayfanın altındaki hafıza seçenekleri istenen şekilde ayarlanır: Burada Java Options bölümüne de en alta yukarıdaki resimde işaretle gösterilen değer yazılmalıdır (-XX:PermSize=256m). Bu ayarlar yapıldıktan sonra Tomcat sunucusu çalışır durumda ise tekrar başlatılmalıdır.!bilgi! Bu kısımdaki Initial Memory Pool Windows üzerinde Tomcat için ayıracağınız memory miktarını belirler. Yani biz yukarıda yaptığımız ayar ile bilgisayarımızın 1024 mb lık memory sini Tomcat için ayırmış durumdayız. Bu memory her halükarda (Tomcat çalışmasa bile) tomcat için hazır olarak tutulur ve bu performansa direkt etki eden bir ayardır. Maximum Memory Pool ise tomcat için maximum ne kadar bellek kullancağımızı belirler. 6
Logging tabında Level Error olarak seçilir.!bilgi! Bu kısımdaki Loging Level Default olarak Info olarak gelir, bu ayarı değiştirip Error yapılarak tomcatin log seviyesi düşürülür ve bu ayar direkt performansa etki eden bir ayardır. Bu ayarlar yapıldıktan sonra Tomcat Restart edilir. 7
Tomcat Üzerine EAR Kurulumu Tomcat sunucusunda yukarıdaki bölümlerde anlatılan ayarlar yapıldıktan sonra ear dosyası ile ürün kurulabilir. Tomcat'e ürünü kurmak için öncelikle Tomcat sunucusu açılır ve http://localhost:8080 adresi bir web tarayıcısında açılır. Bu adres açılmıyorsa o zaman ya Tomcat sunucusu düzgün başlatılamamıştır ya da kurulumda bir sıkıntı vardır. Açılan sayfa şöyle olur: 8
Açılan sayfada işaretli yerdeki Tomcat Manager linkine tıklanır. Bu linke tıklanınca yönetici uygulamasına geçiş sırasında bir kullanıcı adı - şifre diyaloğu görüntülenir. Bu diyalogda tomcat kurulumu esnasında belirlemiş olduğumuz kullanıcı adı - şifre değeri (bu dokümandaki örnekte admin - logo) girilir. Kullanıcı adı ve şifre doğrulanırsa Tomcat yönetici konsolu açılır: Yönetici konsolu üzerinde sunucuda kurulu olan uygulamalar listelenir. J-Guar uygulaması kurulu ise bu listed /logo olarak görünür. J-Guar uygulaması istenirse bu listeden başlatılıp, durdurulabilir. Ürün ear'ını Tomcat sunucusuna kurmak için öncelikle ear dosyasının açılması ve içindeki.war dosyasının alınması gerekir. Tomcat uygulama sunucusu direk ear dosyası üzerinden çalışamaz. ear dosyasını açmak için Win Zip ya da Win RAR gibi bir arşiv yönetici program kullanılabilir. Arşiv yöneticisi programla açılan ear dosyasının içindeki.war uzantılı dosya makinada bir yere çıkarılır. 9
Daha sonra Tomcat yönetici konsolu sayfasındaki Deploy bölümünde bulunan WAR file to deploy kısmından bu war dosyası seçilir ve Deploy tuşuna basılır: Eğer ürün başarıyla kurulursa sayfanın üstündeki uygulama listesine gelir. Kurulan ürün Tomcat dizinindeki webapps dizininde bulunur:!bilgi! Tomcat sunucusunun logları Tomcat dizininin altındaki logs dizininde bulunur. Bu dizindeki localhost****.log dosyası sunucudaki uygulamaların (dolayısıyla ürünün de) loglarını içerir.!bilgi! Programda çalışırken alınan "Session Time-out" sorununu gidermek için "...\Tomcat7\conf" dizini altındaki "context.xml" dosyasını açıp Context tagına aşağıda gösterildiği gibi usehttponly="false" değerini eklemek gerekiyor. 10
<Context usehttponly="false"> 11
Yükleme Sonrası Yapılacak Ayar ve İşlemler Yükleme sonrası ilk yapılacak aşama ve işlem Application ile Database arasında bağlantının sağlanacağı program parçasıdır. Program da bu alan jsadmin.jsp olarak adlandırılmaktadır. Açık halde; http://localhost:8080/logo/jsadmin.jsp ya da (http://localhost:8080/logo/smart/sadmin) biçimindedir. Programın bu kısmına girişte, Kullanıcı adı ve şifre; LOGO / LOGO Bu ekrana girildikten sonra yeni bir bağlantı ayarı eklemek için Ekle butonuna basılır ve gerekli bilgiler doldurulup kaydedilir. Kaydetme işlemi tamamlandıktan sonra Sına butonu ile bağlantı testi kontrol edilir. SQL için Örnek bağlantı ekranı ; Not 1: Sunucu adı bölümü SQL Server adınız veya localhost olarak doldurulabilir. Not 2: Bu parametre JDBC bağlantısına alternatif bir parametredir. Bağlantı aracı olarak JTDC sürücüsünü kullanır.!dikkat! Bağlantı işleminin başarılı bir biçimde sınanması sonrası Application Server (Tomcat), önce stop sonra start edilmelidir.!bilgi! Versiyon geçişi yapılmadan önce aşağıdaki katalogdan DbConnection.xml dosyasının yedeği alınıp yükleme sonrası aynı yere kopyalanabilir. Bu sayede versiyon geçisi sonrası yeniden Bağlantı bilgileri sekmesini doldurmak zorunda kalmazsanız. 12
C:\Program Files\Apache Software Foundation\Tomcat 7.0webapps\logo\Config\System Lisans Kurulum İşlemleri Sistem Tablolarını Oluştur/Güncelle işleminden önce Logo tarafından iletilmiş olan Lisans Anahtarları ile aktivasyon işleminin tamamlanmış olması gerekmektedir. (Ürün için yeni versiyonlar baştan yüklenmesi gerektiği için her yükleme sonrası mevcut lisans anahtarı ile aktivasyon yapılması gerekmektedir.) Aktivasyon İşlemleri Aktivasyon işlemi http://localhost:8080/logo/activation linki üzerinden yapılmalıdır. Aktivasyon işleminin sağlıklı bir şekilde tamamlanabilmesi için çalışır bir internet bağlantısına sahip olunması gerekmektedir. Ayrıca Windows üzerinden Ortam Değişkenleri ayarlarından JDK klasörünün Windowsa tanıtılması gerekmektedir. Bunun için Bilgisayarım Sağ Tıklanır ve Özellikler seçilir, Gelişmiş Sistem Ayarları tıklanır. 13
Açılan Ekrandan En alttaki Ortam Değişkenleri seçeneği seçilir. Daha sonra değişkenlerden Path değişkeni seçilip Edit butonuna tıklanır. 14
Karşımıza gelen Edit ekranında Değişken değeri kısmında en sona noktalı virgül koyularak Jdk nın bin klasörü tanımlanır. Tamam seçenekleri seçilerek bahsedilen ekranlardan çıkılır.!bilgi! Yapılan bu ayardan sonra yaptığınız ayarların çalışıp çalışmadığını kontrol edebilirsiniz, Başlat/Çalıştır/Cmd ile Komut sistemine geçiş yapınız. Javac yazarak Enter tuşuna basınız. Size Java Compiler ile ilgili bilgileri getirmesi gerekli, eğer Javac komutuna yanıt alamıyorsunuz, Ortam değişkenlerinden yaptığınız ayarları kontrol ediniz. 15
Eğer ayarlarınız doğru yapıldıysa Javac komutundan aşağıdaki gibi bir yanıt almalısınız. Bu ayarda düzgün yapıldıktan sonra http://localhost:8080/logo/activation adresinden dil seçimi ile Aktivasyon işlemine başlanır ve ekranda gelen yönlendirmelere göre Aktivasyon işlemine devam edilir.!dikkat! Lisanslama işlemi için kullanacağınız adreste büyük küçük harf duyarlılığı vardır, Activation mutlaka büyük A ile yazılmalıdır. 16
!Bilgi! Bu adrese ulaşamadığınız durumlarda aşağıdaki linki deneyiniz, bu link tarayıcınızda bir tick işareti görüntülemeli, eğer bunu görüntüleyemiyorsanız Lisanslama için kullandğımız serverlara erişemiyorsunuz demektir. Bu gibi durumlarda bulunduğunuz ortamdaki güvenlik ayarlarını kontrol ediniz. http://license1.logo.com.tr/logolicenseservice/tick.jpg 17
Logo tarafından iletilen Lisans anahtarı girilir ve işleme devam edilir. 18
Aktivasyon esnasında Bayi kullanıcısı, Bayi parolası ve Kullanıcı parolasına ihtiyaç vardır. Aktivasyon işleminin devam edebilmesi için bu bilgilerin hazırlanmış olması gerekmektedir.!bilgi! Kurulum Sonrası jadmin içerisinde, Grup tanımlarında Administrator grubunun içerisinden eklenen lisans anahtarı gruba seçilmeldir. Aynı şekilde yeni grup eklendikçe bu lisans anahtarı yeni tanımlanan gruba da seçilmelidir. Bütün kurulum işlemlerini tamamladıktan sonra bu ayarları Admin panele girip yapmayı unutmayınız Başarılı bir biçimde yapılan lisanslama sonrası, http://localhost:8080/logo/smart/sadmin tekrar girilip Veritabanı işlemleri altından sırasıyla önce; Sistem tablolarını oluştur /güncelle Sistem tablolarının referans toplama araçlarını oluştur güncelle işlemleri gerçekleştirilmelidir. 19
Lisans Yenileme işlemleri Lisans Yenileme Uyarısı alındığı durumda http://localhost:8080/logo/licenserenewal komutu ile lisans yenileme işlemi yapılmalıdır. Burada yenileme için programda Administrator grubuna dahil bir kullanıcı adı ve şifresi girilmelidir.!dikkat! Lisanslama işlemi için kullanacağınız adreste büyük küçük harf duyarlılığı vardır, LicenseRenewal mutlaka büyük L ve büyük R ile yazılmalıdır.!dikkat! Lisans yenileme sonrası Sistem tablolarını oluştur /güncelle, Sistem tablolarının referans toplama araçlarını oluştur güncelle işlemlerini yapmanıza gerek yoktur. Genel Kontroller Program files/java Klasörüne Jdk Ve Jre nin kurulmuş olduğundan emin olunuz, Tomcat inizin Memory,Java Options ayarlarının doğru yapıldığından emin olun, Tomcat inizin Java Virtual Machine olarak JDK kataloğunu gördüğünden emin olunuz, Logging Tabından Level ın Error olduğunu kontrol ediniz. Başlat/Çalıştır/Cmd den Javac yazarak Java Compiler çalıştığını teyit ediniz, Tarayıcınızdan http://localhost:8080 yazdığınız zaman Tomcat Manager ekranına ulaşabildiğinizden emin olunuz. Eğer manager ekranında yaptığınız deploy işlemi başarılı ise C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps kataloğunda logo klasörü olmalı.kontrol ediniz, Bu işlemin sonrasında Kurum, yetki ve diğer sistem ayarlarının yapılacağı program bölümü olan http://localhost:8080/logo/smart/admin adresine girilmelidir. 20
Burada yer alan kullanıcı adı ve şifresi; admin / logo Gerekli Kurum, yetki vb. Tanımlar yapıldıktan sonra programa giriş için; http://localhost:8080/logo/smart/run Burada yer alan kullanıcı adı ve şifresi; admin / logo Debug Opsiyonlarının açılıp /kapatılması Debug opsiyonları programın yüklenmesi ile birlikte öndeğer olarak açık biçimde gelecektir. Bu opsiyonun kalıcı olarak kapatılması için;...\apachetomcat-7\webapps\logo\config\ System altında yer alan "Debug.xml" dosyası edit edilip, true olan bütün parametrelerin false yapılması, ayrıca log lama seviyesinin de 7 yerine boş bırakılması gerekir. Geçici olarak düzenlenmek istenirse Status ( http://localhost:8080/logo/status ) ekranından aşağıdaki gibi ilgili ayarlamalar yapılmalıdır. 21
Web Application Status Programın içinde olduğu ve yapılmış ayarları takip edebileceğiniz diğer program alanı; http://localhost:8080/logo/status adresidir. Buradan Application Info, Debug Options, Server and Client Variables, Form BuildOptions (kullanılması gerekli değil), Sessions durumları takip edilebilir. Debug Options üzerinde yapılacak herhangi bir ayar bir sonraki, Application Server servisinin stop start aşamasına kadar geçerlidir. Ardından ilk haline döner. * jguar ürününü daha hızlı kullanabilmek için yapılması gereken başlıca ayarlar; 1- ServerConfig.xml "SKIP_Cahce = False" olmalı. (Status ekranından yapılır. Xml edit edildikten sonra mutlaka tomcat servisi restart edilmelidir.) 2- ConsoleConfig.Xml LogLevel = "ERROR" olmalıdır. (Status ekranından yapılır. Xml edit edildikten sonra mutlaka tomcat servisi restart edilmelidir.) 22
3- Tomcat\Conf\logging.properties dosyasından Log seviyeleri "WARNING" e çekilmeli. 4- SQL server da Mermory\CPU ayarları yapılmalıdır. Bu konuda bir DB admin'den destek alınabilir. 5- SQL => Recovery Model "Simple" olmalıdır 23
Versiyon Değişim İşlemleri DBConnection.xml dosyasının yedeğini alınız. Tomcat manager ekranında kullanmakta olduğunuz seti Undeploy etmeden önce, Bütün Jguar kullanıcılarının Log off olduklarından emin olunuz, gerekirse Tomcati restart ettikten sonra undeploy işlemi yapınız. Yeni seti yukarıda anlatıldığı şekilde yeniden Deploy ediniz. Deploy sonrası yedeğini aldığınız DBConnection.xml dosyasını katoloğuna geri kopyalayınız. DBConnection.xml I geri kopyaldığımız için yeniden bağlantı bilgileri sekmesinden ayar yapmamıza gerek yok. Fakat yeni bir set deploy ettiğimiz için Yeniden Lisanslama yapmamız gerekir. Yukarıda anlatıldığı şekilde Activation yapılır. Lisanslama sonrası Sadmin e bağlanarak, Sistem tablolarını oluştur ve güncelle işlemi çalıştırılır. Admin panele bağlanılarak kullandığımız kurum üzerine sağ tıklanır. Ve Tabloları Sürüme Göre Güncelle çalıştırılır. Bu işlem adımları sonrası yeni setinizle programa yeniden login olabilirsiniz. 24