Deploying the IVP EAR file to WebSphere Application Server Community Edition

To deploy the IVP WAR 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 your resource JNDI name. The JNDI name must match the JNDI name of a connection factory defined in the resource adapter deployment plan XML file.

    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="IMSICOIVPServiceEAR">
        <dep:environment>
          <dep:moduleId>
            <dep:groupId>com.ibm.imsico</dep:groupId>
            <dep:artifactId>IMSICOIVP</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>
        <web>IMSICOIVPServiceWeb.war</web>
        <web-app xmlns="http://geronimo.apache.org/xml/ns/j2ee/web-2.0"
                 xmlns:naming="http://geronimo.apache.org/xml/ns/naming-1.0">
          <context-root>IMSICOIVPServiceWeb</context-root>
             <naming:resource-ref>
             <naming:ref-name>myIMSResRef</naming:ref-name>
             <!-- Specify the JNDI name of the connection factory that you would like to use. -->
             <!-- This name must match the JNDI name of a connection factory defined in the --> 
             <!-- resource adapter deployment plan XML file. --> 
             <naming:resource-link>jca/myIMSTMRA</naming:resource-link>
          </naming:resource-ref>
        </web-app>
      </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 imsicoivp.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 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 TM resource adapter IVP.


Feedback