| # |
| # Licensed to the Apache Software Foundation (ASF) under one |
| # or more contributor license agreements. See the NOTICE file |
| # distributed with this work for additional information |
| # regarding copyright ownership. The ASF licenses this file |
| # to you under the Apache License, Version 2.0 (the |
| # "License"); you may not use this file except in compliance |
| # with the License. You may obtain a copy of the License at |
| # |
| # http://www.apache.org/licenses/LICENSE-2.0 |
| # |
| # Unless required by applicable law or agreed to in writing, |
| # software distributed under the License is distributed on an |
| # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| # KIND, either express or implied. See the License for the |
| # specific language governing permissions and limitations |
| # under the License. |
| # |
| Qpid JCA Example - Apache Geronimo 2.x |
| |
| Overview |
| ======== |
| This document explains the steps required to configure and |
| deploy the Qpid JCA examples for the Apache Geronimo environment. |
| General information can be found in the README.txt file. |
| |
| The Apache Geronimo environment provides two methods for deploying |
| JEE application components: the web-based administration console and the |
| command line based deployment environment. This document only explains |
| the command line environment. Please see the Apache Geronimo 2.x |
| documentation for the web-based console. |
| |
| Requirements |
| ============ |
| In order to deploy the Qpid JCA adapter, as well as the example application, |
| the GERONIMO_HOME environemnt variable must be set. The environment variable |
| should point to the root of your Apache Geronimo 2.x install directory. |
| |
| In order to automatically deploy the Qpid JCA Adapter, the QPID_JCA_HOME |
| environment variable needs to be set. The environment variable should point |
| to the directory which contains the Qpid JCA Adapter. If building from the |
| source tree, by default this can be found at |
| |
| QPID_ROOT/java/build/lib |
| |
| If installing from RPM or other binary distribution, this can vary by platform. |
| |
| Prior to deploying any application component, the Apache Geronimo application |
| should be started and available for requests. |
| |
| |
| Deploy the Qpid JCA Adapter |
| ============================== |
| Once the above requirements are satisfied the command |
| |
| ant deploy-rar |
| |
| will attempt to use the Apache Geronimo deployer to install the Qpid JCA |
| adapter into the Apache Geronimo environment. Any errors will be reported |
| back to the client for further examination. Once the above command executes |
| successfully, the Qpid JCA adapter has been deployed, configured and is ready |
| for use. |
| |
| |
| Deploy the Qpid JCA Examples |
| ============================ |
| After the Qpid JCA adapter is deployed, executing the command |
| |
| ant deploy-ear |
| |
| will attempt to use the Apache Geronimo deploy to install the Qpid JCA |
| example EAR into the Apache Geronimo environment. Any errors will be reported |
| back to the client for further examination. Once the above command executes |
| successfully, the Qpid JCA example application is deployed, configured and ready |
| for use. |
| |
| The build-geronimo-properties.xml file contain Apache Geronimo specific values |
| and Ant targets that can be used to suit your development requirements. |
| |
| The README.txt file in this directory provides the necessary instructions for using the Qpid JCA |
| adapter and example application. |
| |
| |
| |
| |
| |
| |