Commandes utilisables avec l'objet AdminApp et les outils de script de wsadmin
L'objet AdminApp permet d'installer, de modifier et d'administrer des applications.
L'objet AdminApp interagit avec les services de gestion et de configuration de WebSphere Application Server afin d'effectuer des requêtes et des modifications d'application. Ces opérations incluent l'installation et la désinstallation d'applications, le listage de modules, l'exportation, etc.
Vous pouvez démarrer le client de scriptage alors qu'aucun serveur n'est actif si seules les opérations locales vous intéressent. Pour une exécution en mode local, démarrez le client de scriptage avec l'option -conntype NONE. Un message vous informe que vous êtes en mode local. Il n'est pas recommandé d'exécuter l'objet AdminApp en mode local lorsqu'un serveur est en cours d'exécution. En effet, les modifications de configuration en mode local ne sont pas reflétées dans la configuration du serveur en cours d'exécution et vice versa. Si vous sauvegardez des modifications non compatibles, la configuration risque d'être endommagée.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
- Faites une copie de sauvegarde du fichier racine_install/bin/wsadmin.bat ou rep_install/bin/wsadmin.bat.
- Ajoutez les lignes de code suivantes dans le fichier wsadmin juste après l'appel au fichier setupCmdLine.bat ou setupCmdLine.sh :
LIBPATH="$WAS_LIBPATH":$LIBPATH export LIBPATH EXTSHM
SHLIB_PATH="$WAS_LIBPATH":$SHLIB_PATH export SHLIB_PATH
LD_LIBRARY_PATH="$WAS_LIBPATH":$LD_LIBRARY_PATH export LD_LIBRARY_PATH
SET PATH=%WAS_PATH%
Eviter les incidents: Ne spécifiez pas LD_LIBRARY_PATH_64 à la place de LD_LIBRARY_PATH dans l'instruction d'exportation précédente. En spécifiant LD_LIBRARY_PATH_64 dans cette instruction d'exportation, vous remplacez les valeurs de LD_LIBRARY_PATH qui existent dans d'autres scripts.gotcha
- Enregistrez le fichier mis à jour wsadmin.bat ou wsadmin.sh.
- Déployez l'application.
Dans l'environnement d'un gestionnaire de déploiement, les mises à jour de la configuration sont uniquement disponibles lorsqu'un client de scriptage est connecté à un gestionnaire de déploiement.
Lorsque le client de scriptage est connecté à un agent de noeud ou à un serveur d'applications géré, vous n'êtes pas en mesure de mettre à jour la configuration de ces processus de serveur car il s'agit d'une copie de la configuration maîtresse qui réside sur le gestionnaire de déploiement. Cette copie est créée sur une machine noeud lorsqu'une synchronisation de la configuration du gestionnaire de déploiement et de l'agent de noeud a lieu. Pour modifier la configuration des processus de serveur, vous devez connecter un client de scriptage à un gestionnaire de déploiement. Pour cette raison, pour modifier une configuration, n'exécutez pas un client de scriptage en mode local sur une machine noeud. Cette configuration n'est pas prise en charge.

Toutefois, un module Java EE 5 ou version ultérieure peut exister dans une application qui inclut des fichiers antérieurs à Java EE 5 et utilise l'extension de nom de fichier .xmi.
Les fichiers ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi et ibm-portlet-ext.xmi continuent d'utiliser les extensions de fichier .xmi.
sptcfgdeleteUserAndGroupEntries
La commande deleteUserAndGroupEntries permet de supprimer des utilisateurs ou des groupes de tous les rôles et de supprimer les ID utilisateur et les mots de passe de tous les rôles RunAs définis dans l'application.
Objet cible
Aucun.Paramètres obligatoires
- nom_application
- Indique l'application en question.
Paramètres optionnels
Aucun.Exemples
- Avec Jacl :
$AdminApp deleteUserAndGroupEntries myapp
- A l'aide de
la chaîne Jython :
print AdminApp.deleteUserAndGroupEntries('myapp')
- En langage Jython :
print AdminApp.deleteUserAndGroupEntries(['myapp'])
modification
La commande edit permet d'éditer une application ou un module en mode de traitement par lots. La commande edit modifie l'application indiquée par l'argument de nom d'application, à l'aide des options spécifiées par l'argument options. Aucune option n'est requise pour la commande edit.
Objet cible
Aucun.Paramètres obligatoires
- nom_application
- Indique l'application en question.
- options
- Indique les options à appliquer à la configuration de l'application ou du module.
Paramètres optionnels
Aucun.Exemples
- Avec Jacl :
$AdminApp edit "JavaMail Sample" {-MapWebModToVH {{"JavaMail Sample WebApp" mtcomps.war,WEB-INF/web.xml newVH}}}
- A l'aide de
la chaîne Jython :
print AdminApp.edit("JavaMail Sample", '[-MapWebModToVH [["JavaMail 32 Sample WebApp" mtcomps.war,WEB-INF/web.xml newVH]]]')
- En langage Jython :
option = [["JavaMail 32 Sample WebApp", "mtcomps.war,WEB-INF/web.xml", "newVH"]] mapVHOption = ["-MapWebModToVH", option] print AdminApp.edit("JavaMail Sample", mapVHOption)
editInteractive
La commande editInteractive permet d'éditer une application ou un module en mode interactif. La commande editInteractive modifie le déploiement de l'application. Spécifiez ces modifications dans le paramètre options. Aucune option n'est requise pour la commande editInteractive.
Objet cible
Aucun.Paramètres obligatoires
- nom_application
- Indique l'application en question.
- options
- Indique les options à appliquer à la configuration de l'application ou du module.
Paramètres optionnels
Aucun.Exemples
- Avec Jacl :
$AdminApp editInteractive ivtApp
- A l'aide de
la chaîne Jython :
AdminApp.editInteractive('ivtApp')
exportation
La commande export permet d'exporter le paramètre de nom d'application dans un fichier spécifié par son nom.
Objet cible
Aucun.Paramètres obligatoires
- nom_application
- Indique l'application en question.
- nom_fichier
- Indique le nom du fichier dans lequel exporter l'application désignée.
Paramètres optionnels
- exportToLocal
- Indique que la système doit exporter l'application qui vous intéresse avec le nom de fichier indiqué sur le système client local.
Exemples
- Avec Jacl :
$AdminApp export DefaultApplication c:/temp/export.ear {-exportToLocal}
- Langage
Jython :
AdminApp.export('DefaultApplication', 'c:/temp/export.ear', '[-exportToLocal]')
exportDDL
La commande exportDDL permet d'extraire le langage de définition de données (DDL) du paramètre de nom d'application dans le paramètre de nom de répertoire indiqué par un répertoire. Le paramètre options est facultatif.
Objet cible
Aucun.Paramètres obligatoires
- nom_application
- Indique l'application en question.
- nom_répertoire
- Indique le nom du répertoire dans lequel exporter l'application désignée.
Paramètres optionnels
- options
- Indique les options à transmettre à l'application spécifiée.
Exemples
- Avec Jacl :
$AdminApp exportDDL "My App" /usr/me/DDL {-ddlprefix myApp}
- A l'aide de
la chaîne Jython :
print AdminApp.exportDDL("My App", '/usr/me/DDL', '[-ddlprefix myApp]')
exportFile
La commande exportFile vous permet d'exporter le contenu d'un fichier unique indiqué par l'URI (Uniform Resource Identifier) à partir de l'application qui vous intéresse.
Objet cible
Aucun.Paramètres obligatoires
- nom_application
- Indique l'application en question.
- URI
- Indique le fichier unique à exporter. Indiquez l'URI dans le contexte d'une application, comme dans l'exemple suivant : META-INF/application.xml. Pour que les fichiers soient indiqués dans un module, l'URI commence par un URI de module, comme dans l'exemple suivant : foo.war/WEB-INF/web.xml.
- nom_fichier
- Indique le chemin d'accès complet et le nom du fichier vers lequel effectuer l'exportation.
Paramètres optionnels
Aucun.Exemples
- Avec Jacl :
$AdminApp exportFile "My App" myapp/components.jar/META-INF/ibm-ejb-jar-bnd.xml META-INF/ibm-ejb-jar-bnd.xml
- A l'aide de
la chaîne Jython :
AdminApp.exportFile('My App', 'myapp/components.jar/META-INF/ibm-ejb-jar-bnd.xml', 'META-INF/ibm-ejb-jar-bnd.xml')
getDeployStatus
La commande getDeployStatus permet d'afficher l'état de déploiement de l'application. Après l'installation ou la mise à jour d'une application de grande taille, cette commande permet d'afficher des informations d'état détaillées sur l'expansion des fichiers binaires de l'application. Vous ne pouvez pas démarrer l'application tant que le système n'a pas extrait les fichiers binaires associés à cette application.
Objet cible
Aucun.Paramètres obligatoires
- nom_application
- Indique le nom de l'application qui vous intéresse.
Paramètres optionnels
Aucun.Exemples
- A l'aide de Jacl :
$AdminApp getDeployStatus myApplication
- En langage Jython :
print AdminApp.getDeployStatus('myApplication')
L'exécution de la commande getDeployStatus, où myApplication correspond à DefaultApplication, permet d'afficher des informations d'état sur DefaultApplication, qui se présentent comme suit :
ADMA5071I: Distribution status check started for application DefaultApplication.
WebSphere:cell=myCell01,node=myNode01,distribution=unknown,expansion=unknown
ADMA5011I: The cleanup of the temp directory for application DefaultApplication is complete.
ADMA5072I: Distribution status check completed for application DefaultApplication.
WebSphere:cell=myCell01,node=myNode01,distribution=unknown,expansion=unknown
help
La commande help permet d'afficher des informations d'aide générales relatives à l'objet AdminApp.
Objet cible
Aucun.Paramètres obligatoires
Aucun.Paramètres optionnels
- nom_opération
- Indiquez cette option pour afficher l'aide d'une commande AdminApp ou d'une option d'installation.
Exemple de sortie
WASX7095I: The AdminApp object allows application objects to be manipulated including installing,
uninstalling, editing, and listing. Most of the commands supported by AdminApp operate in two modes:
the default mode is one in which AdminApp communicates with the application server to accomplish its
tasks. A local mode is also possible, in which no server communication takes place. The local mode of
operation is invoked by including the "-conntype NONE" flag in the option string supplied to the command.
The following commands are supported by AdminApp; more detailed information about each of these commands
is available by using the "help" command of AdminApp and supplying the name of the command as an argument.
edit Edit the properties of an application
editInteractive Edit the properties of an application interactively
export Export application to a file
exportDDL Extract DDL from application to a directory
help Show help information
install Installs an application, given a file name and an option string.
installInteractive Installs an application in interactive mode, given a file name and an option string.
list List all installed applications
listModules List the modules in a specified
application options Shows the options available, either for a given file, or in general.
taskInfo Shows detailed information pertaining to a given installation task for a given file
uninstall Uninstalls an application, given an application name and an option string
WASX7102I: Method: uninstall
Arguments: application name, options
Description: Uninstalls application named by "application name" using the options supplied by String 2.
Method: uninstall
Arguments: application name
Description: Uninstalls the application specified by "application name" using default options.
Exemples
- Dans l'exemple suivant, aucun argument n'est spécifié :
$AdminApp help
- Dans l'exemple suivant, l'argument de nom d'opération est spécifié :
$AdminApp help uninstall
- Dans l'exemple suivant, aucun argument n'est spécifié :
print AdminApp.help()
- Dans l'exemple suivant, l'argument de nom d'opération est spécifié :
print AdminApp.help('uninstall')
installer
La commande install permet d'installer une application en mode non interactif, en fonction d'un nom de fichier complet et d'une chaîne d'options d'installation. Le paramètre options est facultatif.
Objet cible
Aucun.Paramètres obligatoires
- fichier ear
- Indiquez le chemin du fichier .ear à installer.
Paramètres optionnels
- options
- Indiquez les options d'installation pour la commande.
Exemples
- A l'aide de Jacl :
$AdminApp install c:/apps/myapp.ear
- En langage Jython :
print AdminApp.install('c:/apps/myapp.ear')
Avec Jacl :
$AdminApp options myApp.ear
print AdminApp.options('myApp.ear')
En langage Jacl :
$AdminApp help MapModulesToServers
print AdminApp.help('MapModulesToServers')
installInteractive
La commande installInteractive permet d'installer une application en mode interactif, en fonction d'un nom de fichier complet et d'une chaîne d'options d'installation. Le paramètre options est facultatif.
Objet cible
Aucun.Paramètres obligatoires
- fichier ear
- Indiquez le chemin du fichier .ear à installer.
Paramètres optionnels
- options
- Indiquez les options d'installation pour la commande.
Exemples
- A l'aide de Jacl :
$AdminApp installInteractive c:/websphere/appserver/installableApps/jmsample.ear
- En langage Jython :
print AdminApp.installInteractive('c:/websphere/appserver/installableApps/jmsample.ear')
isAppReady
La commande isAppReady permet de vérifier si l'application indiquée a été distribuée et est prête à s'exécuter. Retourne la valeur true ou la valeur false selon que l'application est prête ou non. En général, un script qui appelle isAppReady installe ou met à jour une application, puis boucle l'appel jusqu'à ce que l'appel renvoie la valeur true avant le démarrage de l'application. Cette commande n'est pas prise en charge quand l'outil wsadmin n'est pas connecté à un serveur.
Objet cible
Aucun.Paramètres obligatoires
- nom_application
- Spécifiez le nom de l'application qui vous intéresse.
Paramètres optionnels
- ignoreUnknownState
- Vérifie si l'application indiquée a été distribuée et est prête à s'exécuter. Les valeurs admises du paramètre ignoreUnknownState sont true et false. Si vous indiquez true, les noeuds et les serveurs dont l'état est inconnu ne figureront pas dans la liste finale des ressources prêtes. La commande retourne la valeur true ou la valeur false selon que l'application est prête ou non. Cette commande n'est pas prise en charge quand l'outil wsadmin n'est pas connecté à un serveur.
Exemple de sortie
ADMA5071I: Distribution status check started for application
DefaultApplication.WebSphere:cell=Node03Cell,node=myNode,distribution=true
ADMA5011I: The cleanup of the temp directory for application DefaultApplication is complete.
ADMA5072I: Distribution status check completed for application DefaultApplication.true
ADMA5071I: Distribution status check started for application TEST.WebSphere:cell=myCell,node=myNode,
distribution=unknown
ADMA5011I: The cleanup of the temp directory for application TEST is complete.
ADMA5072I: Distribution status check completed for application TEST.false
Exemples
- A l'aide de Jacl :
set result [$AdminApp isAppReady DefaultApplication] while {$result == "false"} { ### Wait 5 seconds before checking again after 5000 set result [$AdminApp isAppReady DefaultApplication] } puts "Starting application..."
- En langage Jython :
import time result = AdminApp.isAppReady('DefaultApplication') while (result == "false") : ### Wait 5 seconds before checking again time.sleep(5) result = AdminApp.isAppReady ('DefaultApplication') print("Starting application...")
- A l'aide de Jacl :
set result [$AdminApp isAppReady DefaultApplication] while {$result == "false"} { ### Wait 5 seconds before checking again after 5000 set result [$AdminApp isAppReady DefaultApplication] } puts "Starting application..."
- En langage Jython :
import time result = AdminApp.isAppReady ('DefaultApplication') while (result == "false"): ### Wait 5 seconds before checking again time.sleep(5) result = AdminApp.isAppReady ('DefaultApplication') print("Starting application...")
list
La commande list répertorie les applications installées dans la configuration.
Objet cible
Aucun.Paramètres obligatoires
Aucun.Paramètres optionnels
- target
- Répertorie dans la configuration les applications installées dans une portée cible donnée .
Exemple de sortie
adminconsole
DefaultApplication
ivtApp
Exemples
- A l'aide de Jacl :
$AdminApp list
- En langage Jython :
print AdminApp.list()
- A l'aide de Jacl :
$AdminApp list WebSphere:cell=myCell,node=myNode,server=myServer
- En langage Jython :
print AdminApp.list("WebSphere:cell=myCell,node=myNode,server=myServer")
listModules
La commande listModules permet de répertorier les modules d'une application.
Objet cible
Aucun.Paramètres obligatoires
- nom_application
- Indique l'application en question.
Paramètres optionnels
- options
- Indique la liste des serveurs d'applications sur lesquels les modules sont installés. Le paramètre options est facultatif. L'option admise est -server.
Exemple de sortie
ivtApp#ivtEJB.jar+META-INF/ejb-jar.xml
ivtApp#ivt_app.war+WEB-INF/web.xml
Exemples
- A l'aide de Jacl :
$AdminApp listModules ivtApp
- En langage Jython :
print AdminApp.listModules('ivtApp')
options
La commande options permet d'afficher la liste des options d'installation d'un fichier EAR.
Objet cible
Aucun.Paramètres obligatoires
Aucun.Paramètres optionnels
- fichier EAR
- Indique le fichier EAR concerné.
- nom_application
- Indique l'application pour laquelle afficher une liste d'options pour modifier une application existante.
- nom_module_application
- Indique le nom du module pour lequel afficher une liste d'options pour modifier un module existant. Ce paramètre requiert le même format de nom de module que la sortie de la commande listModules.
- fichier, opérations
- Affiche une liste d'options pour installer ou mettre à jour une application ou un fichier de module d'application. Indiquez une des valeurs admises suivantes :
- installapp - Cette option permet d'installer le fichier indiqué.
- updateapp - Cette option permet de mettre à jour une application existante à l'aide du fichier indiqué.
- addmodule - Cette option permet d'ajouter le fichier de module indiqué à une application existante.
- updatemodule - Cette option permet de mettre à jour un module existant dans une application à l'aide du fichier de module indiqué.
Exemple de sortie
WASX7112I: The following options are valid for "ivtApp"
MapRolesToUsers
BindJndiForEJBNonMessageBinding
MapEJBRefToEJB
MapWebModToVH
MapModulesToServers
distributeApp
nodistributeApp
useMetaDataFromBinary
nouseMetaDataFromBinary
createMBeansForResources
nocreateMBeansForResources
reloadEnabled
noreloadEnabled
verbose
installed.ear.destination
reloadInterval
Exemples
- A l'aide de Jacl :
$AdminApp options c:/websphere/appserver/installableApps/ivtApp.ear
- En langage Jython :
print AdminApp.options('c:/websphere/appserver/installableApps/ivtApp.ear')
- A l'aide de Jacl :
$AdminApp options ivtApp
- En langage Jython :
print AdminApp.options('ivtApp')
- A l'aide de Jacl :
$AdminApp options ivtApp#ivtEJB.jar+META-INF/ejb-jar.xml
- En langage Jython :
print AdminApp.options('ivtApp#ivtEJB.jar+META-INF/ejb-jar.xml')
- A l'aide de Jacl :
$AdminApp options c:/websphere/appserver/installableApps/ivtApp.ear updateapp
- En langage Jython :
print AdminApp.options('c:/websphere/appserver/installableApps/ivtApp.ear', 'updateapp')
publishWSDL
La commande publishWSDL permet de publier des fichiers WSDL (Web Services Description Language) pour l'application spécifiée dans le paramètre de nom d'application dans le fichier mentionné dans le paramètre de nom de fichier.
Objet cible
Aucun.Paramètres obligatoires
- nom_fichier
- Indique le fichier en question.
- nom_application
- Indique l'application en question.
Paramètres optionnels
- préfixes_adresse_SOAP
- Indique les préfixes d'adresse SOAP à utiliser.
Exemple de sortie
La commande publishWSDL ne renvoie pas de sortie.
Exemples
- A l'aide de Jacl :
$AdminApp publishWSDL JAXRPCHandlerServer c:/temp/a.zip
- En langage Jython :
print AdminApp.publishWSDL('JAXRPCHandlerServer', 'c:/temp/a.zip')
- A l'aide de Jacl :
$AdminApp publishWSDL JAXRPCHandlersServer c:/temp/a.zip {{JAXRPCHandlersServerApp.war {{http http://localhost:9080}}}}
- En langage Jython :
print AdminApp.publishWSDL('JAXRPCHandlersServer', 'c:/temp/a.zip', '[[JAXRPCHandlersServerApp.war [[http http://localhost:9080]]]]')
searchJNDIReferences
La commande searchJNDIReferences permet de répertorier les applications faisant référence au nom JNDI (Java Naming and Directory Interface) sur un noeud spécifique.
Objet cible
Aucun.Paramètres obligatoires
- ID_configuration_noeud
- Indique l'ID configuration du noeud en question.
Paramètres optionnels
- options
- Indique les options à utiliser.
Exemple de sortie
WASX7410W: This operation may take a while depending on the number of applications installed in your system.
MyApp
MapResRefToEJB :ejb-jar-ic.jar : [eis/J2CCF1]
Exemples
- A l'aide de Jacl :
$AdminApp searchJNDIReferences $node {-JNDIName eis/J2CCF1 -verbose}
- En langage Jython :
print AdminApp.searchJNDIReferences(node, '[-JNDIName eis/J2CCF1 -verbose]')
taskInfo
La commande taskInfo permet de fournir des informations sur une option de tâche spécifique d'un fichier d'application. De nombreux noms de tâches ont été modifiés entre la version 5.x et la version 6.x pour des opérations identiques ou similaires. Pour faire migrer la version 5.x vers la version 6.x, il vous faudra peut-être effectuer une mise à jour des scripts.
Objet cible
Aucun.Paramètres obligatoires
- fichier EAR
- Indique le fichier EAR concerné.
- nom_tâche
- Indique la tâche pour laquelle demander les informations.
Paramètres optionnels
Aucun.Exemple de sortie
MapWebModToVH: Selecting virtual hosts for web modules
Specify the virtual host where you want to install the web modules that are contained in
your application. Web modules can be installed on the same virtual host or dispersed among several hosts.
Each element of the MapWebModToVH task consists of the following three fields: "webModule," "uri," "virtualHost."
Of these fields, the following fields might be assigned new values: "virtualHost"and the following are
required: "virtualHost"
The current contents of the task after running default bindings are:
webModule: JavaMail Sample WebApp
uri: mtcomps.war,WEB-INF/web.xml
virtualHost: default_host
Exemples
- A l'aide de Jacl :
$AdminApp taskInfo c:/websphere/appserver/installableApps/jmsample.ear MapWebModToVH
- En langage Jython :
print AdminApp.taskInfo('c:/websphere/appserver/installableApps/jmsample.ear', 'MapWebModToVH')
uninstall
La commande uninstall permet de désinstaller une application existante.
Objet cible
Aucun.Paramètres obligatoires
- nom_application
- Indique le nom de l'application à désinstaller.
Paramètres optionnels
- options
- Indique les options de désinstallation.
Exemple de sortie
ADMA5017I: Uninstallation of myapp started.
ADMA5104I: Server index entry for myCellManager was updated successfully.
ADMA5102I: Deletion of config data for myapp from config
repository completed successfully.
ADMA5011I: Cleanup of temp dir for app myapp done.
ADMA5106I: Application myapp uninstalled successfully.
Exemples
- A l'aide de Jacl :
$AdminApp uninstall myApp
- En langage Jython :
print AdminApp.uninstall('myApp')
update
La commande update permet de mettre à jour une application en mode non interactif. Cette commande prend en charge l'ajout, la suppression et la mise à jour des sous-composants ou de l'ensemble d'une application. Indiquez le nom de l'application, le type de contenu et les options de mise à jour.
Objet cible
Aucun.Paramètres obligatoires
- nom_application
- Indique le nom de l'application à mettre à jour.
- content type
- Utilisez le paramètre content type pour indiquer si vous souhaitez mettre à jour une partie ou l'ensemble de l'application. Les valeurs admises pour le paramètre content type de la commande update sont :
- app : Indique que vous souhaitez mettre à jour l'ensemble de l'application. Cette option revient à indiquer l'option update avec la commande install. Si vous indiquez la valeur app pour le type de contenu, vous devez indiquer l'option operation associée à la valeur update. Utilisez l'option contents pour fournir le nouveau fichier EAR (Enterprise Archive File). Vous pouvez également indiquer des informations de liaison et des options d'application. Par défaut, les informations de liaison des modules installés sont fusionnées avec les informations de liaison des modules mis à jour. Pour redéfinir le comportement par défaut, indiquez les options update.ignore.old ou update.ignore.new.
- file : Indique que vous souhaitez mettre à jour un seul fichier. Vous pouvez ajouter, supprimer ou mettre à jour des fichiers spécifiques à n'importe quel niveau de l'application déployée. Si vous indiquez la valeur file pour le type de contenu, vous devez effectuer des opérations sur le fichier en utilisant l'option operation. En fonction du type d'opération effectuée, d'autres options peuvent être nécessaires. Pour ajouter ou mettre à jour des fichiers, vous devez indiquer le contenu du fichier et l'URI relative du fichier par rapport au répertoire racine du fichier EAR, à l'aide des options contents et contenturi. Pour supprimer des fichiers, vous devez fournir l'URI relative du fichier par rapport au répertoire racine du fichier EAR, à l'aide de l'option contenturi, qui est la seule entrée obligatoire. Toutes les autres options sont ignorées.
- modulefile : Indique que vous souhaitez mettre à jour un module. Vous pouvez ajouter, supprimer ou mettre à jour un module d'application spécifique. Si vous indiquez la valeur modulefile en tant que type de contenu, vous devez indiquer l'opération à effectuer sur le module à l'aide de l'option operation. En fonction du type d'opération effectuée, d'autres options peuvent être nécessaires. Pour installer ou mettre à jour des modules dans une application, vous devez indiquer le contenu du fichier et l'URI relative du fichier par rapport au répertoire racine du fichier EAR, à l'aide des options contents et contenturi. Vous pouvez également indiquer des informations de liaison relatives à des modules nouveaux ou mis à jour. Pour les mises à jour de modules, les informations de liaison du module installé sont fusionnées avec les informations de liaison du module d'entrée par défaut. Pour redéfinir le comportement par défaut, indiquez les options update.ignore.old ou update.ignore.new. Pour supprimer un module, indiquez l'URI relative du fichier par rapport au répertoire racine du fichier EAR.Restriction : En général, vous ne pouvez pas ajouter ou mettre à jour un module s'il repose sur des classes situées en dehors de lui-même, par exemple des classes contenues dans une bibliothèque ou un module optionnel. Le traitement côté client induit une analyse des classes du module d'entrée et le chargement de ces classes peut échouer si leurs dépendances ne sont pas résolues. Vous pouvez ajouter ou mettre à jour un module si vous rendez les classes requises disponibles dans un système de fichiers accessible via les outils de script de wsadmin. Avec les outils de script de wsadmin, vous pouvez modifier la propriété com.ibm.ws.scripting.classpath contenue dans le fichier profile_root/properties/wsadmin.properties afin d'incorporer ces classes et que le chargeur de classe puisse les résoudre.
- partialapp : Indique que vous souhaitez mettre à jour une partie de l'application. Un sous-ensemble des composants d'application fourni sous la forme d'un fichier .zip compressé permet de mettre à jour, d'ajouter et de supprimer des fichiers et des modules. Le fichier compressé n'est pas une archive J2EE (Java 2 platform, Enterprise Edition) valide. Ici, le fichier contient des artefacts d'application placés dans la même structure hiérarchique que celle d'un fichier EAR. Pour plus d'informations sur la création du fichier compressé de l'application partielle, reportez-vous à la section relative à l'API Java. Si vous indiquez la valeur partialapp comme type de contenu, utilisez l'option contents pour indiquer l'emplacement du fichier compressé. Lorsqu'une partie de l'application est fournie sous la forme d'une mise à jour, vous ne pouvez pas indiquer les informations de liaison ni les options de l'application. Si elles sont indiquées, elles sont ignorées.
Paramètres optionnels
- options
- De nombreuses options sont disponibles pour la commande update. Pour connaître la liste de chaque option valide associée à la commande update, voir Options des commandes install, installInteractive, edit, editInteractive, update et updateInteractive de l'objet AdminApp avec les outils de script de wsadmin.
Exemple de sortie
Update of singleFile has started.
ADMA5009I: Application archive extracted at C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\ext
Added files from partial ear: []
performFileOperation: source=C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\ext,
dest=C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\mrg, uri= META-INF/web.xml, op= add
Copying file from C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\ext/META-INF/web.xml to
C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\mrg\META-INF\web.xml
Collapse list is: []
FileMergeTask completed successfully
ADMA5005I: Application singleFile configured in WebSphere repository
delFiles: []
delM: null
addM: null
Pattern for remove loose and mod:
Loose add pattern: META-INF/[^/]*|WEB-INF/[^/]*|.*wsdl
root file to be copied: META-INF/web.xml to
C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a191b4e\workspace\cells\BAMBIE\applications\
singleFile.ear\deployments\singleFile/META-INF/web.xml
ADMA5005I: Application singleFile configured in WebSphere repository xmlDoc: [#document: null]
root element: [app-delta: null]
****** delta file name: C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a191b4e\workspace\cells\BAMBIE\applications\
singleFile.ear/deltas/delta-1079548405564
ADMA5005I: Application singleFile configured in WebSphere repository
ADMA6011I: Deleting directory tree C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0
ADMA5011I: Cleanup of temp dir for app singleFile done.
Update of singleFile has ended.
Exemples
- A l'aide de Jacl :
$AdminApp update myApp file {-operation add -contents c:/apps/myApp/web.xml -contenturi META-INF/web.xml}
$AdminApp update myApp file {-operation add -contents /apps/myApp/web.xml -contenturi META-INF/web.xml}
- En langage Jython :
print AdminApp.update('myApp', 'file', '[-operation add -contents c:/apps/myApp/web.xml -contenturi META-INF/web.xml]')
print AdminApp.update('myApp', 'file', '[-operation add -contents /apps/myApp/web.xml -contenturi META-INF/web.xml]')
- A l'aide de la liste Jython :
print AdminApp.update('myApp', 'file', ['-operation', 'add', '-contents', 'c:/apps/myApp/web.xml', '-contenturi', 'META-INF/web.xml'])
print AdminApp.update('myApp', 'file', ['-operation', 'add', '-contents', '/apps/myApp/web.xml', '-contenturi', 'META-INF/web.xml'])
updateAccessIDs
La commande updateAccessIDs permet de mettre à jour les informations relatives aux ID accès des utilisateurs et des groupes affectés à divers rôles définis dans l'application. Les ID accès sont lus dans le registre d'utilisateurs et sauvegardés dans les liaisons de l'application. Cette opération améliore les performances d'exécution de l'application. Vous devez utiliser cette commande après avoir installé une application ou après avoir édité les informations relatives au rôle de sécurité d'une application installée. Cette méthode ne peut pas être appelée lorsque l'option -conntype de l'outil wsadmin a pour valeur NONE. Vous devez être connecté à un serveur pour pouvoir appeler cette commande.
Objet cible
Aucun.Paramètres obligatoires
- nom_application
- Indique le nom de l'application qui vous intéresse.
- bALL
- Le paramètre booléen bALL extrait et sauvegarde tous les ID accès des utilisateurs et des groupes dans les liaisons de l'application. Spécifiez false pour extraire les ID accès des utilisateurs et des groupes ne possédant pas d'ID accès dans les liaisons de l'application.
Exemples
- Utilisation de Jacl pour true :
$AdminApp updateAccessIDs myapp true
- Utilisation de Jacl pour false :
$AdminApp updateAccessIDs myapp false
- Utilisation de Jython pour true :
print AdminApp.updateAccessIDs('myapp', 1)
- Utilisation de Jython pour false :
print AdminApp.updateAccessIDs('myapp', 0)
updateInteractive
Utilisez la commande updateInteractive pour ajouter, supprimer et mettre à jour les sous-composants ou l'ensemble d'une application. Lorsque vous mettez à jour un module ou l'ensemble d'une application à l'aide du mode interactif, les étapes à suivre pour configurer les informations de liaison sont comparables à celles utilisées pour la commande installInteractive. Si vous mettez à jour un fichier ou une partie de l'application, la procédure à suivre pour configurer les informations de liaison n'est pas disponible. Dans ce cas, les étapes sont comparables à celles utilisées pour la commande update.
Objet cible
Aucun.Paramètres obligatoires
- nom_application
- Indique le nom de l'application à mettre à jour.
- content type
- Utilisez le paramètre content type pour indiquer si vous souhaitez mettre à jour une partie ou l'ensemble de l'application. Les valeurs admises pour le paramètre content type de la commande updateInteractive sont :
- app : Indique que vous souhaitez mettre à jour l'ensemble de l'application. Cette option revient à indiquer l'option update avec la commande install. Si vous indiquez la valeur app pour le type de contenu, vous devez indiquer l'option operation associée à la valeur update. Utilisez l'option contents pour fournir le nouveau fichier EAR (Enterprise Archive File). Vous pouvez également indiquer des informations de liaison et des options d'application. Par défaut, les informations de liaison des modules installés sont fusionnées avec les informations de liaison des modules mis à jour. Pour redéfinir le comportement par défaut, indiquez les options update.ignore.old ou update.ignore.new.
- file : Indique que vous souhaitez mettre à jour un seul fichier. Vous pouvez ajouter, supprimer ou mettre à jour des fichiers spécifiques à n'importe quel niveau de l'application déployée. Si vous indiquez la valeur file pour le type de contenu, vous devez effectuer des opérations sur le fichier en utilisant l'option operation. En fonction du type d'opération effectuée, d'autres options peuvent être nécessaires. Pour ajouter ou mettre à jour des fichiers, vous devez indiquer le contenu du fichier et l'URI relative du fichier par rapport au répertoire racine du fichier EAR, à l'aide des options contents et contenturi. Pour supprimer des fichiers, vous devez fournir l'URI relative du fichier par rapport au répertoire racine du fichier EAR, à l'aide de l'option contenturi, qui est la seule entrée obligatoire. Toutes les autres options sont ignorées.
- modulefile : Indique que vous souhaitez mettre à jour un module. Vous pouvez ajouter, supprimer ou mettre à jour un module d'application spécifique. Si vous indiquez la valeur modulefile en tant que type de contenu, vous devez indiquer l'opération à effectuer sur le module à l'aide de l'option operation. En fonction du type d'opération effectuée, d'autres options peuvent être nécessaires. Pour installer ou mettre à jour des modules dans une application, vous devez indiquer le contenu du fichier et l'URI relative du fichier par rapport au répertoire racine du fichier EAR, à l'aide des options contents et contenturi. Vous pouvez également indiquer des informations de liaison relatives à des modules nouveaux ou mis à jour. Pour les mises à jour de modules, les informations de liaison du module installé sont fusionnées avec les informations de liaison du module d'entrée par défaut. Pour redéfinir le comportement par défaut, indiquez les options update.ignore.old ou update.ignore.new. Pour supprimer un module, indiquez l'URI relative du fichier par rapport au répertoire racine du fichier EAR.Restriction : En général, vous ne pouvez pas ajouter ou mettre à jour un module s'il repose sur des classes situées en dehors de lui-même, par exemple des classes contenues dans une bibliothèque ou un module optionnel. Le traitement côté client induit une analyse des classes du module d'entrée et le chargement de ces classes peut échouer si leurs dépendances ne sont pas résolues. Vous pouvez ajouter ou mettre à jour un module si vous rendez les classes requises disponibles dans un système de fichiers accessible via les outils de script de wsadmin. Avec les outils de script de wsadmin, vous pouvez modifier la propriété com.ibm.ws.scripting.classpath contenue dans le fichier profile_root/properties/wsadmin.properties afin d'incorporer ces classes et que le chargeur de classe puisse les résoudre.
- partialapp : Indique que vous souhaitez mettre à jour une partie de l'application. Un sous-ensemble des composants d'application fourni sous la forme d'un fichier .zip compressé permet de mettre à jour, d'ajouter et de supprimer des fichiers et des modules. Le fichier compressé n'est pas une archive J2EE (Java 2 platform, Enterprise Edition) valide. Ici, le fichier contient des artefacts d'application placés dans la même structure hiérarchique que celle d'un fichier EAR. Pour plus d'informations sur la création du fichier compressé de l'application partielle, reportez-vous à la section relative à l'API Java. Si vous indiquez la valeur partialapp comme type de contenu, utilisez l'option contents pour indiquer l'emplacement du fichier compressé. Lorsqu'une partie de l'application est fournie sous la forme d'une mise à jour, vous ne pouvez pas indiquer les informations de liaison ni les options de l'application. Si elles sont indiquées, elles sont ignorées.
Paramètres optionnels
- options
- De nombreuses options sont disponibles pour la commande updateInteractive. Pour connaître la liste de chaque option valide associée à la commande updateInteractive, voir Options des commandes install, installInteractive, edit, editInteractive, update et updateInteractive de l'objet AdminApp avec les outils de script de wsadmin.
Exemple de sortie
Getting tasks for: myApp
WASX7266I: A was.policy file exists for this application; would you like to display it? [No]
Task[4]: Binding enterprise beans to JNDI names
Each non message driven enterprise bean in your application or module must be bound to a JNDI name.
EJB Module: Increment EJB module
EJB: Increment
URI: Increment.jar,META-INF/ejb-jar.xml
JNDI Name: [Inc]:
Task[10]: Specifying the default data source for
EJB 2.x modules
Specify the default data source for
the EJB 2.x Module containing 2.x CMP beans.
WASX7349I: Possible value for resource authorization is container or per connection factory
EJB Module: Increment EJB module
URI: Increment.jar,META-INF/ejb-jar.xml
JNDI Name: [DefaultDatasource]:
Resource Authorization: [Per connection factory]:
Task[12]: Specifying data sources for individual 2.x CMP beans
Specify an optional data source for each 2.x CMP bean. Mapping a specific data source to a CMP bean overrides
the default data source for the module containing the enterprise bean.
WASX7349I: Possible value for resource authorization is container or per connection factory
EJB Module: Increment EJB module
EJB: Increment
URI: Increment.jar,META-INF/ejb-jar.xml
JNDI Name: [DefaultDatasource]:
Resource Authorization: [Per connection factory]:container
Setting "Resource Authorization" to "cmpBinding.container"
Task[14]: Selecting Application Servers
Specify the application server where you want to install modules that are contained in your application.
Modules can be installed on the same server or dispersed among several servers.
Module: Increment EJB module
URI: Increment.jar,META-INF/ejb-jar.xml
Server: [WebSphere:cell=myCell,node=myNode,server=server1]:
Task[16]: Selecting method protections for unprotected methods for 2.x EJB
Specify whether you want to assign security role to the unprotected method, add the method to the exclude list, or mark
the method as unchecked.
EJB Module: Increment EJB module
URI: Increment.jar,META-INF/ejb-jar.xml
Protection Type: [methodProtection.uncheck]:
Task[18]: Selecting backend ID
Specify the selection for the BackendID
EJB Module: Increment EJB module
URI: Increment.jar,META-INF/ejb-jar.xml
BackendId list: CLOUDSCAPE_V50_1
CurrentBackendId: [CLOUDSCAPE_V50_1]:
Task[21]: Specifying application options
Specify the various options available to prepare and install your application.
Pre-compile JSP: [No]:
Deploy EJBs: [No]:
Deploy WebServices: [No]:
Task[22]: Specifying EJB deploy options
Specify the options to deploy EJB.
....EJB Deploy option is not enabled.
Task[24]: Copy WSDL files
Copy WSDL files
....This task does not require any user input
Task[25]: Specify options to deploy web services
Specify options to deploy web services
....Web services deploy option is not enabled.
Update of myApp has started.
ADMA5009I: Application archive extracted at C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a48e969\ext/Increment.jar
FileMergeTask completed successfully
ADMA5005I: Application myApp configured in WebSphere repository
delFiles: []
delM: null
addM: [Increment.jar, ]
Pattern for remove loose and mod:
Loose add pattern: META-INF/[^/]*|WEB-INF/[^/]*|.*wsdl
root file to be copied:
META-INF/application.xml to C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/META-INF/application.xml
del files for full module add/update: []
ADMA6017I: Saved document C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/ejb-jar.xml
ADMA6016I: Add to workspace Increment.jar/META-INF/ejb-jar.xml
ADMA6017I: Saved document C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/MANIFEST.MF
ADMA6016I: Add to workspace Increment.jar/META-INF/MANIFEST.MF
ADMA6017I: Saved document C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/ibm-ejb-jar-bnd.xmi
ADMA6016I: Add to workspace Increment.jar/META-INF/ibm-ejb-jar-bnd.xmi
ADMA6017I: Saved document C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/Table.ddl
ADMA6016I: Add to workspace Increment.jar/META-INF/Table.ddl
ADMA6017I: Saved document C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/ibm-ejb-jar-ext.xmi
ADMA6016I: Add to workspace Increment.jar/META-INF/ibm-ejb-jar-ext.xmi
add files for full module add/update: [Increment.jar/META-INF/ejb-jar.xml, Increment.jar/META-INF/MANIFEST.MF,
Increment.jar/META-INF/ibm-ejb-jar-bnd.xmi,
Increment.jar/META-INF/Table.ddl, Increment.jar/META-INF/ibm-ejb-jar-ext.xmi]
ADMA5005I: Application myApp configured in WebSphere repository
xmlDoc: [#document: null]
root element: [app-delta: null]
****** delta file name: C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear/deltas/delta-1079551520393
ADMA5005I: Application myApp configured in WebSphere repository
ADMA6011I: Deleting directory tree C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a48e969
ADMA5011I: Cleanup of temp dir for app myApp done.
Update of myApp has ended.
Exemples
- A l'aide de Jacl :
$AdminApp updateInteractive myApp modulefile {-operation add -contents c:/apps/myApp/Increment.jar -contenturi Increment.jar -nodeployejb -BindJndiForEJBNonMessageBinding {{"Increment EJB module" Increment Increment.jar,META-INF/ejb-jar.xml Inc}}}
$AdminApp updateInteractive myApp modulefile {-operation add -contents /apps/myApp/Increment.jar -contenturi Increment.jar -nodeployejb -BindJndiForEJBNonMessageBinding {{"Increment EJB module" Increment Increment.jar,META-INF/ejb-jar.xml Inc}}}
- En langage Jython :
print AdminApp.updateInteractive('myApp', 'modulefile', '[-operation add -contents c:/apps/myApp/Increment.jar -contenturi Increment.jar -nodeployejb -BindJndiForEJBNonMessageBinding [["Increment EJB module" Increment Increment.jar,META-INF/ejb-jar.xml Inc]]]')
print AdminApp.updateInteractive('myApp', 'modulefile', '[-operation add -contents /apps/myApp/Increment.jar -contenturi Increment.jar -nodeployejb -BindJndiForEJBNonMessageBinding [["Increment EJB module" Increment Increment.jar,META-INF/ejb-jar.xml Inc]]]')
- A l'aide de la liste Jython :
bindJndiForEJBValue = [["Increment EJB module", "Increment","Increment.jar,META-INF/ejb-jar.xml", "Inc"]] print AdminApp.updateInteractive('myApp', 'modulefile', ['-operation', 'add', '-contents', 'c:/apps/myApp/Increment.jar', '-contenturi', 'Increment.jar', '-nodeployejb', '-BindJndiForEJBNonMessageBinding', bindJndiForEJBValue])
bindJndiForEJBValue = [["Increment EJB module", "Increment", "Increment.jar,META-INF/ejb-jar.xml", "Inc"]] print AdminApp.updateInteractive('myApp', 'modulefile', ['-operation', 'add', '-contents', '/apps/myApp/Increment.jar', '-contenturi', 'Increment.jar', '-nodeployejb', '-BindJndiForEJBNonMessageBinding', bindJndiForEJBValue])
view
La commande view permet d'afficher la tâche spécifiée par le paramètre de nom de tâche pour l'application ou le module spécifié par le paramètre de nom d'application. Utilisez l'option -tasknames pour obtenir une liste des noms de tâche valides pour l'application. Vous pouvez également spécifier un ou plusieurs noms de tâche comme option.
Objet cible
Aucun.Paramètres obligatoires
- Nom
- Indique le nom de l'application ou du module à afficher.
Paramètres optionnels
- bALL
- Le paramètre booléen bALL extrait et sauvegarde tous les ID accès des utilisateurs et des groupes dans les liaisons de l'application. Spécifiez false pour extraire les ID accès des utilisateurs et des groupes ne possédant pas d'ID accès dans les liaisons de l'application.
- -buildVersion
- Indique si la version de génération de l'application qui vous intéresse doit ou non être affichée.
Exemple de sortie
MapModulesToServers
MapWebModToVH
MapRolesToUsers
MapModulesToServers: Selecting Application Servers
Specify the application server where you want to install the modules that are contained in your
application. Modules can be installed on the same server or dispersed among several servers:
Module: adminconsole
URI: adminconsole.war,WEB-INF/web.xml
Server: WebSphere:cell=juniartiNetwork,
node=juniartiManager,server=dmgr
Exemples
- A l'aide de Jacl :
$AdminApp view DefaultApplication {-tasknames}
- En langage Jython :
print AdminApp.view('DefaultApplication', ['-tasknames'])
- A l'aide de Jacl :
$AdminApp view DefaultApplication {-MapModulesToServers}
- En langage Jython :
print AdminApp.view('DefaultApplication', ['-MapModulesToServers'])
- A l'aide de Jacl :
$AdminApp view DefaultApplication {-AppDeploymentOptions}
- En langage Jython :
print AdminApp.view('DefaultApplication', '-AppDeploymentOptions')
- A l'aide de Jacl :
$AdminApp view DefaultApplication {-buildVersion}
- En langage Jython :
print AdminApp.view('DefaultApplication', '-buildVersion')