WAS | Déployer une application entreprise (EAR)
  1. Déployer une application (console d'administration) : Déploiement rapide
  2. Déployer une application (console d'administration) : Déploiement détaillé
  3. Déployer une application (script Jython)
  4. Désinstaller une application (console d'administration)
  5. Désinstaller une application (script Jython)
  6. Démarrer/arrêter une application (console d'administration)
  7. Activer/désactiver l'auto-démarrage d'une application (console d'administration)
  8. Activer/désactiver l'auto-démarrage d'une application (fichier de configuration)
  9. Activer/désactiver l'auto-démarrage d'une application (script Jython)
  1. Déployer une application (console d'administration) : Déploiement rapide
    Pour Déployer une application (EAR) à partir de la console d'administration suivre les étapes suivantes :
    - Cliquer sur "Applications".
    - Cliquer sur "New Application".
    - Cliquer sur "New Enterprise Application".

    Notes :
    Il est aussi possible de :
    - Cliquer sur "Applications".
    - Cliquer sur "Application Types".
    - Cliquer sur "WebSphere enterprise applications".
    - Cliquer sur "Install".

    Ensuite :
    - Choisir "Remote file system" (dans ce cas, le fichier est supposé être déjà copié sur le serveur où WAS est installé).
    - Remplir le champ "Full path" par le chemin où se trouver le fichier EAR de l'application (Exemple : "C:\programs\IBM\WebSphere\AppServer\profiles\profile1\installableApps\myjeeapp.ear").
    - Cliquer sur "Next".

    Notes :
    Il est aussi possible de :
    - Choisir "Local file system".
    - Cliquer sur "Browse" pour uploader le fichier EAR sur le serveur WAS.

    Ensuite :
    - Choisir "Fast Path"
    - Afficher le contenu de "Choose to generate default bindings and mappings".
    - Choisir "Generate Default Bindings".
    - Cliquer sur "Next".

    Notes : Les étapes suivantes peuvent être différentes selon le type de l'application déployée.

    Step 1: Select installation options
    - Modifier le champ "Application name" : laisser la valeur par défaut ou entrer le nom que vous voulez donner à votre application.
    - Cocher "Allow EJB reference targets to resolve automatically".
    - Cliquer sur "Next".

    Step 2: Map modules to servers
    - Spécifier le serveur où les modules de l'application seront installés.
    - Cliquer sur "Next".

    Step 3: Metadata for modules
    - Cliquer sur "Next".

    Step 4: Summary
    - Cliquer sur "Finish".
    - Cliquer sur "Save".

    Notes :
    • Les informations temporaires relatives au déploiement de l'application sont sauvegardées dans le dossier "${WAS_PROFILE_ROOT}\wstemp\TEMP_FOLDER\workspace\cells\${WAS_CELL_NAME}\applications\myjeeapp.ear\deployments\myjeeapp\".

    • Lorsque le déploiement de l'application est complété (clique sur "Save") le fichier EAR est sauvegardé dans le dossier "${WAS_PROFILE_ROOT}\installedApps\${WAS_CELL_NAME}\myjeeapp.ear\".

    • WAS sauvegarde aussi les configurations de l'application ainsi que le fichier EAR dans le dossier "${WAS_PROFILE_ROOT}\config\cells\${WAS_CELL_NAME}\applications\myjeeapp.ear\".

  2. Déployer une application (console d'administration) : Déploiement détaillé
    Pour Déployer une application (EAR) à partir de la console d'administration suivre les étapes suivantes :
    - Cliquer sur "Applications".
    - Cliquer sur "New Application".
    - Cliquer sur "New Enterprise Application".

    - Choisir "Remote file system".
    - Remplir le champ "Full path" par le chemin où se trouver le fichier EAR de l'application.
    - Cliquer sur "Next".

    - Choisir "Detailed - Show all installation options and parameters".
    - Afficher le contenu de "Choose to generate default bindings and mappings".
    - Choisir "Generate Default Bindings".
    - Cliquer sur "Next".

    Notes : Les étapes suivantes peuvent être différentes selon le type de l'application déployée.

    Step 1: Select installation options
    - Cocher "Allow EJB reference targets to resolve automatically".
    - Cliquer sur "Next".

    Step 2: Map modules to servers
    - Spécifier le serveur où les modules de l'application seront installés.
    - Cliquer sur "Next".

    Step 3: Provide JSP reloading options for Web modules
    - Spécifier si le serveur peut recharger les fichiers JSP quand ils sont modifiés.
    - Cliquer sur "Next".

    Step 4: Map shared libraries
    - Indiquer les librairies partagées que l'application (ou des modules individuels) peut référencer.
    - Cliquer sur "Next".

    Step 5: Map shared library relationships
    - Indiquer des "asset" comme des librairies partagées que l'application (ou des modules individuels) peut référencer.
    - Cliquer sur "Next".

    Step 6: Provide JNDI names for beans
    - Spécifier un nom JNDI pour les beans.
    - Cliquer sur "Next".

    Step 7: Bind EJB Business
    - Spécifier un nom JNDI pour chaque interface métier des beans.
    - Cliquer sur "Next".

    Step 8: Map EJB references to beans
    - Cliquer sur "Next".

    Step 9: Map virtual hosts for Web modules
    - Associer les modules Web aux "virtual hosts". Plusieurs modules Web peuvent utiliser le même "virtual host".
    - Cliquer sur "Next".

    Step 10: Map context roots for Web modules
    - Spécifier un "context root" pour chaque module Web. Les URLs seront relatives a ce "context root" (hostName:port/contextRoot/URL).
    - Cliquer sur "Next".

    Step 11: Map JASPI provider
    - Cliquer sur "Next".

    Step 12: Metadata for modules
    - Cliquer sur "Next".

    Step 13: Display module build Ids
    - Cliquer sur "Next".

    Step 14: Summary
    - Cliquer sur "Finish".
    - Cliquer sur "Save".
  3. Déployer une application (script Jython)
    Il est possible d'installer une application en utilisant un script Jython. Mais le souci est de savoir toutes les options nécessaires pour le script d'installation de l'application.

    Je pense que la meilleure façon est de toujours passer par la console d'administration pour l'installation des applications dans un environnement de teste ou de production.

    S'il faut automatiser l'installation dans un environnement de développement, le script Jython peut être utilisé et raffiné aux particularités de chaque application.
    Une alternative est d'utiliser le déploiement automatique de WAS.
    Aussi une autre alternative plus pratique est d'utiliser les fichiers de propriétés pour installer une application.

    Voici un exemple de script Jython ("installApp.jy") qui installer une application ("myjeeapp.ear").
    Sauvegarder ce script dans un fichier "installApp.jy".

    Voici la ligne de commande pour exécuter ce script :

    Où ${JYTHON_SCRIPT_PATH} est le chemin du dossier qui contient le script Jython "installApp.jy".

    Voici la sortie d'exécution de ce script dans ma console :

    Voici une liste des options possibles pour la commande d'installation ("AdminApp.install"):
  4. Désinstaller une application (console d'administration)
    Voici les étapes à suivre pour désinstaller une application à partir de la console d'administration :
    - Cliquer sur "Applications".
    - Cliquer sur "Application Types".
    - Cliquer sur "WebSphere enterprise applications".

    - Pour désinstaller une application, sélectionner l'application.
    - Cliquer sur "Uninstall".
    - Cliquer sur "OK".
    - Cliquer sur "Save".
  5. Désinstaller une application (script Jython)
    Il est possible de désinstaller une application en utilisant un script Jython.

    Voici un exemple de script Jython ("uninstallApp.jy") qui désinstalle l'application ("myjeeapp.ear") :

    Sauvegarder ce script dans un fichier "uninstallApp.jy".

    Voici la ligne de commande pour exécuter ce script :

    Où ${JYTHON_SCRIPT_PATH} est le chemin du dossier qui contient le script Jython "uninstallApp.jy".

    Voici la sortie d'exécution de ce script dans ma console :
  6. Démarrer/arrêter une application (console d'administration)
    Voici les étapes à suivre pour démarrer une application à partir de la console d'administration :
    - Cliquer sur "Applications".
    - Cliquer sur "Application Types".
    - Cliquer sur "WebSphere enterprise applications".

    - Pour démarrer une application, sélectionner l'application.
    - Cliquer sur "Start".

    - Pour arrêter une application, sélectionner l'application.
    - Cliquer sur "Stop".
  7. Activer/désactiver l'auto-démarrage d'une application (console d'administration)
    Au démarrage du serveur, WAS essaye automatiquement de démarrer toutes les applications installées sur le serveur.
    Pour empêcher un tel comportement, il faut désactiver l'auto-démarrage chacune des applications qu'on ne veut pas qu'elles soient démarrées automatiquement au démarrage du serveur.

    Voici les étapes à suivre pour activer/désactiver une application à partir de la console d'administration :
    - Cliquer sur "Applications".
    - Cliquer sur "Application Types".
    - Cliquer sur "WebSphere enterprise applications".

    - Cliquer sur une application (exemple "myjeeapp.ear").

    Dans la section "Detail Properties".
    - Cliquer sur "Target specific application status".

    - Sélectionnez le serveur cible sur lequel l'application réside.
    - Cliquer sur "Enable Auto Start" (si vous voulez activer l'auto-démarrage de l'application).
    - Cliquer sur "Disable Auto Start" (si vous voulez désactiver l'auto-démarrage de l'application).

    - Cliquer sur "Save".
  8. Activer/désactiver l'auto-démarrage d'une application (fichier de configuration)
    Il est possible d'activer/désactiver une application en modifiant directement le fichier de configuration « deployment.xml ».
    Ce fichier se trouve dans le répertoire : ${WAS_PROFILE_ROOT}\config\cells\${WAS_CELL_NAME}\applications\${APP_NAME}.ear\deployments\${APP_NAME}

    Il faut retrouver l'élément "targetMappings" (enfant de l'élément "deployedObject") et modifier la valeur de l'attribut "enable".
    - La valeur "true" spécifie que l'auto-démarrage d'une application est activé.
    - La valeur "false" spécifie que l'auto-démarrage d'une application est désactivé.

    Voici un exemple du fichier C:\programs\IBM\WebSphere\AppServer\profiles\profile1\config\cells\node1Node01Cell\applications\myjeeapp.ear\deployments\myjeeapp\deployment.xml :
  9. Activer/désactiver l'auto-démarrage d'une application (script Jython)
    Il est possible d'activer/désactiver une application en utilisant un script Jython.

    Voici un exemple de script Jython ("disable_auto_start.jy") qui désactive l'application ("myjeeapp.ear") :

    Sauvegarder ce script dans un fichier "disable_auto_start.jy".

    Voici la ligne de commande pour exécuter ce script :

    Où ${JYTHON_SCRIPT_PATH} est le chemin du dossier qui contient le script Jython "disable_auto_start.jy".
© 2025  mtitek