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]Important : Si vous déployez une application en mode local avec la commande wsadmin -conntype NONE, vous devez modifier le fichier wsadmin.bat ou wsadmin.sh qui se trouve dans le répertoire install_root/bin. Effectuez les étapes suivantes :
  1. Faites une copie de sauvegarde du fichier racine_install/bin/wsadmin.bat ou rep_install/bin/wsadmin.bat.
  2. Ajoutez les lignes de code suivantes dans le fichier wsadmin juste après l'appel au fichier setupCmdLine.bat ou setupCmdLine.sh :
    [AIX]
    LIBPATH="$WAS_LIBPATH":$LIBPATH
    export LIBPATH EXTSHM
    [HP-UX]
    SHLIB_PATH="$WAS_LIBPATH":$SHLIB_PATH
    export SHLIB_PATH
    [Linux][Solaris]
    LD_LIBRARY_PATH="$WAS_LIBPATH":$LD_LIBRARY_PATH
    export LD_LIBRARY_PATH
    [Windows]
    SET PATH=%WAS_PATH%
    Eviter les incidents 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
  3. Enregistrez le fichier mis à jour wsadmin.bat ou wsadmin.sh.
  4. 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.

La remarque suivante s'applique aux références de fichier xmi dans cette rubrique :
Configurations prises en charge Configurations prises en charge: Pour les fichiers de liaison et d'extension IBM®, l'extension de nom de fichier .xmi ou .xml est différente selon que vous utilisiez un module ou une application antérieure à Java EE 5 ou un module ou une application ultérieure à Java™ EE 5. Un fichier de liaison ou d'extension IBM porte le nom ibm-*-ext.xmi ou ibm-*-bnd.xmi où * correspond au fichier d'extension ou de liaison, tel app, application, ejb-jar ou web. Les conditions suivantes s'appliquent :
  • Pour une application ou un module qui utilise une version Java EE antérieure à la version 5, l'extension de fichier doit être .xmi.
  • Pour une application ou un module qui utilise Java EE 5 ou version ultérieure, l'extension de fichier doit être .xml. Si des fichiers .xmi sont inclus dans l'application ou le module, le produit les ignore.

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.

sptcfg

deleteUserAndGroupEntries

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

La sortie suivante est renvoyée si aucun argument n'est défini :
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
La sortie suivante est renvoyée si vous spécifiez uninstall comme argument de nom d'opération :
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

Avec Jacl :
  • 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
En langage Jython :
  • 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')
Plusieurs options sont disponibles pour cette commande. Vous pouvez obtenir la liste des options valides d'un fichier EAR (enterprise archive) à l'aide de la commande suivante :

Avec Jacl :

$AdminApp options myApp.ear
Langage Jython :
print AdminApp.options('myApp.ear')
Vous pouvez également obtenir l'aide de chaque objet à l'aide de la commande suivante :

En langage Jacl :

$AdminApp help MapModulesToServers
Langage Jython :
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

La sortie suivante est renvoyée si vous spécifiez le paramètre de nom d'application :
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
La sortie suivante est renvoyée si vous spécifiez le paramètre de nom d'application et le paramètre ignoreUnknownState :
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

Les exemples ci-dessous spécifient uniquement le paramètre de nom d'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...")
Les exemples suivants spécifient les paramètres de nom d'application et ignoreUnknownState :
  • 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()
Les exemples suivants spécifient une valeur pour le paramètre cible :
  • 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

L'exemple suivant est la concaténation de nomapp, #, URI module, + et URI DD. Vous pouvez transmettre cette chaîne aux commandes AdminApp edit et editInteractive.
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

La commande options dans l'exemple suivant renvoie les options valides pour un fichier EAR :
  • 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')
La commande options dans l'exemple suivant renvoie les options valides pour une application :
  • A l'aide de Jacl :
    $AdminApp options ivtApp
  • En langage Jython :
    print AdminApp.options('ivtApp')
La commande options dans l'exemple suivant renvoie les options valides pour un module d'application :
  • 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')
La commande options de l'exemple suivant renvoie les options valides disponibles pour l'opération demandée par le fichier d'entrée:
  • 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

La commande publishWSDL de l'exemple suivant indique le nom d'application et le nom de fichier :
  • A l'aide de Jacl :
    $AdminApp publishWSDL JAXRPCHandlerServer c:/temp/a.zip
  • En langage Jython :
    print AdminApp.publishWSDL('JAXRPCHandlerServer', 'c:/temp/a.zip')
La commande publishWSDL de l'exemple suivant indique les valeurs des paramètres de nom d'application, de nom de fichier et de préfixes d'adresse SOAP :
  • 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

L'exemple suivant présuppose qu'une application installée appelée MyApp porte le nom JNDI eis/J2CCF1 :
  • 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 :
    [AIX Solaris HP-UX Linux Windows]
    $AdminApp update myApp file {-operation add -contents c:/apps/myApp/web.xml 
    -contenturi META-INF/web.xml}
    [z/OS]
    $AdminApp update myApp file {-operation add -contents /apps/myApp/web.xml 
    -contenturi META-INF/web.xml}
  • En langage Jython :
    [AIX Solaris HP-UX Linux Windows]
    print AdminApp.update('myApp', 'file', '[-operation add -contents c:/apps/myApp/web.xml 
    -contenturi META-INF/web.xml]')
    [z/OS]
    print AdminApp.update('myApp', 'file', '[-operation add -contents /apps/myApp/web.xml 
    -contenturi META-INF/web.xml]')
  • A l'aide de la liste Jython :
    [AIX Solaris HP-UX Linux Windows]
    print AdminApp.update('myApp', 'file', ['-operation', 'add', '-contents', 'c:/apps/myApp/web.xml',
     '-contenturi',  'META-INF/web.xml'])
    [z/OS]
    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 :
    [AIX Solaris HP-UX Linux Windows]
    $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}}}
    [z/OS]
    $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 :
    [AIX Solaris HP-UX Linux Windows]
    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]]]')
    [z/OS]
    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 :
    [AIX Solaris HP-UX Linux Windows]
    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])
    [z/OS]
    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

La commande renvoie les informations suivantes si vous spécifiez la valeur taskoptions pour le paramètre de nom de tâche :
MapModulesToServers
MapWebModToVH
MapRolesToUsers
La commande renvoie les informations suivantes si vous spécifiez la tâche mapModulesToServers pour le paramètre de nom de tâche :
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

La commande view dans l'exemple suivant répertorie chaque nom de tâche disponible :
  • A l'aide de Jacl :
    $AdminApp view DefaultApplication {-tasknames}
  • En langage Jython :
    print AdminApp.view('DefaultApplication', ['-tasknames'])
La commande view dans l'exemple suivant renvoie des informations relatives à la tâche mapModulesToServer :
  • A l'aide de Jacl :
    $AdminApp view DefaultApplication {-MapModulesToServers}
  • En langage Jython :
    print AdminApp.view('DefaultApplication', ['-MapModulesToServers'])
La commande view dans l'exemple suivant renvoie des informations relatives à la tâche AppDeploymentOptions :
  • A l'aide de Jacl :
    $AdminApp view DefaultApplication {-AppDeploymentOptions}
  • En langage Jython :
    print AdminApp.view('DefaultApplication', '-AppDeploymentOptions')
La commande view dans l'exemple suivant renvoie le numéro de version de génération de l'application ApplicationParDéfaut :
  • A l'aide de Jacl :
    $AdminApp view DefaultApplication {-buildVersion}
  • En langage Jython :
    print AdminApp.view('DefaultApplication', '-buildVersion')

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_adminapp
Nom du fichier : rxml_adminapp.html