Cara Memasang XWiki 9.11.x di Ubuntu 16.04 LTS

• Prasyarat
• Siapkan repo APT XWiki LTS
• Instal semua dalam satu bundel XWiki (termasuk XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7, dan banyak lagi.)
• Inisialisasi XWiki pada antarmuka web "Distribution Wizard"
• (Opsional) Persingkat URL situs XWiki
• (Opsional) Siapkan proxy Nginx terbalik

XWiki adalah platform wiki open source tingkat perusahaan yang populer dan ditulis dalam Java. Dengan ekstensibilitas dan kemudahan penggunaan, XWiki digunakan di berbagai perusahaan sebagai tempat penyimpanan pengetahuan, portal publik, dan banyak lagi.

Pada artikel ini, saya akan memandu Anda melalui proses menginstal XWiki 9.11.2 pada contoh server Ubuntu 16.04 LTS. OpenJDK 8, Tomcat 8 dan MySQL 5.7 akan diinstal secara otomatis sebagai dependensi selama proses instalasi.

Prasyarat

• Contoh server baru Vultr Ubuntu 16.04 LTS x64 dengan memori minimal 2GB, 4GB atau lebih direkomendasikan. Katakan alamat IP-nya 203.0.113.1.
• Seorang pengguna sudo .
• Contoh server telah diperbarui ke status stabil terbaru menggunakan apt.

Siapkan repo APT XWiki LTS

Masuk sebagai pengguna sudo, lalu unduh dan atur repo APT XWiki LTS (Dukungan Jangka Panjang) pada contoh server 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

Catatan: Jika Anda ingin mencoba rilis XWiki stabil terbaru (tetapi BUKAN LTS), Anda dapat mengunduh repo XTiki APT berikut:

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

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

Ketika digunakan dalam produksi, XWiki perlu bekerja dengan wadah Java Servlet dan perangkat lunak database. Sebagai platform wiki yang fleksibel, XWiki secara resmi menyediakan berbagai opsi integrasi. Anda dapat menggunakan perintah berikut untuk menampilkan semua opsi yang tersedia di repo XTiki LTS APT:

apt search xwiki

Hasil pencarian 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 dependensi yang paling umum, Anda dapat menginstal semua komponen yang diperlukan dalam satu perintah sebagai berikut:

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

Selama proses instalasi, Anda akan diminta untuk mengatur kata sandi baru untuk pengguna root MySQL beberapa kali. Biarkan bidang kata sandi kosong dan tekan Enteruntuk melewati langkah ini untuk saat ini. Kami akan mengatasi masalah ini nanti saat mengamankan instalasi MySQL.

Ketika ditanya apakah Anda ingin Configure database for xwiki with dbconfig-common?, pilih <Yes>dan kemudian tekan ENTER.

Ketika diminta untuk memberikan MySQL application password for xwiki, Anda dapat memasukkan kata sandi aplikasi MySQL tertentu atau membiarkan bidang kata sandi kosong. Yang terakhir akan memberi tahu XWiki untuk menggunakan kata sandi aplikasi MySQL acak.

Setelah XWiki dan semua dependensi yang diperlukan diinstal, amankan instalasi MySQL:

sudo /usr/bin/mysql_secure_installation

Selama proses, program akan menanyakan beberapa pertanyaan kepada Anda. Balas mereka seperti di bawah ini:

• Apakah Anda ingin memasang plugin VALIDATE PASSWORD? Y
• Silakan masukkan 0 = RENDAH, 1 = MENENGAH dan 2 = KUAT: 2
• Kata sandi baru: a-strong-MySQL-root-password
• Masukkan kembali kata sandi baru: a-strong-MySQL-root-password
• Apakah Anda ingin melanjutkan dengan kata sandi yang diberikan? Y
• Hapus pengguna anonim? Y
• Larang login root dari jarak jauh? Y
• Hapus database pengujian dan akses ke sana? Y
• Muat ulang tabel privilege sekarang? Y

Tingkatkan keamanan XWiki dengan memodifikasi file konfigurasi XWiki.

Gunakan editor vi untuk membuka file konfigurasi XWiki:

sudo vi /etc/xwiki/xwiki.cfg

Temukan dua garis yang ditunjukkan di bawah ini:

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

Ganti nilai kedua parameter dengan dua string acak yang berbeda, dan pastikan panjang setiap string sama dengan yang lainnya, misalnya:

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

Simpan dan keluar:

:wq!

Kuota memori default terlalu rendah untuk menjalankan Tomcat 8 dan XWiki di dalamnya. Anda perlu menambah kuota memori default sebagai berikut sebelum Anda dapat memulai instance XWiki di Tomcat 8 dengan benar.

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

Temukan garis:

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

Ubah baris seperti yang ditunjukkan di bawah ini:

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

Catatan: Memori 1024M hanya kuota minimum untuk menjalankan situs XWiki kecil atau menengah. Anda mungkin perlu melakukan penyesuaian pada saluran ini sesuai dengan tuntutan spesifik Anda.

Simpan dan keluar:

:wq!

Mulai ulang Tomcat 8 untuk mengaktifkan semua modifikasi Anda:

sudo systemctl restart tomcat8.service

Ubah aturan firewall UFW untuk memungkinkan akses web pada port 8080:

sudo ufw allow 8080
sudo ufw enable

Inisialisasi XWiki pada Distribution Wizardantarmuka web " "

Pada titik ini, Anda telah menyiapkan situs XWiki yang fungsional tetapi kosong. Untuk mengisi konten, Anda harus menyelesaikan beberapa tugas tindak lanjut, termasuk membuat pengguna admin dan menginstal rasa dan ekstensi yang diperlukan untuk wiki ini, pada antarmuka web XWiki awal bernama " Distribution Wizard".

Arahkan browser web favorit Anda http://203.0.113.1:8080/xwiki, dan Anda akan secara otomatis dibawa ke Distribution Wizardantarmuka web " ". Klik tombol " Continue" untuk memulai wizard.

Di halaman " Step 1 - Admin user", Anda perlu memasukkan kredensial pengguna admin, 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 tombol " Register and login" untuk melanjutkan.

Di halaman berikutnya yang menunjukkan " You are connected with user John Doe.", klik tombol " Continue" untuk membuat pengguna admin John Doeyang nama pengguna johndoedan lanjutkan.

Di halaman " Step 2 - Flavor", klik area " XWiki Standard Flavor 9.11.2" untuk menyorot rasa ini, dan kemudian klik tombol " Install this flavor" untuk melanjutkan.

Pada halaman berikutnya yang merinci " XWiki Standard Flavor 9.11.2", klik tombol " Install" untuk melakukan instalasi.

Setelah rasa diinstal, semua ekstensi yang diperlukan akan terdaftar di halaman, klik tombol " Continue" untuk menginstal semuanya.

Setelah rasa dan semua ekstensi yang diperlukan terpasang, klik tombol " Continue" di sudut kanan bawah untuk melanjutkan.

Di halaman " Step 4 - Report", Anda dapat meninjau semua halaman yang dibuat.

Jika perlu, Anda dapat menghapus halaman yang tidak populer dengan mengklik Xtombol merah yang sesuai .

Akhirnya, klik tombol " Continue" untuk menyelesaikan " Distribution Wizard". Anda akan dibawa ke dasbor XWiki sebagai pengguna admin yang Anda siapkan sebelumnya.

(Opsional) Persingkat URL situs XWiki

Secara default, karena Tomcat dapat melayani lebih dari satu aplikasi secara bersamaan, Anda perlu mengakses situs 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 mempersingkat URL situs XWiki dengan menghapus /xwikisuffix, Anda harus memodifikasi tiga file konfigurasi XWiki sebagai berikut.

Modifikasi file 1:

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

Modifikasi file 2:

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

Temukan garis:

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

Ubah nilai parameter jalur:

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

Simpan dan keluar:

:wq!

Modifikasi file 3:

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

Temukan garis:

# xwiki.webapppath=

Batalkan komentar:

xwiki.webapppath=

Simpan dan keluar:

:wq!

Terakhir, mulai ulang Tomcat 8 untuk menerapkan semua modifikasi Anda:

sudo systemctl restart tomcat8.service

Mulai sekarang, Anda akan mengunjungi situs XWiki Anda dari http://203.0.113.1:8080/langsung.

(Opsional) Siapkan proxy Nginx terbalik

Secara default, Tomcat 8 berfungsi pada port 8080, dan Anda hanya dapat mengunjungi situs XWiki Anda dari port yang sama. Jika Anda ingin memfasilitasi akses pengunjung dengan menghapus bagian nomor port, Anda dapat menginstal Nginx sebagai proxy terbalik antara XWiki dan pengunjung.

Pertama, instal Nginx menggunakan apt:

sudo apt install nginx -y

Selanjutnya, setup Nginx sebagai proxy terbalik dengan memodifikasi konfigurasi situs default-nya:

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

Isi file 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 keluar:

:wq!

Mulai layanan Nginx dan atur untuk memulai secara otomatis saat startup sistem:

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

Akhirnya, ubah aturan firewall UFW sesuai:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Mulai sekarang, pengunjung ke situs XWiki Anda tidak perlu lagi menentukan nomor port. Mereka harus langsung berkunjung http://203.0.113.1/.