Préparer le plan de déploiement pour WebSphere Application Server Community Edition

Pour déployer un adaptateur de ressources ou une application sur WebSphere CE, vous devez préparer un plan de déploiement. Celui-ci contient la définition de l'adaptateur de ressources IMS TM et des dépendances vis-à-vis du fichier icu4j.

Pourquoi et quand exécuter cette tâche

Le plan de déploiement est un fichier XML qui contient le nom de l'artefact concerné (IMSTMRA), le nom du groupe auquel il appartient et ses dépendances vis-à-vis d'autres artefacts.

Un exemple de plan de déploiement d'adaptateur de ressources figure ci-après.

Important : Si vous utilisez WebSphere CE version 3.0 ou ultérieure, veillez à supprimer la mise en commentaire des trois lignes export-package, comme indiqué dans l'exemple de plan de déploiement. Si ces lignes demeurent masquées (en commentaire), en tentant d'appeler l'adaptateur de ressources, vous rencontrerez plusieurs erreurs signalant une spécification de connexion (ConnectionSpec) non valide.
<connector xmlns="http://geronimo.apache.org/xml/ns/j2ee/connector-1.2"
  xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.2"
  xmlns:naming="http://geronimo.apache.org/xml/ns/naming-1.2">
  <dep:environment>
    <dep:moduleId>
      <dep:groupId>com.ibm.imsico</dep:groupId>
      <dep:artifactId>IMSTMRA</dep:artifactId>
      <!-- Spécifiez la version de l'adaptateur de ressources utilisé -->
      <dep:version>12.1.0</dep:version>
      <dep:type>rar</dep:type>
    </dep:moduleId>
    <dep:dependencies>
      <dep:dependency>
        <dep:groupId>com.ibm.imsico</dep:groupId>
        <dep:artifactId>icu4j</dep:artifactId>
      </dep:dependency>
    </dep:dependencies>
    <!-- Supprimez la mise en commentaire de ces lignes export-package en cas d'utilisation de WAS CE 3.0 ou version ultérieure -->
    <!-- <dep:export-package>com.ibm.connector2.ims.ico</dep:export-package>  -->
    <!-- <dep:export-package>com.ibm.ims.ico</dep:export-package> -->
    <!-- <dep:export-package>commonj.connector.runtime</dep:export-package>  -->
  </dep:environment>
  <resourceadapter>
    <resourceadapter-instance>
      <!-- Spécifiez un nom pour l'adaptateur de ressources -->
      <resourceadapter-name>IMSTMRA</resourceadapter-name>
      <naming:workmanager>
        <naming:gbean-link>DefaultWorkManager</naming:gbean-link>
      </naming:workmanager>
    </resourceadapter-instance>

    <outbound-resourceadapter>
      <connection-definition>
        <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>
        <connectiondefinition-instance>
          <!-- Fournissez un nom JNDI pour votre instance de fabrique de connexions. -->
          <!-- Ce nom sera à indiquer dans le champ resource-link de l'élément -->
          <!-- resource-ref de votre module Java EE.  -->             
          <name>jca/monIMSTMRA</name>
          <!-- Changez le nom d'hôte, le numéro de port et le nom du magasin de données en fonction de votre environnement.  -->            
          <config-property-setting name="HostName">votre.hote.ims.com</config-property-setting>
          <config-property-setting name="PortNumber">9999</config-property-setting>
          <config-property-setting name="DataStoreName">IMS1</config-property-setting>
          <connectionmanager>
            <!-- no-transaction (pas de transaction) est spécifié car l'adaptateur de ressources IMS TM ne gère pas -->
            <!-- la validation en deux phases dans WAS CE ou les autres serveurs non IBM. -->            
            <no-transaction/>
            <!-- Options de mise en pool des connexions -->
            <!-- Ici, single-pool (un seul pool) est indiqué pour la mise en pool et la réutilisation des connexions. -->
            <!-- Modifiez les propriétés de mise en pool des connexions en fonction de votre environnement. -->
            <single-pool>
              <max-size>10</max-size>
              <min-size>0</min-size>
              <blocking-timeout-milliseconds>5000</blocking-timeout-milliseconds>
              <idle-timeout-minutes>5</idle-timeout-minutes>
              <select-one-assume-match />
            </single-pool>
          </connectionmanager>
        </connectiondefinition-instance>
      </connection-definition>
    </outbound-resourceadapter>
  </resourceadapter>

</connector>
Vous pouvez télécharger cet exemple de fichier XML de plan de déploiement (les commentaires seront en anglais) en cliquant avec le bouton droit ici et en sélectionnant Enregistrer la cible du lien sous (Mozilla Firefox) ou Enregistrer la cible sous (Microsoft Internet Explorer).

Vos commentaires