Incidents d'administration liés à l'outil de scriptage wsadmin
Utilisez ces informations si vous rencontrez des incidents lors du démarrage ou de l'utilisation de l'outil wsadmin.
- WASX7016E, WASX7017E ou WASX7209I : Erreur du langage de script Jython
- "WASX7023E: Erreur lors de la création de la connexion "SOAP" à l'hôte" ou erreur similaire lors de la tentative de lancement de l'utilitaire de ligne de commande wsadmin.
- "com.ibm.bsf.BSFException : Erreur lors de l'évaluation de l'expression JACL : aucune méthode "<nom commande>" de la classe com.ibm.ws.scripting.AdminConfigClient" n'a été renvoyée par la commande wsadmin.
- WASX7022E renvoyée après l'exécution de la commande "wsadmin -c ..." , qui indique une commande non valide.
- com.ibm.ws.scripting.ScriptingException: WASX7025E: La chaîne "" est incorrecte. Impossible de créer ObjectName.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
L'erreur " La ligne
d'entrée est trop longue " a été renvoyée par la commande wsadmin sur une plateforme Windows.- WASX701E: Exception reçue lors de l'exécution du fichier "nom_script.jacl"; informations sur l'exception : com.ibm.bsf.BSFException: erreur lors de l'évaluation de l'expression Jacl : crochet de fin manquant
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
WASX7015E :
Exception lors de l'exécution de la commande : "source c: ..." ; informations sur
l'exception : com.ibm.bsf.BSFException: erreur lors de l'évaluation de l'expression Jacl
: impossible de lire le fichier "c: ..."- Erreur CWSIV0806E inattendue dans le journal WebSphere suite à la suppression d'un service sortant
- Exception du séparateur
- Le format de la sortie "$AdminConfig list" a changé dans la version 6.0
- Vous n'êtes pas invité à entrer l'ID utilisateur et le mot de passe après avoir appliqué un service V6.0.2 si vous utilisez un profil 6.0 existant
- Lors de l'exécution de la commande $AdminApp searchJNDIReferences avec le nom JNDI (Java Naming and Directory Interface) d'une destination de message, la référence de la destination de message n'est pas renvoyée
WASX7022E : Un incident est survenu lors de l'exécution de la commande "import sys" -- informations sur l'exception : com.ibm.bsf.BSFException :
impossible de charger le langage
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Si vous ne pouvez pas entrer le mode de commande wsadmin, tentez
d'exécuter wsadmin -c "$Help wsadmin" pour savoir si vous avez
entré la commande correctement.- Si vous n'obtenez pas l'invite de commande wsadmin, entrez $Help help pour vous assurer que vous utilisez les commandes correctement.
- Les commandes wsadmin sont une version élaborée de Jacl (Java Command Language), qui est à son tour une implémentation Java du langage de commande Tcl. Pour plus de détails sur la syntaxe Jacl au-delà des commandes wsadmin, reportez-vous au site Tcl developer Xchange. Pour des détails spécifiques sur l'implémentation Java de Tcl, reportez-vous au site The Tcl/Java Project.
- Recherchez des indices dans le fichier rép_install/profiles/nom_profil/logs/wsadmin.traceout.
- N'oubliez pas que wsadmin.traceout est actualisé (les enregistrements de journal existants sont supprimés) lorsqu'une nouvelle session wsadmin est lancée.
- Si l'erreur renvoyée par wsadmin ne semble pas concerner la commande que vous avez entrée, par exemple si vous recevez l'erreur WASX7023E indiquant qu'une connexion n'a pas pu être créée pour l'hôte "myhost" et que vous n'avez pas indiqué "-host myhost" sur la ligne de commande, examinez les fichiers de propriétés utilisés par wsadmin pour déterminer les propriétés qui ont été indiquées. Si vous ne savez pas quels fichiers de propriétés ont été chargés, consultez les messages WASX7326I du fichier wsadmin.traceout. L'un de ces messages s'affichera pour chaque fichier de propriétés chargé.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Lorsqu'aucune de ces opérations ne résout l'incident, vérifiez
dans le support
disponible en ligne (conseils et astuces, notes techniques et
correctifs) s'il a été identifié et documenté. Si vous n'y trouvez aucune information utile, veuillez contacter le support technique IBM.
WASX7016E, WASX7017E ou WASX7209I: Erreur du langage de script Jython
Les erreurs suivantes surviennent lorsque vous exécutez ce script Jython :
script Jython
"profile_root/bin/wsadmin.sh -lang jython -profile profile_name -host host_name -f script_file.py"
Messages d'erreur
WASX7209I : Connecté au processus "server1" sur le noeud
nom_noeud en utilisant le connecteur SOAP ; le type de processus est :
UnManagedProcess
WASX7016E: Exception reçue lors de la lecture du fichier
"fichier_script.py"; informations sur l'exception :
sun.io.MalformedInputException
WASX7017E: Exception reçue lors de l'exécution du fichier
"fichier_script.py"; informations sur l'exception :
com.ibm.bsf.BSFException : exception de Jython : Traceback
(innermost last): File "<string>" line 89, in ? NameError: log
- Ouvrez un nouveau lecteur de texte sur le fichier.
- Lisez-le caractère par caractère.
- Imprimez le caractère qui n'est pas valide.
- Lorsque vous appuyez sur les caractères arrière, vous recevez l'exception et saurez ensuite quel caractère est à l'origine de l'erreur.
- Supprimez tous les caractères non valides, puis exécutez à nouveau le script
"WASX7023E: Erreur lors de la création de la connexion "SOAP" à l'hôte" ou erreur similaire lors de la tentative de lancement de l'utilitaire de ligne de commande wsadmin
Par défaut, l'utilitaire wsadmin tente d'établir une connexion avec un serveur d'applications lorsque celui-ci démarre. Cela est dû au fait que certaines commandes sont exécutées au lancement des serveurs d'applications. Cette erreur indique qu'aucune connexion n'a été établie.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Si vous n'êtes pas certain qu'un serveur d'applications est exécuté, démarrez-le en entrant startserver nomserveur à l'invite de commande. Si le serveur est déjà lancé, une erreur similaire à "ADMU3027E: Une instance du serveur est déjà en cours d'exécution" s'affiche.- Si un serveur d'applications est en cours d'exécution et que vous recevez l'erreur suivante :
- Si l'exécution se fait à distance (c'est-à-dire sur un poste différent de celui sur lequel fonctionne WebSphere Application Server), vous devez utiliser l'option -host nom_hôte avec la commande wsadmin pour diriger wsadmin vers le serveur physique approprié.
- Si vous utilisez l'option -host, essayez d'envoyer une commande ping au poste serveur à partir de la ligne de commande sur le poste sur lequel vous tentez de lancer wsadmin pour vérifier qu'il n'existe aucun incident de connectivité tel que des pare-feux.
- Vérifiez que vous utilisez le bon numéro de port pour vous connecter
au processus WebSphere
Application Server :
- Si vous n'indiquez aucun numéro de port (avec l'option -port) lors du démarrage de l'outil wsadmin, ce dernier utilise le port par défaut spécifié dans le fichier rép_install/profiles/nom_profil/properties/wsadmin.properties, nom propriété=com.ibm.ws.scripting.port (valeur par défaut = 8879).
Le port sur lequel wsadmin doit effectuer des envois dépend du processus serveur auquel wsadmin tente de se connecter.
Pour une installation à serveur unique, wsadmin tente de se connecter au processus de serveur d'applications par défaut. Pour vérifier le numéro de port :- Dans le fichier racine_profil/config/cells/"nom_cellule"/nodes/nom_noeud/serverindex.xml, recherchez une balise contenant la propriété serverType="APPLICATION_SERVER".
- Dans cette balise, recherchez une entrée contenant la propriété endPointName="SOAP_CONNECTOR_ADDRESS".
- Recherchez une propriété "port" dans cette balise. Il s'agit du port sur lequel wsadmin doit effectuer des envois.
"com.ibm.bsf.BSFException : Erreur lors de l'évaluation de l'expression JACL : aucune méthode nom commande de la classe com.ibm.ws.scripting.AdminConfigClient" n'a été renvoyée par la commande wsadmin.
Cette erreur est provoquée habituellement par un nom de commande mal orthographiée. Utilisez la commande $AdminConfig help pour obtenir des informations sur les commandes disponibles. Les majuscules et les minuscules sont différenciées dans les noms de commande.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
WASX7022E renvoyée après l'exécution de la commande wsadmin -c ..., qui indique une commande non valide
Si la commande suivant -c semble valide, l'incident peut être dû au fait que lorsque wsadmin -c est utilisé sous Unix pour appeler une commande qui comporte des signes dollar, le shell tente d'effectuer une substitution variable. Pour confirmer que le problème est bien là, vérifiez que la commande contient bien un signe dollar de commande, par exemple : wsadmin -c "$AdminApp install ...."
Pour éliminer cet incident, placez une barre oblique inverse devant le signe dollar. Par exemple : wsadmin -c "\$AdminApp install ...".
com.ibm.ws.scripting.ScriptingException: WASX7025E: La chaîne """" est incorrecte. Impossible de créer ObjectName.
Cette erreur est peut-être due au fait qu'une chaîne vide a été indiquée pour un nom d'objet. Elle peut se produire si vous utilisez une instruction de scriptage pour créer un nom d'objet et l'instruction suivante pour utiliser ce nom, peut-être dans une commande "invoke" ou "getAttribute" mais que vous ne vous assurez pas que la première instruction a effectivement renvoyé un nom d'objet. Par exemple (les exemples suivants utilisent les commandes Jacl de base en plus des extensions Jacl wsadmin pour effectuer un exemple de script) :
#let's misspell "Server"
set serverName [$AdminControl queryNames type=Srever,*]
$AdminControl getAttributes $serverName
Pour corriger cette erreur, assurez-vous, avant d'utiliser les chaînes de nom d'objet, que celles-ci contiennent des valeurs. Par exemple :
set serverName[$AdminControl queryNames node=mynode,type=Server,name=server1,*]
if {$serverName == """"} {puts "queryNames returned empty - check query argument"}
else {$AdminControl getAttributes $serverName}
Pour plus de détails sur la syntaxe Jacl au-delà des commandes wsadmin, reportez-vous au site des développeurs Tcl http://www.tcl.tk.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
L'erreur "La ligne d'entrée est trop longue" a été renvoyée par la commande wsadmin sur une plateforme Windows.
Cette erreur indique que la longueur de ligne de commande Windows de 2048 caractères a été dépassée. Cette situation peut être due à un long chemin de profil utilisé dans la commande wsadmin.bat. Vous pouvez obtenir cette erreur lors de l'exécution de wsadmin dans une invite de commande Windows ou lors de l'appel de la commande wsadmin à partir d'un fichier .bat file, d'un fichier de génération ant ou de l'outil de gestion de profils. Si cette erreur est due à l'exécution de la commande wsadmin autrement qu'à partir de l'outil de gestion de profils, vous pouvez éviter le problème en utilisant la commande subst Windows qui permet de mapper un chemin entier vers une unité virtuelle. Pour consulter la syntaxe de la commande subst, entrez help subst à partir d'une invite de commande Windows.
SET CUR_DIR=%cd%
cd /d "%~dp0.."
SET WAS_HOME=%cd%
cd /d "%CUR_DIR%"
@REM add the following two lines to workaround Windows 2K command line length limit
subst w: %WAS_HOME%
set WAS_HOME=w:
...
...
SET WAS_USER_PROFILE=...
SET USER_INSTALL_ROOT=...
SET WAS_HOME=app_server_root
SET JAVA_HOME=app_server_root\java
@REM add the following three lines to workaround Windows 2K command line length limit
subst w: %WAS_HOME%
set WAS_HOME=w:
set JAVA_HOME=%WAS_HOME%\java
...
...
Si cette erreur s'est produite lors de l'exécution de l'outil de gestion de profils, vous devez exécuter ce dernier à nouveau pour avoir un chemin de profil plus court avec un nom de profil plus court. If this does not fix the problem, follow the same instructions to edit the setupCmdLine.bat file in the bin directory of your WebSphere Application Server installation. Une fois le fichier modifié, exécutez à nouveau l'outil de gestion de profils. Si le problème persiste, réinstallez WebSphere Application Server avec un chemin de répertoire principal plus court.
Le support technique IBM possède des documents permettant de gagner du temps lors de la collecte des informations requises pour résoudre cet incident. Avant d'ouvrir un PMR, consultez la page IBM Support.
WASX701E: Exception reçue lors de l'exécution du fichier "scriptName.jacl" ; informations sur l'exception : com.ibm.bsf.BSFException: erreur lors de l'évaluation de l'expression Jacl : crochet de fin manquant
Cette erreur est due à une association de la page de codes attendue par le client de scriptage et le page de codes dans laquelle le script Jacl a été écrite.
- Si le script a été rédigé dans l'interface OMVS à l'aide de l'éditeur OEDIT, la page de codes est IBM-037. Dans ce cas, définissez l'option de la manière suivante : -Dscript.encoding=Cp037
- Si le script a été rédigé dans une session telnet de l'interface OMVS à l'aide de l'éditeur VI, la page de codes est IBM-1047. Dans ce cas, définissez l'option de la manière suivante : -Dscript.encoding=Cp1047
- Si le script a été rédigé sur un ordinateur personnel ou sur une autre machine ASCII puis transféré vers l'hôte en tant que fichier texte, la page de codes est IBM-1047. Dans ce cas, définissez l'option de la manière suivante : -Dscript.encoding=Cp1047
- Si le script a été rédigé sur un ordinateur personnel ou sur une autre machine ASCII puis transféré vers l'hôte au format binaire, la page de codes est ISO-8859-1 (ASCII). Dans ce cas, il n'est pas nécessaire de définir l'option car la valeur par défaut est ASCII. Consultez les autres causes possibles de cette erreur.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
WASX7015E: Exception lors de l'exécution de la commande : "source c: ..." ; informations sur l'exception : com.ibm.bsf.BSFException: erreur lors de l'évaluation de l'expression Jacl : impossible de lire le fichier "c: ..."
Cette erreur est provoquée par l'utilisation d'une barre oblique inversée ( \ ) à la place d'une barre oblique ( / ) lors de l'exécution de la commande wsadmin afin d'intégrer un script Jacl à un environnement Windows®. Le chemin du fichier ne peut pas contenir une barre oblique inversée ( \ ) ; par exemple, . Le chemin du fichier doit utiliser la barre oblique ( / ) comme séparateur du chemin ; par exemple, .
Pour corriger cet incident, utilisez la barre oblique ( / ) dans le chemin du fichier lors de l'utilisation de la commande wsadmin afin d'intégrer un script Jacl à un environnement Windows :
app_server_root\bin>wsadmin
WASX7209I: Connected to process "dmgr" on node sunCellManager01
using SOAP connector; The type of process is:
DeploymentManager WASX7029I: For help, enter: "$Help help"
wsadmin>source c:/temp/test.jacl
Erreur CWSIV0806E inattendue dans le journal WebSphere suite à la suppression d'un service sortant
Cette erreur se produit quand une exception est émise pour une destination MPOutBoundServicePortDestination, sur le moteur de messagerie trueliesNode01.server1-FVTSIBus01, le bus FVTSIBus01, pour l'activation du point de contact :
com.ibm.websphere.sib.exception.SINotPossibleInCurrentConfigurationException: CWSIP0111E : La destination ayant le nom MPOutBoundServicePortDestination est supprimée sur le moteur de messagerie {1}.
Vous pouvez ignorer cette erreur, car elle est bénigne.
Exception du séparateur
Vous devez utiliser des barres obliques (/) comme séparateur dans le chemin d'accès. Les barres obliques inversées (\) ne fonctionnent pas.
Le format de la sortie "$AdminConfig list" a changé dans la version 6.0
Si vous possédez un script qui analyse la sortie de $AdminConfig list, telle que $AdminConfig list Node, vous risquez de recevoir des erreurs, telles que "Noeud introuvable". Les scripts ne doivent pas analyser la sortie de $AdminConfig. Cependant, si vous possédez un script qui effectue cette analyse, il doit être mis à jour pour WebSphere Application Server V6.0 afin d'intégrer les changements du format de sortie.
Vous n'êtes pas invité à entrer l'ID utilisateur et le mot de passe après avoir appliqué un service V6.0.2 si vous utilisez un profil 6.0 existant
Si la sécurité est activée, l'exécution d'un fichier .bat nécessitera un ID utilisateur et un mot de passe. La version 6.0.2 contient une nouvelle fonction qui vous invite à saisir un ID utilisateur et un mot de passe, s'ils ne sont pas fournis dans la ligne de commande. Cependant, cette fonction n'est pas disponible pour les profils qui ont été créés au niveau 6.0.
Les fichiers de propriété des profils créés au niveau de la version 6.0 ne sont pas mis à jour après avoir appliqué le groupe de mise à jour de la version 6.0.2.
- Créer un nouveau profil après avoir appliqué le service de la version 6.0.2. Ce nouveau profil contient tous les fichiers de propriété mis à jour. Vous serez ensuite invité à saisir un ID utilisateur et un mot de passe.
- Si vous souhaitez garder le profil V6.0 existant et utilisez la nouvelle fonction d'invite, vous devez mettre à jour ces fichiers manuellement :
- pour racine_serveur_applis/properties/soap.client.props,
ajoutez la ligne suivante :
com.ibm.SOAP.loginSource=prompt
- pour racine_serveur_applis/properties/wsjaas_client.conf,
ajoutez les lignes suivantes :
WSAdminClientLogin { com.ibm.ws.security.common.auth.module.proxy.WSLoginModuleProxy required del egate=com.ibm.ws.security.common.auth.module.WSAdminClientLoginModuleImpl; }; - pour racine_serveur_applis/bin/setupCmdLine.bat, ajoutez la ligne suivante :
SET JAASSOAP=-Djava.security.auth.login.config=racine_serveur_app/properties/wsjaas_client.conf
- pour racine_serveur_applis/properties/soap.client.props,
ajoutez la ligne suivante :
Lors de l'exécution de la commande $AdminApp searchJNDIReferences avec le nom JNDI (Java Naming and Directory Interface) d'une destination de message, la référence de la destination de message n'est pas renvoyée
Cet incident se produit lorsque la commande $AdmnApp searchJNDIReferences est exécutée avec le nom JNDI d'une destination de message. La commande ne peut pas collecter une référence de destination de message définie dans le descripteur de déploiement d'application. La destination de message que vous avez configurée pour le serveur d'applications est définie dans un lien de destination de message qui se trouve non pas sur un mais sur deux éléments : un bean géré par message et une référence de destination de message.
A l'heure actuelle, il n'existe toujours pas de solution à cet incident. La commande $AdmnApp searchJNDIReferences ne peut pas renvoyer une référence pour une destination de message définie sur deux éléments.
![[AIX HP-UX Solaris]](../images/unix.gif)
WASX7022E : Un incident est survenu lors de l'exécution de la commande "import sys" -- informations sur l'exception : com.ibm.bsf.BSFException : impossible de charger le langage
Ce problème peut être causé par une limitation appliquée à quelques plateformes UNIX, par exemple, Linux, lors de la tentative d'utilisation du langage Jython.
- Vérifiez le nombre de fichiers que vous êtes autorisé à stocker dans votre machine, par exemple : ulimit -a
- Vérifiez le nombre de fichiers que vous avez définis sur votre machine. La valeur par défaut est 1024.
- Utilisez, par exemple, un nombre plus élevé : ulimit -n 2048
- Essayez d'utiliser l'outil wsadmin à nouveau avec le langage Jython.
Rubrique de référence