Tuesday, September 25, 2007

Dokümantasyon ve Twiki – II (TWiki)

Aşağıdaki adımları izleyerek RedHat EL3 üzerine Twiki 4.1.2 kurulumunu tamamladım. Twiki'nin çalışabilmesi için Apache ve Perl'ün Linux üzerinde bulunması gerekiyor. Neyse ki, bunlar yüklü, Apache 2.0.46 ve Perl 5.8.0. Hmm bu arada kurulum bir miktar linux bilgisi ve sistem yöneticiliği gerektiriyor, zaman zaman root şifresine ihtiyacınız olacak. Eğer bu tür yeteneklerim yok diyorsanız, VMDebianStable linki işinizi görecektir, kendisi yaklaşık 350 MB. Ben uzak durdum tabi. Şimdi Twiki'yi kurmak için neler gerektiğini sırası ile anlatayım. Anlatım esnasında belirtilen tüm lokasyonlar kurulumu yaptığımız makinenindir.


  • Twiki4.1.2 linkinden Twiki'yi indirin. Yaklaşık 5,5 MB.

  • /var/www/twiki klasörünün içerisine bu zip'i açın.

  • Twiki'nin çalışmasında aksama olmaması için bazı CPAN modüllerinin yüklenmesi lazım. Bu CPAN'ların listesini bu linkte bulabilirsiniz. Bunları tar.gz formatında http://cpan.perl.org/ sitesinden indirip ardından “make” komutu ile yapılandırabilirsiniz. Fakat daha kolayı var, bu linkten RPM'leri indirin, sonra bunları twiki makinesine kopyalayın, sonra bunları kopyaladığınız klasör altında "rpm -ivh *" komutunu çalıştırın. Evet hepsi bu, gerekli tüm CPAN modülleri kuruldu.

  • Apache ayarlarının yapılması lazım. Bunun için TwikiApacheConfigGenerator linkine girip, formu doldurmamız gerekiyor. Bu formu doldururken birkaç hususa dikkat etmeniz gerekiyor,

    • Eğer ayarları lokalden yapmayacaksanız, IP listesine IP'nizi ekleyin.

    • Yine konfigürasyon ayarlarını yapacak kullanıcıların listesini kullanıcı listesine ekleyin.

    • Login Manager seçin, sakın none'da bırakmayın. Login sayfası kullanacaksanız, TemplateLogin'i seçin, diğeri zaten anlaşılır. Ben TemplateLogin seçtim.

    • mod_perl'ü enable etmeyin, bunun dışında diğer ayarlara dokunmasanız da olur.

      • No you do not need mod_perl. mod_perl needs to be installed on your Apache installation for you to be able to use it and you need a lot of RAM. mod_perl compiles all the perl code ONCE and keep it in RAM. This speeds up the execution of TWiki by at least factor 2. But mod_perl also keeps all variables in RAM so the programs must be written with great care. The TWiki core and the default plugins are pretty mod_perl safe now. But some other plugins do not work with mod_perl. I recommend to start a new TWiki installation without. And once it works you can try and activate it. Read the topic ModPerlUnix for more information. This ApacheConfigGenerator is a helper that generates a working apache config also for mod_perl but you need to know more about it to use it. As a beginner, run without.

  • Update config file dedikten sonra aşağıda oluşan bilgileri twiki.conf isimli bir dosyaya koyun, ve bu dosyayı da /etc/httpd/conf.d altına koyun. Apache'nin konfigürasyon dosyasında bulunan Include conf.d/*.conf satırı, bu conf dosyasının otomatik olarak okunmasını sağlayacak.

  • chmod 644 twiki.conf” ve “ chown root:root twiki.conf” komutlarını conf.d klasörü altında çalıştırmamız gerekiyor.

  • Apache konfigürasyonunu bitirdikten sonra ilk ayarları yapacak olan kullanıcıyı yaratma kısmına geldik. htpasswd -c /var/www/twiki/data/.htpasswd oguz” komutu ilk kullanıcımızı yaratıyor. Eğer “-c” parametresini kullanmazsak, yeni kullanıcıyı bu listenin sonuna ekliyor. Aksi takdirde, bu dosyayı sıfırlıyor. “-c” yerine “-D” kullanırsak kullanıcıyı siliyor. Twiki kurulumu bittikten sonra yaratılan her kullanıcı bu dosya içerisine eklenecek.

  • /var/www/twiki/bin klasöründeki LocalLib.cfg.txt dosyasını LocalLib.cfg'ye çevirmek ve ardından içerisinde twikiLibPath parametresini doğru bir şekilde düzeltmek gerekiyor...

  • SDosyalar üzerinde bazı yetkilerin verilmesi gerekiyor. Bu yetkileri SettingFileAccessRightsLinuxUnix linkinde bulabilirsiniz.

  • Son işimiz Apache'yi ayağa kaldırmak olacak. “service httpd start” yazıyoruz ve ardından http:///twiki/bin/configure yazarak konfigürasyona geçiyoruz.

  • Bundan sonraki ayarları Run Configure For The First Time linkindeki bilgiler ışığında yapabilirsiniz

  • Bunun dışında tam kurulum dokümanını TwikiOnRedHat linkinde bulabilirsiniz.


Umarım memnun kalırsınız...


0 comments: