Deploying the sample application on WebSphere Application Server Community Edition to process callout requests

To deploy the callout IVP EAR file in WebSphere® CE, prepare the deployment plan XML file and use the deployer function to deploy the enterprise archive file.

Procedure

  1. Prepare the deployment plan XML file to specify the IMS TM resource adapter name that is deployed in the server and configure the ActivationSpec properties.

    The following is a sample resource adapter deployment plan.

    <?xml version="1.0" encoding="UTF-8"?>
    <application 
      xmlns="http://geronimo.apache.org/xml/ns/j2ee/application-2.0" 
      xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.2" 
      application-name="IMSICOCalloutIVPMDBEAR">
        <dep:environment>
            <dep:moduleId>
                <dep:groupId>com.ibm.imsico</dep:groupId>
                <dep:artifactId>IMSICOCalloutIVP</dep:artifactId>
    						<!-- Specify the version of the resource adapter that you use. -->
                <dep:version>12.1.0</dep:version>
                <dep:type>war</dep:type>
            </dep:moduleId>
            <dep:dependencies>
                <dep:dependency>
                    <dep:groupId>com.ibm.imsico</dep:groupId>
                    <dep:artifactId>IMSTMRA</dep:artifactId>
                    <!-- Specify the version of the resource adapter that you use. -->
                    <dep:version>12.1.0</dep:version>
                    <dep:type>rar</dep:type>
                </dep:dependency>
            </dep:dependencies>
        </dep:environment>
      <module>
        <ejb>IMSICOCalloutIVPMDB.jar</ejb>
        <openejb-jar xmlns="http://www.openejb.org/xml/ns/openejb-jar-2.1"
                     xmlns:naming="http://geronimo.apache.org/xml/ns/naming-1.2">
          <enterprise-beans> 
            <message-driven> 
              <ejb-name>IMSICOCalloutIVPMDB</ejb-name> 
              <naming:resource-adapter>
                 <!-- Specify the name of the IMS TM resource adapter you defined in the -->
                 <!-- <resourceadapter-name> element of resource adapter deployment plan XML file. --> 
                 <naming:resource-link>IMSTMRA</naming:resource-link> 
              </naming:resource-adapter> 
              <!-- Modify host name, port number, data store name and TPIPE names for your environment.  -->
              <!-- Specify IVPPIPE3,IVPPIPE4 if you plan to verify both asynchronous and synchronous callout messages.-->
              <!-- Specify IVPPIPE3 if you plan to verify only asynchronous callout messages. -->
              <!-- Specify IVPPIPE4 if you plan to verify only synchronous callout messages. -->
              <activation-config> 
                <activation-config-property> 
                  <activation-config-property-name>HostName</activation-config-property-name> 
                  <activation-config-property-value>your.ims.host.com</activation-config-property-value> 
                </activation-config-property> 
                <activation-config-property> 
                  <activation-config-property-name>PortNumber</activation-config-property-name> 
                  <activation-config-property-value>9999</activation-config-property-value> 
                </activation-config-property> 
                <activation-config-property> 
                  <activation-config-property-name>DataStoreName</activation-config-property-name> 
                  <activation-config-property-value>IMS1</activation-config-property-value> 
                </activation-config-property> 
                <activation-config-property> 
                  <activation-config-property-name>QueueNames</activation-config-property-name> 
                  <activation-config-property-value>IVPPIPE4</activation-config-property-value> 
                </activation-config-property> 
              </activation-config> 
            </message-driven> 
          </enterprise-beans>
        </openejb-jar>
      </module>
    </application>

    You can download this sample deployment plan XML file by right-clicking here and select Save Link As (Mozilla Firefox) or Save Target As (Microsoft Internet Explorer).

  2. In the WebSphere CE administrative console, click Deployer.
  3. In the Install New Applications window:
    1. For the Archive field, click Browse to navigate to where the imsicocalloutivp.ear file is and select it
    2. For the Plan field, click Browse to navigate to where the deployment plan XML file is for the IVP and select it.
  4. Click Install. The application is successfully deployed. The callout IVP EAR file would show up in the list of installed enterprise applications in the administrative console.

Results

You have deployed the EAR file for the IMS™ TM resource adapter IVP.

What to do next

For more information about the WebSphere CE deployment framework and related XML schema document (XSD) file for different Java™ EE module type, see the WebSphere CE documentation.

You are ready to run the IMS callout application on the host system.


Feedback