Πώς να εγκαταστήσετε το XWiki 9.11.x στο Ubuntu 16.04 LTS

Το XWiki είναι μια δημοφιλής πλατφόρμα wiki ανοιχτού κώδικα σε επίπεδο επιχείρησης γραμμένη σε Java. Με επεκτασιμότητα και ευκολία στη χρήση, το XWiki αναπτύσσεται σε διάφορες εταιρείες ως αποθετήριο γνώσης, δημόσια πύλη και πολλά άλλα.

Σε αυτό το άρθρο, θα σας καθοδηγήσω στη διαδικασία εγκατάστασης του XWiki 9.11.2 σε μια παρουσία διακομιστή Ubuntu 16.04 LTS. Τα OpenJDK 8, Tomcat 8 και MySQL 5.7 θα εγκατασταθούν αυτόματα ως εξαρτήσεις κατά τη διαδικασία εγκατάστασης.

Προαπαιτούμενα

• Ένα νέο παράδειγμα διακομιστή Vultr Ubuntu 16.04 LTS x64 με τουλάχιστον 2 GB μνήμης, συνιστάται 4 GB ή περισσότερο. Ας πούμε ότι η διεύθυνση IP του είναι 203.0.113.1.
• Ένας χρήστης sudo .
• Η παρουσία διακομιστή έχει ενημερωθεί στην πιο πρόσφατη σταθερή κατάσταση χρησιμοποιώντας apt.

Ρυθμίστε το αποθετήριο XWiki LTS APT

Συνδεθείτε ως χρήστης sudo και, στη συνέχεια, πραγματοποιήστε λήψη και ρυθμίστε το αποθετήριο XWiki LTS (Μακροπρόθεσμη Υποστήριξη) APT στην παρουσία του διακομιστή σας:

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

Σημείωση: Εάν θέλετε να δοκιμάσετε την πιο πρόσφατη σταθερή έκδοση XWiki (αλλά ΟΧΙ LTS), μπορείτε να κάνετε λήψη του παρακάτω αποθετηρίου XWiki APT:

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

Εγκαταστήστε το πακέτο όλα σε ένα XWiki (συμπεριλαμβανομένων των XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 και άλλων.)

Όταν αναπτύσσεται στην παραγωγή, το XWiki πρέπει να συνεργάζεται με κοντέινερ Java Servlet και λογισμικό βάσης δεδομένων. Ως ευέλικτη πλατφόρμα wiki, το XWiki παρέχει επίσημα διάφορες επιλογές ενσωμάτωσης. Μπορείτε να χρησιμοποιήσετε την ακόλουθη εντολή για να εμφανίσετε όλες τις διαθέσιμες επιλογές στο αποθετήριο XWiki LTS APT:

apt search xwiki

Το αποτέλεσμα αναζήτησης θα μοιάζει με το εξής:

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 με τις πιο κοινές εξαρτήσεις, μπορείτε να εγκαταστήσετε όλα τα απαιτούμενα στοιχεία σε μία εντολή ως εξής:

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

Κατά τη διαδικασία εγκατάστασης, θα σας ζητηθεί να ορίσετε έναν νέο κωδικό πρόσβασης για τον ριζικό χρήστη της MySQL πολλές φορές. Απλώς αφήστε το πεδίο κωδικού πρόσβασης κενό και πατήστε Enterγια να παραλείψετε αυτό το βήμα προς το παρόν. Θα αντιμετωπίσουμε αυτό το πρόβλημα αργότερα ενώ θα διασφαλίσουμε την εγκατάσταση της MySQL.

Όταν ερωτηθείτε εάν θέλετε Configure database for xwiki with dbconfig-common?, επιλέξτε <Yes>και μετά πατήστε ENTER.

Όταν σας ζητηθεί να δώσετε ένα MySQL application password for xwiki, μπορείτε είτε να εισαγάγετε έναν συγκεκριμένο κωδικό πρόσβασης εφαρμογής MySQL είτε να αφήσετε κενό το πεδίο κωδικού πρόσβασης. Το τελευταίο θα πει στο XWiki να χρησιμοποιήσει έναν τυχαίο κωδικό πρόσβασης εφαρμογής MySQL.

Έχοντας εγκαταστήσει το XWiki και όλες τις απαιτούμενες εξαρτήσεις, εξασφαλίστε την εγκατάσταση της MySQL:

sudo /usr/bin/mysql_secure_installation

Κατά τη διάρκεια της διαδικασίας, το πρόγραμμα θα σας κάνει μερικές ερωτήσεις. Απαντήστε τους ως εξής:

• Θέλετε να ρυθμίσετε την προσθήκη VALIDATE PASSWORD; Y
• Εισαγάγετε 0 = ΧΑΜΗΛΟ, 1 = ΜΕΣΑΙΟ και 2 = ΙΣΧΥΡΟ: 2
• Νέος Κωδικός: a-strong-MySQL-root-password
• Εισαγάγετε ξανά νέο κωδικό πρόσβασης: a-strong-MySQL-root-password
• Θέλετε να συνεχίσετε με τον κωδικό πρόσβασης που παρέχεται; Y
• Κατάργηση ανώνυμων χρηστών; Y
• Να μην επιτρέπεται η απομακρυσμένη σύνδεση root; Y
• Κατάργηση δοκιμαστικής βάσης δεδομένων και πρόσβαση σε αυτήν; Y
• Επαναφόρτωση πινάκων προνομίων τώρα; Y

Βελτιώστε την ασφάλεια του XWiki τροποποιώντας το αρχείο διαμόρφωσης XWiki.

Χρησιμοποιήστε το πρόγραμμα επεξεργασίας vi για να ανοίξετε ένα αρχείο διαμόρφωσης XWiki:

sudo vi /etc/xwiki/xwiki.cfg

Βρείτε τις δύο γραμμές που φαίνονται παρακάτω:

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

Αντικαταστήστε τις τιμές και των δύο παραμέτρων με δύο διαφορετικές τυχαίες συμβολοσειρές και απλώς βεβαιωθείτε ότι το μήκος κάθε συμβολοσειράς είναι το ίδιο με το άλλο, για παράδειγμα:

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

Αποθήκευση και έξοδος:

:wq!

Το προεπιλεγμένο όριο μνήμης είναι πολύ χαμηλό για την εκτέλεση του Tomcat 8 και του XWiki εντός. Πρέπει να αυξήσετε το προεπιλεγμένο όριο μνήμης ως εξής για να μπορέσετε να ξεκινήσετε σωστά μια παρουσία XWiki στο Tomcat 8.

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

Βρείτε τη γραμμή:

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

Τροποποιήστε τη γραμμή όπως φαίνεται παρακάτω:

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

Σημείωση: 1024M μνήμης είναι μόνο το ελάχιστο όριο για την εκτέλεση μιας μικρής ή μεσαίας τοποθεσίας XWiki. Ίσως χρειαστεί να κάνετε προσαρμογές σε αυτή τη γραμμή σύμφωνα με τις συγκεκριμένες απαιτήσεις σας.

Αποθήκευση και έξοδος:

:wq!

Επανεκκινήστε το Tomcat 8 για να τεθούν σε ισχύ όλες οι τροποποιήσεις σας:

sudo systemctl restart tomcat8.service

Τροποποιήστε τους κανόνες του τείχους προστασίας UFW για να επιτρέψετε την πρόσβαση στο web στη θύρα 8080:

sudo ufw allow 8080
sudo ufw enable

Εκκινήστε το XWiki στη Distribution Wizardδιεπαφή ιστού " "

Σε αυτό το σημείο, έχετε εγκαταστήσει έναν λειτουργικό αλλά κενό ιστότοπο XWiki. Για να συμπληρώσετε περιεχόμενο, πρέπει να ολοκληρώσετε πολλές εργασίες παρακολούθησης, συμπεριλαμβανομένης της δημιουργίας ενός χρήστη διαχειριστή και της εγκατάστασης μιας γεύσης και των απαιτούμενων επεκτάσεων για αυτό το wiki, στην αρχική διεπαφή ιστού XWiki με το όνομα " Distribution Wizard".

Κατευθύνετε το αγαπημένο σας πρόγραμμα περιήγησης ιστού στο http://203.0.113.1:8080/xwiki, και θα μεταφερθείτε αυτόματα στη Distribution Wizardδιεπαφή ιστού " ". Κάντε κλικ στο Continueκουμπί " " για να ξεκινήσει ο οδηγός.

Στη Step 1 - Admin userσελίδα " ", πρέπει να εισαγάγετε τα διαπιστευτήρια του χρήστη διαχειριστή, για παράδειγμα:

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

Έχοντας συμπληρώσει όλα τα απαιτούμενα πεδία, κάντε κλικ στο Register and loginκουμπί " " για να προχωρήσετε.

Στην επόμενη σελίδα που εμφανίζει το " You are connected with user John Doe.", κάντε κλικ στο κουμπί " Continue" για να δημιουργήσετε τον διαχειριστή του John Doeοποίου το όνομα χρήστη είναι johndoeκαι προχωρήστε.

Στη Step 2 - Flavorσελίδα " ", κάντε κλικ στην περιοχή " XWiki Standard Flavor 9.11.2" για να επισημάνετε αυτή τη γεύση και, στη συνέχεια, κάντε κλικ στο κουμπί " Install this flavor" για να προχωρήσετε.

Στην επόμενη σελίδα που περιγράφει λεπτομερώς το " XWiki Standard Flavor 9.11.2", κάντε κλικ στο κουμπί " Install" για να πραγματοποιήσετε την εγκατάσταση.

Έχοντας εγκαταστήσει τη γεύση, όλες οι απαιτούμενες επεκτάσεις θα εμφανιστούν στη σελίδα, κάντε κλικ στο κουμπί " Continue" για να τις εγκαταστήσετε όλες.

Έχοντας εγκαταστήσει τη γεύση και όλες τις απαιτούμενες επεκτάσεις, κάντε κλικ στο κουμπί " Continue" στην κάτω δεξιά γωνία για να προχωρήσετε.

Στη Step 4 - Reportσελίδα " ", μπορείτε να ελέγξετε όλες τις σελίδες που δημιουργήθηκαν.

Εάν είναι απαραίτητο, μπορείτε να διαγράψετε τυχόν μη δημοφιλείς σελίδες κάνοντας κλικ στο αντίστοιχο κόκκινο Xκουμπί.

Τέλος, κάντε κλικ στο κουμπί " Continue" για να ολοκληρώσετε το " Distribution Wizard". Θα μεταφερθείτε στον πίνακα ελέγχου του XWiki ως ο διαχειριστής που είχατε ρυθμίσει νωρίτερα.

(Προαιρετικό) Συντομεύστε τη διεύθυνση URL του ιστότοπου XWiki

Από προεπιλογή, καθώς το Tomcat μπορεί να εξυπηρετήσει περισσότερες από μία εφαρμογές ταυτόχρονα, πρέπει να αποκτήσετε πρόσβαση στον ιστότοπό σας XWiki στη διεύθυνση URL http://203.0.113.1:8080/xwiki. Ωστόσο, εάν το XWiki είναι η μόνη εφαρμογή που εκτελείται στο Tomcat και θέλετε να συντομεύσετε τη διεύθυνση URL του ιστότοπου XWiki αφαιρώντας το /xwikiεπίθημα, θα πρέπει να τροποποιήσετε τρία αρχεία διαμόρφωσης XWiki ως εξής.

Τροποποίηση αρχείου 1:

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

Τροποποίηση αρχείου 2:

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

Βρείτε τη γραμμή:

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

Τροποποιήστε την τιμή της παραμέτρου διαδρομής:

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

Αποθήκευση και έξοδος:

:wq!

Τροποποίηση αρχείου 3:

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

Βρείτε τη γραμμή:

# xwiki.webapppath=

Καταργήστε το σχολιασμό:

xwiki.webapppath=

Αποθήκευση και έξοδος:

:wq!

Τέλος, επανεκκινήστε το Tomcat 8 για να εφαρμόσετε όλες τις τροποποιήσεις σας:

sudo systemctl restart tomcat8.service

Από εδώ και στο εξής, θα επισκέπτεστε τον ιστότοπό σας στο XWiki από http://203.0.113.1:8080/απευθείας.

(Προαιρετικό) Ρυθμίστε έναν αντίστροφο διακομιστή μεσολάβησης Nginx

Από προεπιλογή, το Tomcat 8 λειτουργεί σε θύρα 8080, και μπορείτε να επισκεφτείτε τον ιστότοπό σας XWiki μόνο από την ίδια θύρα. Εάν θέλετε να διευκολύνετε την πρόσβαση των επισκεπτών αφαιρώντας το τμήμα του αριθμού θύρας, μπορείτε να εγκαταστήσετε το Nginx ως αντίστροφο διακομιστή μεσολάβησης μεταξύ του XWiki και των επισκεπτών.

Πρώτα, εγκαταστήστε το Nginx χρησιμοποιώντας το apt:

sudo apt install nginx -y

Στη συνέχεια, ρυθμίστε το Nginx ως αντίστροφο διακομιστή μεσολάβησης τροποποιώντας τις προεπιλεγμένες διαμορφώσεις του ιστότοπού του:

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

Συμπληρώστε το αρχείο με τα εξής:

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

Αποθήκευση και έξοδος:

:wq!

Ξεκινήστε την υπηρεσία Nginx και ρυθμίστε την να ξεκινά αυτόματα κατά την εκκίνηση του συστήματος:

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

Τέλος, τροποποιήστε τους κανόνες του τείχους προστασίας UFW ανάλογα:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Από εδώ και στο εξής, οι επισκέπτες στον ιστότοπό σας XWiki δεν χρειάζεται πλέον να προσδιορίζουν τον αριθμό θύρας. Θα πρέπει να επισκεφθούν απευθείας http://203.0.113.1/.