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.
Argument ou Option | Mode d'opération | Description |
---|---|---|
--admin-only |
Autonome |
Définir le type d'exécution du serveur à |
--admin-only |
Domaine |
Définir le type d'exécution du contrôleur hôte à |
-b=<value>, -b <value> |
Autonome, Serveur |
Définir la propriété de système |
-b<interface>=<value> |
Autonome, Serveur |
Définir la propriété système |
--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 |
-c=<config>, -c <config> |
Domaine |
Nommer le fichier de configuration du serveur à utiliser. La valeur par défaut est |
--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 |
-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 |
--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 |
--master-port=<port> |
Domaine |
Définit la propriété système |
--read-only-server-config=<config> |
Autonome |
Nom du fichier de configuration du serveur à utiliser. Cela diffère de |
--read-only-domain-config=<config> |
Domaine |
Nom du fichier de configuration du domaine à utiliser. Cela diffère de |
--read-only-host-config=<config> |
Domaine |
Nom du fichier de configuration de l'hôte à utiliser. Cela diffère de |
-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 |
-u=<value>, -u <value> |
Autonome, Serveur |
Définir la propriété système |
-v, -V, --version |
Autonome, Serveur |
Affiche la version du serveur d'applications et sort. |
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.
Argument de ligne de commande | Description |
---|---|
-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 |
-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 |
-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 |
-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 |
-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 |
-s, --silent |
Exécuter le script |
-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 |
A.3. Attributs d'interface
Élément d'interface | Description |
---|---|
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 ( |
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
Attribut | Description |
---|---|
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 |
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
Nom | Port | Port multi-diffusion | Description | Groupes 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 |