Dans ce tutoriel, nous allons vous montrer comment installer XWiki sur votre serveur Ubuntu 20.04. Nous expliquerons ce que représente XWiki et les étapes de son installation, de sa configuration et des autres logiciels supplémentaires requis.
XWiki est une plateforme wiki open-source et gratuite écrite en Java, qui vous permet de personnaliser votre wiki avec une interface web très simple et conviviale. Il s'exécute sur des conteneurs de servlets Tomcat, Jetty ou JBoss et utilise MySQL/MariaDB ou PostgreSQL comme base de données pour stocker les informations.
Dans cet article, nous utiliserons Tomcat comme conteneur de servlet et MariaDB comme base de données. L'installation de XWiki sur Ubuntu 20.04 ne devrait pas prendre plus de 15 minutes. Commençons l'installation !
Prérequis
- Nouvelle installation d'Ubuntu 20.04
- Privilèges utilisateur :utilisateur root ou non root avec privilèges sudo
Étape 1. Mettre à jour le système
Nous devons mettre à jour le système vers sa dernière version et nous assurer que le logiciel est à jour car nous supposons que vous avez une nouvelle installation d'Ubuntu 20.04
Exécutez la commande d'une ligne suivante et attendez un certain temps que le système obtienne les dernières mises à jour logicielles
sudo apt update -y && sudo apt upgrade -y
Étape 2. Installer Java
Nous avons besoin que Java soit installé sur notre système car XWiki y est écrit. Java peut être installé avec la commande suivante :
apt-get install default-jdk gnupg2 -y
Une fois Java installé, vous pouvez vérifier la version avec la commande suivante :
java --version
La sortie suivante doit être renvoyée.
root@vps:~# java --version openjdk 11.0.11 2021-04-20 OpenJDK Runtime Environment (build 11.0.11+9-Ubuntu-0ubuntu2.20.04) OpenJDK 64-Bit Server VM (build 11.0.11+9-Ubuntu-0ubuntu2.20.04, mixed mode, sharing)
Étape 3. Clé publique et référentiel XWiki GPG
La clé GPG de signature peut être ajoutée avec la commande suivante :
wget https://maven.xwiki.org/xwiki-keyring.gpg -P /usr/share/keyrings/
Ubuntu 20.04 ne contient pas le dépôt XWiki et c'est pourquoi cette étape est importante pour l'ajouter.
wget "https://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/
Mettez à jour le référentiel avec la commande suivante :
sudo apt update -y
Étape 4. Installez XWiki avec Tomcat et MySQL
Avant d'installer XWiki, il existe une option pour lister les paquets XWiki disponibles :
apt-cache search xwiki
Dans ce tutoriel, nous devons installer xwiki-tomcat9-common et xwiki-tomcat9-mariadb avec la commande suivante :
sudo apt install xwiki-tomcat9-common xwiki-tomcat9-mariadb -y
Lors de l'installation des paquets requis, l'invite vous demandera d'entrer le mot de passe root MySQL pour votre installation XWiki.
Appuyez sur Oui, dans la première fenêtre.
Entrez le mot de passe root MySQL et cliquez sur Oui.
Confirmez le mot de passe root MySQL et cliquez sur Oui.
Pendant que l'installation est en cours, il est recommandé d'enregistrer le mot de passe root MySQL dans vos notes pour une configuration ultérieure.
Maintenant, une fois les paquets installés, nous pouvons vérifier si les services tomcat et MariaDB sont opérationnels.
Exécutez la commande suivante pour voir si le service tomcat fonctionne correctement :
systemctl status tomcat9
Vous devriez voir le résultat suivant :
root@vps:/# systemctl status tomcat9
● tomcat9.service - Apache Tomcat 9 Web Application Server
Loaded: loaded (/lib/systemd/system/tomcat9.service; enabled; vendor preset: enabled)
Drop-In: /etc/systemd/system/tomcat9.service.d
└─xwiki-tomcat9-systemd.conf
Active: active (running) since Mon 2021-10-11 23:32:55 UTC; 7min ago
Docs: https://tomcat.apache.org/tomcat-9.0-doc/index.html
Main PID: 91633 (java)
Tasks: 67 (limit: 4617)
Memory: 690.8M
CGroup: /system.slice/tomcat9.servic Pour vérifier si le service MariaDB est opérationnel, exécutez la commande suivante :
sudo systemctl status mariadb
Vous devriez voir le résultat suivant :
root@vps:/# sudo systemctl status mariadb
● mariadb.service - MariaDB 10.3.31 database server
Loaded: loaded (/lib/systemd/system/mariadb.service; enabled; vendor preset: enabled)
Active: active (running) since Mon 2021-10-11 23:30:46 UTC; 10min ago
Docs: man:mysqld(8)
https://mariadb.com/kb/en/library/systemd/
Main PID: 90670 (mysqld)
Status: "Taking your SQL requests now..."
Tasks: 30 (limit: 4617)
Memory: 69.9M
CGroup: /system.slice/mariadb.service
└─90670 /usr/sbin/mysqld Étape 5. Installer Nginx en tant que serveur Web
Nous avons besoin d'un serveur Web afin de pouvoir configurer le proxy inverse pour accéder à l'installation de XWiki.
Exécutez la commande suivante pour installer le serveur Web Nginx :
sudo apt install nginx -y
Une fois, Nginx est installé, démarrez-le avec la commande suivante :
sudo systemctl start nginx
Vérifiez si le service est opérationnel :
sudo systemctl status nginx
Vous devriez voir le résultat suivant :
root@vps:/# sudo systemctl status nginx
● nginx.service - A high performance web server and a reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: active (running) since Mon 2021-10-11 23:44:40 UTC; 5s ago
Docs: man:nginx(8)
Process: 93791 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
Process: 93798 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
Main PID: 93799 (nginx)
Tasks: 5 (limit: 4617)
Memory: 5.0M
CGroup: /system.slice/nginx.service
Étape 6. Créer un nouveau fichier d'hôte virtuel Nginx
Une fois le serveur Web Nginx installé, créez le fichier d'hôte virtuel avec la commande suivante :
sudo nano /etc/nginx/conf.d/xwiki.conf
Collez les lignes suivantes :
server {
listen 80;
server_name xwiki.example.com;
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 http://127.0.0.1:8080;
}
} Enregistrez et fermez le fichier de configuration.
L'étape suivante consiste à augmenter la valeur de taille hash_bucket dans le fichier nginx.conf :
sudo nano /etc/nginx/nginx.conf
Ajoutez ou décommentez la ligne suivante sous la section HTTP, comme indiqué :
server_names_hash_bucket_size 64;
Enregistrez le fichier de configuration et redémarrez le service Nginx.
sudo systemctl restart nginx
Étape 7. Accéder à l'interface Web XWiki
Ouvrez, votre navigateur et accédez à l'interface XWiki en utilisant l'URL dans le reverse proxy xwiki.example.com/xwiki
Cliquez sur le bouton "Continuer" où une autre fenêtre s'affichera pour saisir le prénom et le nom, le nom d'utilisateur, le mot de passe et l'e-mail adresse.
Une fois, tout est rempli cliquez sur le bouton « S'inscrire et se connecter »
Dans la fenêtre suivante, choisissez une saveur de votre choix et installez-la en cliquant sur le bouton "Installer cette saveur".
Dans les étapes suivantes, laissez tout tel quel et cliquez simplement sur le bouton "Continuer" jusqu'à ce que l'installation soit terminée.
Après la dernière étape, vous verrez le tableau de bord de bienvenue XWiki.
C'est ça! Vous avez installé avec succès la plate-forme XWiki sur Ubuntu 20.04. Bien sûr, vous n'avez pas à l'installer si vous trouvez cela difficile. Vous pouvez simplement demander à nos administrateurs experts en hébergement VPS Linux d'installer XWiki sur Ubuntu 20.04 pour vous. Ils sont disponibles 24h/24 et 7j/7 et prendront immédiatement en charge votre demande.
Si vous avez aimé cet article sur la façon d'installer XWiki sur Ubuntu 20.04, partagez-le avec vos amis sur les réseaux sociaux en utilisant les boutons à gauche ou laissez simplement une réponse ci-dessous. Merci.