Dans ce tutoriel, nous allons vous montrer comment installer XWiki sur Ubuntu 20.04 LTS. Pour ceux d’entre vous qui ne le savaient pas, XWiki est une plate-forme logicielle wiki avancée, gratuite et open source, basée sur Java. Il fonctionne sur des conteneurs de servlets comme JBoss, Tomcat, Jetty, etc. Il utilise également une base de données telle que MySQL ou PostgreSQL pour stocker ses informations.
Cet article suppose que vous avez au moins des connaissances de base sur Linux, que vous savez utiliser le shell et, plus important encore, que vous hébergez votre site sur votre propre VPS. L’installation est assez simple et suppose que vous utilisez le compte root, sinon vous devrez peut-être ajouter ‘sudo‘ aux commandes pour obtenir les privilèges root. Je vais vous montrer l’installation étape par étape de XWiki sur Ubuntu 20.04 (Focal Fossa). Vous pouvez suivre les mêmes instructions pour Ubuntu 18.04, 16.04 et toute autre distribution basée sur Debian comme Linux Mint.
Installer XWiki sur Ubuntu 20.04 LTS Focal Fossa
Étape 1. Tout d’abord, assurez-vous que tous vos packages système sont à jour en exécutant ce qui suit apt commandes dans le terminal.
sudo apt update sudo apt upgrade
Étape 2. Installation de XWiki sur Ubuntu 20.04.
Maintenant, nous importons la clé GPG avec la commande ci-dessous :
wget -q "https://maven.xwiki.org/public.gpg" -O- | apt-key add -
Ensuite, ajoutez le dépôt officiel XWiki :
sudo wget "https://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/
Une fois cela fait, vérifiez tous les packages disponibles dans ce référentiel à l’aide de la commande suivante :
sudo apt update sudo apt-cache search xwiki
Dans ce guide, nous allons installer XWiki avec tomcat 9 et MariaDB comme serveur de base de données :
sudo apt install xwiki-tomcat9-common xwiki-tomcat9-mariadb
Après avoir installé XWiki, vous pouvez vérifier le service Tomcat à l’aide de la commande suivante :
sudo systemctl status tomcat9.service
Étape 3. Configurez Nginx pour XWiki.
Vous devrez installer et configurer Nginx en tant que proxy inverse pour accéder à XWiki. Tout d’abord, installez le serveur Web Nginx avec la commande suivante :
sudo apt install nginx
Une fois installé, créez un nouveau fichier de configuration d’hôte virtuel Nginx à l’aide de la commande suivante :
sudo nano /etc/nginx/sites-available/xwiki.conf
Ajoutez les lignes suivantes :
server {
listen 80;
server_name xwiki.idroot.us;
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 https://127.0.0.1:8080;
}
}Save et close le fichier de configuration. Ensuite, activez l’hôte virtuel Nginx en exécutant :
sudo ln -s /etc/nginx/sites-available/xwiki.conf /etc/nginx/sites-enabled/
Ensuite, modifiez le fichier de configuration principal de Nginx et augmentez le hash_bucket size:
sudo nano /etc/nginx/nginx.conf
Ajoutez la ligne suivante sous la section HTTP comme indiqué :
server_names_hash_bucket_size 64;
Save et close le fichier puis redémarrez le service Nginx pour appliquer les modifications :
sudo systemctl restart nginx
Étape 4. Accéder à l’interface Web XWiki.
XWiki sera disponible sur le port HTTP 8080 par défaut. Ouvrez votre navigateur préféré et accédez à https://xwiki.domain.com:8080/xwiki ou https://server-ip-address:8080/xwiki et suivez les étapes requises pour terminer l’installation.
Toutes nos félicitations! Vous avez correctement installé XWiki. Merci d’avoir utilisé ce didacticiel pour installer XWiki sur le système Ubuntu 20.04 LTS Focal Fossa. Pour une aide supplémentaire ou des informations utiles, nous vous recommandons de vérifier le site officiel de XWiki.
