Apache Tomcat / J-Guar Setup/License Installation
Kurulum Öncesi Dikkat Edilmesi Gereken Noktalar
Öncelikle aşağıda kurulum esnasında anlatılacak ve kurulması gereken programlar içerisinden mutlaka kullanıcı sistemine uygun olanlar indirilmelidir. Yani 32 bit makineler için 32 bit versiyonları 64 bit makineler için 64 bit versiyonları kurulmalıdır. Bu yüzden kuruluma başlamadan önce kurulum yapılacak bilgisayarın özellikleri öğrenilmelidir.
Kurulum öncesi mutlaka j-Platform Sistem İhtiyaçları dokümanı incelenmelidir, kurulum yapılacak bilgisayarın j-Platform sistem ihtiyaçlarını karşıladığından emin olunmalıdır
(http://support.logo.com.tr/index.php/tr/j-Platform/javadokumanarsivi)
Aşağıda kurulumundan bahsedilecek JDK uygulaması mutlaka application server (Tomcat'in Kurulu olacağı bilgisayar) olarak kullanılacak bilgisayar üzerine kurulmalıdır. Database Server ve Application Server'in ayrı Bilgisayarlara kurulmasında bir sakınca yoktur, yalnız uygulama sunucusu olarak kullanılacak bilgisayarda mutlaka JDK Kurulu olmalıdır.
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.
!DİKKAT! 64 bit için 64 bit setup 32 bit için 32 bit setup indirilmelidir.
Apache Tomcat Kurulumu
Apache Tomcat uygulama sunucusunda j-Platform ü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 edinilebilir.
!DİKKAT! 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 gerekli olan Username ve Password yazılır. Buradaki Windows Service Name, kurulum sonrası windows içersindeki services penceresinde tomcatin hangi isimle yer alacağını ifade eder.
HTTP/1.1 Connector Port ise kurulum sonrası j-Platform uygulamasının hangi port üzerinden kullanılacağını belirlemek için kullanılır. Örnek olarak kurulum dokümanı için 8080 portu kullanılacaktır. İlgili bilgiler doldurulup Next tıklanır.
!DİKKAT! Bu ekranda öndeğer olarak Http: 8080 portu gelir. Bir sunucuya birden fazla tomcat kurulması gereken durumda yukarıdaki ekran görüntüsünde bulunan Server Shutdown Port ve Ajp Connector portlarında değiştirilmesi gerekir. Bunun sebebi ise iki farklı http porta tomcat kurulumu sonrası port çakışması olabilir ve tomcat çalışmayabilir.
Java Virtual Machine ayarları bölümünde tomcat, kullanılacak java uygulamasının seçilmesini ister. Burada kurulumunun önceki adımlarda yapıldığı JDK uygulaması Java uygulaması olarak seçilir. Next diyerek kurulum tamamlanır.
!DİKKAT! Bu ekranda öndeğer olarak Jre uygulamasının kataloğu gelir, bunun mutlaka JDK ile değiştirilmesi gerekir.
Bu şekilde kurulan Tomcat uygulama sunucusu bir Windows Service'si olarak kurulur ve Control Panel>Administrative Tools>Services sayfasında listelenir:
Bu Tomcat sunucusunu başlatıp durdurmak için listedeki Service'yi başlatıp durdurmak gerekir. Bu şekilde kurulan Apache Tomcat C:\Program Files\Apache Software Foundation\Tomcat 7.0 dizinine kurulmuş olur.
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>
!DİKKAT! Bu dosyayı değiştirdikten sonra kaydederken hata alınırsa web.xml dosyası farklı klasöre kopyalanıp, değişikliği yaptıktan sonra orijinal dosya üzerine yapıştırılmalıdır.
Sihirbaz ile kurulan Tomcat sunucusunun hangi Jvm'i (Java Virtual Machine) kullanacağı bilgisi sihirbaz kurulumu yaparken seçilmişti 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-Platform 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.
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.
!BİLGİ! Bu kısımdaki Initial Memory Pool Windows üzerinde Tomcat için ayrılacak memory miktarını belirler. Yani yukarıda yapılan ayar ile bilgisayarın 1024 MB.'lik hafızası Tomcat için ayrıldı. 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 kullanılacağını belirler.
Logging sekmesinde Level Error olarak seçilir.
!BİLGİ! Bu kısımdaki Loging Level öndeğer olarak Info olarak gelir, bu ayar değiştirilip 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.
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:
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-Platform uygulaması kurulu ise bu listede /logo olarak görünür. j-Platform 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.
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:
!BİLGİ! 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.
!BİLGİ! Programda çalışırken alınan "Session Time-out" sorununu gidermek için ".......\Tomcat7\conf" dizini altındaki "context.xml" dosyasını açıp değerini eklemek gerekiyor. Context tagına aşağıda gösterildiği gibi useHttpOnly="false"
<Context useHttpOnly="false">
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ılı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ı 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çişi sonrası yeniden Bağlantı bilgileri sekmesi doldurulmak zorunda kalınmaz.
J-Guar
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şlemi tamamlanmış olmalıdır. (Ü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ı gerekir.)
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ı olmaıdır. Ayrıca Windows üzerinden Ortam Değişkenleri ayarlarından JDK klasörünün Windows'a tanıtılması gerekir.
Bunun için
Bilgisayarım Sağ Tıklanır ve Özellikler seçilir, Gelişmiş Sistem Ayarları tıklanır.
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.
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 ayarların çalışıp çalışmadığı kontrol edilebilir, Başlat/Çalıştır/Cmd ile Komut sistemine geçiş yapılır. Javac yazarak Enter tuşuna basılır. Java Compiler ile ilgili bilgilerin getirmesi gereklidir, eğer Javac komutuna yanıt alınamıyorsa, Ortam değişkenlerinden yapılan ayarlar kontrol edilir.
Eğer ayarlar doğru yapıldıysa Javac komutundan aşağıdaki gibi bir yanıt alınmalıdır.
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.
!DİKKAT! Lisanslama işlemi için kullanılacak adreste büyük küçük harf duyarlılığı vardır, Activation mutlaka büyük A ile yazılmalıdır.
!Bilgi! Bu adrese ulaşılamayan durumlarda aşağıdaki linki deneyiniz, bu link tarayıcınızda bir onay işareti (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
Logo tarafından iletilen Lisans anahtarı girilir ve işleme devam edilir.
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ı gerekir.
!Bilgi! Kurulum Sonrası jAdmin içerisinde, Grup tanımlarında Administrator grubunun içerisinden eklenen lisans anahtarı gruba seçilmelidir. 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 yapılmalıdır.
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.
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.
!DİKKAT! Lisanslama işlemi için kullanılacak 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şlemlerinin yapılmasına gerek yoktur.
Genel Kontroller
- Program files/Java Klasörüne JDK ve Jre'nin kurulmuş olduğundan emin olunmalıdır,
- Tomcat'in Memory, Java Options ayarlarının doğru yapıldığından emin olunmalıdır,
- Tomcat'in Java Virtual Machine olarak JDK kataloğunu gördüğünden emin olunmalıdır,
- Logging Tabından Level'ın Error olduğu kontrol edilmelidir.
- Başlat/Çalıştır/Cmd'den Javac yazarak Java Compiler çalıştığı teyit edilmelidir,
- Tarayıcıdan http://localhost:8080 yazıldığı zaman Tomcat Manager ekranına ulaşıldığından emin olunmalıdır.
- Eğer manager ekranında yapılan deploy işlemi başarılı ise C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps kataloğunda logo klasörü olmalıdır.
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.
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 öndeğer olarak açık biçimde gelir. Bu opsiyonun kalıcı olarak kapatılması için;
*.......\ApacheTomcat-7\webapps\logo\Config*
"true" olan bütün parametrelerin "false" yapılması, gerekir.
System altında yer alan "Debug.xml" dosyası edit edilip, ayrıca log'lama seviyesinin de 7 yerine boş bırakılması
Geçici olarak düzenlenmek istenirse Status ( http://localhost:8080/logo/Status ) ekranından aşağıdaki gibi ilgili ayarlamalar yapılmalıdır.
Web Application Status
Programın içinde olduğu ve yapılmış ayarların takip edilebileceği 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.
- j-Platform ü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.)
3- Tomcat\Conf\logging.properties dosyasından Log seviyeleri "WARNING"'e çekilmelidir.
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.
Versiyon Değişim İşlemleri
- DBConnection.xml dosyasının yedeği alınır.
- Tomcat manager ekranında kullanılan seti Undeploy etmeden önce, Bütün j-Platform kullanıcılarının Log off olduklarından emin olarak, gerekirse Tomcati restart ettikten sonra undeploy işlemi yapılır.
- Yeni set yukarıda anlatıldığı şekilde yeniden Deploy edilir.
- Deploy sonrası yedeği alıan DBConnection.xml dosyası kataloğuna geri kopyalanır.
- DBConnection.xml I geri kopyalandığı için yeniden bağlantı bilgileri sekmesinden ayar yapmaya gerek yok. Fakat yeni bir set deploy edildiği için Yeniden Lisanslama yapılmalıdır.
- 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 kullanılan 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 setle programa yeniden login olunabilir.