Installation d'applications d'entreprise à l'aide de l'outil de scriptage wsadmin

Utilisez l'objet AdminApp ou la bibliothèque de scripts AdminApplication pour installer une application dans l'environnement d'exécution du serveur d'applications. Vous pouvez installer un fichier EAR (fichier d'archive d'entreprise), WAR (fichier d'archive d'application web), SAR (fichier d'archive de servlet) ou JAR (fichier d'archive Java™).

Avant de commencer

Si l'installation comporte un déploiement réseau, vérifiez que le gestionnaire de déploiement est en cours d'exécution avant d'installer une application. Utilisez l'utilitaire de commande startManager pour démarrer le gestionnaire de déploiement.

Vous disposez de deux méthodes pour effectuer cette tâche. Grâce à la procédure détaillée dans cette rubrique, vous allez installer des applications d'entreprise à l'aide de l'objet AdminApp. Mais, pour installer, désinstaller et administrer la configuration de vos applications, vous pouvez aussi utiliser les scripts de la bibliothèque de scripts AdminApplication.

La bibliothèque de scripts propose un ensemble de procédures permettant d'automatiser les fonctions d'administration les plus courantes. Vous pouvez exécuter chaque procédure de script individuellement ou combiner plusieurs procédures pour développer rapidement de nouveaux scripts.

Pourquoi et quand exécuter cette tâche

Cette rubrique vous permet d'installer une application issue d'un fichier EAR (fichier d'archive d'entreprise), WAR (fichier d'archive d'application web), SAR (fichier d'archive de servlet) ou JAR (fichier d'archive Java). Pour que l'outil wsadmin puisse effectuer cette installation, le fichier d'archive doit être doté de l'extension .ear, .jar, .sar ou .war. L'outil wsadmin utilise ces extensions pour déterminer le type d'archive. L'outil wsadmin encapsule automatiquement les fichiers WAR et JAR en tant que fichier EAR.

Pratiques recommandées Pratiques recommandées: Afin de garantir la disponibilité des options et des commandes wsadmin les plus récentes, utilisez la version la plus récente de l'outil wsadmin lorsque vous installez des applications dans des environnements avec des versions mixtes. bprac

Procédure

  1. Démarrez l'outil de scriptage wsadmin.
  2. Déterminez les options à utiliser pour installer l'application dans votre configuration.

    Par exemple, si la configuration comprend un noeud, une cellule et un serveur, vous pouvez l'indiquer dans la commande install. Examinez la liste des options valides pour les commandes install et installinteractive de la rubrique Options des commandes install, installInteractive, edit, editInteractive, update et updateInteractive de l'objet AdminApp avec les outils de script de wsadmin pour obtenir la syntaxe correcte des options -node, -cell et -server. Pour cette configuration, utilisez les exemples de commande suivants :

    En langage Jython :
    AdminApp.install('location_of_ear.ear','[-node nomNoeud -cell nomCellule -server nomServeur]')
    A l'aide de Jacl :
    $AdminApp install "emplacement_de_ear.ear" {-node nom_noeud -cell nom_cellule -server nom_serveur}

    Vous pouvez également obtenir la liste des options prises en charge pour un fichier EAR (fichier d'archive d'entreprise) à l'aide de la commande options. Exemple :

    En langage Jython :
    print AdminApp.options()
    A l'aide de Jacl :
    $AdminApp options

    Vous pouvez définir ou mettre à jour une valeur de configuration en utilisant les options en mode de traitement par lot. Pour identifier l'objet de configuration à définir ou mettre à jour, les valeurs des zones en lecture seule sont utilisées pour rechercher l'objet de configuration correspondant. Toutes les valeurs des zones en lecture seule doivent correspondre à un objet de configuration existant pour que la commande aboutisse.

    Vous pouvez utiliser l'appariement de formes pour simplifier la tâche de spécification des valeurs requises pour certaines options complexes. L'appariement de formes ne s'applique qu'aux zones requises ou en lecture seule.

  3. Choisissez la commande install ou installInteractive pour installer l'application.

    Vous pouvez installer l'application en mode différé, en utilisant la commande install ou en mode interactif, au moyen de la commande installinteractive. En mode interactif, une série de tâches vous invite à fournir des informations. Les commandes install et installinteractive prennent en charge l'ensemble d'options sélectionné pour l'installation au cours de l'étape précédente.

  4. Installez l'application. Pour cet exemple, seule l'option -server est utilisée avec la commande install, où la valeur de l'option -server est serv2. Personnalisez la commande install ou installinteractive à l'aide d'une des options choisies en fonction de votre configuration.
    • Utilisez la commande install pour installer l'application en mode par lots :
      • Dans une installation de Network Deployment uniquement, la commande suivante utilise le fichier EAR et les informations d'options de commande pour installer l'application sur un cluster :
        • Avec la chaîne Jython :

          [AIX Solaris HP-UX Linux Windows]
          AdminApp.install('c:/MyStuff/application1.ear', '[-cluster cluster1]')
          [z/OS]
          AdminApp.install('MyStuff/application1.ear', '[-cluster cluster1]')
          [IBM i]
          AdminApp.install('/home/myProfile/MyStuff/application1.ear', '[-cluster cluster1]')
        • A l'aide de la liste Jython :

          [AIX Solaris HP-UX Linux Windows]
          AdminApp.install('c:/MyStuff/application1.ear', ['-cluster', 'cluster1'])
          [z/OS]
          AdminApp.install('MyStuff/application1.ear', ['-cluster', 'cluster1'])
          [IBM i]
          AdminApp.install('/home/myProfile/MyStuff/application1.ear', ['-cluster', 'cluster1'])
        • A l'aide de Jacl :

          [AIX Solaris HP-UX Linux Windows]
          $AdminApp install "c:/MyStuff/application1.ear" {-cluster cluster1}
          [z/OS]
          $AdminApp install "MyStuff/application1.ear" {-cluster cluster1}
          [IBM i]
          $AdminApp install "/home/myProfile/MyStuff/application1.ear" {-cluster cluster1}
        Tableau 1. Eléments de la commande install cluster. Exécutez la commande install avec l'option -cluster.
        Elément Description
        $ est un opérateur Jacl permettant de remplacer un nom de variable par sa valeur
        AdminApp est un objet autorisant la gestion des objets application
        install est une commande AdminApp
        MyStuff/application1.ear est le nom de l'application à installer
        cluster est une option d'installation
        cluster1 est le valeur de l'option cluster qui deviendra le nom du cluster
    • Utilisez la commande installInteractive pour installer l'application en mode interactif. La commande suivante modifie les informations de l'application en vous invitant à effectuer une série de tâches d'installation :
      • En langage Jython :

        [AIX Solaris HP-UX Linux Windows]
        AdminApp.installInteractive('c:/MyStuff/application1.ear')
        [z/OS]
        AdminApp.installInteractive('MyStuff/application1.ear')
        [IBM i]
        AdminApp.installInteractive('/home/myProfile/MyStuff/application1.ear')
      • A l'aide de Jacl :

        [AIX Solaris HP-UX Linux Windows]
        $AdminApp installInteractive "c:/MyStuff/application1.ear"
        [z/OS]
        $AdminApp installInteractive "MyStuff/application1.ear"
        [IBM i]
        $AdminApp installInteractive "/home/myProfile/MyStuff/application1.ear"
      Tableau 2. Eléments de la commande installInteractive. Exécutez la commande installInteractive avec le nom de l'application à installer.
      Elément Description
      $ est un opérateur Jacl permettant de remplacer un nom de variable par sa valeur
      AdminApp est un objet autorisant la gestion des objets application
      installInteractive est une commande AdminApp
      MyStuff/application1.ear est le nom de l'application à installer
  5. Enregistrez les modifications apportées à la configuration.
    Entrez l'exemple de commande suivante pour sauvegarder les modifications de configuration :
    AdminConfig.save()
  6. Dans un environnement de déploiement en réseau uniquement, synchronisez le noeud.

Que faire ensuite

Un message de réussite est renvoyé si le système installe correctement l'application. Toutefois, les étapes peuvent aboutir avant que le système n'extraie chaque fichier binaire. Dans un environnement de déploiement réseau, par exemple, des fichiers binaires sont extraits après la fin de la synchronisation du nœud. Vous ne pouvez pas démarrer l'application tant que le système n'a pas extrait tous les fichiers binaires. Utilisez les commandes isAppReady et getDeployStatus de l'objet AdminApp pour vérifier que le système a extrait les fichiers avant de démarrer l'application.

La commande isAppReady renvoie la valeur true si le système est prêt à démarrer l'application, sinon elle renvoie la valeur false. Si l'application ne peut pas être démarrée, le système peut développer les fichiers binaires d'applications. Un script qui installe une application puis la démarre crée en général une boucle autour d'un appel à isAppReady jusqu'à recevoir une valeur true avant de tenter de lancer l'application.

Exemple, à l'aide de Jython :
import time
result = AdminApp.isAppReady('application1')
while (result == "false"):
   ### Attendre 5 secondes avant de revérifier
   time.sleep(5)
   result = AdminApp.isAppReady('application1')
print("Starting application...")
A l'aide de Jacl :
set result [$AdminApp isAppReady application1]
while {$result == "false"} {
   ### Attendre 5 secondes avant de revérifier
   after 5000
   set result [$AdminApp isAppReady application1]
}
puts "Démarrage de l'application..."

Si l'application ne peut pas être démarrée, le système peut développer les fichiers binaires d'applications. Utilisez la commande getDeployStatus pour afficher les informations supplémentaires sur le statut de développement des fichiers binaires, comme illustré ci-dessus :

En langage Jython :
print AdminApp.getDeployStatus('application1')
A l'aide de Jacl :
$AdminApp getDeployStatus application1

L'exécution de la commande getDeployStatus, où application1 correspond à DefaultApplication, permet d'afficher des informations d'état sur DefaultApplication, qui se présentent comme suit :

ADMA5071I: Vérification de l'état de la distribution démarrée pour l'application DefaultApplication.
WebSphere:cell=myCell01,node=myNode01,distribution=unknown,expansion=unknown
ADMA5011I : Le nettoyage du répertoire temp pour l'application DefaultApplication est terminé.
ADMA5072I : Vérification de l'état de la distribution terminée pour l'application DefaultApplication.
WebSphere:cell=myCell01,node=myNode01,distribution=unknown,expansion=unknown

Icône indiquant le type de rubrique Rubrique de tâche



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=txml_callappinstall
Nom du fichier : txml_callappinstall.html