Comment installer Wildfly (jboss) sur Debian 9

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

Dans ce tutoriel, nous vous guiderons à travers les étapes requises pour installer le serveur d'applications WildFly sur Debian 9.

Conditions préalables

L'utilisateur auquel vous êtes connecté doit disposer des privilèges sudo pour pouvoir installer des packages.

Installation de Java OpenJDK

WildFly nécessite l'installation de Java. Nous installerons OpenJDK, qui est le développement et le runtime Java par défaut dans Debian 9:

sudo apt update sudo apt install default-jdk

Création d'un utilisateur

Créez 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 wildfly sudo useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly

Installer WildFly

Au moment d'écrire ces 16.0.0 , la dernière version de WildFly est la 16.0.0 . Avant de passer à l'étape suivante, vous devriez vérifier la page de téléchargement pour une nouvelle version. S'il existe une nouvelle version, remplacez la variable WILDFLY_VERSION dans la commande ci-dessous.

Téléchargez l'archive WildFly dans le /tmp à l'aide de la commande wget suivante:

WILDFLY_VERSION=16.0.0.Final wget 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 dans le répertoire /opt :

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

Créez un lien symbolique wildfly qui pointera vers le répertoire d'installation de WildFly:

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

WildFly s'exécute en tant qu'utilisateur wildfly qui doit avoir accès au répertoire d'installation de WildFly. Changez la propriété de l'annuaire en utilisateur et groupe wildfly :

sudo chown -RH wildfly: /opt/wildfly

Configuration de Systemd

Le package WildFly comprend 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 WildFly:

sudo mkdir -p /etc/wildfly

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

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 s'exécutera en mode autonome et écoutera sur toutes les interfaces. Modifiez 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

Ensuite, copiez le script launch.sh WildFly dans le launch.sh /opt/wildfly/bin/ :

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

Les scripts dans le répertoire bin doivent 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 répertoire /etc/systemd/system/ :

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

Rechargez la configuration du gestionnaire systemd:

sudo systemctl daemon-reload

Démarrez et activez le démarrage automatique du service WildFly au démarrage:

sudo systemctl start wildfly sudo systemctl enable 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

Réglage du 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 disposerez très probablement d'un équilibreur de charge ou d'un proxy inverse et il est recommandé de restreindre l'accès au port 8080 uniquement à votre réseau interne.

Configuration de l'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 script add-user.sh qui se trouve dans le répertoire bin de WildFly:

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

On vous demandera 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? eg 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

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

Test de l'installation de WildFly

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

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

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; then WILDFLY_HOME="/opt/wildfly" fi if]; 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

Description=The WildFly Application Server After=syslog.target network.target Before=httpd.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 WantedBy=multi-user.target

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

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

Rechargez la configuration du gestionnaire systemd:

sudo systemctl daemon-reload

Redémarrez le service WildFly en exécutant:

sudo systemctl restart wildfly

En supposant que votre pare-feu ne bloque pas le port 9990 , vous devriez pouvoir accéder à la console d'administration WildFly à l' http://:9990/console http://:9990/console .

Conclusion

Vous avez installé avec succès WildFly sur votre serveur Debian 9. Vous devriez visiter la documentation officielle de WildFly et en savoir plus sur les fonctionnalités de WildFly.

java wildfly debian