Comment installer Wildfly (jboss) sur Ubuntu 18.04

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.

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.

Conditions préalables

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

Étape 1: installer Java OpenJDK

WildFly nécessite l'installation de Java. Nous installerons 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 utilisateur

Nous allons créer un nouvel utilisateur et groupe système 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

Étape 3: installez 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écutera sous l'utilisateur wildfly 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 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. Vous pouvez éditer 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 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/

Informez 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: ajuster le 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.

Étape 6: configurer 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.

Étape 6: tester 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/

Informez 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 à l' http://:9990/console http://:9990/console .

Conclusion

Vous avez correctement installé WildFly sur votre système Ubuntu 18.04. Vous pouvez maintenant visiter la documentation officielle de WildFly et en savoir plus sur les fonctionnalités de WildFly.

java wildfly ubuntu