Plants by WebSphere |
|
Mise en route |
Identification de l'arborescence |
Régénération et installation de l'exemple |
La portabilité est l'un des principaux avantages du développement d'applications sur une plateforme J2EE. Tous les programmes exemples de la galerie d'exemples sont développés sur un poste de travail et peuvent être exécutés sur des systèmes z/OS et iSeries sans qu'il soit nécessaire de modifier une seule ligne du code Java. En créant des applications J2EE sur des systèmes
Intel ou UNIX, un développeur évite l'écueil des conversions de fichiers EBCDIC en ASCII ou ASCII en EBCDIC.
La disponibilité des outils facilite le travail d'écriture et de test du développeur sur un poste de travail de développement et l'installation des fichiers EAR (Enterprise Archive) sur les systèmes z/OS et iSeries.
Chaque instance WebSphere Application Server (Application Server) pour le client z/OS et iSeries
est autorisée à accéder aux supports Application Server multi-plateformes. Si vous installez le produit WebSphere Application Server de base et les exemples
sur l'une des plateformes prises en charge par ce package, vous obtenez la même galerie d'exemples. Il y a une exception : quand vous cliquez sur nom_exemple > Génération avec Ant > plateforme > Régénération et installation du fichier sample.ear, vous recevez des instructions pour régénérer le fichier EAR sur cette plateforme. Etant donné que les fichiers texte dans un fichier EAR (fichiers XML, xmi, JSP (JavaServer Pages), etc.) doivent être au format ASCII, il est plus facile de modifier ces fichiers sur une machine ASCII. Si vous effectuez des modifications sur une machine ASCII, vous pouvez ensuite déployer et installer le fichier EAR résultant sur la plateforme z/OS ou iSeries sans conversion EBCDIC en ASCII.
Installez WebSphere Application Server sur la plateforme distribuée de votre choix et indiquez qu'il convient d'installer également les modèles d'applications.
Générez une copie de sauvegarde du répertoire <racine_profil>/samples avant de modifier ou de régénérer les exemples. Créez un fichier zip du répertoire samples. Vous pourrez ensuite extraire le fichier zip pour restaurer le répertoire samples.
Les exemples sont installés dans les répertoires suivants :
<racine_profil>/samples/src/PlantsByWebSphere | Contient le code source de l'exemple Plants by WebSphere. |
<racine_profil>/samples/lib/PlantsByWebSphere | Contient les fichiers WAR (Web Archive), les fichiers JAR (Java Archive) et le fichier PlantsByWebSphere.ear final de l'exemple Plants by WebSphere. Ce répertoire est créé une fois que l'exemple Plants by WebSphere a été régénéré. |
<racine_profil>/samples/javadoc/PlantsByWebSphere | Contient la documentation Javadoc. Ce répertoire est créé une fois que l'exemple Plants by WebSphere a été régénéré. |
<racine_profil>/samples/bld/PlantsByWebSphere | Contient les fichiers de classe générés. Utilisez ces fichiers de classe pour générer le fichier PlantsByWebSphere.ear final. Ce répertoire est créé une fois que l'exemple Plants by WebSphere a été régénéré. |
L'exemple Plants by WebSphere est installé automatiquement lors de l'installation de WebSphere Application Server. Il n'est pas nécessaire de générer l'exemple Plants by WebSphere pour pouvoir l'utiliser. Les instructions ci-dessous décrivent la procédure à suivre pour régénérer l'exemple et fournissent des informations complémentaires sur la manière de les modifier.
Exécution du script de génération des exemples |
Pour régénérer cet exemple, vérifiez que racine_profil/bin figure dans votre variable d'environnement PATH. Suivez les étapes ci-après pour exécuter le script de génération de l'exemple, qui régénére l'exemple :
L'exemple est à présent généré.
Les scripts buildplantsby.bat et buildplantsby.sh du répertoire racine_profil/samples/bin/PlantsByWebSphere ont défini les informations du chemin d'accès aux classes appropriées et exécuté l'utilitaire de génération Ant. Ant lit les fichiers build.xml qui décrivent le mode de génération de l'exemple. Pour plus d'informations sur Ant, voir le site Web Jakarta.
Lors du processus de génération, seuls les fichiers de classe ayant été modifiés sont régénérés. Les autres fichiers de classe sont intégrés dans le nouveau fichier EAR.
Utilisez le protocole FTP (File Transfer Protocol) pour transférer le fichier EAR binaire vers le serveur z/OS ou iSeries en procédant comme indiqué ci-dessous.
Par défaut, l'exemple Plants by WebSphere est installé dans le répertoire racine_profil/installedApps/<nom de cellule>, où <nom de cellule > est le nom de la cellule dans laquelle l'application est installée. Réinstallez l'exemple en suivant la procédure ci-dessous :
wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')"
wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')"
wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')"
wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')"
wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear', ['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<noeud>', '-server', '<serveur>', '-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"où <noeud> est le nom du noeud, et <serveur> est le nom du serveur sur lequel l'exemple est installé.
wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear', ['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<noeud>', '-server', '<serveur>', '-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"où <noeud> est le nom du noeud, et <serveur> est le nom du serveur sur lequel l'exemple est installé.
wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear', ['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<noeud>', '-server', '<serveur>', '-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear', ['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<noeud>', '-server', '<serveur>', '-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"où <noeud> est le nom du noeud, et <serveur> est le nom du serveur sur lequel l'exemple est installé.
Le fichier PlantsByWebsphere.ear régénéré est à présent déployé sur votre serveur d'applications.