Page History
Anchor
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!
| Warning |
|---|
| 64 bit için 64 bit setup 32 bit için 32 bit setup indirilmelidir. |
Anchor
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!
| Warning |
|---|
| 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 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.
!DİKKAT!
| Warning |
|---|
| 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. |
Anchor
!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. Anchor
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!
| Warning |
|---|
| 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.
Anchor
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İ!
| Info |
|---|
| 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. |
Anchor
!BİLGİ!
| Info |
|---|
| 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. |
Anchor
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:
Anchor
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 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.
Anchor
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İ!
| Info |
|---|
|
...
|
...
|
Anchor
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!
| Warning |
|---|
| Bağlantı işleminin başarılı bir biçimde sınanması sonrası Application Server (Tomcat), önce stop sonra start edilmelidir. |
...
| Info |
|---|
| 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. |
Anchor
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ırolmalı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.
Anchor
!Bilgi!
| Info |
|---|
| 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. |
Anchor
Bu ayarda ayar da düzgün yapıldıktan sonra http://localhost:8080/logo/Activationadresinden dil seçimi ile Aktivasyon işlemine başlanır ve ekranda gelen yönlendirmelere göre Aktivasyon işlemine devam edilir. !DİKKAT!
| Warning |
|---|
| 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. |
...
| Info |
|---|
| 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 |
Anchor
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!
| Info |
|---|
| 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.
Anchor
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!
| Warning |
|---|
|
...
|
...
|
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. Anchor
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ı 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.
Anchor
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.) Anchor
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.
...