Chapitre 2. Gestion de serveur d'applications

2.1. Démarrer JBoss Enterprise Application Platform 6

2.1.1. Démarrer JBoss Enterprise Application Platform 6

Démarrer JBoss Enterprise Application Platform 6 d'une des manières suivantes :

2.1.2. Démarrez JBoss EAP 6 comme un serveur autonome

Résumé

Cette rubrique couvre toutes les étapes à couvrir pour démarrer JBoss Enterprise Application Platform 6 en tant que serveur autonome.

Procédure 2.1. Démarrer le Service de plate-forme comme serveur autonome.

  1. Dans Red Hat Enterprise Linux.

    Exécuter la commande suivante : EAP_HOME/bin/standalone.sh
  2. Dans Microsoft Windows Server

    Exécuter la commande suivante : EAP_HOME\bin\standalone.bat
  3. Option : indiquer les paramètres supplémentaires.

    Pour imprimer une liste de paramètres supplémentaires à passer aux scripts de démarrage, utiliser le paramètre -h.
Résultat

L'instance du serveur autonome JBoss EAP 6 démarre.

2.1.3. Démarrer JBoss Enterprise Application Platform 6 en tant que domaine géré

Procédure 2.2. Démarrer le Service de plate-forme comme serveur géré

  1. Dans Red Hat Enterprise Linux.

    Exécutez la commande : EAP_HOME/bin/domain.sh
  2. Dans Microsoft Windows Server

    Exécutez la commande : EAP_HOME\bin\domain.bat
  3. En option : passez des paramètres supplémentaires au script de démarrage.

    Pour obtenir une liste de paramètres que vous pourrez passer au script de démarrage, utilisez le paramètre -h.
Résultat

L'instance du serveur géré JBoss EAP 6 démarre.

2.1.4. Démarrer la plateforme Enterprise Application Platform avec une Configuration différente.

Si vous n'indiquez pas de fichier de configuration, le serveur démarrera avec le fichier par défaut. Malgré tout, quand vous démarrez le serveur, vous pouvez spécifier Configuration manuelle. Le processus varie légèrement, suivant que vous utilisez un Domaine géré ou un Serveur autonome, et suivant le système d'exploitation que vous utilisez.

Prérequis

  • Avant d'utiliser un fichier de configuration alternatif, préparez-le à l'aide de la configuration par défaut modèle. Pour un domaine géré, le fichier de configuration doit être placé dans EAP_HOME/domain/configuration/. Pour les Serveurs autonomes, le fichier de configuration devra être mis dans EAP_HOME/standalone/configuration/.

Note

Plusieurs exemples de configurations sont inclus dans les répertoires de configuration. Utiliser ces exemples pour activer des fonctionnalités supplémentaires, comme clustering ou l'API XTS de Transactions.

Procédure 2.3. Démarrage de l'instance par une configuration différente

  1. Domaine géré

    Pour un Domaine géré, fournir le nom du fichier de configuration comme option du paramètre --domain-config. Vous n'avez pas besoin de procurer le nom complet, si le fichier de configuration se trouve dans le répertoire EAP_HOME/domain/configuration/.

    Exemple 2.1. Utilisation d'un fichier de configuration alternatif pour un Domaine géré dans Red Hat Enterprise Linux

    [user@host bin]$ ./domain.sh --domain-config=domain-alternate.xml

    Exemple 2.2. Utilisation d'un fichier de configuration alternatif pour un Domaine géré dans un serveur Microsoft Windows

    C:\EAP_HOME\bin> domain.bat --domain-config=domain-alternate.xml
  2. Serveur autonome

    Pour un Domaine autonome, fournir le nom du fichier de configuration comme option du paramètre --server-config. Vous n'avez pas besoin de procurer le nom complet, si le fichier de configuration se trouve dans le répertoire EAP_HOME/standalone/configuration/.

    Exemple 2.3. Utiliser un fichier de configuration alternatif pour un Serveur autonome Red Hat Enterprise Linux.

    [user@host bin]$ ./standalone.sh --server-config=standalone-alternate.xml

    Exemple 2.4. Utiliser un fichier de configuration alternatif pour un Serveur autonome Microsoft Windows.

    C:\EAP_HOME\bin> standalone.bat --server-config=standalone-alternate.xml
Résultat

La plateforme Enterprise Application Platform est maintenant en cours d'exécution, avec une configuration différente.

2.1.5. Stopper JBoss Enterprise Application Platform 6

La façon dont vous arrêtez la plate-forme JBoss Enterprise Application Platform 6 dépend de la façon dont elle a été lancée. Cette tâche couvre l'arrêt d'une instance qui a démarré de manière interactive, faire cesser une instance qui a été démarrée par un service et faire cesser une instance qui a été mise en arrière-plan par un script.

Note

Cette tâche ne règle pas l'arrêt d'un serveur ou d'un groupe de serveurs dans un Domaine géré. Pour ces scénarios, voir Section 2.2.3, « Stopper un serveur qui utilise une Console de gestion ».

Procédure 2.4. Stopper une instance autonome de JBoss Enterprise Application Platform 6

  1. Stopper une instance qui a été démarrée de façon interactive à partir d'une invite de commande.

    Appuyez sur Ctrl-C dans le terminal où JBoss Enterprise Application Platform 6 exécute.
  2. Stopper une instance qui a démarré en tant que service de système d'exploitation.

    Suivant votre système d'exploitation, utiliser une des procédures suivantes :
    • Red Hat Enterprise Linux

      Dans Red Hat Enterprise Linux, si vous avez écrit un script de service, utiliser sa fonction stop. Cela devra être inscrit dans le script. Ensuite, vous pourrez utiliser service scriptname stop, avec scriptname comme nom de script.
    • Microsoft Windows Server

      Dans Microsoft Windows, utiliser la commande net service, ou bien faîtes cesser le service à partir de l'applet Services qui se trouve dans le Panneau de contrôle.
  3. Stopper une instance qui exécute en arrière-plan (Red Hat Enterprise Linux)

    1. Cherchez l'instance dans la liste de processus. Une option consiste à exécuter la commande ps aux |grep "[j]ava -server". Cela renverra un résultat pour chaque instance de JBoss Enterprise Application Platform 6 en cours d'exécution sur la machine locale.
    2. Envoyer au processus le signalTERM, en exécutant kill process_ID, avec process_ID comme numéro de deuxième champ de la commande ps aux ci-dessus.
Résultat

Chacune de ces solutions ferme la plate-forme JBoss Enterprise Application Platform 6 nettement, ce qui fait qu'aucune donnée n'est perdue.

2.1.6. Référence aux variables et arguments à passer à l'exécution du serveur

Le script de démarrage du serveur d'applications accepte l'ajout d'arguments et de variables en cours d'exécution. L'utilisation de ces paramètres permettent au serveur d'être démarré sous d'autres configurations que celles qui sont définies dans les fichiers de configuration standalone.xml, domain.xml et host.xml. Cela peut comprendre le démarrage du serveur par un ensemble de liaisons de sockets différent ou une configuration secondaire. Vous pourrez accéder à une liste des paramètres disponibles en passant la variable d'assistance au démarrage.

Exemple 2.5. 

L'exemple suivant ressemble au démarrage de serveur expliqué dans Section 2.1.2, « Démarrez JBoss EAP 6 comme un serveur autonome », avec les variables -h ou --help en plus. Le résultats de cette variable d'assistance sont expliqués dans le tableau ci-dessous.
[localhost bin]$ standalone.sh -h

Tableau 2.1. Tableau des arguments et variables du temps d'exécution

Argument ou Variable Description
--admin-only Définir le type d'exécution du serveur à ADMIN_ONLY. Cela le fera ouvrir les interfaces administratives et il pourra ainsi accepter les ordres de gestion, mais il ne pourra pas démarrer d'autres services de runtime ou accepter les demandes de l'utilisateur final.
-b=<value> Définir la propriété système jboss.bind.address à la valeur donnée.
-b <value> Définir la propriété système jboss.bind.address à la valeur donnée.
-b<interface>=<value> Définir la propriété système jboss.bind.address.<interface> à la valeur donnée.
-c=<config> Nommer le fichier de configuration du serveur à utiliser. La valeur par défaut est standalone.xml.
-c <config> Nommer le fichier de configuration du serveur à utiliser. La valeur par défaut est standalone.xml.
--debug [<port>] Activer 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>] Définir une propriété système.
-h Afficher le message d'assistance et sortir.
--help Afficher le message d'assistance et sortir.
-P=<url> Télécharger les propriétés système de l'URL donné.
-P <url> Télécharger les propriétés système de l'URL donné.
--properties=<url> Télécharger les propriétés système de l'URL donné.
-S<name>[=<value>] Définir une propriété de sécurité.
--server-config=<config> Nommer le fichier de configuration du serveur à utiliser. La valeur par défaut est standalone.xml.
-u=<value> Définir la propriété système jboss.default.multicast.address à la valeur donnée.
-u <value> Définir la propriété système jboss.default.multicast.address à la valeur donnée.
-V Afficher la version du serveur d'application et sortir.
-v Afficher la version du serveur d'application et sortir.
--version Afficher la version du serveur d'application et sortir.