Utilisez la commande serviceDeploy pour générer des modules compatibles SCA (Service
Component Architecture) sous forme d'applications Java™ pouvant être installées
sur un serveur. Cette commande est utile lors de l'exécution d'installations par lots via wsadmin.
Objet
La commande
serviceDeploy génère un fichier .ear à partir d'un fichier .jar ou .zip contenant des composants de service.
Remarque : Les paramètres ne sont pas dépendants maj/min.
Rôles
Cette commande peut être exécutée par des utilisateurs titulaires des rôles suivants :
Syntaxe

>>-serviceDeploy-- -archive_entrée------------------------------>
>--+--------------------------------+--------------------------->
'- -workingDirectory-- -rép_temp-'
>--+--------------------------------------------------+--------->
'- -outputApplication-- -+-archive_entréeApp.ear-+-'
'-outputpathname.ear----'
>--+----------------+--+------------+--------------------------->
'- -noJ2eeDeploy-' '- -freeform-'
>--+-----------------------+--+--------+--+----------------+---->
'- -cleanStagingModules-' '- -keep-' '- -ignoreErrors-'
>--+----------------------------------------------------------+-->
'- -classpath-- -nom_chemin_JAR--;--nom_chemin_RAR--;--...-'
>--+----------------------------------+--+-------------+-------->
'- -fileEncoding-- -jeu_caractères-' '- -javaDebug-'
>--+----------------+--+----------------+--+--------+----------><
'- -noJavaSource-' '- -uniqueCellID-' '- -help-'
Paramètres
- archive_entrée
- Paramètre positionnel obligatoire servant à spécifier le fichier .jar, .zip ou .ear
contenant l'application à déployer. Si la commande n'est pas lancée à partir du chemin d'accès dans lequel réside le fichier, le chemin d'accès complet au fichier doit être spécifié. Le fichier .zip peut être soit une archive imbriquée, soit un fichier au format Eclipse Project Interchange.
- -classpath
- Paramètre facultatif servant qui définit l'emplacement des fichiers de ressource
requis (.jar et .rar). Il convient que le chemin d'accès à chaque fichier soit un chemin d'accès qualifié complet séparé par des points-virgules (;) sans espaces.
- -fileEncoding
- Paramètre facultatif qui définit le jeu de caractères (jeu_caractères)
requis si l'application que vous déployez utilise un paramètre jeu_caractères autre que celui pris en charge par l'encodage de fichier par défaut de la machine JVM (Java Virtual Machine).
Remarque : Sous z/OS, la commande serviceDeploy utilise toujours le jeu ASCII pour l'encodage de fichier par défaut.
Si, par exemple, l'application comporte une table de règles métier contenant des caractères japonais, vous devez définir une valeur jeu_caractères (telle que UTF-8) qui prend en charge les caractères codés sur deux octets, afin d'éviter toute altération des données contenues dans les fichiers Java et
fichiers .class générés.
Pour consulter la liste des valeurs admises pour -fileEncoding, voir http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html.
Si aucune valeur n'est spécifiée, ce paramètre renvoie par défaut au jeu de caractères par défaut pris en charge par le kit JDK (Java Development Kit).
Important : Ce paramètre affecte uniquement les fichiers générés par serviceDeploy. Pour les fichiers existants, l'encodage en cours est conservé.
Restriction : Si vous spécifiez une valeur
jeu_caractères non prise en charge par le système d'exploitation qui exécute la commande serviceDeploy, le système traite l'archive de la même manière que si vous n'aviez pas spécifié -fileEncoding et les messages sont inscrits dans le journal système.
- -freeform
- Paramètre facultatif indiquant que le sous-répertoire J2EE du fichier
service.jar doit être traité en tant que projet à format libre.
- -help
- Paramètre facultatif servant à afficher les paramètres de cette commande.
- -ignoreErrors
- Paramètre facultatif indiquant que la commande serviceDeploy
génère un fichier .ear quelles que soient les erreurs générées lors de la compilation ou de la validation de l'application. Par défaut, la commande serviceDeploy ne génère aucun fichier .ear si des erreurs se sont produites dans une application.
- -javaDebug
- Paramètre facultatif qui indique si toutes les informations de débogage doivent être incluses dans les fichiers de classe générés.
- -noJavaSource
- Paramètre facultatif qui indique si les fichiers source Java doivent être exclus du fichier EAR généré. Par défaut, les fichiers source Java sont compris.
- -cleanStagingModules
- Paramètre facultatif indiquant si les modules de transfert doivent être supprimés d'un fichier d'entrée .ear avant le déploiement. Par défaut, la commande serviceDeploy importe les modules de transfert existants avec leur contenu.
- -keep
- Paramètre facultatif indiquant si les fichiers temporaires éventuels générés après le déploiement doivent être sauvegardés. Par défaut, la commande serviceDeploy supprime l'espace de travail temporaire.
- -noJ2eeDeploy
- Paramètre facultatif indiquant si l'application requiert le déploiement des
EJB après la génération du fichier .ear. Par défaut, la commande serviceDeploy exécute les modules de déploiement J2EE pour l'application.
- -outputApplication
- Paramètre facultatif qui spécifie le nom du fichier .ear créé par la commande serviceDeploy. La valeur par défaut est archive_entréeApp.ear, où archive_entrée est le nom de fichier duquel est retranchée l'extension spécifiée pour le fichier d'entrée .jar.
- -outputApplicationMigratedApp.ear
- Paramètre facultatif indiquant que l'archive d'entrée est un fichier .jar
migré depuis une instance WebSphere Interchange Server.
- -uniqueCellID
- Paramètre facultatif spécifiant une chaîne d'identification utilisée pour créer une instance
unique de l'application.
L'identificateur doit être unique dans le contexte de la cellule.
- -workingDirectory
- Paramètre facultatif spécifiant un répertoire utilisé par la commande serviceDeploy pour l'inscription des fichiers temporaires.
Fichiers d'entrée
Les types de fichiers suivants peuvent être utilisés comme fichiers d'entrée pour la commande
serviceDeploy :
- jar
- Type de fichier le plus utilisé pour les applications simples. Le fichier .ear résultant contient un seul fichier .jar et tous les modules de transfert générés requis. Le fichier .jar doit contenir le fichier service.module.
- zip (Project Interchange)
- Vous pouvez exporter un fichier archive au format Project Interchange à partir de WebSphere Integration Developer. Ce format est spécifique au développement Eclipse. Le fichier ZIP exporté doit contenir strictement un projet contenant le fichier
service.module. Le fichier .ear résultant contient un nombre de modules qui dépend exactement de ce que contient l'échange de projet.
- zip
- Vous pouvez créer un fichier ZIP contenant des fichiers JAR, WAR et RAR. Un seul fichier JAR doit contenir le fichier service.module. Toutes les archives contenues deviennent membre du fichier EAR exporté final.
- ear
- Vous pouvez toujours exécuter la commande serviceDeploy sur un fichier EAR aussi longtemps qu'un seul fichier JAR du fichier EAR contient un fichier service.module.
Fichiers de sortie
Lorsque le traitement de la commande serviceDeploy s'achève, un fichier .ear est créé dans le répertoire à partir duquel la commande est exécutée, sauf si le paramètre -outputApplication est spécifié.
Exemple de commande serviceDeploy
Dans
l'exemple suivant, la commande :
- Crée un fichier d'application nommé MyValueModule.ear à partir du fichier MyValueModule.jar.
- Indique que les ressources résident dans les répertoires c:\java\myvaluemoduleres.rar et c:\java\commonres.jar.
- Active le format libre pour le sous-répertoire Java dans le fichier .jar.
- Conserve les fichiers temporaires générés durant le déploiement.
servicedeploy MyValueModule.jar
-classpath "c:\java\myvaluemoduleres.rar;c:\java\commonres.jar"
-noj2eedeploy -freeform true -keep