JBoss

Fiche express
Type	Serveur d'applications Java EE
Éditeur	Red Hat
Console	http://localhost:9990/console
Voir aussi	Tomcat · Java

JBoss (WildFly / JBoss EAP) est un serveur d'applications Java EE édité par Red Hat. La console d'administration web est accessible par défaut sur le port 9990.

Installation

adduser jboss
chown -fR jboss:jboss jboss/
su jboss
cd /APPDIR/jboss/jboss/bin
chmod +x ./add-user.sh

Créer un utilisateur de management :

# interactif : choisir « a » (Management User) puis le nom, ex. jbossmanager
./add-user.sh

# compte management non interactif
./add-user.sh {username} {password}

# compte applicatif
./add-user.sh -a {username} {password}

Démarrage / arrêt

# démarrer (écoute sur toutes les interfaces)
./standalone.sh -Djboss.bind.address=0.0.0.0 -Djboss.bind.address.management=0.0.0.0 &
# console : http://<ip>:9990/

# arrêter
./jboss-cli.sh --connect command=:shutdown

Interface en ligne de commande (CLI)

./bin/jboss-cli.sh
connect
connect 192.168.0.10:9999

./bin/jboss-cli.sh --connect --commands="ls deployment"

Lister les opérations d'un sous-système :

[standalone@localhost:9999 /] /subsystem=logging:read-operation-names
[standalone@localhost:9999 /] /subsystem=logging:read-operation-description(name=change-root-log-level)

Configuration

domain/configuration/domain.xml
domain/configuration/host.xml
standalone/configuration/standalone.xml

Déploiement

Le déploiement d'un .jar (connecteur JDBC) se fait comme un .war.

# déployer
[domain@localhost:9999 /] deploy ~/test-application.war
[domain@localhost:9999 /] deploy ~/test-application.war --all-server-groups

# lister les déploiements
[domain@localhost:9999 /] :read-children-names(child-type=deployment)

# retirer
[domain@localhost:9999 /] undeploy test-application.war --all-relevant-server-groups

Sources de données (datasources)

Lister les drivers installés :

[standalone@localhost:9999 /] /subsystem=datasources:installed-drivers-list

Un driver s'installe soit par module, soit par déploiement. Exemples de noms JNDI :

MySQL  : java:jboss/datasources/ExampleDS
Oracle : java:/jdbc/ExempleDS

Ajout par interface graphique : Profile → Connector → datasources → add.

Ajout par CLI :

# datasource
/subsystem=datasources/data-source="java:jboss/datasources/MySqlDS2":add(jndi-name="java:jboss/datasources/MySqlDS2",pool-name="MySqlPool",driver-name="mysql",connection-url="jdbc:mysql://localhost:3306/test",user-name="user")

# xa-datasource
/subsystem=datasources/xa-data-source="java:jboss/datasources/MySqlXADS2":add(jndi-name="java:jboss/datasources/MySqlXADS2",pool-name="MySQLXA_Pool2",enabled=true,xa-data-source-properties={"ServerName"=>"localhost","DatabaseName"=>"test","User"=>"user"},driver-name="mysql")

# tester la datasource
/subsystem=datasources/xa-data-source=java\:jboss\/datasources\/MySqlXADS2:test-connection-in-pool

Voir aussi

• Documentation officielle : https://docs.jboss.org/
• Tomcat
• Java