Comment installer WildFly (JBoss) sur Ubuntu 18.04

WildFly, anciennement connu sous le nom de JBoss, est un environnement d'exécution d'application open source multiplateforme écrit en Java qui vous aide à créer des applications étonnantes. WildFly est flexible, léger et basé sur des sous-systèmes enfichables qui peuvent être ajoutés ou supprimés selon les besoins.

Ce tutoriel vous montrera comment installer le serveur d'applications WildFly sur Ubuntu 18.04. Les mêmes instructions s'appliquent à Ubuntu 16.04 et à toute distribution basée sur Ubuntu, y compris Kubuntu, Linux Mint et Elementary OS.

Prérequis #

Pour pouvoir installer des packages sur votre système Ubuntu, vous devez être connecté en tant qu'utilisateur avec des privilèges sudo.

Étape 1 :Installer Java OpenJDK #

WildFly nécessite l'installation de Java. Nous allons installer OpenJDK, qui est le développement et l'exécution Java par défaut dans Ubuntu 18.04.

L'installation de Java est assez simple. Commencez par mettre à jour l'index du package :

sudo apt update

Installez le package OpenJDK en exécutant :

sudo apt install default-jdk

Étape 2 :Créer un numéro d'utilisateur

Nous allons créer un nouvel utilisateur système et un groupe nommé wildfly avec le répertoire personnel /opt/wildfly qui exécutera le service WildFly :

sudo groupadd -r wildflysudo useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly

Étape 3 :Installer WildFly #

Au moment de la rédaction, la dernière version de WildFly est 16.0.0 . Avant de passer à l'étape suivante, vous devez vérifier la page de téléchargement pour une nouvelle version. S'il y a une nouvelle version, remplacez le WILDFLY_VERSION variable dans la commande ci-dessous.

Téléchargez l'archive WildFly dans le /tmp répertoire en utilisant le wget suivant commande :

WILDFLY_VERSION=16.0.0.Finalwget https://download.jboss.org/wildfly/$WILDFLY_VERSION/wildfly-$WILDFLY_VERSION.tar.gz -P /tmp

Une fois le téléchargement terminé, extrayez le fichier tar.gz et déplacez-le vers /opt répertoire :

sudo tar xf /tmp/wildfly-$WILDFLY_VERSION.tar.gz -C /opt/

Créer un lien symboliquewildfly qui pointera vers le répertoire d'installation de WildFly :

sudo ln -s /opt/wildfly-$WILDFLY_VERSION /opt/wildfly

WildFly fonctionnera sous le wildfly utilisateur qui doit avoir accès au répertoire d'installation de WildFly.

La commande suivante changera la propriété du répertoire en utilisateur et groupe wildfly :

sudo chown -RH wildfly: /opt/wildfly

Étape 4 :Configurer Systemd #

Le package WildFly inclut les fichiers nécessaires pour exécuter WildFly en tant que service.

Commencez par créer un répertoire qui contiendra le fichier de configuration de WildFly :

sudo mkdir -p /etc/wildfly

Copiez le fichier de configuration dans /etc/wildfly répertoire :

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/

Ce fichier vous permet de spécifier le mode WildFly et l'adresse de liaison. Par défaut, WildFly fonctionnera en mode autonome et écoutera sur toutes les interfaces. Vous pouvez modifier le fichier selon vos besoins.

/etc/wildfly/wildfly.conf

# The configuration you want to run
WILDFLY_CONFIG=standalone.xml

# The mode you want to run
WILDFLY_MODE=standalone

# The address to bind to
WILDFLY_BIND=0.0.0.0

Copiez ensuite WildFly launch.sh script au /opt/wildfly/bin/ répertoire :

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/

Les scripts à l'intérieur de bin le répertoire doit avoir un drapeau exécutable :

sudo sh -c 'chmod +x /opt/wildfly/bin/*.sh'

La dernière étape consiste à copier le fichier d'unité systemd nommé dans le /etc/systemd/system/ répertoire :

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/

Avertissez systemd que nous avons créé un nouveau fichier d'unité :

sudo systemctl daemon-reload

Démarrez le service WildFly en exécutant :

sudo systemctl start wildfly

Vérifiez l'état du service avec la commande suivante :

sudo systemctl status wildfly

* wildfly.service - The WildFly Application Server
   Loaded: loaded (/etc/systemd/system/wildfly.service; disabled; vendor preset: enabled)
   Active: active (running) since Sun 2019-02-17 04:59:39 PST; 2s ago
 Main PID: 10005 (launch.sh)
    Tasks: 62 (limit: 2319)
   CGroup: /system.slice/wildfly.service

Activez le démarrage automatique du service au démarrage :

sudo systemctl enable wildfly

Étape 5 :Ajustez le numéro de pare-feu

Si votre serveur est protégé par un pare-feu et que vous souhaitez accéder à l'interface WildFly depuis l'extérieur de votre réseau local, vous devez ouvrir le port 8080 .

Pour autoriser le trafic sur le port 8080 tapez la commande suivante :

sudo ufw allow 8080/tcp

Lors de l'exécution d'une application WildFly dans un environnement de production, vous aurez très probablement un équilibreur de charge ou un proxy inverse et il est recommandé de restreindre l'accès au port 8080 uniquement à votre réseau interne.

Étape 6 :Configurer le numéro d'authentification WildFly

Maintenant que WildFly est installé et en cours d'exécution, l'étape suivante consiste à créer un utilisateur qui pourra se connecter à l'aide de la console d'administration ou à distance à l'aide de la CLI.

Pour ajouter un nouvel utilisateur, utilisez le add-user.sh script situé dans le répertoire bin de WildFly :

sudo /opt/wildfly/bin/add-user.sh

Il vous sera demandé quel type d'utilisateur souhaitez-vous ajouter :

What type of user do you wish to add? 
 a) Management User (mgmt-users.properties) 
 b) Application User (application-users.properties)
(a):

Sélectionnez a et appuyez sur Enter :

Ensuite, le script vous demandera d'entrer les détails du nouvel utilisateur :

Enter the details of the new user to add.
Using realm 'ManagementRealm' as discovered from the existing property files.
Username : linuxize
Password recommendations are listed below. To modify these restrictions edit the add-user.properties configuration file.
 - The password should be different from the username
 - The password should not be one of the following restricted values {root, admin, administrator}
 - The password should contain at least 8 characters, 1 alphabetic character(s), 1 digit(s), 1 non-alphanumeric symbol(s)
Password : 
Re-enter Password : 
What groups do you want this user to belong to? (Please enter a comma separated list, or leave blank for none)[  ]: 
About to add user 'linuxize' for realm 'ManagementRealm'
Is this correct yes/no? yes
Added user 'linuxize' to file '/opt/wildfly-16.0.0.Final/standalone/configuration/mgmt-users.properties'
Added user 'linuxize' to file '/opt/wildfly-16.0.0.Final/domain/configuration/mgmt-users.properties'
Added user 'linuxize' with groups  to file '/opt/wildfly-16.0.0.Final/standalone/configuration/mgmt-groups.properties'
Added user 'linuxize' with groups  to file '/opt/wildfly-16.0.0.Final/domain/configuration/mgmt-groups.properties'
Is this new user going to be used for one AS process to connect to another AS process? 
e.g. for a slave host controller connecting to the master or for a Remoting connection for server to server EJB calls.
yes/no? yes
To represent the user add the following to the server-identities definition <secret value="UGFuMjNkZWo3NyNA" />

Le nouvel utilisateur sera ajouté aux fichiers de propriétés utilisés pour l'authentification.

Étape 6 :Testez l'installation de WildFly #

Pour accéder à la page WildFly par défaut, ouvrez votre navigateur et tapez :http://<your_domain_or_IP_address>:8080

En supposant que l'installation est réussie, un écran semblable au suivant apparaît :

Étape 7 :Accéder à la console d'administration WildFly #

Interface de ligne de commande #

Pour accéder à la console d'administration WildFly à partir de la ligne de commande, vous pouvez utiliser le jboss-cli.sh script.

Accédez au répertoire bin de WildFly et exécutez le script avec le --connect choix :

cd /opt/wildfly/bin/./jboss-cli.sh --connect

Il vous sera demandé d'entrer votre nom d'utilisateur et votre mot de passe administratifs (créés à l'étape 6) :

Authenticating against security realm: ManagementRealm
Username: linuxize
Password:

Une fois connecté, l'invite de la console passera à [standalone@localhost:9990 /] . Tapez help pour obtenir une liste des commandes et la syntaxe des commandes.

À partir de là, vous pouvez déployer et annuler le déploiement de vos applications, gérer les utilisateurs et les groupes et configurer et surveiller le serveur WildFly.

Numéro d'interface Web

Si vous préférez gérer votre serveur à partir de l'interface graphique, WildFly fournit également une console Web.

Par défaut, la console d'administration WildFly est disponible uniquement à partir de localhost sur http://localhost:9990/console . Connectez-vous en utilisant l'utilisateur que vous avez créé à l'étape 6.

Si vous souhaitez accéder à la console à distance, vous devrez apporter de petites modifications au wildfly.service , wildfly.conf et launch.sh fichiers.

Ouvrez le wildfly.conf et ajoutez WILDFLY_CONSOLE_BIND=0.0.0.0 à la fin du fichier.

/etc/wildfly/wildfly.conf

# The configuration you want to run
WILDFLY_CONFIG=standalone.xml

# The mode you want to run
WILDFLY_MODE=standalone

# The address to bind to
WILDFLY_BIND=0.0.0.0

# The address console to bind to
WILDFLY_CONSOLE_BIND=0.0.0.0

Ouvrez le launch.sh et modifiez les lignes en surbrillance :

/opt/wildfly/bin/launch.sh

#!/bin/bash

if [ "x$WILDFLY_HOME" = "x" ]; then
    WILDFLY_HOME="/opt/wildfly"
fi

if [[ "$1" == "domain" ]]; then
    $WILDFLY_HOME/bin/domain.sh -c $2 -b $3 -bmanagement $4
else
    $WILDFLY_HOME/bin/standalone.sh -c $2 -b $3 -bmanagement $4
fi

Redémarrez le service pour que les modifications prennent effet :

sudo systemctl restart wildfly

Ouvrez le wildfly.service et modifiez les lignes en surbrillance :

/etc/systemd/system/wildfly.service

[Unit]
Description=The WildFly Application Server
After=syslog.target network.target
Before=httpd.service

[Service]
Environment=LAUNCH_JBOSS_IN_BACKGROUND=1
EnvironmentFile=-/etc/wildfly/wildfly.conf
User=wildfly
LimitNOFILE=102642
PIDFile=/var/run/wildfly/wildfly.pid
ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND
StandardOutput=null

[Install]
WantedBy=multi-user.target

Créez le /var/run/wildfly répertoire et définissez les autorisations appropriées :

sudo mkdir /var/run/wildfly/sudo chown wildfly: /var/run/wildfly/

Avertissez systemd que le fichier d'unité a été modifié :

sudo systemctl daemon-reload

Redémarrez le service WildFly en exécutant :

sudo systemctl restart wildfly

En supposant que le port 9990 n'est pas bloqué dans votre pare-feu, vous devriez pouvoir accéder à la console d'administration WildFly à http://<your_domain_or_IP_address>:9990/console .