Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

Annexe A. Matériel de référence

A.1. Arguments de temps d'exécution du serveur

Le script de démarrage du serveur d'applications accepte les arguments et s'active lors du runtime. Cela permet au serveur de démarrer dans une configuration autre que celle définie dans les fichiers de configuration standalone.xml, domain.xml et host.xml.

Les configurations alternatives peuvent signifier de démarrer le serveur avec un ensemble de liaisons de sockets alternatif ou une configuration secondaire.

La liste des paramètres disponibles est accessible en exécutant l'aide avec l'option -h ou --help lors du démarrage.

Tableau A.1. Arguments et options de Runtime

Argument ou OptionMode d'opérationDescription

--admin-only

Autonome

Définir le type d'exécution du serveur à ADMIN_ONLY. Cela le fera ouvrir les interfaces administratives et il pourra ainsi accepter les requêtes de gestion, mais il ne pourra pas démarrer d'autres services de runtime ou accepter des requêtes de la part de l'utilisateur final.

--admin-only

Domaine

Définir le type d'exécution du contrôleur hôte à ADMIN_ONLY, ce qui le fera ouvrir les interfaces administratives et il pourra ainsi accepter les requêtes de gestion, mais il ne pourra pas démarrer d'autres serveurs ou, si ce contrôleur hôte est le master du domaine, il pourra accepter les requêtes des contrôleurs hôte esclaves.

-b=<value>, -b <value>

Autonome, Serveur

Définir la propriété de système jboss.bind.address, utilisée dans la configuration de l'adresse de liaison pour l'interface publique. La valeur par défaut est 127.0.0.1 si aucune valeur n'est spécifiée. Voir l'entrée -b<interface>=<value> pour définir l'adresse de liaison pour les autres interfaces.

-b<interface>=<value>

Autonome, Serveur

Définir la propriété système jboss.bind.address.<interface> à la valeur donnée. Par exemple, -bmanagement=IP_ADDRESS

--backup

Domaine

Conserver une copie de la configuration de domaine persistante même si cet hôte n'est pas le contrôleur de domaines.

-c=<config>, -c <config>

Autonome

Nommer le fichier de configuration du serveur à utiliser. La valeur par défaut est standalone.xml.

-c=<config>, -c <config>

Domaine

Nommer le fichier de configuration du serveur à utiliser. La valeur par défaut est domain.xml.

--cached-dc

Domaine

Si l'hôte n'est pas le contrôleur de domaine et ne peut pas contacter le contrôleur de domaine au démarrage, démarrer en utilisant une copie de la configuration de domaine mise en cache localement.

--debug [<port>]

Autonome

Active le mode de débogage par un argument en option qui indique le port. Ne fonctionne que si le script de lancement le supporte.

-D<name>[=<value>]

Autonome, Serveur

Définit une propriété système.

--domain-config=<config>

Domaine

Nommer le fichier de configuration du serveur à utiliser. La valeur par défaut est domain.xml.

-h, --help

Autonome, Serveur

Affiche le message d'assistance et sort.

--host-config=<config>

Domaine

Nom du fichier de configuration hôte à utiliser. La valeur par défaut est host.xml.

--interprocess-hc-address=<address>

Domaine

Adresse à laquelle le contrôleur hôte doit écouter la communication en provenance du contrôleur de processus.

--interprocess-hc-port=<port>

Domaine

Port sur lequel le contrôleur hôte doit écouter la communication en provenance du contrôleur de processus.

--master-address=<address>

Domaine

Définit la propriété système jboss.domain.master.address à la valeur donnée. Dans une configuration de contrôleur hôte esclave par défaut, cette valeur est utilisée pour configurer l'adresse du contrôleur hôte maître.

--master-port=<port>

Domaine

Définit la propriété système jboss.domain.master.port à la valeur donnée. Dans une configuration de contrôleur hôte esclave par défaut, cette valeur est utilisée pour configurer le port utilisé pour la communication de gestion native du contrôleur hôte maître.

--read-only-server-config=<config>

Autonome

Nom du fichier de configuration du serveur à utiliser. Cela diffère de --server-config et -c en ce que le fichier d'origine n'est jamais écrasé.

--read-only-domain-config=<config>

Domaine

Nom du fichier de configuration du domaine à utiliser. Cela diffère de --domain-config et de -c en ce que le fichier de départ n'est jamais écrasé.

--read-only-host-config=<config>

Domaine

Nom du fichier de configuration de l'hôte à utiliser. Cela diffère de --host-config en ce que le fichier de départ n'est jamais écrasé.

-P=<url>, -P <url>, --properties=<url>

Autonome, Serveur

Télécharge les propriétés système de l'URL donné.

--pc-address=<address>

Domaine

Adresse à laquelle le contrôleur de processus doit écouter les communications en provenance des processus qu'il contrôle.

--pc-port=<port>

Domaine

Port sur lequel le contrôleur de processus doit écouter les communications en provenance des processus qu'il contrôle.

-S<name>[=<value>]

Autonome

Définit une propriété de sécurité.

-secmgr

Autonome, Serveur

Exécute le serveur avec un gestionnaire de sécurité installé.

--server-config=<config>

Autonome

Nommer le fichier de configuration du serveur à utiliser. La valeur par défaut est standalone.xml.

-u=<value>, -u <value>

Autonome, Serveur

Définir la propriété système jboss.default.multicast.address utilisée pour configurer l'adresse multidiffusion des éléments de liaison de socket dans les fichiers de configuration. La valeur par défaut est 230.0.0.4 si aucune valeur n'est spécifiée.

-v, -V, --version

Autonome, Serveur

Affiche la version du serveur d'applications et sort.

Avertissement

Les fichiers de configuration compris dans JBoss EAP sont configurés pour gérer les comportements des options (-b, -u). Si vous modifiez vos fichiers de configuration afin de ne plus utiliser la propriété système contrôlée par l'option, son ajout à la commande de lancement sera alors sans effet.

A.2. Arguments de l'utilitaire Add-User

Le tableau suivant décrit les arguments disponibles pour le script add-user.sh ou add-user.bat, un utilitaire pour ajouter de nouveaux utilisateurs au fichier de propriété pour une authentification non courante.

Tableau A.2. Arguments pour la commande Add-User

Argument de ligne de commandeDescription

-a

Cet argument demande de créer un utilisateur dans le domaine de l'application. S'il est omis, un utilisateur sera créé par défaut dans le domaine de gestion.

-dc <value>

Cet argument spécifie le répertoire de configuration de domaine qui contient les fichiers de propriétés. S'il est omis, le répertoire par défaut sera EAP_HOME/domain/configuration/.

-sc <value>

Cet argument spécifie un répertoire de configuration de serveur autonome différent qui contient les fichiers de propriétés. S'il est omis, le répertoire par défaut sera EAP_HOME/standalone/configuration/.

-up, --user-properties <value>

Cet argument spécifie le nom d'un autre fichier de propriétés utilisateur. Il peut correspondre à un chemin absolu ou il peut correspondre à un nom de fichier utilisé en conjonction avec l'argument -sc ou -dc qui spécifie le répertoire de configuration alternatif.

-g, --group <value>

Une liste séparée par des virgules de groupes à assigner à cet utilisateur.

-gp, --group-properties <value>

Cet argument spécifie le nom d'un autre fichier de propriétés de groupe. Il peut correspondre à un chemin absolu ou il peut correspondre à un nom de fichier utilisé en conjonction avec l'argument -sc ou -dc qui spécifie le répertoire de configuration alternatif.

-p, --password <value>

Mot de passe associé à l'utilisateur.

-u, --user <value>

Le nom de l'utilisateur. Seuls les caractères alphanumériques et les symboles suivants sont valides : ,./=@\.

-r, --realm <value>

Le nom du domaine utilisé pour sécuriser les interfaces de gestion. S'il est omis, la valeur par défaut sera ManagementRealm.

-s, --silent

Exécuter le script add-user sans sortie vers la console.

-e, --enable

Active l'utilisateur.

-d, --disable

Désactive l'utilisateur.

-cw, --confirm-warning

Confirme les avertissements automatiquement en mode interactif.

-h, --help

Affiche les informations d'utilisation du script add-user.

A.3. Attributs d'interface

Tableau A.3. Attributs et valeurs d'interface

Élément d'interfaceDescription

any

Élément indiquant qu'une partie du critère de sélection d'une interface doit être qu'elle remplisse au moins un, mais pas forcément tous, les groupes de critères imbriqués.

any-address

Élément vide indiquant que les sockets qui utilisent cette interface doivent être liés à une adresse générique. L'adresse générique IPv6 (::) sera utilisée à moins que la propriété système java.net.preferIPv4Stack soit définie sur true, dans lequel cas, l'adresse générique (0.0.0.0) IPv4 sera utilisée. Si un socket est lié à une adresse anylocal IPv6 sur une machine dual-stack, il pourra accepter le trafic IPv6 et IPv4 ; si lié à l'adresse IPv4 anylocal (mappées IPv4), il ne peut accepter que le trafic IPv4.

inet-address

Soit une adresse IP en notation à points IPV6 ou IPV4, ou un nom d'hôte pouvant être résolu.

link-local-address

Élément vide indiquant qu'une partie du critère de sélection d'une interface devrait consister à savoir si oui ou non il a une adresse associée local-link.

loopback

Élément vide indiquant qu'une partie du critère de sélection d'une interface est de savoir s'il s'agit oui ou non d'une interface de loopback.

loopback-address

Une adresse de loopback qui ne peut pas réellement être configurée sur l'interface de loopback de la machine. Diffère du type d'adresse inet car la valeur donnée sera utilisée même si aucune carte réseau possédant l'adresse IP associée ne peut être trouvée.

multicast

Élément vide indiquant qu'une partie du critère de sélection d'une interface doit être si oui ou non il y a un support multi-diffusion.

nic

Le nom d'une interface de réseau (e.g. eth0, eth1, lo).

nic-match

Une expression standard à laquelle faire correspondre les noms des interfaces de réseau disponibles sur la machine pour trouver une interface qui convienne.

not

Élément indiquant qu'une partie du critère de sélection d'une interface doit être qu'elle ne remplisse aucun des ensembles de critères imbriqués.

point-to-point

Élément vide indiquant qu'une partie du critère de sélection d'une interface doit être de savoir si elle a oui ou non une interface d'un point à un autre.

public-address

Élément vide indiquant qu'une partie du critère de sélection d'une interface doit être de savoir si elle a oui ou non une adresse publiquement routable.

site-local-address

Élément vide indiquant qu'une partie du critère de sélection d'une interface doit être ou non une adresse associée à son site-local

subnet-match

Une adresse IP réseau et le nombre de bits dans le préfixe de réseau de l'adresse, sous la forme slash notation (e.g. 192.168.0.0/16).

up

Élément vide indiquant qu'une partie du critère de sélection d'une interface est active ou non.

virtual

Élément vide indiquant qu'une partie du critère de sélection d'une interface doit être ou non une interface virtuelle.

A.4. Attributs de liaisons de sockets

Tableau A.4. Attributs de liaisons de sockets

AttributDescription

client-mappings

Spécifie les mappages de client pour cette liaison de socket. Un client qui se connecte à ce socket doit utiliser l'adresse de destination indiquée dans le mappage qui correspond à son interface de sortie désirée. Cela permet aux topologies de réseau avancées, qui utilisent une traduction d'adresses réseau ou qui ont des liaisons sur plusieurs interfaces de réseau, de fonctionner. Chaque mappage doit être évalué dans l'ordre déclaré, avec la première correspondance trouvée utilisée pour déterminer la destination.

fixed-port

Indique si la valeur de port doit rester fixe quand les décallages numériques sont appliqués aux autres sockets du groupe de sockets.

interface

Nom de l'interface à laquelle le socket doit être lié, ou, pour les sockets de multidiffusion, l'interface sur laquelle écouter. Cela doit correspondre à l'une des interfaces déclarées. Si non définie, la valeur de l'attribut d'interface par défaut du groupe de liaison de sockets englobant sera utilisée.

multicast-address

Adresse multidiffusion sur laquelle le socket doit recevoir le trafic multidiffusion. Si non spécifié, le socket ne sera pas configuré pour recevoir le trafic multidiffusion.

multicast-port

Port sur lequel le socket doit recevoir le trafic multidiffusion. Doit être configuré si l'adresse multidiffusion est configurée.

name

Le nom du socket. Les services ayant besoin d'accéder aux informations de configuration de socket pourront le faire par l'intermédiaire de son nom. Cet attribut est exigé.

port

Le numéro du port dans lequel le socket doit être lié. Notez que cette valeur peut être remplacée si les serveurs appliquent une valeur de décalage de port pour incrémenter ou décrémenter toutes les valeurs de port.

A.5. Liaisons de socket par défaut

Tableau A.5. Liaisons de socket par défaut

NomPortPort multi-diffusionDescriptionGroupes de liaisons de sockets

ajp

8009

 

Protocole Apache JServ. Utilisé pour le clustering HTTP et pour l'équilibrage des charges.

standard-sockets, ha-sockets, full-sockets, full-ha-sockets

http

8080

 

Le port par défaut des applications déployées.

standard-sockets, ha-sockets, full-sockets, full-ha-sockets

https

8443

 

Connexion cryptée-SSL entre les applications déployées et les clients.

standard-sockets, ha-sockets, full-sockets, full-ha-sockets

iiop

3528

 

Services CORBA pour les transactions JTS et autres services dépendants-ORB.

full-sockets, full-ha-sockets

iiop-ssl

3529

 

Services CORBA cryptés-SSL.

full-sockets, full-ha-sockets

jgroups-mping

 

45700

Multidiffusion. Utilisée pour découvrir l'appartenance de groupe d'origine dans un cluster HA.

ha-sockets, full-ha-sockets

jgroups-tcp

7600

 

Découverte d'homoplogues unicastes dans les groupements HA avec TCP.

ha-sockets, full-ha-sockets

jgroups-tcp-fd

57600

 

Utilisé pour la détection des échecs en TCP.

ha-sockets, full-ha-sockets

jgroups-udp

55200

45688

Découverte de paires multicast dans les groupements HA avec UDP.

ha-sockets, full-ha-sockets

jgroups-udp-fd

54200

 

Utilisé pour la détection des échecs par UDP.

ha-sockets, full-ha-sockets

management-http

9990

 

Utilisé pour les communications HTTP avec la couche de gestion.

standard-sockets, ha-sockets, full-sockets, full-ha-sockets

management-https

9993

 

Utilisé pour les communications HTTPS avec la couche de gestion.

standard-sockets, ha-sockets, full-sockets, full-ha-sockets

modcluster

 

23364

Port de multidiffusion pour la communication entre JBoss EAP 6 et l'équilibreur de charges HTTP.

ha-sockets, full-ha-sockets

txn-recovery-environment

4712

 

Gestionnaire de recouvrement des transactions JTA.

standard-sockets, ha-sockets, full-sockets, full-ha-sockets

txn-status-manager

4713

 

Gestionnaire des transactions JTA / JTS.

standard-sockets, ha-sockets, full-sockets, full-ha-sockets