Page History

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.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 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 7 8 indirilir ve kurulur. JDK kurulumu sonrası Program files/Java klasörü içerisinde JDK7 JDK ve Jre7JRE'nin kurulmuş olduğu teyit edilir.

Image Removed
Image Added

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 9 ailesinin en günceli) indirilir. Apache Tomcat uygulama sunucusunu Tomcat'in internet sayfasından (http://tomcat.apache.org/download-7090.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.

Image Added

Next yapılarak bir sonraki adımda değişiklik yapmadan devam edilir.

Image Added

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.

Image Removed Image Added

...

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.

Image Removed Image Added

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:

Image Removed Image Added

Bu Tomcat sunucusunu başlatıp durdurmak için listedeki Service'yi başlatıp durdurmak gerekir. Bu şekilde kurulan Apache Tomcat CTomcat C:\Program Files\Apache Software Foundation\Tomcat 79.0 dizinine 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 79.0 klasörü bulunur ve bu klasördeki Configure Tomcat menü seçeneği seçilir:.

Image RemovedImage Added

Eğer başlangıç menüsünde bu seçenek bulunmuyorsa o zaman Tomcat kurulum dizininde bulunan bin dizinindeki tomcat6wTomcat9w.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:

Image Removed

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.

...

Image Added

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.

Image Removed Image Added

...

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 ve http://localhost:8080 adresi 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 şöyle oluraşağıda belirtilen resim gibidir:

Image Removed Image Added

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:.
Image Removed Image Added

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:.

Image Removed Image Added

Eğer ürün başarıyla kurulursa sayfanın üstündeki uygulama listesine gelir. Kurulan ürün Tomcat dizinindeki webapps dizininde bulunur:.
Image Removed Image Added

...

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 jSAdminSAdmin.jsp olarak adlandırılır.

Açık halde; halde http://localhost:80808090/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 / 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ı;

Image Removed Image Added

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 79.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 işlemi http://localhost:80808090/logo/Activation linki  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.
Image Removed Image Added

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.Image Removed

Image Added

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.
Image Removed

Eğer ayarlar doğru yapıldıysa Javac komutundan aşağıdaki gibi bir yanıt alınmalıdır.Image Removed
Image Added

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.
Image Added

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.

Image Added

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 sonra http://localhost:80808090/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

Image Modified

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.

Image RemovedImage Added

...

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.

Image Removed Image Added

Başarılı bir biçimde yapılan lisanslama sonrası, http://localhost:80808090/logo/smart/sadmin tekrar  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 durumda http://localhost:80808090/logo/LicenseRenewalLicenseRenewal 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.
Image Modified

...

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 olan http://localhost:80808090/logo/smart/adminadmin 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:80808090/logo/smart/run

Burada yer alan kullanıcı adı ve şifresi;admin  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-79\webapps\logo\Config*
"true" olan bütün parametrelerin "false" yapılması, gerekir.

System altında 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 istenirse Status ( http://localhost:80808090/logo/StatusStatus ) ekranından aşağıdaki gibi ilgili ayarlamalar yapılmalıdır.

Image RemovedImage Added  

Web Application Status

Programın içinde olduğu ve yapılmış ayarların takip edilebileceği diğer program alanı; http://localhost:80808090/logo/Status adresidir 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.
Image Removed Image Added
Image Added

j-Platform ürününü daha hızlı kullanabilmek için yapılması gereken başlıca ayarlar ;şunlardır:1-

1. ServerConfig.xml "SKIP_Cahce = False" olmalı.

...

1. (

...

1. Status ekranından yapılır. Xml edit edildikten sonra mutlaka tomcat servisi restart edilmelidir.)

...

2. ConsoleConfig.Xml LogLevel = "ERROR" olmalıdır.

...

1. (

...

1. Status ekranından yapılır. Xml edit edildikten sonra mutlaka tomcat servisi restart edilmelidir.)

...

1. Tomcat\Conf\logging.properties dosyasından Log seviyeleri "WARNING"'e çekilmelidir.

...

1. SQL server'da Mermory\CPU ayarları yapılmalıdır. Bu konuda bir DB admin'den destek alınabilir.

...

1. SQL => Recovery Model "Simple" olmalıdır.

Image RemovedImage Added

Image Added

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.
Image Removed Image Added

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.