Cara Memasang XWiki 9.11.x pada Ubuntu 16.04 LTS

• Prasyarat
• Sediakan repo XWiki LTS APT
• Pasang bundle XWiki semua dalam satu (termasuk XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7, dan banyak lagi.)
• Inisialisasi XWiki pada antara muka web "Pengedaran Wizard"
• (Pilihan) Pendekkan URL laman XWiki
• (Pilihan) Sediakan proksi terbalik Nginx

XWiki adalah platform wiki sumber terbuka peringkat perusahaan yang popular yang ditulis di Java. Dengan kepanjangan dan kemudahan penggunaan, XWiki digunakan di berbagai syarikat sebagai repositori pengetahuan, portal awam, dan banyak lagi.

Dalam artikel ini, saya akan membimbing anda melalui proses pemasangan XWiki 9.11.2 pada contoh server Ubuntu 16.04 LTS. OpenJDK 8, Tomcat 8 dan MySQL 5.7 akan dipasang secara automatik sebagai pergantungan semasa proses pemasangan.

Prasyarat

• Contoh pelayan Vultr Ubuntu 16.04 LTS x64 segar dengan sekurang-kurangnya 2GB memori, 4GB atau lebih disyorkan. Katakan alamat IPnya adalah 203.0.113.1.
• Pengguna sudo .
• Contoh pelayan telah dikemas kini ke status stabil terkini menggunakan apt.

Sediakan repo XWiki LTS APT

Log masuk sebagai pengguna sudo, kemudian muat turun dan siapkan repo APT XWiki LTS (Sokongan Jangka Panjang) pada contoh pelayan anda:

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

Nota: Sekiranya anda ingin mencuba pelepas XWiki stabil yang terkini (tetapi TIDAK LTS), anda boleh memuat turun repo APBN di bawah ini sebagai gantinya:

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

Pasang semua dalam satu pakej XWiki (termasuk XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7, dan banyak lagi.)

Ketika digunakan dalam produksi, XWiki perlu bekerja dengan perisian Java Servlet dan perisian pangkalan data. Sebagai platform wiki yang fleksibel, XWiki secara rasmi menyediakan pelbagai pilihan integrasi. Anda boleh menggunakan arahan berikut untuk menunjukkan semua pilihan yang tersedia di repositori XWiki LTS APT:

apt search xwiki

Hasil carian akan menyerupai yang berikut:

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

Jika anda ingin menggunakan XWiki dengan kebergantungan yang paling biasa, anda boleh memasang semua komponen yang diperlukan dalam satu arahan seperti berikut:

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

Semasa proses pemasangan, anda akan diminta untuk menyiapkan kata laluan baru untuk pengguna root MySQL beberapa kali. Hanya tinggal kosongkan kata laluan dan tekan Enteruntuk melangkau langkah ini untuk sekarang. Kami akan menangani masalah ini kemudian sambil mengamankan pemasangan MySQL.

Apabila ditanya sama ada anda mahu Configure database for xwiki with dbconfig-common?, pilih <Yes>dan kemudian tekan ENTER.

Apabila diminta untuk memberikan MySQL application password for xwiki, anda boleh memasukkan kata laluan aplikasi MySQL tertentu atau membiarkan bidang kata laluan kosong. Yang terakhir ini akan memberitahu XWiki untuk menggunakan kata laluan aplikasi MySQL rawak.

Setelah memasang XWiki dan semua pergantungan yang diperlukan, selamatkan pemasangan MySQL:

sudo /usr/bin/mysql_secure_installation

Semasa prosesnya, program ini akan menanyakan beberapa soalan kepada anda. Balas mereka seperti di bawah:

• Adakah anda ingin menyediakan VALIDATE PASSWORD plugin? Y
• Sila masukkan 0 = RENDAH, 1 = MEDIUM dan 2 = KUAT: 2
• Kata laluan baharu: a-strong-MySQL-root-password
• Masukkan semula kata laluan baru: a-strong-MySQL-root-password
• Adakah anda ingin meneruskan kata laluan yang diberikan? Y
• Buang pengguna tanpa nama? Y
• Tidak membenarkan login root dari jauh? Y
• Keluarkan pangkalan data ujian dan akses ke dalamnya? Y
• Jadual keistimewaan ulang sekarang? Y

Tingkatkan keselamatan XWiki dengan mengubah fail konfigurasi XWiki.

Gunakan editor vi untuk membuka fail konfigurasi XWiki:

sudo vi /etc/xwiki/xwiki.cfg

Cari dua baris yang ditunjukkan di bawah:

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

Ganti nilai kedua-dua parameter dengan dua rentetan rawak yang berbeza, dan pastikan panjang setiap tali sama dengan yang lain, misalnya:

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

Simpan dan tutup:

:wq!

Kuota memori lalai terlalu rendah untuk menjalankan Tomcat 8 dan XWiki di dalamnya. Anda perlu meningkatkan kuota memori lalai seperti berikut sebelum anda dapat memulakan instance XWiki di Tomcat 8 dengan betul.

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

Cari baris:

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

Ubah garis seperti yang ditunjukkan di bawah:

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

Catatan: Memori 1024M hanyalah kuota minimum untuk menjalankan laman web XWiki kecil atau sederhana. Anda mungkin perlu membuat penyesuaian pada baris ini sesuai dengan permintaan khusus anda.

Simpan dan tutup:

:wq!

Mulakan semula Tomcat 8 untuk melaksanakan semua pengubahsuaian anda:

sudo systemctl restart tomcat8.service

Ubah peraturan firewall UFW untuk membenarkan akses web di port 8080:

sudo ufw allow 8080
sudo ufw enable

Permulaan XWiki di Distribution Wizardantara muka web ""

Pada ketika ini, anda telah menyediakan laman XWiki yang berfungsi tetapi kosong. Untuk mengisi kandungan, anda perlu menyelesaikan beberapa tugas susulan, termasuk membuat pengguna pentadbir dan memasang perasa dan perluasan yang diperlukan untuk wiki ini, di antara muka web XWiki awal bernama " Distribution Wizard".

Arahkan penyemak imbas web kegemaran anda http://203.0.113.1:8080/xwiki, dan anda akan dibawa ke " Distribution Wizard" antara muka web secara automatik . Klik butang " Continue" untuk memulakan penyihir.

Di Step 1 - Admin userhalaman " ", anda perlu memasukkan bukti kelayakan pengguna pentadbir, misalnya:

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

Setelah mengisi semua bidang yang diperlukan, Klik butang " Register and login" untuk meneruskan.

Pada halaman seterusnya yang menunjukkan " You are connected with user John Doe.", klik butang " Continue" untuk membuat pengguna admin John Doeyang nama pengguna johndoedan teruskan.

Di Step 2 - Flavorhalaman " ", klik pada kawasan " XWiki Standard Flavor 9.11.2" untuk menyerlahkan rasa ini, kemudian klik butang " Install this flavor" untuk bergerak.

Pada halaman seterusnya yang memperincikan " XWiki Standard Flavor 9.11.2", klik butang " Install" untuk melakukan pemasangan.

Setelah memasang rasa, semua sambungan yang diperlukan akan disenaraikan di halaman, klik butang " Continue" untuk memasangnya.

Setelah rasa dan semua sambungan yang diperlukan dipasang, klik butang " Continue" di sudut kanan bawah untuk meneruskan.

Di Step 4 - Reporthalaman " ", anda boleh menyemak semua halaman yang dibuat.

Sekiranya perlu, anda boleh menghapus halaman yang tidak popular dengan mengklik Xbutang merah yang sesuai .

Akhirnya, klik butang " Continue" untuk menyelesaikan " Distribution Wizard". Anda akan dibawa ke papan pemuka XWiki sebagai pengguna pentadbir yang telah anda siapkan sebelumnya.

(Pilihan) Pendekkan URL laman XWiki

Secara lalai, kerana Tomcat dapat melayani lebih dari satu aplikasi pada masa yang sama, anda perlu mengakses laman XWiki anda di URL http://203.0.113.1:8080/xwiki. Namun, jika XWiki adalah satu-satunya aplikasi yang berjalan di Tomcat dan anda ingin memendekkan URL laman XWiki dengan membuang /xwikiakhiran, anda harus mengubah tiga fail konfigurasi XWiki seperti berikut.

Pengubahsuaian fail 1:

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

Pengubahsuaian fail 2:

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

Cari baris:

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

Ubah nilai parameter jalan:

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

Simpan dan tutup:

:wq!

Pengubahsuaian fail 3:

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

Cari baris:

# xwiki.webapppath=

Menanggalkannya:

xwiki.webapppath=

Simpan dan tutup:

:wq!

Akhir sekali, mulakan Tomcat 8 untuk memohon semua pengubahsuaian anda:

sudo systemctl restart tomcat8.service

Mulai sekarang, anda akan mengunjungi laman XWiki anda http://203.0.113.1:8080/secara langsung.

(Pilihan) Sediakan proksi terbalik Nginx

Secara lalai, Tomcat 8 berfungsi di port 8080, dan anda hanya boleh mengunjungi laman XWiki anda dari port yang sama. Sekiranya anda ingin memudahkan akses pengunjung dengan membuang bahagian nombor port, anda boleh memasang Nginx sebagai proksi terbalik antara XWiki dan pelawat.

Pertama, pasang Nginx menggunakan apt:

sudo apt install nginx -y

Seterusnya, sediakan Nginx sebagai proksi terbalik dengan mengubah konfigurasi laman lalainya:

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

Isi fail dengan yang berikut:

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;
}
}

Simpan dan tutup:

:wq!

Mulakan perkhidmatan Nginx dan tetapkannya untuk memulakan permulaan sistem secara automatik:

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

Akhirnya, ubah peraturan firewall UFW dengan sewajarnya:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Mulai sekarang, pelawat ke laman XWiki anda tidak lagi perlu menentukan nombor port. Mereka perlu terus melawat http://203.0.113.1/.