Tekir 2.0 MS Windows Kurulum Kılavuzu

 

Bu belge artık geçerliliğini yitirmiştir. Yalnızca arşiv amaçlı sunulmaktadır.

Özgür Yazılım A.Ş.

www.tekir.com.tr

www.ozguryazilim.com.tr

 TKB-1.0

İçindekiler

Bölüm 1. Sunuş

Bölüm 2. Ön Gereksinimler

1. Windows Sürümleri

2. JDK (Java Development Kit)

3. MySQL Kurulumu

4. JBoss AS 4.2.3.GA Kurulumu

Bölüm 3. Tekir Kurulumu

1. Tekir 2.0 Kurulum Paketi

2. Veri Tabanı Oluşturma

3. Veri Tabanı Bağlantı Bilgilerini Düzenleme

4. E-Posta Sunucu Ayarları

5. Tekir Ayarları

6. Tekir’in JBoss’a yüklenmesi

Bölüm 4. Tekir’in Çalışması

1. JBoss AS’nin Çalıştırılması

1.1. JBoss Windows Servisi

Bölüm 5. Uygulamanın Sistemden Kaldırılması

Ek A. Gerçek Çalışma Ortamında Java Uygulama Sunucuları

Ek B. Geri Bildirim

Ek C. Markalar

Bölüm 1. Sunuş   

Tekir Ticari Otomasyon uygulaması Özgür Yazılım A.Ş. tarafından geliştirilen açık kaynak kodlu özgür bir yazılımdır. LGPL ile dağıtılmaktadır.

Sunucu ortamı olarak Java EE 5 standartlarına uyularak geliştirilmiş olup Java EE 5 uyumlu uygulama sunucular ve bu sunucuların üzerinde koştuğu farklı işletim sistemlerinde çalışabilmektedir. İstemci tarafında ise web standartlarına uyularak geliştirme yapıldığından tarayıcı bağımsız olarak çalışabilmektedir.

Tekir, farklı işletim sistemleri, uygulama sunucuları, veri tabanları ve tarayıcılar ile çalışabilmesine rağmen Özgür Yazılım A.Ş. olarak özgür yazılım ürünleri tercih etmekte ve kullanıcılarımıza önermekteyiz.

Bölüm 2. Ön Gereksinimler   

Tekir 2.0’ın çalışabilmesi için Java JDK, uygulama sunucusu, veri tabanı gibi bazı ön gereksinimler bulunmaktadır. Bu doküman kapsamında bu ihtiyaç duyulan ortamların kurulumu hakkında detaya girilmeden bahsedilecektir. Bu gereksinim duyulan yazılımların daha detaylı kurulumları için kendi kurulum dökümanlarına bakmanızı tavsiye ederiz.

Bu kurulum dokümanında bir alt küme olarak tamamı özgür yazılım ürünü olan aşağıdaki ürünler kullanılacaktır.

  • Java JDK : Sun-JDK (Sun/Oracle)
  • Veri tabanı : MySQL (Oracle)
  • Uygulama Sunucu : JBoss AS 4.2.3.GA (RedHat)

Not: Bu doküman içinde bahsi geçen ürünlerin sisteminize varsayılan halleri ile kurulumundan bahsedilecektir. En performanslı ve güvenilir şekilde çalışmaları için kendi dokümanlarını mutlaka incelemenizi tavsiye ederiz.

1. Windows Sürümleri   

Microsoft Windows’un farklı sürümlerinde farklı kurulum stratejileri gerkebilmektedir. Özellikle Windows 7 64bit sürümünde kurulum klasörlerinde isimlendirme farkı vardır. 64bit uygulamalar C:\Program Files altına yüklenirken 32bit uygulamalar C:\Program Files (x86) altına konmaktadır.

Eğer Windows 7 64bit kullanıyorsanız JDK ve MySQL’in 64bit sürümlerini kurmayı tercih ediniz.

2. JDK (Java Development Kit)   

Tekir Java teknolojileri ile geliştirilmiş bir uygulamadır. Bu nedenle sisteminizde java 5 ya da üzerinin yüklü olması gerekmektedir. Java iki farklı paket olarak dağıtılmaktadır. Normal şartlarda JRE( Java Run Time ) paketinin sisteminizde yüklü olması muhtemeldir. Tekir’in çalışabilmesi için ise JDK(Java development Kit) gerekmektedir.

Adımlar
  1. Java JDK kurulum paketini http://www.oracle.com adresinden indirin
    Eğer Windows 7 64bit kullanıyorsanız Java JDK’nın 64bit sürümünü indiiriniz.
  2. İndirdiğiniz kurulum uygulamasındaki yönergeleri takip ederek kurulumu yapınız

3. MySQL Kurulumu   

Tekir çalışabilmek için bir veri tabanına ihtiyaç duymaktadır. Bu adımda MySQL’in kurulumu anlatılacaktır.

Adımlar
  1. MySQL’in kurulum paketini http://mysql.com adresinden indirin
    Windows 7 64bit kullanıcısı iseniz MySQL’in 64bit sürümünü indirmeyi tercih ediniz.
  2. İndirilen kurulum paketindeki yönergeleri izleyerek MySQL veri tabanı kurulumunu yapın.

4. JBoss AS 4.2.3.GA Kurulumu

Tekir 2.0 JBoss 4.2.3 sürümü ile test edilmiştir. Tekir’in en son sürüm olan JBoss AS 6 ile çalışma testleri devam etmektedir.

Adımlar

  1. JBoss AS 4.2.3.GA sürümünü indirin

    JBoss AS paketini http://sourceforge.net/projects/jboss/files/JBoss/JBoss-4.2.3.GA/ adresinden indirin.

  2. İndirdiğiniz paketi istediğiniz bir yerde açın

    JBoss paketi sadece zip arşivi olarak bulunmaktadır. İstediğiniz bir klasör içerisine açınız. İstediğiniz her hangi bir unzip aracını kullanacağınız gibi java jar komutunu da kullanabilirsiniz.

    jar -xvf jboss-4.2.3.GA.zip
  3. Açtığınız dosyaları sisteminizde dilediğiniz bir yere kopyalayın

    Bu kurulum dokümanı içerisinde C:\Jboss altına kopyaladığınız varsayılacaktır

İlgili bilgiler

‣ Daha detaylı kurulum bilgisi için lütfen JBoss Kurulum dokümanlarına bakınız.

Bölüm 3. Tekir Kurulumu   

Tekir 2.0 kurulumu için Java JDK, Uygulama sunucusu ve ver tabanı kurulumu yapılmış olmalıdır.

1. Tekir 2.0 Kurulum Paketi   

Tekir 2.0 kurulum paketi bir zip arşividir. Bu arşivi indirdikten sonra istediğiniz bir yerde açabilirsiniz. Ardından sisteminiz ile ilgili basit bazı ayarlamaları yaparak kurulumunuz tamamlanacaktır.

Arşiv İçeriği

Tekir 2.0 Kurulum Paketi şu dosyaları içermektedir.

|-- 2.0.0.0_release_notes.txt                     
|-- jboss_service                                 
|-- jboss_service_x64                             
|-- lib                                           
|   `-- mysql.jar                                 
|-- resources                                     
|-- tekir                                         
|   |-- sablonlar                                 
|   |-- tekir-ds.xml
|   |-- tekir-mail-service.xml
|   |-- tekir.ear
|   |-- tekir.properties
|   `-- tekir.sql
|-- windows-kurulum.html
`-- windows-kurulum.pdf
Dosya Adı Açıklama
tekir.ear Tekir uygulama paketi
tekir-ds.xml Veri tabanı bağlantı bilgileri dosyası
tekir-mail-service.xml e-posta sunucusu bilgileri dosyası
tekir.properties Ayar bilgileri dosyası
sablonlar Basılı evraklar için şablon dosyaları
jboss_service 32bit Windows’lar için servis yazılımı
jboss_service_x64 64bit Windows’lar için servis yazılımı
mysql.jar MySQL için JDBC sürücüsü

2. Veri Tabanı Oluşturma   

Tekir’in çalışması için önceden veri tabanının oluşturulması, tablo ve varsayılan verilerin yüklenmesi gerekmektedir. Tekir varsayılan veri tabanı olarak MySQL üzerinde tekir isimli bir veri tabanı oluşturacaktır.

Başlamadan önce

Adımlar

  1. Veri tabanını oluşturunTekir varsayılan olarak tekir isimli veri tabanını kullanmaktadır.Bu ismi değiştirebilirsiniz fakat böyle bir değişiklik yapıldığında ayar dosyalarında gerekli güncellemelerin yapıldığından emin olunuz.

    Veri tabanını ve tabloları dilediğiniz bir veri tabanı erişim aracıyla yapabilirsiniz. Bu doküman içerisinde komut satırı üzerinden kurulum anlatılmıştır.

    Not: Eğer daha önce komut satırı kullanmadıysanız, çalıştır menüsünden cmd komutunu çalıştırmanız yeterlidir.

     :\mysql -u root -p

    Komutu ile mysql konsolunu açın.

     mysql> create database tekir collate utf8_turkish_ci;

    Komutu ile veri tabanını oluşturun

     mysql>exit;

    Komutu ile mysql konsolundan çıkabilirsiniz.

  2. Tabloları ve varsayılan verileri oluşturun

    Oluşturulacak tablolar ve içerikleri tekir kurulum paketi içerisinde tekir.sql dosyası içerisinde bulunmaktadır.

    Not:Eğer veri tabanı oluştururken tekir‘den farklı bir isim kullandıysanız -p‘den sonra o ismi giriniz.

    mysql -u root -p tekir < tekir.sql

3. Veri Tabanı Bağlantı Bilgilerini Düzenleme   

Veri tabanı bağlatısı için gereken bilgiler tekir-ds.xml içinde bulunmaktadır. Veri tabanını oluşturduktan sonra buradaki bilgilerin düzenlenmesi gerekmektedir.

Dosya içeriği şu şekildedir :

<datasources>
   <local-tx-datasource>
      <jndi-name>tekirDatasource</jndi-name>
      <connection-url>jdbc:mysql://localhost:3306/tekir?characterEncoding=UTF-8</connection-url>
      <driver-class>com.mysql.jdbc.Driver</driver-class>
      <user-name>root</user-name>
      <password></password>
      
      <exception-sorter-class-name>
         org.jboss.resource.adapter.jdbc.vendor.MySQLExceptionSorter
      </exception-sorter-class-name>
      <metadata>
         <type-mapping>mySQL</type-mapping>
      </metadata>
   </local-tx-datasource>
</datasources>
Adımlar
  • Bağlantı Bilgisi

    connection-url kısmında Tekir’in veri tabanına bağlanması için gereken bilgiler bulunur. Veri tabanı adını değiştirdiyseniz burada gerekli güncellmeyi yapmalısınız.

    Not: En sonda bulunan ?characterEncoding=UTF-8 bilgisini değiştirmeyiniz. Aksi halde MySQL veri tabanı Türkçe karakter desteğinde sorun yaşanacaktır.

  • Kullanıcı Bilgisi

    Eğer veri tabanında root dışında bir kullanıcı oluşturduysanız ya da root kullanıcısının bir paralosı varsa, bağlantı için bu bilgileri user-name ve password alanlarında düzelmeniz gerekmektedir.

    Not: Farklı bir kullanıcı tanımlamanız ve root kullanıcısına bir parola vermeniz tavsiye edilir.

İlgili bilgiler

‣ Kullanıcı tanımlama için detaylı bilgi için MySQL dokümanlarına bakabilirsiniz

4. E-Posta Sunucu Ayarları   

Tekir’in e-posta gönderileri için e-posta sunucu ayarlarının düzenlenmesi gerekmektedir. Bu bilgiler tekir-mail-service.xml dosyasında bulunmaktadır.

 <mbean code="org.jboss.mail.MailService"
         name="jboss:service=TekirMail">
    <attribute name="JNDIName">java:/TekirMail</attribute>
    <attribute name="User">nobody</attribute>
    <attribute name="Password">password</attribute>
    <attribute name="Configuration">
      <!-- A test configuration -->
      <configuration>
        <!-- Change to your mail server prototocol -->
        <property name="mail.store.protocol" value="pop3"/>
        <property name="mail.transport.protocol" value="smtp"/>

        <!-- Change to the user who will receive mail  -->
        <property name="mail.user" value="sunucu@alanadi.com.tr"/>

        <!-- Change to the mail server  -->
        <property name="mail.pop3.host" value="mail.alanadi.com.tr"/>

        <!-- Change to the SMTP gateway server -->
        <property name="mail.smtp.host" value="mail.alanadi.com.tr"/>
        
        <!-- The mail server port -->
        <property name="mail.smtp.port" value="25"/>
        
        <!-- Change to the address mail will be from  -->
        <property name="mail.from" value="sunucu@alanadi.com.tr"/>

        <!-- Enable debugging output from the javamail classes -->
        <property name="mail.debug" value="false"/>
      </configuration>
    </attribute>
    <depends>jboss:service=Naming</depends>
  </mbean>

Tekir 2.0 gelen e-posta denetimi yapmamaktadır. Dolayısı ile düzenlenmesi gereken bilgiler e-posta gönderimine ait bilgilerdir.

Alan Açıklama
User e-posta sunucusuna bağlanmak için gereken kullanıcı adı
Password e-posta sunucusuna bağlanmak için gereken parola
mail.smtp.host bağlanılacak e-posta sunucusu
mail.smtp.port bağlanılacak e-posta sunucu portu

5. Tekir Ayarları   

Tekir 2.0 ayarları tekir.properties dosyası içerisinde bulunur. Bu ayarlar sayesinde firma logonuzun kullanımı, baskı şablonlarının yolu gibi uygulamayı kendiniz için özelleştirebilirsiniz.

Marka Ayarları
# uygulama basliginda kullanilacak logo png 64x64pix
branding.logo.file=C:\\tekir\\sablonlar\\logo.png

# uygulama basligi
branding.title=Tekir Otomasyon 2.0

# rapor sablonlarinda kullanilacak logo gif 128x64pix
report.logo.file=C:\\tekir\\sablonlar\\logo2.gif

# rapor ciktilarinda kullanilacak on ek
report.prefix=Tekir
Özellik Açıklama
branding.logo.file Tekir içerisinde sol üst köşede çıkacak olan logo imaj dosyasının yolu. Bu imaj 64×64 pixel bir png, jpg ya da gif olabilir.
branding.title Tekir içerisinde üst kısımda çıkacak olan uygulama ismi. Bu metni istediğiniz gibi düzenleye bilirsiniz.
report.logo.file Raporlar içerisinde kullanılacak olan logo imaj dosyasının yolu. Bu imaj 128×64 pixel bir gif olabilir.
report.prefix Rapor çıktılarında kullanılacak ön ek. Bu metni istediğiniz gibi değiştirebilirisiniz.
Dosya Yolları
 # ft,irs,mutabakat vb. rapor sablonlarinin sistemde bulunacagi yol
folder.templates=C:\\tekir\\sablonlar
#yuklencek dosyalarin yolu
file.folder=C:\\tekir\\dosyalar
Özellik Açıklama
folder.templates Fatura, irsaliye gibi matbuu form tasarımlarının bulunduğu klasör. Bu klasör içerisindeki dosyaları kurum ihtiyaçlarınız doğrultusunda güncelleyerek, istenilen form tasarımları yapılabilir.
file.folder Tekir içerisinde bulunan basit doküman yönetimi içinden yüklenen dosyaların saklanacağı klasör.

Not Bu klasör uygulama tarafından erişilip yazma hakları olan bir klasör olmalıdır.
Not Bu klasörün içeriginin yedek alma sistemine dahil edilmesi gerekir.

6. Tekir’in JBoss’a yüklenmesi Önceki Üst başlık Alt Sonraki

Tekir 2.0’ın JBoss’a yüklenme işlemi bir dizi dosyanın JBoss üzerindeki gerekli yerlere kopyalanmasından ibarettir. Aşağıdaki yönergelerde JBoss klasörü {JBOSS_HOME} olarak gösterilecektir. Bu bilgiyi JBoss’un sisteminizde kurulu olduğu yolla değiştirmelisiniz.

Adımlar
  1. Tekir EAR dosyasını kopyalayın 
    >copy tekir.ear {JBOSS_HOME}\server\default\deploy\
  2. Veri tabanı bağlantı bilgisini kopyalayın 
    >copy tekir-ds.xml {JBOSS_HOME}\server\default\deploy
  3. E-posta bağlantı bilgisini kopyalayın 
    >copy tekir-mail-service.xml {JBOSS_HOME}\server\default\deploy
  4. Tekir ayar dosyasını kopyalayın 
    >copy tekir.properties {JBOSS_HOME}\server\default\conf
  5. MySQL JDBC sürücünü kopyalayın 
    >copy mysql.jar {JBOSS_HOME}\server\default\lib
  6. Baskı şablonları ve yüklenecek olan dosyaların için klasörleri hazırlayın
    tekir.properties dosyası içerisinde belirttiğiniz şablon ve saklanacak dosyalar için sistemde mevcut klasörler yoksa bunları hazırlamalısınız. Bu klasörler için varsayılan yollar olarak C:\tekir seçilmiştir.
    >mkdir C:\tekir
>mkdir C:\tekir\dosyalar

    Not: Yüklenecek olan dosyalar için sunucunun çalıştığı kullanıcının yazma yetkileri olması gerekmektedir.

  • Baskı şablonları ve logo imajlarını kopyalayın
    tekir.properties dosyasında şablon ve imaj yolu olarak belirttiğiniz klasör içerisine baskı şablonları ve logo imajlarını kopyalayın. Varsayılan yol C:\tekir\sablonlar klasörüdür.
    >copy sablonlar\*.* C:\tekir\sablonlar\

Sonuçlar

Yukarıdaki işlemlerin sonucunda Tekir uygulama sunucusuna kurulmuş durumdadır. Denemek için uygulama sunucusunu çalıştırıp, dilediğiniz tarayıcıdan http://localhost:8080/tekir adresine giriniz.

İlgili bilgiler

‣ Bölüm 4, Kısım 1. JBoss AS’nin Çalıştırılması

Bölüm 4. Tekir’in Çalışması   

Tekir bir web uygulaması olarak tasarlandığından bir sunucu ortamında çalışıyor olması beklenmektedir. Kurulumların ardından üzerine yüklenmiş olduğu uygulama sunucusu ve veri tabanı sunucusunun işletim sistemi seviyesinde bir servis olarak çalıştırılması gerekmektedir.

1. JBoss AS’nin Çalıştırılması 

JBoss AS’nin çalıştırılması için kurulum klasörü altında run.bat‘ın çalıştırılması yeterlidir.

{JBOSS_HOME}\bin\run.bat
Fakat bu şekilde çalıştırıldığında çağrının yapıldığı konsol kapatıldığında JBoss’da otomatik olarak kapanacaktır. JBoss’un bir servis olarak çalıştırılması gerekmektedir. Windows’larda servis çalıştırmak için yapılması gerekenler aşağıda listelenmiştir.

1.1. JBoss Windows Servisi 

JBoss uygulama sunucusunun windows altında bir sevis olarak çalışması için extra bir yazılım yüklenmesi gerekmektedir. Bu yazılım kurulum paketi içerisinde mevcuttur.

Adımlar
    1. Kurulum paketinden jboss_service klasörünün içeriğini {JBOSS_HOME}\bin klasörünün içine kopyalayınız.

  Not: Eğer Windows’unuz 64bit ise jboss_service_x64 klasörünün içini kopyalayınız

2. Yönetici yetkilerine sahip bir konsoldan {JBOSS_HOME}\bin klasörüne geçiniz

JBoss’u C:\JBoss altına kurduğunuzu varsayarsak
> cd C:\JBoss\bin
Not Windows 7’de yönetici yetkili konsol açmak için “Çalıştır” kutusuna cmd yazıp CTRL+SHIFT+ENTER tuşlarına basabilirsiniz.

3. service.bat komutunu çalıştırınız

C:\JBoss\bin\service.bat install

Bu sayede Jboss servis olarak sisteminizde her açılışta otomatik çalışmaya başlayacaktır. Eğer kapatmak isterseniz yönetim konsolundan hizmetler menüsünden “JBoss Application Server” hizmetini bulup ayarlarını değiştirebilirsiniz.

4. JBoss servisinin ilk kez çalışması için aşağıdaki komutu çalıştırabilirsiniz

C:\JBoss\bin\sc start JBAS42SVC

Bölüm 5. Uygulamanın Sistemden Kaldırılması   

Tekir’in sistemden kaldırılması için JBoss altına kopyalanmış olan tekir.ear dosyasının silinmesi yeterli olacaktır. Aynı şekilde JBoss’un sistemden kaldırılması da isteniyorsa JBoss’un işletim sistemine tanıtımı yapılan servis bilgilerinin kaldırılmasının ardından kurulum yapılan klasörün silinmesi yeterli olacaktır.

Eğer sadece uygulamanın çalışmaması isteniyorsa JBoss uygulama sunucusunun sistemde otomatik başlatılmasının kapatılması yeterlidir.

Ek A. Gerçek Çalışma Ortamında Java Uygulama Sunucuları  

Java uygulama sunucularının ey iyi performansı sağlaması için sisteminize göre ölçeklendirilmeleri ve ayarlanmaları gerekebilir. Bu ayarlar, kullanıcı sayısı, aynı anda oluşan yoğunluklar, donanım özelliklerine göre değişiklik göstermektedir.

Java uygulama sunucuları, kurum içi politikalara göre değişmekle birlikte genelde doğrudan erişime açılmazlar. Bir web sunucusunun arkasında revers proxy desteği ile çalıştırılırlar. Örneğin Apache Web sunucu ile mod_jk ya da mod_proxy modüllerinin sisteme yüklenmesi ve JBoss AS ile ilişkilendirilmesi gerekmektedir.

İnternete açılacak olan sunucuların ise güvenlik katmanı yapılandırması tavsiye edilir.

Bu tür bir kurulumlar için Özgür Yazılım A.Ş. profesyonel destek sağlanmaktadır.

Ek B. Geri Bildirim   

Bu kurulum kılavuzu GFDL ( Özgür Doküman Lisansı ) ile yayınlanmaktadır. Gelişimine katkıda bulunabilirsiniz.

Kurulum Kılavuzu’nun daha kapsamlı ve anlaşılır olması için önerilerinizi, olası kurulum ve uygulama hatalarının bildirilmesini, https://www.tekir.com.tr/hata/ adresinden yapabilirisiniz.

Ek C. Markalar 

Markalar hak sahiplerine aittir.

  • Java, Oracle Corp.’ın ABD ve/veya diğer ülkelerdeki tescilli ticari markasıdır.
  • JBoss, Redhat Inc.’in ABD ve/veya diğer ülkelerdeki tescilli ticari markasıdır.
  • MySQL, Oracle Corp.’ın ABD ve/veya diğer ülkelerdeki tescilli ticari markasıdır.
  • Pardus markası ve logotipi TÜBİTAK’ın tescilli ticari markasıdır.
  • Ubuntu, Canonical Ltd.’in tescilli ticari markasıdır.
  • Fedora, Redhat Inc.’in ABD ve/veya diğer ülkelerdeki tescilli ticari markasıdır.
  • Windows, Microsoft Corp.’ın ABD ve/veya diğer ülkelerdeki tescilli ticari markasıdır.
  • Tekir, Özgür Yazılım A.Ş.’nin tescilli ticari markasıdır.

 

Son Yorumlar