j-Platform kurulumu hakkında ayrıntılı bilgiye bu dokümandan ulaşılır.
Apache Tomcat / j-Platform 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.
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
64 bit için 64 bit setup 32 bit için 32 bit setup indirilmelidir.
Oracle internet sitesinden Java SE Development Kit 8 indirilir ve kurulur. JDK kurulumu sonrası Program files/Java klasörü içerisinde JDK ve JRE'nin kurulmuş olduğu teyit edilir.
Apache Tomcat Kurulumu
Apache Tomcat uygulama sunucusunda j-Platform ürününü kullanabilmek için öncelikle Apache Tomcat'in desteklenen sürümü (Tomcat 9 ailesinin en günceli) indirilir. Apache Tomcat uygulama sunucusunu Tomcat'in internet sayfasından (http://tomcat.apache.org/download-90.cgi) sayfasından edinilebilir. 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.
Next yapılarak bir sonraki adımda değişiklik yapmadan devam edilir.
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çerisindeki 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.
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.
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 9.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 9.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>.
- 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 9.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 Tomcat9w.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.
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ükârda (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.
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:8090 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 aşağıda belirtilen resim gibidir:
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.
Tomcat sunucusunun logları Tomcat dizininin altındaki logs dizininde bulunur. Logs dizinindeki localhost****.log dosyası sunucudaki uygulamaların (dolayısıyla ürünün de) loglarını içerir.
Programda çalışırken alınan "Session Time-out" sorununu gidermek için ".......\Tomcat9\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 SAdmin.jsp olarak adlandırılır.
Açık halde http://localhost:8090/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ı;
Sunucu adı bölümü "SQL Server adı veya localhost" olarak doldurulabilir.
Bu parametre JDBC bağlantısına alternatif bir parametredir. Bağlantı aracı olarak JTDC sürücüsünü kullanır.
Bağlantı işleminin başarılı bir biçimde sınanması sonrası Application Server (Tomcat), önce stop sonra start edilmelidir.
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.
C:\Program Files\Apache Software Foundation\Tomcat 9.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:8090/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ı olmalı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.
Tanımlanan java sürümünün düzgün çalışıp çalışmadığını anlamak için cmd ekranında java.exe -version komutu çalıştırılarak kontrol sağlanabilir. 
Doğru java versiyonu gelmiyorsa ortam değişkenlerinde Java.exe bin klasörü path bölümünde gösterilmeli ve tekrardan java versiyonu kontrol edilmelidir.Java 64 bit yüklendikten sonra tomcat tarafında yapılması gereken ayarlar aşağıdaki gibidir.
Java sekmesinde Java Virtual Machine kısmında ilgili sürüme ait jvm.dll seçilmesi gerekmektedir. Bu ayar da düzgün yapıldıktan sonra http://localhost:8090/logo/Activationadresinden dil seçimi ile Aktivasyon işlemine başlanır ve ekranda gelen yönlendirmelere göre Aktivasyon işlemine devam edilir.
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.
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.
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:8090/logo/smart/sadmin tekrar girilip "Veritabanı işlemleri" altından sırasıyla önce sistem tablolarını oluştur/güncelle ve lisans yenileme işlemleri gerçekleştirilir.
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:8090/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.
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.
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:8090 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 9.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:8090/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:8090/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-9\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ı gerekir.
Geçici olarak düzenlenmek istenirse Status ( http://localhost:8090/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:8090/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 şunlardır:
- ServerConfig.xml "SKIP_Cahce = False" olmalı.(Status ekranından yapılır. Xml edit edildikten sonra mutlaka tomcat servisi restart edilmelidir.)
- ConsoleConfig.Xml LogLevel = "ERROR" olmalıdır.(Status ekranından yapılır. Xml edit edildikten sonra mutlaka tomcat servisi restart edilmelidir.)
- Tomcat\Conf\logging.properties dosyasından Log seviyeleri "WARNING"'e çekilmelidir.
- SQL server'da Mermory\CPU ayarları yapılmalıdır. Bu konuda bir DB admin'den destek alınabilir.
- 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.