Versions Compared

Key

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

...

You can also install a plugin into a new server assembly by using the car-maven-plugin.
Note that in all cases the dependency system assure that if you install a plugin, everything that is needed to run the plugin will also be installed. For instance, if you install a Java EE application plugin, such as one of the samples, into the framework server, openejb, openjpa, the transaction manager and connector framework, and the appropriate Web container will also be installed as dependencies.

Updating a plugin

At times, you may might need to upgrade a plugin or jar version , for instance if a new version of a dependency is released but you cannot rerelease without rereleasing all the artifacts that depend on it. Here are some methods to upgrade jar versions.

Simple jar upgrade

If you want to install the upgraded jar is to be installed as part of a plugin installation, see the section belowfollowing #Upgrading a jar while releasing a plugin section. Otherwise, follow these steps. use the following steps to upgrade the jar file:

  1. If the server is running, stop the server.
  2. Copy the new jar into the appropriate directory in your geronimo server's repository. For instance:
    Code Block
    mkdir -p repository/org/foo/myjar/1.1/
    cp ~/newFooJar/myjar-1.1.jar repository/org/foo/myjar/1.1/
    
    Alternatively, you can use the administration console portlet Services->Repository can be used portlet on the administration console to add artifacts to the server's repository.

Finally, after the new jar is installed in the server's repository, add a line to var/config/artifact_aliases.properties (or the equivalent file, if the server is using a non-standard alias file) to configure the server to substitute the version for any old version dependency . For instance, to replace myjar-1.0.jar with myjar-1.1.jar, add the following line:

Code Block
org.foo/myjar/1.0/jar=org.foo/myjar/1.1/jar

...

If the jar is installed as part of a plugin installation, you can include configuration upgrade information in the geronimo-plugin.xml. During plugin installation, the upgraded jar will be automatically installed. This is the easiest way to specify in the car-maven-config configuration in the pom.xml, prior to building the plugin.

...