Ubuntu 16.04 LTS Üzerine XWiki 9.11.x Kurulumu

• Ön şartlar
• XWiki LTS APT deposunu kurma
• Hepsi bir arada XWiki paketini yükleyin (XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 ve daha fazlası dahil).
• "Dağıtım Sihirbazı" web arabiriminde XWiki'yi başlat
• (İsteğe bağlı) XWiki site URL'sini kısaltın
• (İsteğe bağlı) Nginx ters proxy oluşturma

XWiki, Java ile yazılmış, kurumsal düzeyde popüler, açık kaynaklı bir wiki platformudur. Genişletilebilirlik ve kullanım kolaylığı sayesinde, XWiki çeşitli şirketlere bilgi deposu, genel portal ve daha fazlası olarak dağıtılmaktadır.

Bu makalede, bir Ubuntu 16.04 LTS sunucusu örneğine XWiki 9.11.2'yi yükleme işlemi boyunca size rehberlik edeceğim. Kurulum işlemi sırasında OpenJDK 8, Tomcat 8 ve MySQL 5.7 otomatik olarak bağımlılık olarak kurulacaktır.

Ön şartlar

• En az 2GB belleğe, 4GB veya daha fazlasına sahip yeni bir Vultr Ubuntu 16.04 LTS x64 sunucu örneği. Diyelim ki IP adresi 203.0.113.1.
• Bir sudo kullanıcısı .
• Sunucu örneği kullanılarak en son kararlı duruma güncellendi apt.

XWiki LTS APT deposunu kurma

Bir sudo kullanıcısı olarak oturum açın ve ardından sunucu örneğinize XWiki LTS (Uzun Süreli Destek) APT deposunu indirip kurun:

cd
wget -q "https://maven.xwiki.org/public.gpg" -O- | sudo apt-key add -
sudo wget "https://maven.xwiki.org/lts/xwiki-lts.list" -P /etc/apt/sources.list.d/
sudo apt update

Not: En son kararlı XWiki sürümünü (ancak LTS DEĞİL ) denemek istiyorsanız , aşağıdaki XWiki APT deposunu indirebilirsiniz:

cd
wget -q "https://maven.xwiki.org/public.gpg" -O- | sudo apt-key add -
sudo wget "https://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/
sudo apt update

Hepsi bir arada XWiki paketini yükleyin (XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 ve daha fazlası dahil).

Üretimde konuşlandırıldığında, XWiki'nin bir Java Servlet kapsayıcısı ve veritabanı yazılımı ile çalışması gerekir. Esnek bir wiki platformu olarak, XWiki resmen çeşitli entegrasyon seçenekleri sunar. XWiki LTS APT deposundaki tüm kullanılabilir seçenekleri göstermek için aşağıdaki komutu kullanabilirsiniz:

apt search xwiki

Arama sonucu aşağıdakine benzer:

xwiki-common/lts 9.11.2 all
xwiki-mysql-common/lts 9.11.2 all
xwiki-pgsql-common/lts 9.11.2 all
xwiki-solr-data/lts 9.11.2 all
xwiki-tomcat7-common/lts 9.11.2 all
xwiki-tomcat7-mysql/lts 9.11.2 all
xwiki-tomcat7-pgsql/lts 9.11.2 all
xwiki-tomcat8-common/lts 9.11.2 all
xwiki-tomcat8-mysql/lts 9.11.2 all
xwiki-tomcat8-pgsql/lts 9.11.2 all

XWiki'yi en yaygın bağımlılıklarla kullanmak istiyorsanız, gerekli tüm bileşenleri tek bir komutta aşağıdaki gibi yükleyebilirsiniz:

sudo apt install xwiki-tomcat8-mysql/lts -y

Yükleme işlemi sırasında, MySQL kök kullanıcısı için birkaç kez yeni bir parola ayarlamanız istenecektir. Şifre alanını boş bırakın ve Enterşimdilik bu adımı atlamak için tuşuna basın . Bu sorunu daha sonra MySQL kurulumunu güvenli hale getirirken ele alacağız.

İsteyip istemediğiniz sorulduğunda Configure database for xwiki with dbconfig-common?, öğesini seçin <Yes>ve düğmesine basın ENTER.

Bir sağlamanız istendiğinde MySQL application password for xwiki, belirli bir MySQL uygulama şifresi girebilir veya şifre alanını boş bırakabilirsiniz. İkincisi, XWiki'ye rastgele bir MySQL uygulama şifresi kullanmasını söyleyecektir.

XWiki ve gerekli tüm bağımlılıkları yükledikten sonra MySQL kurulumunu güvenli hale getirin:

sudo /usr/bin/mysql_secure_installation

İşlem sırasında, program size birkaç soru soracaktır. Onları aşağıdaki gibi yanıtlayın:

• VALIDATE PASSWORD eklentisini kurmak ister misiniz? Y
• Lütfen 0 = DÜŞÜK, 1 = ORTA ve 2 = GÜÇLÜ girin: 2
• Yeni Şifre: a-strong-MySQL-root-password
• Yeni şifreyi tekrar giriniz: a-strong-MySQL-root-password
• Girilen şifreye devam etmek istiyor musunuz? Y
• Anonim kullanıcılar kaldırılsın mı? Y
• Kök girişine uzaktan izin verilsin mi? Y
• Test veritabanı kaldırılsın mı? Y
• Ayrıcalık tabloları şimdi yeniden yüklensin mi? Y

XWiki yapılandırma dosyasını değiştirerek XWiki'nin güvenliğini artırın.

Bir XWiki yapılandırma dosyasını açmak için vi düzenleyicisini kullanın:

sudo vi /etc/xwiki/xwiki.cfg

Aşağıda gösterilen iki satırı bulun:

xwiki.authentication.validationKey=totototototototototototototototo
xwiki.authentication.encryptionKey=titititititititititititititititi

Her iki parametrenin değerlerini iki farklı rastgele dizeyle değiştirin ve her dizenin uzunluğunun diğeriyle aynı olduğundan emin olun, örneğin:

xwiki.authentication.validationKey=f0130dfa6fc841e920d5e1056184c03e
xwiki.authentication.encryptionKey=z84kf92ko073tgjdnvkdfmms91qa0ke4

Kaydet ve çık:

:wq!

Varsayılan bellek kotası, Tomcat 8 ve XWiki'yi çalıştırmak için çok düşük. Tomcat 8'de bir XWiki örneğini düzgün bir şekilde başlatmadan önce varsayılan bellek kotasını aşağıdaki gibi artırmanız gerekir.

sudo cp /etc/default/tomcat8 /etc/default/tomcat8.bak
sudo vi /etc/default/tomcat8

Hattı bulun:

JAVA_OPTS="-Djava.awt.headless=true -Xmx128m -XX:+UseConcMarkSweepGC"

Çizgiyi aşağıda gösterildiği gibi değiştirin:

JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m"

Not: 1024M bellek, küçük veya orta büyüklükteki bir XWiki sitesini çalıştırmak için yalnızca minimum kotadır. Özel talepleriniz doğrultusunda bu hatta ayarlamalar yapmanız gerekebilir.

Kaydet ve çık:

:wq!

Tüm değişikliklerinizi hayata geçirmek için Tomcat 8'i yeniden başlatın:

sudo systemctl restart tomcat8.service

Bağlantı noktasında web erişimine izin vermek için UFW güvenlik duvarı kurallarını değiştirin 8080:

sudo ufw allow 8080
sudo ufw enable

" Distribution Wizard" Web arayüzünde XWiki'yi başlat

Bu noktada, işlevsel ancak boş bir XWiki sitesi oluşturdunuz. İçeriği doldurmak için, yönetici kullanıcısı oluşturmak ve bu wiki için bir lezzet ve gerekli uzantıları yüklemek de dahil olmak üzere çeşitli izleme görevlerini tamamlamanız gerekir, " Distribution Wizard" adlı ilk XWiki web arayüzüne .

Favori web tarayıcınızın http://203.0.113.1:8080/xwikiüzerine gelin, otomatik olarak " Distribution Wizard" web arayüzüne yönlendirileceksiniz. ContinueSihirbazı başlatmak için " " düğmesini tıklayın .

" Step 1 - Admin user" Sayfasında, yönetici kullanıcısının kimlik bilgilerini girmeniz gerekir, örneğin:

FIRST NAME: `John`
LAST NAME: `Doe`
USERNAME (Required): `johndoe`
PASSWORD (Required): `yourpassword`
CONFIRM PASSWORD (Required): `yourpassword`
EMAIL ADDRESS: `[email protected]`

Gerekli alanların tümünü doldurduktan sonra, devam etmek için " Register and login" düğmesini tıklayın .

" You are connected with user John Doe." Yazan bir sonraki sayfada , Continuekullanıcı John Doeadı olan johndoeve devam eden yönetici kullanıcısı oluşturmak için " " düğmesini tıklayın .

" Step 2 - Flavor" Sayfasında, XWiki Standard Flavor 9.11.2bu lezzeti vurgulamak için " " alanını tıklayın ve ardından devam etmek için " Install this flavor" düğmesini tıklayın.

" XWiki Standard Flavor 9.11.2" Ayrıntılarını gösteren bir sonraki sayfada Install, kurulumu gerçekleştirmek için " " düğmesini tıklayın.

Lezzet yüklendiğinde, gerekli tüm uzantılar sayfada listelenir, Continuehepsini yüklemek için " " düğmesini tıklayın.

Lezzet ve gerekli tüm uzantılar yüklendiğinde, Continuedevam etmek için sağ alt köşedeki " " düğmesini tıklayın.

" Step 4 - Report" Sayfasında, oluşturulan tüm sayfaları inceleyebilirsiniz.

Gerekirse, ilgili kırmızı Xdüğmeyi tıklayarak popüler olmayan sayfaları silebilirsiniz .

Son olarak, " Continue" düğmesini bitirmek için " Distribution Wizard" düğmesini tıklayın . Daha önce ayarladığınız yönetici kullanıcı olarak XWiki kontrol paneline getirileceksiniz.

(İsteğe bağlı) XWiki site URL'sini kısaltın

Varsayılan olarak, Tomcat aynı anda birden fazla uygulama sunabildiğinden, URL'den XWiki sitenize erişmeniz gerekir http://203.0.113.1:8080/xwiki. Ancak, Tomcat'te çalışan tek uygulama XWiki ise ve /xwikison eki kaldırarak XWiki sitesinin URL'sini kısaltmak istiyorsanız , üç XWiki yapılandırma dosyasını aşağıdaki gibi değiştirmeniz gerekir.

Dosya değişikliği 1:

cd /etc/tomcat8/Catalina/localhost/
sudo cp xwiki.xml ROOT.xml
sudo mv xwiki.xml xwiki.xml.bak

Dosya değişikliği 2:

cd /etc/xwiki
sudo cp xwiki-tomcat8.xml xwiki-tomcat8.xml.bak
sudo vi xwiki-tomcat8.xml

Hattı bulun:

<Context path="/xwiki" docBase="/usr/lib/xwiki" privileged="true" crossContext="true">

Path parametresinin değerini değiştirin:

<Context path="/" docBase="/usr/lib/xwiki" privileged="true" crossContext="true">

Kaydet ve çık:

:wq!

Dosya değişikliği 3:

cd /etc/xwiki
sudo cp xwiki.cfg xwiki.cfg.bak
sudo vi xwiki.cfg

Hattı bulun:

# xwiki.webapppath=

Uncomment it:

xwiki.webapppath=

Kaydet ve çık:

:wq!

Son olarak, tüm değişikliklerinizi uygulamak için Tomcat 8'i yeniden başlatın:

sudo systemctl restart tomcat8.service

Şu andan itibaren, http://203.0.113.1:8080/doğrudan XWiki sitenizi ziyaret edeceksiniz .

(İsteğe bağlı) Nginx ters proxy oluşturma

Tomcat 8 varsayılan olarak bağlantı noktasında çalışır 8080ve XWiki sitenizi yalnızca aynı bağlantı noktasından ziyaret edebilirsiniz. Bağlantı noktası numarası bölümünü kaldırarak ziyaretçilerin erişimini kolaylaştırmak istiyorsanız, Nginx'i XWiki ve ziyaretçiler arasında ters proxy olarak yükleyebilirsiniz.

İlk olarak, apt kullanarak Nginx'i kurun:

sudo apt install nginx -y

Ardından, varsayılan site yapılandırmalarını değiştirerek Nginx'i ters proxy olarak kurun:

cd /etc/nginx/sites-available
sudo mv default default.bak
sudo vi default

Dosyayı aşağıdakilerle doldurun:

server {
listen 0.0.0.0:80;

proxy_request_buffering off;
proxy_buffering off;

location / {
    proxy_pass http://127.0.0.1:8080;
    proxy_redirect     off;
        proxy_set_header   Host $host;
        proxy_set_header   X-Real-IP $remote_addr;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Host $server_name;
}
}

Kaydet ve çık:

:wq!

Nginx hizmetini başlatın ve sistem başlangıcında otomatik olarak başlayacak şekilde ayarlayın:

sudo systemctl restart nginx.service
sudo systemctl enable nginx.service

Son olarak, UFW güvenlik duvarı kurallarını uygun şekilde değiştirin:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Şu andan itibaren, XWiki sitenize gelen ziyaretçilerin artık bağlantı noktası numarasını belirtmeleri gerekmiyor. Doğrudan ziyaret etmeliler http://203.0.113.1/.