Création, modification et suppression de variables WebSphere

Vous pouvez utiliser WebSphere® variables pour fournir des paramètres pour tous les attributs de type de données chaîne contenus dans les fichiers de configuration du produit.

Avant de commencer

Parce que les applications ne peuvent pas accéder directement WebSphere variables, si vous définissez un WebSphere variable à l'intérieur d'une application, un message d'erreur, tel que « Variable inconnue », est renvoyé. Si vous devez référencer une variable WebSphere à partir d'une application, ajoutez la méthode ci-dessous à l'application afin de développer la chaîne qui utilise la variable WebShpere.
Eviter les problèmes: L'extension des variables WebSphere nécessite que vous ayez des privilèges d'administration.
private String expandVariable(String s) throws
javax.management.JMException {  
com.ibm.websphere.management.AdminService as = 
com.ibm.websphere.management.AdminServiceFactory.getAdminService 
();  

String server = as.getProcessName();  

java.util.Set result = as.queryNames(new javax.management.ObjectName("*:*,type=AdminOperations,process=" 
+ server), null);  

return (String)as.invoke((javax.management.ObjectName) 
result.iterator().next(),"expandVariable",new Object[] 
{"${"+s+"}"}, new String[] {"java.lang.String"});
De même, vous pouvez inclure les lignes de code suivantes dans un fichier script si vous voulez utiliser une commande de script pour développer les variables WebSphere.
  • A l'aide de Jacl :
    set mbean [$AdminControl completeObjectName WebSphere:*,type=AdminOperations]
$AdminControl invoke $mbean expandVariable {{"${APP_INSTALL_ROOT}"}}
  • Avec Jython :
    AdminOperations = AdminControl.completeObjectName('WebSphere:*,type=AdminOperations')
print AdminControl.invoke(AdminOperations, 'expandVariable', '${APP_INSTALL_ROOT}')

A propos de cette tâche

Les variables WebSphere sont généralement employées pour indiquer des chemins d'accès à des fichiers. Le WebSphere paramètres variables fournissez plus de détails sur la spécification des variables et des composants du produit qui les utilisent.

Les variables WebSphere permettent également de configurer :
  • les noms de chemins de produits, par exemple JAVA_HOME et APP_INSTALL_ROOT ;
  • certaines valeurs de personnalisation au niveau de la cellule ou du cluster ;
  • [z/OS]le service de localisation ;
  • [z/OS]les variables d'environnement.

Le mécanisme de définition de la portée d'une variable WebSphere permet de définir une variable au niveau du noeud, du cluster ou de la cellule mais également au niveau du serveur. Grâce à ce mécanisme, vous pouvez en outre spécifier un paramètre pour tous les serveurs, au niveau d'un noeud, d'un cluster ou d'une cellule. Il n'est donc pas nécessaire de procéder serveur par serveur.

Pour définir une nouvelle variable, modifier la valeur d'une variable existante ou supprimer une variable existante, procédez comme suit, selon ce que vous souhaitez faire.

Procédure

  1. Cliquez sur Environnement > WebSphere dans la console d'administration
  2. Sélectionnez la portée de la variable à partir de la liste des portées disponibles.

    Si vous créez une nouvelle variable, elle sera créée à la portée sélectionnée. Si vous définissez la même variable à plusieurs niveaux, la définition la plus granulaire remplace le paramètre de niveau le plus élevé. Par exemple, si vous spécifiez la même variable sur un niveau de cellule et à un niveau de noeud, le paramètre du niveau de noeud remplace celui du niveau de cellule.

    L'attribution d'une portée aux variables est particulièrement importante si vous testez des objets de source de données. L'affectation d'une portée à une variable peut amener une source de données à échouer lors du test de connexion, mais à réussir à se connecter lors de l'exécution et vice versa.

  3. Créez, modifiez ou supprimez une variable.

    • Créez une nouvelle variable.

      1. Cliquez sur New.
      2. Indiquez un nom, une valeur et une description (facultatif) pour la variable.

        Vous pouvez créer des variables Websphere prenant en charge la substitution. Par exemple, si vous entrez${<variable name>}dans la zone Nom , la valeur de<variable name>devient le nom de votre nouvelle variable WebSphere . Par exemple, si vous entrez${JAVA_HOME}comme nom de votre variable, le nom de la variable WebSphere créée est le répertoire de base Java™ .

        [z/OS]Vous pouvez utiliser les variables WebSphere pour modifier la configuration du démon. En ajoutant une propriété de serveur personnalisée à une balise de démon, vous pouvez désigner cette variable comme étant destinée spécialement à ce démon. EntrezDAEMON_<server custom property>dans la zone Nom . Par exemple, si vous entrezDAEMON_ras_trace_outputlocationdans le Nom champ etSYSOUTdans le Valeur, vous pouvez diriger la sortie de trace de ce démon particulier vers SYSPRINT.

    • Modifier le paramètre pour une variable existante.
      1. Cliquez sur le nom de la variable que vous voulez modifier.

        [z/OS]Le serveur d'applications utilise WebSphere Application Server variables internes à ses propres fins. Les préfixes qui indiquent qu'une variable est interne sontWAS_DAEMON_<server custom property>,WAS_DAEMON_ONLY_<server custom property>etWAS_SERVER_ONLY_<server custom property>. Les variables avec ces balises ne sont pas destinées à votre utilisation. Elles sont réservées exclusivement au contexte d'exécution du serveur. Si vous les modifiez, des erreurs peuvent se produire.

      2. Modifier le contenu du Valeurs champ.

        Le Valeurs Le champ de certaines variables déjà définies lors de l'installation du produit est en lecture seule, car la modification des valeurs spécifiées pour ces variables peut entraîner des erreurs de traitement du produit.

    • Supprimer une variable existante.
      1. Sélectionnez la variable que vous voulez supprimer.
      2. Cliquez sur Supprimer.
  4. Cliquez sur OK.
  5. Vérifiez la modification.

    Si vous avez créé une variable, cliquez sur Environnement >WebSphere variables dans la navigation de la console d'administration et vérifiez que la variable est affichée dans la liste des variables pour la portée sélectionnée.

    Si vous l'avez mal orthographiée, la console d'administration ne la détecte pas La variable est ignorée si elle est référencée incorrectement.

    Si vous avez supprimé une variable, vérifiez qu'elle a été supprimée de la liste des variables pour la portée sélectionnée.

  6. Sauvegardez votre configuration.
  7. Arrêtez les serveurs attribués et redémarrez-les pour appliquer le changement de configuration.

    Si les modifications que vous avez effectuées affecte un noeud, vous devez arrêter et redémarrer tous les serveurs sur ce noeud. De même, si les modifications que vous avez effectuées affecte une cellule, vous devez arrêter et redémarrer tous les serveurs de cette cellule.