Publier un EAR sur un WebSphere distant avec Maven 2

Voici comment publier un EAR créé avec RAD par exemple sur un serveur WebSphere 6 installé sur une autre machine avec le plugin Was6 Maven Plugin.

Les informations sur le site du plugin n'étant pas très nombreuses, je trouve bon de présenter rapidement ici un cas concret pour son utilisation !

Il faut que le serveur WebSphere sur la machine distant soit démarré. ET, je le précise car c'est pas clair sur le site du plugin, il FAUT qu'un WebSphere soit installé sur le poste à partir duquel on envoi le EAR. Il ne faut pas qu'il soit démarré. En effet, le plugin a besoin de scripts pour le déploiement du EAR d'où la nécessité d'une installation de WS.

Après avoir généré l'EAR, il suffit simplement de taper la commande Maven 2 dans son projet Web :

mvn was6:installApp
-Dwas6.host=MON_SRV
-Dwas6.conntype=SOAP
-Dwas6.username=MON_USR
-Dwas6.password=MON_PSW
-Dwas6.updateExisting=false
-Dwas6.earFile=monProjet-web.ear
-Dwas6.port=8880
(les retours à la lignes sont là par soucis
de lisibilité)

Il faut remplacer :
MON_SRV par le nom ou l'adresse du serveur distant où déployer l'EAR sur le WebSphere
MON_USR et MON_PSW sont utilisés si la sécurité est activé sur le WebSphere distant (sinon ne pas renseigner ces valeurs)
updateExisting : si l'application a deja été déployée une fois, mettre à true pour qu'on fasse un update
earFile : le chemin vers l'EAR à déployer

C'est donc tout simple !

NOTE méga importante : j'ai remarqué que le déploiement ne fonctionne pas si le chemin vers votre projet Web contient des espaces (erreur lors du build avec ant) ! Déplacer éventuellement le projet pour que son chemin n'en contienne pas ! je vous aurez prévenu ! :)

Néanmoins, si comme moi, vous avez activé la sécurité SSL sur votre serveur WebSphere, il FAUT le certificat de sécurité du serveur pour que la commande fonctionne !

Voici comment procéder (inspiré de la doc d'IBM : http://publib.boulder.ibm.com/infocenter/iwphelp/v2r5m1/index.jsp?topic=/com.ibm.wcs.ic.doc_2.5.1/infocenter/i_sec_t_impcertwasstores.html) : il faut exporter le certificat de sécurité SSL depuis le serveur distant et l'installer dans le WebSphere de la machine à partir de laquelle est déployée l'application.

Exporter le certificat :
1. Ouvrir la console administrative du serveur WebSphere distant
2. Aller dans Sécurité/Certificat SSL et gestion des clés
3. Cliquer sur 'Gérer les configurations de sécurité du noeud final'
4. Déplier 'Communication entrante/...Cell/nodes/servers/server1/ (varie selon le serveur)
5. Cliquer sur 'SOAP_CONNECTOR_ADDRESS'
6. Dans l'écran, cliquer sur 'Gérer des certificats'
7. Cocher dans la liste des certificats, le certificat concerné (en général Default) puis cliquer sur Extraire
8. Dans l'écran d'extraction, saisir un nom (par ex monCertificat.cer) et sélectionner 'Données ASCII codées en base 64' pour le type de données
9. Cliquer sur Ok, le certificat est extrait
10.Récupérer le fichier du certificat en allant dans le profil du WebSphere, par exemple dans C:\Program Files\IBM\SDP70\runtimes\base_v61\profiles\AppSrv01\etc

Importer le certificat sur la machine à partir de laquelle est déployée l'application :
1. Aller dans le répertoire du profil WebSphere de la machine à partir de laquelle est déployée l'application (par exemple dans C:\Program Files\IBM\SDP70\runtimes\base_v61\profiles\AppSrv01)
2. Exécuter le fichier bat ikeyman.bat se situant dans bin/
3. Le gestionnaire des clés IBM s'ouvre
4. Cliquer sur ouvrir un fichier : pour le type de base de données de clés, sélectionner PKCS12.
5. Ouvrir le fichier trust.p12 du répertoire etc/ du profil (par exemple dans C:\Program Files\IBM\SDP70\runtimes\base_v61\profiles\AppSrv01\etc\)
6. Si on vous demande un mot de passe, le mot de passe par défaut est WebAS
7. Une fois chargé, cliquer sur Ajout
8. Sélectionner le certificat récupéré du serveur distant (voir plus haut)
9. Une fois ajouté, sauvegarder en écrasant le fichier trust.p12 ouvert plus haut (mettre le même mot de passe)
10. Vous pouvez quitter ikeyman

La commande Maven 2 devrait désormais fonctionner !

Voili, c'est tout !