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.

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.

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

1. Serveur autonome

   Pour un domaine autonome, fournir le nom du fichier de configuration comme option du paramètre --server-config. Le fichier de configuration doit se trouver dans le répertoire EAP_HOME/standalone/configuration/, et vous devez indiquer le chemin d'accès du fichier de ce répertoire.

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

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

   Cet exemple utilise le fichier de configuration EAP_HOME/standalone/configuration/standalone-alternate.xml.

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

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

   Cet exemple utilise le fichier de configuration EAP_HOME/standalone/configuration/standalone-alternate.xml.

2. Domaine géré

   Pour un domaine géré, fournir le nom du fichier de configuration comme option du paramètre --domain-config. Le fichier de configuration se trouve dans le répertoire EAP_HOME/domain/configuration/, et vous devez indiquer le chemin d'accès de ce répertoire.

   Exemple 2.3. 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

   Cet exemple utilise le fichier de configuration EAP_HOME/domain/configuration/domain-alternate.xml.

   Exemple 2.4. 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 
   
   

   Cet exemple utilise le fichier de configuration EAP_HOME\domain\configuration\domain-alternate.xml.

Procédure 2.4. Stopper une instance autonome de JBoss EAP 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 EAP 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 faites 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 EAP 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.

Procédure 2.5. Démarrer le serveur

1. Naviguer dans Server Instances dans la Console de gestion

   1. Sélectionner l'onglet Runtime en haut de la console.

2. Sélectionner un serveur

   À partir de la liste Server Instances, sélectionner le serveur que vous souhaitez démarrer. Les serveurs qui sont en cours d'exécution sont indiqués.
   En plaçant le curseur sur une instance de cette liste, vous verrez vos options en bleu sous Détails du serveur.

3. Cliquer sur le bouton Start

   Pour démarrer une instance, cliquer sur Start Server quand vous verrez ce texte. Une boîte de dialogue de confirmation va s'ouvrir. Cliquer sur le bouton Confirm pour démarrer le serveur.

Procédure 2.6. Stopper un serveur qui utilise une Console de gestion

1. Naviguez dans Hôtes, groupes et instances de serveur dans la Console de gestion

   1. Sélectionner l'onglet Runtime en haut de la console. Les instances de serveur disponibles seront affichées sur le tableau général de l'onglet Topologie.

2. Sélectionner un serveur

   À partir de la liste Server Instances, sélectionner le serveur que vous souhaitez stopper. Les serveurs qui sont en cours d'exécution sont indiqués.

3. Cliquer sur le texte Stop Server.

   Cliquer sur le texte Stop Server qui apparaît quand vous bougez la souris sur l'entrée serveur. Une boîte de dialogue de confirmation apparaîtra.
4. Cliquer sur le bouton Confirm pour arrêter le serveur.

1. Identifier la version de sauvegarde que vous souhaitez démarrer. Cet exemple va rappeler l'instance de modèle de serveur qui précédait la première modification qui a lieu suite à un démarrage réussi.

   EAP_HOME/configuration/standalone_xml_history/current/standalone.v1.xml 

2. Démarrer le serveur par cette configuration du modèle de sauvegarde en passant le nom de fichier relatif sous jboss.server.config.dir.

   EAP_HOME/bin/standalone.sh --server-config=standalone_xml_history/current/standalone.v1.xml 

Procédure 2.7. Télécharger un Snapshot de configuration et Sauvegardez-le

• Sauvegarde d'un snapshot

  Exécuter l'opération take-snapshot pour acquérir une copie de la configuration du serveur.

  [standalone@localhost:9999 /] :take-snapshot
  {
      "outcome" => "success",
      "result" => "/home/User/EAP_HOME/standalone/configuration/standalone_xml_history/snapshot/20110630-172258657standalone.xml"
  

Procédure 2.8. Télécharger un snapshot de configuration

1. Identifier le snapshot à télécharger. Cet exemple va rappeler le fichier suivant du répertoire de snapshots. Le chemin par défaut des fichiers de snapshot est le suivant.

   EAP_HOME/standalone/configuration/standalone_xml_history/snapshot/20110812-191301472standalone.xml

   Les snapshots sont exprimés par leurs chemins relatifs, selon lesquels l'exemple ci-dessus peut être écrit ainsi.

   jboss.server.config.dir/standalone_xml_history/snapshot/20110812-191301472standalone.xml

2. Démarrer le serveur par le snapshot de configuration sélectionné en passant le nom du fichier.

   EAP_HOME/bin/standalone.sh --server-config=standalone_xml_history/snapshot/20110913-164449522standalone.xml

Procédure 2.9. Supprimer un snapshot particulier

1. Identifier le snapshot à effacer. Cet exemple va effacer le fichier suivant du répertoire de snapshots.

   EAP_HOME/standalone/configuration/standalone_xml_history/snapshot/20110630-165714239standalone.xml

2. Exécuter la commande :delete-snapshot pour supprimer un snapshot particulier, en spécifiant le nom du snapshot comme dans l'exemple ci-dessous.

   [standalone@localhost:9999 /] :delete-snapshot(name="20110630-165714239standalone.xml")
   {"outcome" => "success"}
   

Procédure 2.10. Supprimer tous les snapshots

• Exécuter la commande :delete-snapshot(name="all") pour supprimer tous les snapshots comme dans l'exemple ci-dessous.

  [standalone@localhost:9999 /] :delete-snapshot(name="all")
  {"outcome" => "success"}
  

Procédure 2.11. Lister tous les snapshots de configuration

• Lister tous les snapshots

  Lister tous les snapshots sauvegardés en exécutant la commande :list-snapshots.

  [standalone@localhost:9999 /] :list-snapshots
  {
      "outcome" => "success",
      "result" => {
          "directory" => "/home/hostname/EAP_HOME/standalone/configuration/standalone_xml_history/snapshot",
          "names" => [
              "20110818-133719699standalone.xml",
              "20110809-141225039standalone.xml",
              "20110802-152010683standalone.xml",
              "20110808-161118457standalone.xml",
              "20110912-151949212standalone.xml",
              "20110804-162951670standalone.xml"
          ]
      }
  }
  

Procédure 3.1. Se conncecter à la console de gestion

1. Naviguer vers la page de démarrage de la console de gestion

   Naviguer vers la console de gestion. L'emplacement par défaut est http://localhost:9990/console/, où le port 9990 est prédéfini comme liaison de socket de console de gestion.

2. Se conncecter à la console de gestion

   Saisir le nom d'utilisateur et le mot de passe du compte que vous avez déjà créé pour vous connecter à l'écran de connexion de la console de gestion.
   

   Figure 3.1. Écran de connexion de la console de gestion

Procédure 3.2. Changer la Langue de la Console de management basée-web

1. Connectez-vous à la Console de management.

   Connectez-vous à la Console de management basée web.

2. Ouvrir le dialogue de configuration.

   Dans le coin gauche de l'écran, il y a une étiquette Settings de configuration. Cliquer sur cette étiquette pour ouvrir les paramètres de configuration de la Console de management.

3. Sélectionner la langue désirée.

   Sélectionner la langue désirée à partir de la case Locale. Puis sélectionner Save. Une autre case explicative vous demande de charger à nouveau l'application. Cliquer sur Confirm. Réactualiser votre navigateur pour pouvoir utiliser les nouveaux paramètres régionaux (Locale).

Procédure 3.3. Configurer le Serveur

1. Naviguer dans le panneau Server Configurations qui se trouve dans la Console de gestion

   1. Sélectionner l'onglet Hosts en haut de la console. Les instances de serveur disponibles s'afficheront sur un tableau.

2. Modifier la configuration du serveur

   1. Sélectionner l'instance de serveur à partir du tableau Available Server Configurations.
   2. Sélectionner le bouton Edit qui se trouve en dessous de la liste de serveurs.
   3. Procédez avec les changements des attributs de configuration.
   4. Sélectionnez le bouton Save qui se trouve en dessous de la liste du serveurs.

Procédure 3.4. Ajouter et vérifier un déploiement

1. Naviguez dans le panneau Manage Deployments de la Console de gestion.

   1. Sélectionner l'onglet Runtime en haut de la console.
   2. Pour un serveur autonome, il vous faudra étendre l'élément de menu Server qui se trouve à gauche de la console et sélectionner Manage Deployments. Pour un domaine géré, étendre l'élément de menu Domain qui se trouve à gauche de la console, et sélectionner Manage Deployments.
   Le panneau Manage Deployments apparaît.

2. Ajouter le contenu du déploiement.

   Sélectionner le bouton Add dans l'onglet Content Repository. Une boîte de dialogue Create Deployment apparaîtra.

3. Choisissez un fichier à déployer

   Dans la boîte de dialogue, sélectionner le bouton Browse. Cherchez le fichier que vous souhaitez déployer, et sélectionnez-le en vue de son chargement. Sélectionner le bouton Next pour continuer une fois que le fichier a été sélectionné.

4. Vérifier les noms de déploiement

   Vérifier le nom du déploiement et le nom du runtime qui apparaît dans la boîte de dialogue Create Deployments. Sélectionner le bouton Save pour charger le fichier une fois que les noms auront été vérifiés.

Procédure 3.5. Créer une nouvelle configuration de serveur

1. Naviguez sur la page Server Configuration qui se trouve dans la Console de management

   Sélectionnez l'onglet Server qui se trouve en haut et à droite de la console.

2. Créer une nouvelle configuration

   1. Sélectionner le bouton Add qui se trouve en haut du panneau Server Configuration.
   2. Modifier les paramètres de base du serveur dans la boîte de dialogue Create Server Configuration.
   3. Cliquez sur le bouton Save pour enregistrer la nouvelle configuration de votre serveur.

Procédure 3.6. Modifier les niveaux de journalisation

1. Naviguez dans le panneau Logging de la Console de gestion.

   1. Si vous travaillez dans un domaine géré, sélectionner l'onglet Profiles en haut de la console, puis, sélectionnez le profil qui convient dans la liste déroulante à gauche de la console.
   2. Pour une domaine géré ou un serveur autonome, sélectionner Core → Logging à partir du menu qui se trouve à gauche de la console et cliquer sur Logging.
   3. Cliquer sur l'onglet Log Categories en haut de la console.

2. Modifier les informations du créateur du journal

   Modifer les informations des entrées du tableau Log Categories.
   1. Sélectionner une entrée dans le tableau Log Categories, puis sélectionner le bouton Edit dans la section Details ci-dessous.
   2. Définir le niveau de journalisation de la catégorie dans la zone déroulante Log Level. Sélectionner le bouton Save quand c'est fait.

Procédure 3.7. Configurer et Ajouter un groupe de serveurs

1. Rendez-vous dans la vue Server Groups

   Sélectionner l'onglet Hosts en haut et à droite.
2. Sélectionner l'onglet Server Groups dans le menu Server dans la colonne de gauche.

3. Ajouter un groupe de serveurs

   Cliquer sur le bouton Add pour ajouter un nouveau groupe de serveurs.

4. Configurer le groupe de serveurs

   1. Saisir un nom pour le groupe de serveurs
   2. Sélectionner le profil dans lequel vous souhaitez ajouter le groupe de serveurs.
   3. Sélectionner la liaison de socket dans laquelle vous souhaitez ajouter le groupe de serveurs.
   4. Sélectionner le bouton Save pour sauvegarder le nouveau groupe.

Procédure 3.8. Lancement du CLI dans Linux ou Windows

• • Lancement du CLI dans Linux

    Exécutez le fichier EAP_HOME/bin/jboss-cli.sh en saisissant ce qui suit dans la ligne de commande :

    $ EAP_HOME/bin/jboss-cli.sh

  • Lancement du CLI dans Windows

    Exécutez le fichier EAP_HOME/bin/jboss-cli.bat en cliquant deux fois, ou en saisissant ce qui suit dans la ligne de commande :

    C:\>EAP_HOME\bin\jboss-cli.bat

Procédure 3.9. Quitter le Management CLI

• Exécutez la commande quit

  Avec le Management CLI, saisir la commande quit :

  [domain@localhost:9999 /] quit
  Closed connection to localhost:9999

Procédure 3.10. Se connecter à une instance de serveur gérée

• Exécutez la commande connect

  Avec Management CLI, saisir la commande connect :

  [disconnected /] connect
  Connected to domain controller at localhost:9999

  • Sinon, pour vous connecter à un serveur géré quand on démarre le Management CLI sur le système Linux, utiliser le paramètre --connect :

    $ EAP_HOME/bin/jboss-cli.sh --connect

  • Le paramètre --connect peut être utilisé pour indiquer l'hôte et le port du serveur. Pour connecter l'adresse 192.168.0.1 à la valeur du port 9999 ce qui suit s'applique :

    $ EAP_HOME/bin/jboss-cli.sh --connect --controller=192.168.0.1:9999

Procédure 3.11. Aide au niveau options Générales et options Sensibles au contexte

1. Exécuter la commande help

   Avec le Management CLI, saisir la commande help :

   [standalone@localhost:9999 /] help

2. Obtenez de l'aide au niveau sensibilité du contexte

   Avec le Management CLI, saisir la commande étendue help -commands :

   [standalone@localhost:9999 /] help --commands

3. Pour plus d'informations sur une commande particulière, exécuter la commande help avec comme argument '--help'.

   [standalone@localhost:9999 /]  deploy --help 

Procédure 3.12. Commandes et opérations en mode par lot

1. Saisir un mode par lot

   Saisir le mode par lot par la commande batch.

   [standalone@localhost:9999 /] batch
   [standalone@localhost:9999 / #]

   Le mode par lot est indiqué par le signe (#) dans l'invite.

2. Ajouter les demandes opérationnelles au lot

   Une fois que vous serez en mode par lot, saisir les demandes opérationnelles comme d'habitude. Les demandes opérationnelles sont ajoutées au lot dans l'ordre de saisie.
   Voir Section 3.5.8, « Utiliser les opérations et les commandes du Management CLI » pour obtenir des informations sur la façon de formater les demandes opérationnelles.

3. Exécuter le lot

   Une fois que toute la séquence de demandes opérationnelles est saisie, exécuter le lot avec la commande run-batch.

   [standalone@localhost:9999 / #] run-batch
   The batch executed successfully.

   Voir Section 3.5.7, « Commandes CLI Mode Lot » pour obtenir une liste complète des commandes disponibles pour pouvoir travailler avec des lots.

4. Les commandes de lots sont stockées dans des fichiers externes

   Les commandes fréquemment exécutées peuvent être stockées dans un fichier texte externe et être chargées en passant le chemin d'accès complet au fichier comme argument à la commande batch ou exécutées directement en étant un argument à la commande run-batch.
   Vous pouvez créer un fichier de commande lot avec l'éditeur de texte. Chaque commande doit figurer sur une ligne par elle-même et la CLI doit être en mesure d'y accéder.
   La commande suivante chargera un fichier myscript.txt en mode lot. Toutes les commandes de ce fichier seront alors être prêtes à la modification ou à la suppression. De nouvelles commandes pourront être ajoutées. Les modifications effectuées au cours de cette session de lot ne persistera pas dans le fichiermyscript.txt.

   [standalone@localhost:9999 /] batch --file=myscript.txt

   Ce qui suit exécutera instantanément les commandes lot stockées dans le fichier myscript.txt

   [standalone@localhost:9999 /] run-batch --file=myscript.txt

Procédure 3.13. Créer, configurer et exécuter les requêtes

1. Construire la demande opérationnelle

   Les demandes opérationnelles facilitent une interaction de bas niveau dans le modèle de gestion. Il s'agit d'une façon contrôlée de modifier les configurations du serveur. Une demande opérationnelle se présente en trois parties :
   • une adresse, avec une barre oblique devant (/).
   • un nom d'opération, avec deux points (:).
   • un groupe optionnel de paramètres, entre parenthèses (()).

   1. Déterminer l'adresse

      La configuration est présentée sous forme de ressources auxquelles s'adresser et de façon hiérarchique. Chaque noeud de ressources procure un groupe différent d'opérations. Une adresse utilise la syntaxe suivante :

      /node-type=node-name

      • node-type correspond au type de noeud de ressource. Cela correspond à un nom d'élément dans la configuration XML.
      • node-name correspond au nom du nœud. Cela correspond à l'attribut nom de l'élément dans la configuration XML.
      • Séparer chaque niveau de l'arborescence de ressources par une barre oblique (/).
      Voir les fichiers de configuration XML pour déterminer l'adresse qui convient. Le fichier EAP_HOME/standalone/configuration/standalone.xml contient la configuration d'un serveur autonome et les fichiers EAP_HOME/domain/configuration/domain.xml et EAP_HOME/domain/configuration/host.xml contiennent la configuration d'un domaine géré.

      Exemple 3.3. Exemple d'adresses d'opérations

      Pour procéder à une opération dans le sous-système de journalisation, utiliser l'adresse suivante dans la demande opérationnelle :

      /subsystem=logging

      Pour effectuer une opération sur la source de données Java, utiliser l'adresse suivante dans la demande opérationnelle :

      /subsystem=datasources/data-source=java

   2. Déterminer l'opération

      Les opérations diffèrent avec chaque type de nœud de ressource. Une opération utilise la syntaxe suivante :

      :operation-name

      • operation-name correspond au nom de l'opération à demander.
      Utiliser l'opération read-operation-names sur une adresse de ressources d'un serveur autonome pour lister les opérations disponibles.

      Exemple 3.4. Opérations disponibles

      Pour énumérer toutes les opérations disponibles du sous-système de journalisation, saisir la requête suivante dans une serveur autonome :

      [standalone@localhost:9999 /] /subsystem=logging:read-operation-names
      {
          "outcome" => "success",
          "result" => [
              "add",
              "read-attribute",
              "read-children-names",
              "read-children-resources",
              "read-children-types",
              "read-operation-description",
              "read-operation-names",
              "read-resource",
              "read-resource-description",
              "remove",
              "undefine-attribute",
              "whoami",
              "write-attribute"
          ]
      }
      

   3. Déterminer un paramètre

      Chaque opération a sans doute besoin de paramètres différents.
      Les paramètres utilisent la syntaxe suivante :

      (parameter-name=parameter-value)

      • parameter-name correspond au nom du paramètre.
      • parameter-value correspond à la valeur du paramètre.
      • Les différents paramètres sont séparés par des virgules (,).
      Afin de déterminer les paramètres qui conviennent, exécutez la commande read-operation-description sur un nœud de ressource, en faisant passer le nom de l'opération en tant que paramètre. Voir Exemple 3.5, « Déterminer les paramètres des opérations » pour plus de détails.

      Exemple 3.5. Déterminer les paramètres des opérations

      Afin de déterminer les paramètres qui conviennent pour l'opération read-children-types sur le sous-système de journalisation, saisir la commande read-operation-description comme suit :

      [standalone@localhost:9999 /] /subsystem=logging:read-operation-description(name=read-children-types)
      {
          "outcome" => "success",
          "result" => {
              "operation-name" => "read-children-types",
              "description" => "Gets the type names of all the children under the selected resource",
              "reply-properties" => {
                  "type" => LIST,
                  "description" => "The children types",
                  "value-type" => STRING
              },
              "read-only" => true
          }
      }
      

2. Saisir toute la demande opérationnelle

   Une fois que l'adresse, l'opération et tous les paramètres auront été sélectionnés, saisir la demande opérationnelle complète.

   Exemple 3.6. Exemple de demande opérationnelle

   [standalone@localhost:9999 /] /subsystem=web/connector=http:read-resource(recursive=true)

Procédure 3.14. Affiche la valeur de runtime en cours pour un attribut sélectionné.

• Exécuter l'opération read-attribute

  À partir du Management CLI, utiliser l'opération read-attribute pour afficher la valeur d'un attribut de ressource. Pour plus d'informations sur les requêtes d'informations, voir le sujet Section 3.5.8, « Utiliser les opérations et les commandes du Management CLI ».

  [standalone@localhost:9999 /]:read-attribute(name=name-of-attribute)

Procédure 3.15. Affiche l'utilisateur qui est actif dans le Management CLI par l'opération whoami

• Exécuter l'opération whoami

  À partir du Management CLI, utiliser l'opération whoami pour afficher le compte utilisateur actif.

  [standalone@localhost:9999 /] :whoami

  L'exemple suivant utilise la commande whoami dans une instance de serveur autonome pour montrer que l'utilisateur actif est le username , et que l'utilisateur est assigné au domaine ManagementRealm.

  Exemple 3.8. Utiliser la commande whoami dans une instance autonome

  [standalone@localhost:9999 /]:whoami
  {
      "outcome" => "success",
      "result" => {"identity" => {
          "username" => "username",
          "realm" => "ManagementRealm"
      }}
  }
  
  

Procédure 3.16. Affiche les informations Système et Serveur dans le Management CLI

• Exécuter la commande version

  À partir du Management CLI, saisir la commande version :

  [domain@localhost:9999 /] version

Procédure 3.17. Éxécuter la commande de Management CLI suivante

• Exécuter l'opération read-operation-description

  À partir du Management CLI, utiliser read-operation-description pour afficher des informations sur l'opération. L'opération requiert des paramètres supplémentaires dans le format d'une paire clé-valeur pour indiquer quelle opération afficher. Pour plus d'informations sur les requêtes d'informations, voir le sujet Section 3.5.8, « Utiliser les opérations et les commandes du Management CLI ».

  [standalone@localhost:9999 /]:read-operation-description(name=name-of-operation)

Procédure 3.18. Éxécuter la commande de Management CLI suivante

• Exécuter l'opération read-operation-names

  À partir du Management CLI, utiliser l'opération read-operation-names pour afficher les noms des opérations disponibles. Pour plus d'informations sur les requêtes d'informations, voir le sujet Section 3.5.8, « Utiliser les opérations et les commandes du Management CLI ».

  [standalone@localhost:9999 /]:read-operation-names

Procédure 3.19. Éxécuter la commande de Management CLI suivante

1. Exécuter l'opération read-resource

   Avec le Management CLI, faites l'opération read-resource pour afficher les ressources disponibles.

   [standalone@localhost:9999 /]:read-resource

   L'exemple suivant vous montre comment il est possible d'utiliser l'opération read-resource dans une instance de serveur autonome pour exposer les informations de ressources générales. Les résultats ressemblent au fichier de configuration standalone.xml, qui affiche les ressources de système, les extensions, les interfaces et les sous-systèmes installés ou configurés pour l'instance du serveur. Ces résultats peuvent être interrogés directement.

   Exemple 3.11. Exécuter l'opération read-resource niveau racine

   [standalone@localhost:9999 /]:read-resource
   {
       "outcome" => "success",
       "result" => {
           "deployment" => undefined,
           "deployment-overlay" => undefined,
           "management-major-version" => 1,
           "management-micro-version" => 0,
           "management-minor-version" => 4,
           "name" => "longgrass",
           "namespaces" => [],
           "product-name" => "EAP",
           "product-version" => "6.1.0.GA",
           "release-codename" => "Janus",
           "release-version" => "7.2.0.Final-redhat-3",
           "schema-locations" => [],
           "system-property" => undefined,
           "core-service" => {
               "management" => undefined,
               "service-container" => undefined,
               "server-environment" => undefined,
               "platform-mbean" => undefined
           },
           "extension" => {
               "org.jboss.as.clustering.infinispan" => undefined,
               "org.jboss.as.connector" => undefined,
               "org.jboss.as.deployment-scanner" => undefined,
               "org.jboss.as.ee" => undefined,
               "org.jboss.as.ejb3" => undefined,
               "org.jboss.as.jaxrs" => undefined,
               "org.jboss.as.jdr" => undefined,
               "org.jboss.as.jmx" => undefined,
               "org.jboss.as.jpa" => undefined,
               "org.jboss.as.jsf" => undefined,
               "org.jboss.as.logging" => undefined,
               "org.jboss.as.mail" => undefined,
               "org.jboss.as.naming" => undefined,
               "org.jboss.as.pojo" => undefined,
               "org.jboss.as.remoting" => undefined,
               "org.jboss.as.sar" => undefined,
               "org.jboss.as.security" => undefined,
               "org.jboss.as.threads" => undefined,
               "org.jboss.as.transactions" => undefined,
               "org.jboss.as.web" => undefined,
               "org.jboss.as.webservices" => undefined,
               "org.jboss.as.weld" => undefined
           },
           "interface" => {
               "management" => undefined,
               "public" => undefined,
               "unsecure" => undefined
           },
           "path" => {
               "jboss.server.temp.dir" => undefined,
               "user.home" => undefined,
               "jboss.server.base.dir" => undefined,
               "java.home" => undefined,
               "user.dir" => undefined,
               "jboss.server.data.dir" => undefined,
               "jboss.home.dir" => undefined,
               "jboss.server.log.dir" => undefined,
               "jboss.server.config.dir" => undefined,
               "jboss.controller.temp.dir" => undefined
           },
           "socket-binding-group" => {"standard-sockets" => undefined},
           "subsystem" => {
               "logging" => undefined,
               "datasources" => undefined,
               "deployment-scanner" => undefined,
               "ee" => undefined,
               "ejb3" => undefined,
               "infinispan" => undefined,
               "jaxrs" => undefined,
               "jca" => undefined,
               "jdr" => undefined,
               "jmx" => undefined,
               "jpa" => undefined,
               "jsf" => undefined,
               "mail" => undefined,
               "naming" => undefined,
               "pojo" => undefined,
               "remoting" => undefined,
               "resource-adapters" => undefined,
               "sar" => undefined,
               "security" => undefined,
               "threads" => undefined,
               "transactions" => undefined,
               "web" => undefined,
               "webservices" => undefined,
               "weld" => undefined
           }
       }
   }
   
   

2. Exécuter l'opération read-resource pour un nœud enfant

   L'opération read-resource peut être exécutée pour chercher les nœuds enfants à partir de la racine. La structure de l'opération commence par définir le nœud à exposer, puis s'ajoute à l'opération pour exécuter à ses côtés.

   [standalone@localhost:9999 /]/subsystem=web/connector=http:read-resource

   Dans l'exemple suivant, on peut exposer des informations de ressources spécifiques sur un composant de sous-système en redirigeant l'opération read-resource vers un nœud de sous-système web particulier.

   Exemple 3.12. Exposer les ressources de nœud enfant à partir d'un nœud racine

   [standalone@localhost:9999 /] /subsystem=web/connector=http:read-resource                      
   {
       "outcome" => "success",
       "result" => {
           "configuration" => undefined,
           "enable-lookups" => false,
           "enabled" => true,
           "executor" => undefined,
           "max-connections" => undefined,
           "max-post-size" => 2097152,
           "max-save-post-size" => 4096,
           "name" => "http",
           "protocol" => "HTTP/1.1",
           "proxy-name" => undefined,
           "proxy-port" => undefined,
           "redirect-port" => 443,
           "scheme" => "http",
           "secure" => false,
           "socket-binding" => "http",
           "ssl" => undefined,
           "virtual-server" => undefined
       }
   }
   
   

   Les mêmes résultats sont possibles en utilisant la commande cd pour naviguer dans les nœuds enfants et en exécutant l'opération read-resource directement.

   Exemple 3.13. Exposer les ressources de nœud enfant en changeant de répertoire

   [standalone@localhost:9999 /] cd subsystem=web
   

   [standalone@localhost:9999 subsystem=web] cd connector=http
   

   [standalone@localhost:9999 connector=http] :read-resource
   {
       "outcome" => "success",
       "result" => {
           "configuration" => undefined,
           "enable-lookups" => false,
           "enabled" => true,
           "executor" => undefined,
           "max-connections" => undefined,
           "max-post-size" => 2097152,
           "max-save-post-size" => 4096,
           "name" => "http",
           "protocol" => "HTTP/1.1",
           "proxy-name" => undefined,
           "proxy-port" => undefined,
           "redirect-port" => 443,
           "scheme" => "http",
           "secure" => false,
           "socket-binding" => "http",
           "ssl" => undefined,
           "virtual-server" => undefined
       }
   }
   
   

3. Utiliser le paramètre récursif pour inclure des valeurs actives dans les résultats

   Le paramètre récursif peut être utilisé pour exposer les valeurs de tous les attributs, y compris les valeurs non persistantes, celles qui sont passées au démarrage, ou les autres attributs normalement actifs du modèle d'exécution.

   [standalone@localhost:9999 /]/interface=public:read-resource(include-runtime=true)

   Par rapport à l'exemple précédent, l'inclusion de la propriété de requête include-runtime expose des attributs actifs supplémentaires, comme des octets envoyés ou des octets reçus par le connecteur HTTP.

   Exemple 3.14. Exposer des valeurs actives et supplémentaires par le paramètre include-runtime

   [standalone@localhost:9999 /] /subsystem=web/connector=http:read-resource(include-runtime=true)
   {
       "outcome" => "success",
       "result" => {
           "any" => undefined,
           "any-address" => undefined,
           "any-ipv4-address" => undefined,
           "any-ipv6-address" => undefined,
           "inet-address" => expression "${jboss.bind.address:127.0.0.1}",
           "link-local-address" => undefined,
           "loopback" => undefined,
           "loopback-address" => undefined,
           "multicast" => undefined,
           "name" => "public",
           "nic" => undefined,
           "nic-match" => undefined,
           "not" => undefined,
           "point-to-point" => undefined,
           "public-address" => undefined,
           "resolved-address" => "127.0.0.1",
           "site-local-address" => undefined,
           "subnet-match" => undefined,
           "up" => undefined,
           "virtual" => undefined
       }
   }
   
   

Procédure 3.20. Éxécuter la commande de Management CLI suivante

1. Exécuter l'opération read-resource-description

   À partir du Management CLI, utiliser l'opération read-resource-description pour lire et afficher les noms des ressources disponibles. Pour plus d'informations sur les requêtes d'opérations, voir le sujet Section 3.5.8, « Utiliser les opérations et les commandes du Management CLI ».

   [standalone@localhost:9999 /]:read-resource-description

2. Utiliser les paramètres en option

   L'opération read-resource-description autorise l'utilisation de paramètres supplémentaires.
   1. Utiliser le paramètre operations pour inclure les descriptions des opérations de la ressource.

      [standalone@localhost:9999 /]:read-resource-description(operations=true)

   2. Utiliser le paramètre inherited pour inclure ou pour exclure des descriptions des opérations héritées de ressource. L'état par défaut est true.

      [standalone@localhost:9999 /]:read-resource-description(inherited=false)

   3. Utiliser le paramètre recursive pour inclure les descriptions récursives des ressources dépendantes.

      [standalone@localhost:9999 /]:read-resource-description(recursive=true)

   4. Utiliser le paramètre locale pour obtenir la description des ressources. Si « null », la locale régionale par défaut sera utilisée.

      [standalone@localhost:9999 /]:read-resource-description(locale=true)

Procédure 3.21. Charger à nouveau le serveur d'applications

• Exécuter l'opération reload

  À partir du Management CLI, utiliser l'opération reload pour fermer le serveur via l'appel de système System.exit(0). Pour plus d'informations sur les demandes d'opérations, voir le sujet Section 3.5.8, « Utiliser les opérations et les commandes du Management CLI ».

  [standalone@localhost:9999 /]:reload
  {"outcome" => "success"}
  

Procédure 3.22. Fermer le Serveur d'applications

• Exécuter l'opération shutdown

  • À partir du Management CLI, utiliser l'opération shutdown pour fermer le serveur via l'appel de système System.exit(0). Pour plus d'informations sur les requêtes d'opérations, voir le sujet Section 3.5.8, « Utiliser les opérations et les commandes du Management CLI ».
    • En mode autonome, utiliser la commande suivante :

      [standalone@localhost:9999 /]:shutdown

    • En mode domaine, utiliser la commande suivante avec le nom d'hôte qui convient :

      [domain@localhost:9999 /]/host=master:shutdown

  • Pour vous connecter à une instance CLI détachée et pour fermer le serveur, exécuter la commande suivante :

    jboss-cli.sh --connect command=:shutdown
    

  • Pour vous connecter à une instance CLI éloignée et pour fermer le serveur, exécuter la commande suivante :

    [disconnected /] connect IP_ADDRESS
    Connected to IP_ADDRESS:PORT_NUMBER
    [192.168.1.10:9999 /] :shutdown
    

    Remplacer l'IP_ADDRESS par l'adresse IP de votre instance.

Procédure 3.23. Configurer un attribut de ressource à l'aide du Management CLI

• Exécuter l'opérationwrite-attribute

  À partir du Management CLI, utiliser l'opération write-attribute pour modifier la valeur d'un attribut de ressource. L'opération peut être exécutée dans le nœud dépendant de la ressource, ou bien dans le nœud root du Management CLI où le chemin de ressource complet est spécifié.

Procédure 3.24. Afficher l'Historique de commandes à l'aide du Management CLI.

• Exécuter la commande history

  À partir du Management CLI, saisir la commande history :

  [standalone@localhost:9999 /] history

Procédure 3.25. Effacer l'Historique de commandes à l'aide du Management CLI.

• Exécuter la commande history --clear

  À partir du Management CLI, saisir la commande version :

  [standalone@localhost:9999 /] history --clear

Procédure 3.26. Désactiver l'Historique de commandes à l'aide du Management CLI.

• Exécuter la commande history --disable

  À partir du Management CLI, saisir la commande history --disable :

  [standalone@localhost:9999 /] history --disable

Procédure 3.27. Activer l'Historique de commandes à l'aide du Management CLI.

• Exécuter la commande history --enable

  À partir du Management CLI, saisir la commande history --enable :

  [standalone@localhost:9999 /] history --enable

Procédure 3.28. Activer la Journalisation sur un Serveur Syslog

1. Créer un Gestionnaire Syslog nommé msyslog

   [standalone@localhost:9999 /]batch
   [standalone@localhost:9999 /]/core-service=management/access=audit/syslog-handler=mysyslog:add(formatter=json-formatter)
   [standalone@localhost:9999 /]/core-service=management/access=audit/syslog-handler=mysyslog/protocol=udp:add(host=localhost,port=514)
   [standalone@localhost:9999 /]run-batch

2. Ajouter une référence au Gestionnaire Syslog.

   [standalone@localhost:9999 /]/core-service=management/access=audit/logger=audit-log/handler=mysyslog:add

Procédure 4.1. Créer l'utilisateur administratif d'origine pour les interfaces de gestion distantes

1. Invoquer le script add-user.sh ou add-user.bat script.

   Passez au répertoire EAP_HOME/bin/. Invoquer le script qui convient à votre système d'exploitation.

   Red Hat Enterprise Linux

   [user@host bin]$ ./add-user.sh

   Microsoft Windows Server

   C:\bin>  add-user.bat

2. Choisissez d'utiliser un utilisateur Management.

   Appuyer sur ENTER pour sélectionner l'option a pour ajouter un utilisateur Management. Cet utilisateur sera ajouté au domaine ManagementRealm et il sera autorisé à effectuer des opérations de gestion par la Management Console basée web ou par le Management CLI basé sur la ligne de commande. Autre alternative, b, ajoutera l'utilisateur au domaine ApplicationRealm, et ne fournit aucune permission particulière. Ce domaine est fourni pour être utilisé avec des applications.

3. Saisir le nom d'utilisateur et le mot de passe que vous souhaitez.

   Quand on vous y invite, saisir le nom d'utilisateur et le nom de passe. On vous demandera de saisir le mot de passe une seconde fois pour confirmer.

4. Saisissez les informations sur votre groupe.

   Ajouter le groupe ou les groupes auxquels l'utilisateur appartient. Si l'utilisateur appartient à plusieurs groupes, saisir une liste séparée par des virgules. Laisser vide s'il n'y a pas de groupes pour l'utilisateur.

5. Vérifier les informations et confirmer.

   On vous invitera à confirmer les informations. Quand vous serez satisfait, saisir yes.

6. Décidez si l'utilisateur représente une instance de serveur de JBoss EAP 6 à distance.

   En plus des administrateurs, un autre type d'utilisateur qui a parfois besoin d'être ajouté à JBoss EAP 6 dans le domaine ManagementRealm est un utilisateur qui représente une autre instance de JBoss EAP 6, et qui a besoin d'être authentifié pour rejoindre un groupement en tant que membre. L'invite suivante vous permet de désigner votre utilisateur supplémentaire dans ce but. Si vous sélectionnez yes, on vous donnera une valeur secret de hachage, qui représentera le mot de passe de l'utilisateur, que vous aurez besoin d'ajouter dans un fichier de configuration différent. Dans le but de cette tâche, répondre no à cette question.

7. Saisir des utilisateurs supplémentaires.

   Vous pouvez saisir des utilisateurs supplémentaires si vous le souhaitez, en répétant la procédure. Vous pouvez également les ajouter à tout moment sur un système en cours d'exécution. Au lieu de choisir le domaine de sécurité par défaut, vous pouvez ajouter des utilisateurs d'autres domaines afin d'ajuster leurs autorisations.

8. Créer des utilisateurs en mode non interactif.

   Vous pouvez créer des utilisateurs en mode non interactif, en l'indiquant dans chaque paramètre de ligne de commande. Cette approche n'est pas recommandée sur les systèmes partagés, parce que les mots de passe seront visibles dans les fichiers de journalisation (log) et dans les fichiers d'historique. La syntaxe de la commande, pour le domaine de gestion, est la suivante :

   [user@host bin]$ ./add-user.sh usernamepassword

   Pour utiliser le domaine d'application, utiliser le paramètre -a.

   [user@host bin]$ ./add-user.sh -a usernamepassword

9. Vous pouvez supprimer la sortie normale du script add-user en passant le paramètre --silent. Cela s'applique uniquement si un minimum de paramètres, nom d'utilisateur et mot de passe, ont été indiqués. Le message d'erreur apparaîtra toujours.

Procédure 4.2. Spécifier des Fichiers de Propriétés alternatifs

• • Pour spécifier un autre répertoire pour la configuration du serveur, utilisez l'argument -sc. Cet argument spécifie un autre répertoire qui contiendra les fichiers de propriétés de configuration de serveur.
  • Pour spécifier un répertoire alternatif de configuration de domaine, utiliser l'argument -dc. Cet argument spécifie un répertoire alternatif qui contient les fichiers de propriétés de configuration de domaines.
  • Pour spécifier un fichier de configuration utilisateur différent, utiliser l'argument -up ou --user-properties. Peut correspondre à un chemin complet ou à un nom de fichier utilisé en conjonction avec -sc ou -dc spécifiant le répertoire de configuration alternatif.
  • Pour spécifier un fichier de configuration groupe différent, utiliser l'argument -up ou --group-properties. Peut correspondre à un chemin complet ou à un nom de fichier utilisé en conjonction avec -sc ou -dc spécifiant le répertoire de configuration alternatif.

• Configuration des attributs d'une interface

  Sélectionner le Management CLI ou la Console de gestion pour configurer vos attributs d'interface selon les besoins.

  • Configurer les attributs d'interface par le Management CLI

    Utiliser le Management CLI pour ajouter de nouvelles interfaces et pour écrire des nouvelles valeurs dans dans les attributs de l'interface.

    1. Ajouter une nouvelle interface

       Utiliser l'opération add (ajouter) pour créer une nouvelle interface selon les besoins. Vous pouvez exécuter cette commande à partir de la racine de la session de Management CLI, qui, dans l'exemple suivant, crée un nouveau titre de nom d'interface interfacename, avec inet-address déclaré ainsi 12.0.0.2.

       /interface=interfacename/:add(inet-address=12.0.0.2)

    2. Modifier les attributs d'une interface

       Utiliser l'opération write pour écrire une nouvelle valeur dans un attribut. Vous pouvez utiliser l'onglet de complétion pour terminer la chaîne de commande en cours, ainsi que pour exposer les attributs disponibles. L'exemple suivant met à jour la valeur de l' inet-address à 12.0.0.8

       /interface=interfacename/:write(inet-address=12.0.0.8)

    3. Modifier les attributs d'une interface

       Confirmer que les valeurs ont changé en exécutant read-resource accompagné du paramètre include-runtime=true pour exposer toutes les valeurs actives en cours du modèle de serveur.

       [standalone@localhost:9999 interface=public] :read-resource(include-runtime=true)

  • Configurer les attributs d'interface par la Console de gestion

    Utiliser la Console de gestion pour ajouter des nouvelles interfaces et pour écrire des nouvelles valeurs dans les attributs de l'interface.

    1. Connectez-vous à la Console de gestion.

       Connectez-vous à la Console de gestion de votre instance de Serveur autonome ou Managed Domain (Domaine géré).

    2. Si vous utilisez le Managed Domain, sélectionner le profil qui convient.

       Sélectionner l'onglet Profiles en haut à droite, puis sélectionner le profil qui convient à partir du menu Profile en haut et à gauche de l'écran suivant.

    3. Sélectionner l'item Interfaces à partir du menu de navigation.

       Sélectionner l'item de menu Interfaces à partir du menu de navigation.

    4. Ajouter une nouvelle interface

       1. Cliquer sur le bouton Add (ajouter).
       2. Saisir les valeurs qui conviennent pour les Name (Nom), Inet Address (Adresse Inet) et Address Wildcard (Adresse générique).
       3. Cliquer sur le bouton Save pour terminer.

    5. Modifier les attributs d'une interface

       1. Sélectionner l'interface à modifier et cliquer sur le bouton Edit.
       2. Saisir les valeurs qui conviennent pour les Name (Nom), Inet Address (Adresse Inet) et Address Wildcard (Adresse générique).
       3. Cliquer sur le bouton Save pour terminer.

• Configurer des liaisons de sockets dans des Groupes de liaisons de sockets

  Sélectionner le Management CLI ou la Console de gestion pour configurer vos liaisons de sockets selon les besoins.

  • Configurer les liaisons de sockets par le Management CLI

    Sélectionner le Management CLI pour configurer les liaisons de sockets.

    1. Ajouter un nouvelle liaison de sockets

       Utiliser l'opération add (ajouter) pour créer une nouvelle configuration d'adresse si nécessaire. Vous pouvez exécuter cette commande à partir de la racine de la session de Management CLI, qui, dans l'exemple suivant, crée une nouvelle liaison de sockets intitulée newsocket, avec un attribut port déclaré comme 1234. Les exemples s'appliquent à la fois pour la modification des serveurs autonomes et des serveurs gérés sur la liaison de sockets standard-sockets comme montré ci-dessous.

       [domain@localhost:9999 /] /socket-binding-group=standard-sockets/socket-binding=newsocket/:add(port=1234)

    2. Modifier les attributs de modèle

       Utiliser l'opération write-attribute pour écrire une nouvelle valeur dans un attribut. Vous pouvez utiliser l'onglet de complétion pour aider à compléter la chaîne de commande que vous saisissez, et pour exposer les attributs disponibles. L'exemple suivant met à jour la valeur port à 2020

       [domain@localhost:9999 /] /socket-binding-group=standard-sockets/socket-binding=newsocket/:write-attribute(name=port,value=2020)

    3. Confirmer les attributs de modèle

       Confirmer que les valeurs ont changé en exécutant read-resource accompagné du paramètre include-runtime=true pour exposer toutes les valeurs actives en cours du modèle de serveur.

       [domain@localhost:9999 /] /socket-binding-group=standard-sockets/socket-binding=newsocket/:read-resource

  • Configurer les liaisons de sockets par la Console de gestion

    Utiliser le Management CLI pour configurer les liaisons de sockets.

    1. Connectez-vous à la Console de gestion.

       Connectez-vous à la Console de gestion de votre domaine géré ou de votre serveur autonome.

    2. Sélectionner le Profile tab

       Sélectionner l'onglet Profiles en haut et à droite.

    3. Sélectionner l'élément Socket Binding à partir du menu de navigation.

       Sélectionner l'élément de menu Socket Binding à partir du menu de navigation. Si vous utilisez un domaine géré, sélectionner le groupe désiré dans le menu Socket Binding Groups.

    4. Ajouter un nouvelle liaison de sockets

       1. Cliquer sur le bouton Add (ajouter).
       2. Saisir les valeurs qui conviennent pour les Name (Nom), Port (Port) et Binding Group (Groupe de liaisons).
       3. Cliquer sur le bouton Save pour terminer.

    5. Modifier les attributs d'une interface

       1. Sélectionner la liaison de sockets à modifier et cliquer sur le bouton Edit.
       2. Saisir les valeurs qui conviennent pour les Name (Nom), Interface (Interface) etr Port (Port).
       3. Cliquer sur le bouton Save pour terminer.

• Configurer les Port Offset (valeurs de décalages de ports)

  Sélectionner le Management CLI ou la Console de gestion pour configurer vos ports offsets.

  • Configurer Port Offsets par le Management CLI

    Sélectionner le Management CLI pour configurer vos ports offsets.

    1. Modifier les Ports Offsets

       Utiliser l'opération write-attribut pour écrire une nouvelle valeur référence de port. L'exemple suivant met à jour la valeur du socket-binding-port-offset de server-two à 250. Ce serveur est membre du groupe hôte local par défaut. Un redémarrage est nécessaire pour que les modifications puissent prendre effet.

       [domain@localhost:9999 /] /host=master/server-config=server-two/:write-attribute(name=socket-binding-port-offset,value=250)

    2. Confirmer les attributs de Port Offset

       Confirmer que les valeurs ont changé en exécutant read-resource accompagné du paramètre include-runtime=true pour exposer toutes les valeurs actives en cours du modèle de serveur.

       [domain@localhost:9999 /] /host=master/server-config=server-two/:read-resource(include-runtime=true)

  • Configurer Port Offsets par la Console de Management

    Sélectionner la Console de Management pour configurer vos ports offsets.

    1. Connectez-vous à la Console de gestion.

       Connectez-vous à la Console de gestion de votre domaine géré.

    2. Sélectionner l'onglet Hosts

       Sélectionner l'onglet Hosts en haut et à droite.

    3. Modifier les attributs de Port Offset

       1. Sélectionner le serveur dans la section Configuration Name et cliquer sur le bouton Edit.
       2. Saisir les valeurs que vous désirez dans le champ Port Offset.
       3. Cliquer sur le bouton Save pour terminer.

Procédure 5.1. Désactiver la propriété IPv4 Stack Java

1. Ouvrir le fichier qui convient à l'installation :

   • Pour le serveur autonome :

     Ouvrir EAP_HOME/bin/standalone.conf.

   • Pour un domaine géré :

     Ouvrir EAP_HOME/bin/domain.conf.
2. Modifier la propriété IPv4 Stack Java à false :

   -Djava.net.preferIPv4Stack=false

   Par exemple :

   # Specify options to pass to the Java VM.
   #
   if [ "x$JAVA_OPTS" = "x" ]; then
      JAVA_OPTS="-Xms64m -Xmx512m -XX:MaxPermSize=256m -Djava.net.preferIPv4Stack=false 
      -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 
      -Dsun.rmi.dgc.server.gcInterval=3600000 -Djava.net.preferIPv6Addresses=true"
   fi
   

Procédure 5.2. Configurer l'interface du réseautage IPv6

1. Cliquer sur l'onglet Profile qui se trouve en haut et à droite de la console.
2. Sélectionner l'option Interfaces qui se trouve sous General Configuration.
3. Sélectionner l'interface réseau nommée à configurer.
4. Cliquer sur le bouton Edit.
5. Définir l'adresse inet à :

   ${jboss.bind.address.management:[ADDRESS]}

6. Cliquez sur le bouton Enregistrer pour enregistrer les modifications.
7. Démarrer le serveur à nouveau pour implémenter les changements.

Procédure 5.3. Configuration de l'installation JBoss EAP 6 pour qu'elle préfère les adresses IPv6

1. Ouvrir le fichier qui convient à l'installation :

   • Pour le serveur autonome :

     Ouvrir EAP_HOME/bin/standalone.conf.

   • Pour un domaine géré :

     Ouvrir EAP_HOME/bin/domain.conf.
2. Ajouter la propriété Java suivante aux options de la Java VM

   -Djava.net.preferIPv6Addresses=true

   Par exemple :

   # Specify options to pass to the Java VM.
   #
   if [ "x$JAVA_OPTS" = "x" ]; then
      JAVA_OPTS="-Xms64m -Xmx512m -XX:MaxPermSize=256m -Djava.net.preferIPv4Stack=false 
      -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 
      -Dsun.rmi.dgc.server.gcInterval=3600000 -Djava.net.preferIPv6Addresses=true"
   fi
   

Procédure 6.1. Déployer le pilote JDBC

1. Accéder à la console de gestion

   Section 3.4.2, « Se conncecter à la console de gestion »

2. Déployez le fichier JAR dans votre serveur ou groupe de serveurs.

   Si vous utilisez un domaine géré, déployez le fichier JAR dans un groupe de serveurs. Sinon, déployez-le sur votre serveur. Voir Section 9.2.2, « Déployer une application par la Console de gestion ».

Procédure 6.2. Installer un pilote JDBC comme core module

1. Créer une structure de chemin d'accès de fichier sous le répertoire EAP_HOME/modules/. Ainsi, pour un pilote MySQL JDBC, créer une structure de répertoire comme suit : EAP_HOME/modules/com/mysql/main/.
2. Copier le pilote JDBC dans le sous-répertoire main/.
3. Dans le sous-répertoire main/, créer un fichier module.xml ressemblant à l'exemple qui se trouve Section 7.1.1, « Modules ». Le module XSD est défini dans le fichier EAP_HOME/docs/schema/module-1_2.xsd.
4. Démarrer le serveur.
5. Démarrer l'interface CLI.
6. Exécuter la commande CLI suivante pour ajouter le module de pilote JDBC comme pilote :

   /subsystem=datasources/jdbc-driver=DRIVER_NAME:add(driver-name=DRIVER_NAME,driver-module-name=MODULE_NAME,driver-xa-datasource-class-name=XA_DATASOURCE_CLASS_NAME)

   Exemple 6.1. Exemple de Commande CLI

   /subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql,driver-xa-datasource-class-name=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource)

Procédure 6.3. Ajouter une dépendance à l'application

• • Configurer le fichier MANIFEST.MF

    1. Ouvrir le fichier META-INF/MANIFEST.MF de l'application dans un éditeur de texte.
    2. Ajouter une dépendance au module JDBC et sauvegarder le fichier.

       Dépendences : MODULE_NAME

       Exemple 6.2. Exemple de dépendance

       Dépendences: com.mysql

  • 1. Créer un fichier jboss-deployment-structure.xml

       Créer un fichier jboss-deployment-structure.xml dans le dossier META-INF/ ou WEB-INF de l'application.

       Exemple 6.3. Exemple de fichier jboss-deployment-structure.xml

       <jboss-deployment-structure>
         <deployment>
           <dependencies>
             <module name="com.mysql" />
           </dependencies>
         </deployment>
       </jboss-deployment-structure>
       
       

Procédure 6.4. Créer une Source de données par le Management CLI ou la Console de gestion

• • Management CLI

    1. Lancer l'outil CLI et connectez-vous à votre serveur.
    2. Exécuter la commande suivante pour créer une source de données non-XA, et configurer les variables comme il se doit :

       data-source add --name=DATASOURCE_NAME --jndi-name=JNDI_NAME --driver-name=DRIVER_NAME  --connection-url=CONNECTION_URL

    3. Activer la source de données :

       data-source enable --name=DATASOURCE_NAME

  • Console de gestion

    1. Connectez-vous à la Console de gestion.

    2. Naviguez dans le panneau Datasources qui se trouve dans la Console de gestion

       1. • Mode autonome

            Sélectionner l'onglet Profile en haut de la console.

          • Mode Domaine

            1. Sélectionner l'onglet Profiles en haut de la console.
            2. Sélectionner le profil qui convient à partir du menu déroulant en haut à gauche.
            3. Étendre le menu Subsystems qui se trouve à gauche de la console.
       2. Sélectionner Connector → Datasources à partir du menu à gauche de la console.

    3. Créer une nouvelle source de données

       1. Sélectionner le bouton Add qui se trouve en haut du panneau Datasources.
       2. Saisir les attributs de la nouvelle source de données de l'assistant Create Datasource et appuyez sur Next.
       3. Saisir les informations sur le pilote JDBC dans l'assistant Create Datasource et appuyez sur Next.
       4. Saisir les paramètres de connexion dans l'assistant Create Datasource et appuyez sur Done.

Procédure 6.5. Modifier une Source de données non-XA

• • Management CLI

    1. Section 3.5.2, « Lancement du Management CLI ».
    2. Utiliser la commande write-attribute pour configurer un attribut de source de données :

       /subsystem=datasources/data-source=DATASOURCE_NAME:write-attribute(name=ATTRIBUTE_NAME,value=ATTRIBUTE_VALUE)

    3. Charger à nouveau le serveur pour confirmer les changements :

       :reload

  • Console de gestion

    1. Section 3.4.2, « Se conncecter à la console de gestion ».

    2. Naviguez dans le panneau Datasources qui se trouve dans la Console de gestion

       1. • Mode autonome

            Sélectionner l'onglet Profile en haut de la console.

          • Mode Domaine

            1. Sélectionner l'onglet Profiles en haut de la console.
            2. Sélectionner le profil qui convient à partir du menu déroulant en haut à gauche.
            3. Étendre le menu Subsystems qui se trouve à gauche de la console.
       2. Sélectionner Connector → Datasources à partir du menu à gauche de la console.

    3. Modifier la source de données

       1. Sélectionner la source de données qui convient à partir de la liste Available Datasources. Les attributs de la source de données sont affichés dans le panneau Attributes ci-dessous.
       2. Sélectionner le bouton Edit pour modifier les attributs de la source de données.
       3. Modifier les attributs de la source de données et sélectionner le bouton Save quand c'est fait.

Procédure 6.6. Supprimer un source de données non-XA

• • Management CLI

    1. Section 3.5.2, « Lancement du Management CLI ».
    2. Exécuter la commande suivante pour supprimer une source de données non-XA :

       data-source remove --name=DATASOURCE_NAME

  • Console de gestion

    1. Section 3.4.2, « Se conncecter à la console de gestion ».

    2. Naviguer dans le panneau Datasources qui se trouve dans la Console de gestion

       1. • Mode autonome

            Sélectionner l'onglet Profile en haut de la console.

          • Mode Domaine

            1. Sélectionner l'onglet Profiles en haut de la console.
            2. Sélectionner le profil qui convient à partir du menu déroulant en haut à gauche.
            3. Étendre le menu Subsystems qui se trouve à gauche de la console.
       2. Sélectionner Connector → Datasources à partir du menu à gauche de la console.
    3. Sélectionner la source de données enregistrée à supprimer, et cliquer sur le bouton Remove qui se trouve en haut et à droite de la console.

Procédure 6.7. Créer une source de données XA en utilisant le Management CLI ou la Console de gestion

• • Management CLI

    1. Section 3.5.2, « Lancement du Management CLI ».
    2. Exécuter la commande suivante pour créer une source de données XA, et configurer les variables comme il se doit:

       xa-data-source add --name=XA_DATASOURCE_NAME --jndi-name=JNDI_NAME --driver-name=DRIVER_NAME --xa-datasource-class=XA_DATASOURCE_CLASS

    3. Configurer les propriétés de la source de données XA

       1. Définir le nom du serveur

          Exécuter la commande suivante pour configurer le nom du serveur de l'hôte :

          /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME/xa-datasource-properties=ServerName:add(value=HOSTNAME)

       2. Définir le nom de la base de données

          Exécuter la commande suivante pour configurer le nom de la base de données :

          /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME/xa-datasource-properties=DatabaseName:add(value=DATABASE_NAME)

    4. Activer la source de données :

       xa-data-source enable --name=XA_DATASOURCE_NAME

  • Console de gestion

    1. Section 3.4.2, « Se conncecter à la console de gestion ».

    2. Naviguez dans le panneau Datasources qui se trouve dans la Console de gestion

       1. • Mode autonome

            Sélectionner l'onglet Profile en haut de la console.

          • Mode Domaine

            1. Sélectionner l'onglet Profiles en haut de la console.
            2. Sélectionner le profil qui convient à partir du menu déroulant en haut à gauche.
            3. Étendre le menu Subsystems qui se trouve à gauche de la console.
       2. Sélectionner Connector → Datasources à partir du menu à gauche de la console.
    3. Sélectionner l'onglet XA Datasource.

    4. Créer une nouvelle source de données XA

       1. Sélectionner le bouton Add qui se trouve en haut du panneau Datasources.
       2. Saisir les attributs de la nouvelle source de données XA de l'assistant Create XA Datasource et appuyez sur Next.
       3. Saisir les informations sur le pilote JDBC dans l'assistant Create XA Datasource et appuyez sur Next.
       4. Modifier les propriétés et appuyer sur Next.
       5. Saisir les paramètres de connexion dans l'assistant Create XA Datasource et appuyer sur Done.

Procédure 6.8. Modifier une source de données XA en utilisant le Management CLI ou la Console de gestion

• • Management CLI

    1. Section 3.5.2, « Lancement du Management CLI ».

    2. Configurer les attributs de source de données XA

       Utiliser la commande write-attribute pour configurer un attribut de source de données :

       /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME:write-attribute(name=ATTRIBUTE_NAME,value=ATTRIBUTE_VALUE)

    3. Configurer les propriétés de la source de données XA

       Exécuter la commande suivante pour configurer une sous-ressource de source de données XA :

       /subsystem=datasources/xa-data-source=DATASOURCE_NAME/xa-datasource-properties=PROPERTY_NAME:add(value=PROPERTY_VALUE)

    4. Charger à nouveau le serveur pour confirmer les changements :

       :reload

  • Console de gestion

    1. Section 3.4.2, « Se conncecter à la console de gestion ».

    2. Naviguez dans le panneau Datasources qui se trouve dans la Console de gestion

       1. • Mode autonome

            Sélectionner l'onglet Profile en haut de la console.

          • Mode Domaine

            1. Sélectionner l'onglet Profiles en haut de la console.
            2. Sélectionner le profil qui convient à partir du menu déroulant en haut à gauche.
            3. Étendre le menu Subsystems qui se trouve à gauche de la console.
       2. Sélectionner Connector → Datasources à partir du menu à gauche de la console.
    3. Sélectionner l'onglet XA Datasource.

    4. Modifier la source de données

       1. Sélectionner la source de données XA qui convient à partir de la liste Available XA Datasources. Les attributs de la source de données XA sont affichés dans le panneau Attributes ci-dessous.
       2. Sélectionner le bouton Edit pour modifier les attributs de la source de données.
       3. Modifier les attributs de la source de données XA et sélectionner le bouton Save quand c'est fait.

Procédure 6.9. Supprimer une source de données XA en utilisant le Management CLI ou la Console de gestion

• • Management CLI

    1. Section 3.5.2, « Lancement du Management CLI ».
    2. Exécuter la commande suivante pour supprimer une source de données :

       xa-data-source remove --name=XA_DATASOURCE_NAME

  • Console de gestion

    1. Section 3.4.2, « Se conncecter à la console de gestion ».

    2. Naviguer dans le panneau Datasources qui se trouve dans la Console de gestion

       1. • Mode autonome

            Sélectionner l'onglet Profile en haut de la console.

          • Mode Domaine

            1. Sélectionner l'onglet Profiles en haut de la console.
            2. Sélectionner le profil qui convient à partir du menu déroulant en haut à gauche.
            3. Étendre le menu Subsystems qui se trouve à gauche de la console.
       2. Sélectionner Connector → Datasources à partir du menu à gauche de la console.
    3. Sélectionner l'onglet XA Datasource.
    4. Sélectionner la source de données XA enregistrée à supprimer, et cliquer sur le bouton Remove qui se trouve en haut et à droite de la console.

Procédure 6.10. 

• /subsystem=datasources/data-source=ExampleDS/statistics=jdbc:read-resource(include-runtime=true)
  

  /subsystem=datasources/data-source=ExampleDS/statistics=pool:read-resource(include-runtime=true)