Red Hat Training

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

3.5.12. Substitution dans l'interface de commandes CLI

JBoss EAP 6 prend en charge l'utilisation des expressions de propriétés et d'élément prédéfinis dans l'interface de commandes CLI. Ces expressions seront résolues à leurs valeurs définies lors de l'exécution de la commande.
Les propriétés suivantes peuvent être substituées par des expressions :
  • la partie adresse d'opération de la demande d'opération (types de nodes et/ou les noms) ;
  • nom d'opération ;
  • noms de paramètres d'opérations ;
  • noms d'en-têtes et valeurs ;
  • noms de commandes :
  • noms d'arguments de commandes.
Par défaut, l'interface CLI effectue la substitution de propriétés à chaque ligne sauf pour les valeurs de paramètres ou d'arguments. Les valeurs de paramètres ou d'arguments sont résolues dans le serveur en cours d'exécution. Si vous avez besoin d'une substitution de propriété pour des valeurs de paramètre ou d'argument dans l'interface CLI client, et de lui faire envoyer les valeurs résolues au serveur, compléter la procédure suivante :

Procédure 3.11. Activer la substition de propriété dans l'interface CLI

  1. Ouvrir le fichier EAP_HOME/bin/jboss-cli.xml.
  2. Trouver l'emplacement du paramètre resolve-parameter-values et changez-en la valeur à true (la valeur par défaut est false).
    <!-- whether to resolve system properties specified as command argument or operation parameter values in the Management CLI VM before sending the operation requests to the controller -->
        <resolve-parameter-values>true</resolve-parameter-values>
    
Cet élément n'affecte que les valeurs de paramètres de la demande d'opération et les valeurs d'arguments de commandes. Il n'a aucun effet sur le reste de la ligne de commande. Ce signifie que les propriétés système présentes dans la ligne de commande seront résolues lors du traitement de la ligne quelle que soit la valeur de l'élément resolve-parameter-values, sauf s'il si celui-ci correspond à une valeur de paramètre/argument.
Voir Section 3.5.9, « Options de configuration de l'interface CLI » pour obtenir d'autres options de configuration d'interface CLI.
Sachez que les valeurs de système utilisées dans les commandes d'interface CLI doivent être déjà définies. Vous devez inclure l'argument --properties=/path/to/file.properties ou bien, un ou plusieurs paramètres -Dkey=VALUE, quand vous commencez votre instance d'interface CLI. Le fichier de propriétés utilise une syntaxe standard key=value.
Les clés de propriétés son dénotées dans vos commandes d'interface CLI en utilisant la syntaxe ${MY_VAR}.

Exemple 3.7. Exemple : utilisation de propriétés dans les commandes d'interface CLI

/subsystem=datasources/data-source=${datasourcename}:add(connection-url=jdbc:oracle:thin:@server:1521:ora1, jndi-name=java:/jboss/${name}, driver-name=${drivername})