Déploiement de la façade de composant

Après avoir testé, vous êtes prêt à déployer la façade de composant sur votre serveur HCL Commerce.

Avant de commencer

Procédure

Exportez tous les projets (à l'exception du projet de tests d'unité) à partir du module de service :

Option	Description
`MyServiceModule`-Client	Contient le code Java de la bibliothèque client. Exportez ce projet en tant que fichier JAR.
`MyServiceModule`-DataObjects	Contient les XSD, WSDL et SDO générés. Exportez ce projet en tant que fichier JAR.
`MyServiceModule`-Server	Contient l'implémentation de façade de composant. Exportez ce projet en tant que fichier JAR EJB.
`MyServiceModule`ServicesHTTPInterface	Module Web utilisé pour activer les services Web sur HTTP pour le module de service. Exportez ce projet en tant que fichier WAR.
(Facultatif) `MyServiceModule`ServicesJMSInterface	Module EJB utilisé pour activer les services Web sur JMS pour le module de service. Exportez ce projet en tant que fichier JAR EJB.

Assurez-vous que le fichier MANIFEST.MF à l'intérieur de votre fichier MyServiceModule-Server.jar comprend les entrées suivantes :
```
Foundation-Core.jar
Foundation-DataObjects.jar
Foundation-Extension.jar
Foundation-Server.jar
MyServiceModuleName-Client.jar
MyServiceModuleName-DataObjects.jar
```
S'il ne contient pas les entrées précédentes, suivez ces instructions pour mettre à jour les dépendances du module et exportez à nouveau le projet.
Important : Ce fichier est très sensible aux erreurs de mise en forme. Des espaces sont requis après chaque fichier d'archive Java répertorié, et il est nécessaire qu'il y ait un retour chariot à la fin du fichier. Le non-respect de ces exigences de mise en forme entraînera des erreurs ClassNotFoundException. Assurez-vous d'utiliser les étapes suivantes pour modifier le fichier et évitez d'effectuer des modifications manuelles.
1. Dans l'Explorateur d'entreprise, cliquez avec le bouton droit sur MyServiceModuleName-Server et sélectionnez Propriétés dans le menu.
2. Sélectionnez Dépendances de module Java EE dans l'onglet Navigation.
3. Sélectionnez les fichiers suivants : Foundation-Core.jar, Foundation-DataObjects.jar, Foundation-Extension.jar, Foundation-Server.jar, MyServiceModuleName-Client.jar, MyServiceModuleName-DataObjects.jar
4. Cliquez sur OK
Déployer le module WAR via la WebSphere Application Server Administrative Console :
1. Cliquez sur Applications > Applications d'entreprise.
2. Sélectionnez l'HCL Commerceinstance , puis cliquez sur Mettre à jour.
3. Sélectionnez Module unique.
4. Dans la zone Chemin relatif, tapez MyServiceModule-ServicesHTTPInterface.war.
5. Sélectionnez Système de fichiers local et spécifiez l'emplacement du fichier WAR.
6. Dans la zone Racine de contexte, entrez /webapp/wcs/component/MyServiceModule. Cliquez sur Suivant.
7. Acceptez les valeurs par défaut et cliquez à nouveau sur Suivant.
8. Cliquez sur Continuer pour parcourir les avertissements de sécurité.
9. Acceptez les valeurs par défaut pour l'étape 1 et cliquez sur Suivant.
10. Sélectionnez les deux options sous Clusters et Serveurs, sélectionnez le module MyServiceModule-ServicesHTTPInterface, puis cliquez sur Appliquer. Cliquez sur Suivant.
11. Sélectionnez le module MyServiceModule-ServicesHTTPInterface et sélectionnez VH_ instance_name comme hôte virtuel.
12. Cliquez sur Suivant. Cliquez sur Terminer. Cliquez sur Sauvegarde dans la configuration maîtresse.
Facultatif : Déployez MyServiceModuleServicesJMSInterface.jar via la console d'administration :
1. Cliquez sur Applications > Applications d'entreprise.
2. Sélectionnez l'HCL Commerceinstance , puis cliquez sur Mettre à jour.
3. Sélectionnez Module unique.
4. Spécifiez le chemin relatif en tant que MyServiceModuleServicesJMSInterface.jar.
5. Sélectionnez Système de fichiers local et spécifiez l'emplacement du fichier JAR.
6. Laissez Racine contextuelle vide. Cliquez sur Suivant.
7. Acceptez les valeurs par défaut et cliquez à nouveau sur Suivant.
8. Cliquez sur Continuer pour parcourir les avertissements de sécurité.
9. Acceptez les valeurs par défaut pour l'étape 1 et cliquez sur Suivant.
10. Sélectionnez les deux options sous Clusters et Serveurs, sélectionnez le module MyServiceModuleServicesJMSInterface, puis cliquez sur Appliquer. Cliquez sur Suivant.
11. Acceptez les valeurs par défaut et cliquez sur Suivant.
12. Acceptez les valeurs par défaut et cliquez sur Suivant.
13. Cliquez sur Terminer.
14. Cliquez sur Sauvegarde dans la configuration maîtresse.
Déployez le module EJB MyServiceModule-Server via la WebSphere Application Server Administrative Console :
1. Sélectionnez Remplacer ou ajouter un module unique. Spécifiez le nom du fichier EJB MyServiceModule-Server.jar comme chemin d'accès, puis cliquez sur Suivant
2. Sélectionnez le type d'installation Détaillé, fusionnez les liaisons nouvelles et existantes, puis cliquez sur Suivant.
3. Dans les avertissements concernant la sécurité de l'application, cliquez sur Continuer.
4. Laissez toutes les options de déploiement effacées et cliquez sur Suivant dans le volet Options d'installation.
5. Activez la case à cocher du module et mettez en surbrillance server1 et webserver1 pour mapper des modules à des serveurs, puis cliquez sur Appliquer. Cliquez sur Suivant.
6. Indiquez des noms JNDI pour les beans. Acceptez les valeurs par défaut et cliquez sur Suivant.
7. Mappez les références de ressources à des ressources.
8. Activez la case à cocher pour MyServiceModuleName et MyServiceModuleNameServicesImpl, puis cliquez sur Définir plusieurs noms JNDI. Sélectionnez jdbc/WCDataSource dans la liste. Cliquez sur Suivant.
9. Assurez-vous que toutes les méthodes 2.x non protégées ont le niveau de protection correct. Laissez les options par défaut, puis cliquez sur Suivant.
10. Cliquez sur Terminer sur la page Récapitulatif.
11. Cliquez sur Gérer les applications (Reportez l'enregistrement jusqu'à l'étape 7).
Déployez MyServiceModule-Client.jar et MyServiceModule-DataObjects.jar via la console d'administration :
1. Activez la case à cocher pour WC_demo et cliquez sur Mettre à jour.
2. Sélectionnez Remplacer ou Ajouter un fichier unique.
3. Spécifiez le chemin relatif en tant que MyServiceModuleName-Client.jar (ou MyServiceModule-DataObjects.jar).
4. Spécifiez le chemin d'accès au fichier du système de fichiers local, puis cliquez sur Suivant.
5. Vérifiez le nom et cliquez sur OK.
6. Lorsque le déploiement se termine, cliquez sur Gérer les applications et répétez le processus pour MyServiceModule-DataObjects.jar
7. Cliquez sur Gérer les applications (Reportez l'enregistrement jusqu'à l'étape 7).
Ajoutez la configuration du module de service au serveur d'exécution :
1. Créer un fichier compressé avec la structure suivante : xml\config\com.mycompany.commerce.myservicemodule y compris SDO.properties et wc-component-client.xml
2. Sélectionnez Remplacer, ajouter ou supprimer plusieurs fichiers
3. Déployez les fichiers SDO.properties et wc-component-client.xml via la WebSphere Application Server Administrative Console en tant que mise à njour de fichiers multiples :
4. Si vous déployez un module SOI, ajoutez les mises à jour de mappage de messages du module de service.
5. Enregistrez dans la Configuration principale
6. Ajoutez les mises à jour du Registre d'instructions du module de service. Vous pouvez trouver l'exemple de registre SQL généré dans l'Explorateur d'entreprise de Rational Application Developer sous, MyServiceModuleName-Server > SampleData > cmdreg.xml
Générez un plug-in de serveur Web :
1. Ouvrez le WebSphere Application Server Administrative Console.
2. Sélectionnez Serveurs > Serveurs Web.
3. Sélectionnez webserver1.
4. Cliquez sur Générer un plug-in.
5. Redémarrez le serveur Web.
6. Redémarrez Transaction server.