Ubuntu 20.10 üzerine Xwiki Kurulumu

Serdar Bayram31 Mayıs 2021

0 577 4 dakika okuma süresi

Nedir bu Xwiki ?
Xwikiyle neleri çözebilirsiniz
Kurulum
Xwiki'yi Ubuntu deposundan yükleyin
Tomcat ve MariaDb kurulumu
Nginx kurulumu
XWiki Web Arayüzüne Erişim

Translate This Page:

Select your language:

Hemen hemen her kuruluşun kurumsal bilgi toplaması, çeşitli kaynaklardan materyalleri harmanlaması ve deneyimlerini paylaşması gerekir. Ve birçok şirket bunu, Word,exel,pdf,resim gibi formtlarda soft veya hard copy olarak saklar yada birden çok kullanıcı tarafından çalışılabilen web sayfaları olan wiki kullanarak başarır.

Ancak wiki’ler bilgilerinizi erişilebilir ve güncel tutmanın en iyi yolu mudur? Artık çok çeşitli veri yönetimi ve iletişim ürünleri mevcut olduğundan, işletmeler araçlarını dikkatli bir şekilde seçmelidir. Wiki’ler de kuruluşlara bu sorunlarını çözebilmeleri için esnek ve güvenilir seçenekler sunmaktadır.

Bu makalede, bir wikinin bilgi toplamanın ve kullanmanın doğru yolu olup olmadığını araştırıyoruz. Eğer öyleyse, wiki’nizi nasıl kuracağınızı ve çalıştığınız yerde onu etkili bir şekilde kullanmaya nasıl başlayacağınızı açıklıyoruz.

Nedir bu Xwiki ?

XWiki, Java ile yazılmış ücretsiz ve açık kaynaklı bir Wiki Yazılım platformudur. Tomcat gibi web sunucular üzerinde çalışır ve bilgileri depolamak için MySQL gibi bir veritabanı kullanır. xWiki, birden çok kullanıcı tarafından düzenlenebilen bir web sitesi veya çevrimiçi kaynaktır. Wikipedia gibi bazı wiki’ler halka açıktır. Diğerleri, kuruluşlar tarafından bilgileri şirket içinde yönetmek için kullanılır ve ekiplerin bilgiyi kolayca paylaşmasına ve birlikte daha verimli çalışmasına olanak tanır.

Xwikiyle neleri çözebilirsiniz

Birden çok perspektife dayalı bir “büyük resim” oluşturmaya çalışıyorsunuz.
Yapınızda Gelişen veya hala kabul edilen bilgileri saklamak istiyorsunuz.
Ekipteki herkesin şu ana kadar toplanan tüm bilgileri görmesi gerekiyor.
Dahili veya harici diğer bilgilere bağlantılar oluşturmak önemlidir.
Bu noktaya varan tüm yazma ve düzenleme adımlarını görmek faydalıdır.
Hatalar ortaya çıkarsa felaket olmayacak çünkü bunlar hızla tespit edilip düzeltilecek.

Biraz daha neslen bir örnek vermek gerekirse Bir kurumun IT birimini ele alalım her departman her takım farklı operasyonlar yürüyor ve bir çok iş yapıyor Developerın yazdığı onlarda kod sisin yapınıza özgür bir takıp çözüm metotları gibi bir çok konu bulunuyor işte bu ve bunun gibi bir çok çözümü merkezi bir yerde dökümante edebileceğiniz bir platform olarak yapılandırabilirsiniz. Böylelikle arama bölümüne yazacağınız birkaç anahtar kelime ile o sisteme hakim olmayan herhangi bir IT çalışanını sorunun çözümüne ulaşmak için izleyeceği yolu dokümante edebilirsiniz .

Bu ve bunun gibi örnekler çoğaltılabilir kısaca bir veriyi bir toplulukla sistemli bir şekilde paylaşmanın iyi bir yöntemi olduğunu söyleyebiliriz.

Temel Özellikler

Bilginin dağıtımı ve erişimi
Bilginin erişilebilir ve sürekli uygunluğunun sağlanması
Etkin çalışma platformu
Ortak ve etkileşimli çalışma platformu
Email trafiğinin azaltılması
Sayfa düzenleme için kullanılan çok güçlü bir WYSIWYG editörü
Sağlam bir wiki sözdizimi
İçerik organizasyonu

Kullanım Alanları

Sosyal intranet / intranet 2.0
Sürüm Kontrolü
Dijital Bilgi Portalı
Proje Yönetim Kokpiti
Proje dokümantasyonu ve iletişimi
Kendi uygulamalarınızı oluşturabilme
Dosya Yöneticisi
Görevler oluşturup takip edebilme
Gelişmiş arama ve çok daha fazlası

Kurulum

Bu kadar ön bilgiden sonra kuruluma başlayabiliriz aşağıdaki kılavuz ubuntu 20.10 için hazırlanmıştır.
Aşağıdaki komut ile sistem güncellemelerini yapıyoruz.
Bu kadar ön bilgiden sonra kuruluma başlayabiliriz aşağıdaki kılavuz ubuntu 20.10 için hazırlanmıştır.

Aşağıdaki komut ile sistem güncellemelerini yapıyoruz.

sudo apt update

Java kurulumu

XWiki Java ile yazılmıştır. Yazılım gereksinimlerini karşılamak için sisteminizde Java 8 veya üstünün kurulu olması gerekir. Varsayılan olarak, Ubuntu 20.04, OpenJDK 11 ile birlikte gelir .

Aşağıdaki komutu çalıştırarak Java paketinin kurulumunu başlatıyoruz.

sudo apt install default-jdk gnupg2 -y

Java yüklendikten sonra, Java sürümünü aşağıdaki komutla doğrulayın:

java --version

Aşağıdaki çıktıyı almalısınız.

Xwiki’yi Ubuntu deposundan yükleyin

XWiki, Ubuntu 20.04 deposunda bulunamadı. XWiki resmi deposunu sisteminize eklemeniz gerekir . Öncelikle aşağıdaki komutla GPG anahtarını içe aktarıyoruz.

Ama önce /root kullanıcısına ”su” komutunu kullanarak geçin.

sudo su

Aşağıdaki komutu çalıştırınız.

wget -q "https://maven.xwiki.org/public.gpg" -O- | apt-key add -

Yukarıdaki ok yanıtını aldıysak xwiki repostory ekleyebiliriz.
Aşağıdaki komutu çalıştırıyoruz.

sudo wget "https://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/
sudo wget https://maven.xwiki.org/xwiki-keyring.gpg -P /usr/share/keyrings/

Repostory yi güncelliyoruz.

sudo apt update

Eklenen paketleri aşağıdaki komut ile görüntüleyebiliriz.

apt-cache search xwiki

Tomcat ve MariaDb kurulumu

Doldurulan listede, kurmak istediğiniz paketleri seçebilirsiniz. Bu kılavuzda, veritabanı sunucusu olarak tomcat 9 ve MariaDB ile Xwiki’yi kuracağız.
Artık aşağıdaki komutu çalıştırarak XWiki’yi kurabilirsiniz:

sudo apt install xwiki-tomcat9-common xwiki-tomcat9-mariadb -y

Aşağıdaki ekranda yes seçeneği ile devam ediyoruz

Mysql DB için bir parola belirliyoruz.

Bu işlemlerden sonra kurulumumuz tamamlanıyor.

Kurulum tamamlandıktan sonra, şu komutu çalıştırarak Tomcat hizmetinin çalışıp çalışmadığını kontrol ediyoruz.

sudo systemctl status tomcat9.service

Tomcat 8080 numaralı bağlantı noktasını dinliyor. Aşağıdaki ss komutunu çalıştırarak doğrulayabilirsiniz:

ss -antpl | grep 8080

Nginx kurulumu

XWiki’ye erişmek için Nginx’i ters proxy olarak kurmamız ve yapılandırmanız gerekecektir. Öncelikle aşağıdaki komutu çalıştırarak Nginx web sunucusunu kuruyoruz:

sudo apt-get install nginx -y

Web sunucusu kurulduktan sonra, aşağıdaki komutla yeni bir Nginx sanal ana bilgisayar yapılandırma dosyası oluşturuyoruz:
İlgili config dosyamıza gidiyoruz.

sudo nano /etc/nginx/sites-available/xwiki.conf

İçerisine aşağıdaki komut dizini yapıştırıyoruz ve “ctrl+o” ile kayıt edip “ctrl+x” ile çıkıyoruz.

server {
 listen 80;

 server_name xwiki.example.com;

 access_log /var/log/nginx/xwiki-access.log;
 error_log /var/log/nginx/xwiki-error.log;

 location / {
 proxy_set_header   X-Real-IP $remote_addr;
 proxy_set_header   Host      $host;
 proxy_http_version 1.1;
 proxy_set_header   Upgrade $http_upgrade;
 proxy_set_header   Connection 'upgrade';
 proxy_cache_bypass $http_upgrade;
 proxy_pass         http://127.0.0.1:8080;
 }
 }

Xwiki.example.com yazan yere siz kendi alan adı formatınıza göre bir isim verebilirsiniz böylelikle daha sonra locale yada public e açarsanız sunucunuza ip adresi yerine bu alan adı ile erişebilirsiniz.

sudo ln -s /etc/nginx/sites-available/xwiki.conf /etc/nginx/sites-enabled/

Ardından, Nginx ana yapılandırma dosyasını düzenleyin ve hash_bucket boyutunu artırın:

sudo nano /etc/nginx/nginx.conf

“#server_names_hash_bucket_size 64;” bölümünde “#” işaretini kaldırarak açıklama olmaktan çıkarıp dosyamızı kayıt ediyoruz.

Nginx servisimizi restart ediyoruz.

sudo systemctl restart nginx

Servisimizi kontrol ediyoruz

sudo systemctl status nginx

XWiki Web Arayüzüne Erişim

Şimdi, web tarayıcınızı açın ve http://127.0.0.1:8080/xwiki URL’sini kullanarak XWiki web arayüzüne erişin. Bu, XWiki sihirbazı aşağıdaki gibi başlayacaktır.