Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The next page of the dialog contains a drop down list of all the objects that can be converted into Geronimo plugins. Many of the objects in this list are already plugins that are used by the Geronimo server. For example, select the console.dbpool/jdbcuserds/1.0/rar from the drop down list.



Selecting your application objects (one at a time) and clicking next will bring up pages that will allow you to change the geronimo-plugin.xml before saving. All fields on the next two pages are data that will be saved with the plugin and will help with installation.



...

For saving multiple projects or applications, repeat the above steps. For example, do the same for ApplicationClient and StatelessSessionEJB, selecting them from the drop down list.
The above process creates an appropriate directory structure in the directory specified by the Local Plugin Repository field of the first page of the wizard. geronimo-plugin.xml files have been created for each plugin and the top directory includes a geronimo-plugins.xml that keeps track of all the plugins that have been created. The values in these files came from data from the last two pages in the Plugin Manager.
If you need to update the geronimo-plugin.xml file after saving, you can edit this file manually. When it is installed in the next step, the updates will be saved.



Code Block
titlegeronimo-plugins.xml
borderStylesolid

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!--
    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.
-->
<geronimo-plugin-list xmlns:ns2="http://geronimo.apache.org/xml/ns/attributes-1.2" xmlns="http://geronimo.apache.org/xml/ns/plugins-1.3">
            <plugin>
        <name>DBPool Database Plugin</name>
        <category>Sample</category>
        <description>This plugin sets up a Derby database pool</description>
        <url>http://www.apache.org</url>
        <author>Ashish Jain</author>
        <license osi-approved="true">The Apache Software License, Version 2.0</license>
        <plugin-artifact>
            <module-id>
                <groupId>console.dbpool</groupId>
                <artifactId>jdbc%2Fuserds</artifactId>
                <version>1.0</version>
                <type>rar</type>
            </module-id>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>system-database</artifactId>
            <version>2.1.1</version>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>transaction</artifactId>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>j2ee-server</artifactId>
            <type>car</type>
        </dependency>
        <source-repository>http://repo1.maven.org/maven2/</source-repository>
	<source-repository>file:/C:/myplugins</source-repository>
        <obsoletes>
            <groupId>console.dbpool</groupId>
            <artifactId>jdbc%2Fuserds</artifactId>
            <type>rar</type>
        </obsoletes>
        </plugin-artifact>
    </plugin>
<plugin>
        <name>Stateless EJB Sample Plugin</name>
        <category>Sample</category>
        <description>This plugin installs an EJB Sample</description>
        <url>http://www.apache.org</url>
        <author>Ashish Jain</author>
        <license osi-approved="true">The Apache Software License, Version 2.0</license>
    <plugin-artifact>
        <module-id>
            <groupId>default</groupId>
            <artifactId>StatelessSessionEJB</artifactId>
            <version>1.0</version>
            <type>car</type>
        </module-id>
        <dependency>
            <groupId>console.dbpool</groupId>
            <artifactId>jdbc%2Fuserds</artifactId>
	    <type>rar</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>openejb</artifactId>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>system-database</artifactId>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>tomcat6</artifactId>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>axis</artifactId>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>axis2</artifactId>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>j2ee-corba-yoko</artifactId>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>openjpa</artifactId>
            <type>car</type>
        </dependency>
	<source-repository>file:/C:/myplugins</source-repository>
	<source-repository>http://repo1.maven.org/maven2/</source-repository>
        <obsoletes>
            <groupId>default</groupId>
            <artifactId>StatelessSessionEJB</artifactId>
            <type>car</type>
        </obsoletes>
    </plugin-artifact>
    </plugin>
<plugin>
        <name>Application Client</name>
        <category>Sample</category>
        <description>This plugin installs an App Client Sample</description>
        <url>http://www.apache.org</url>
        <author>Ashish Jain</author>
        <license osi-approved="true">The Apache Software License, Version 2.0</license>
	<plugin-artifact>
        <module-id>
            <groupId>default</groupId>
            <artifactId>ApplicationClient</artifactId>
            <version>1.0</version>
            <type>car</type>
        </module-id>
        <dependency>
            <groupId>default</groupId>
            <artifactId>StatelessSessionEJB</artifactId>
            <version>1.0</version>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>tomcat6</artifactId>
            <version>2.1.1</version>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>axis</artifactId>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>axis2</artifactId>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>openejb</artifactId>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>j2ee-corba-yoko</artifactId>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>openjpa</artifactId>
            <type>car</type>
        </dependency>
        <dependency>
            <groupId>org.apache.geronimo.configs</groupId>
            <artifactId>jasper</artifactId>
            <type>car</type>
        </dependency>
	<source-repository>file:/C:/myplugins</source-repository>
	<source-repository>http://repo1.maven.org/maven2/</source-repository>
        <obsoletes>
            <groupId>default</groupId>
            <artifactId>ApplicationClient</artifactId>
            <type>car</type>
        </obsoletes>
     </plugin-artifact>
</plugin>
    <default-repository>http://geronimo.apache.org/plugins/geronimo-2.1/</default-repository>
</geronimo-plugin-list>

Installing Geronimo Plugins

If you haven't done so already, remove the projects from the server. In this example, we uninstall the EJB jar, Application Client WAR and database pool from server.This can be down by removing the Web and EJB projects from the server and by using the gshell command line to undeploy the database.



From the main page of the Plugin Manager wizard, select "install the Install Geronimo plugins" and click Next.



Select all the Geronimo plugins that you want to install on the server. If Installable is false, then the plugin cannot be selected. The most common reasons that a plugin cannot be installed are if the version of the plugin is already installed on the server or if prerequisites are not available.
Clicking next will install all selected plugins, and these three plugins will be installed and a confirmation page will be displayed showing what has been installed.