|Home > Documentation > Configuring and administering > Configuring and administering the Apache Geronimo Server > Clustering and farming > Plugin based Farming|
This farming system uses plugins directly and is thus decoupled from the deployment system. It enables the plugin based farming administration for different servers or machines. Farming information is stored in a database using jps. The data model allows a single administration server to manage:
When a node starts up, it broadcasts a service advertisement including an optional node name and a farm name. When the administration server detects this as new, it instructs the new node to install all the plugin lists associated with that farm. If the plugins are already installed, the system provides no further operation; otherwise the plugins are downloaded and installed from the plugin repository specified in the plugin list.
Farming administrative operations include:
Plugin based farming requires two separate sets of functionality:
The farming information is stored in the PluginFarmDatatabase database on the farm controller.
org.apache.geronimo.configs/plugin-farm-member//car(plugins/clustering/plugin-farm-member) plugin turns a server into a plugin farm node. You can configure the multicast address and port, cluster name, and node name in
org.apache.geronimo.assemblies/geronimo-plugin-farm-node//car(plugins/clustering/geronimo-plugin-farm-node) extends the framework assembly with the plugin-farm-member plugin. This is all you need to start up a farm node.
org.apache.geronimo.configs/plugin-farm//car(plugins/clustering/plugin-farm) is the administration plugin for plugin-based farms. Currently it is only accessible through the Gshell cluster/deploy command.
org.apache.geronimo.configs/plugin-farm-datasource//car(plugins/clustering/plugin-farm-datasource) is a derby datasource used by the plugin farm. It is intended to be replaced in production with a remote datasource. As always, the replacement plugin should use an <artifact-alias> element to redirect dependencies on plugin-farm-datasource to itself.
Make sure that the version of the plugins comply with your server.
The following steps demonstrates the plugin based farming using nodes that all share the same geronimo installation. The admin server acts as the farm controller, application deployment server, and plugin repository. The setup steps for plugin based farming includes:
1. Start the controller server and install the following plugins in the server repository. For example, for a version 2.2 server, the plugins are stored in the http://geronimo/apache/org/plugins/geronimo-2.2 repository:
config-substitutions.propertiesfile and set the following attributes: where
ClusterName: defines the name of the farm that the server works in.
NodeName: is optional and defaults to
host:jndi-port. For example, if the host IP for this server is 126.96.36.199 and the jndi-port is 1099, the default
ServerHostname:sets the node IP of this server.
DefaultPluginRepository: defines the plugin repository accessible to all farm nodes. For example, you can use the maven repository as the share install plugin repository by defining
Use the following steps to set up every node server in the farm:
1. Start the node server and install the
org.apache.geronimo.configs/plugin-farm-member//car plugin in the server repository. For example, for a version 2.2 server, the plugin is stored in the http://geronimo/apache/org/plugins/geronimo-2.2 repository.
2. Open the
config-substitutions.properties file and set the following attributes:
3. Add the share install plugin repository to the
plugin-repositories.properties file under
<WASCE_HOME>/var/config/ for each farm node, including access username and password. For example:
mangerin this example is in plain text. However, it is recommended to encrypt your password with the deploy encrypt command.
4. Restart the server.
Install a plugin to the farm controller with command. For example, use the Gshell command as follows to install a HelloWorld.car plugin:
-s: is a command option that indicates the hostname of the server. For this example, the hostname is 188.8.131.52.
Use the cluster/deploy Gshell command to verify the farm that you set up. For example, add and remove plugins and plugin lists with the following commands:
Use this command to add a plugin list p1 to farm cluster1:
Use this command to add the
org.apache.geronimo.samples/HelloWorld/1.0/car plugin to plugin list p1:
Use this command to add the
org.apache.geronimo.samples/HelloWorld/1.0/car plugin to plugin list p1 and add p1 to farm cluster1:
Use this command to remove a plugin list p1 from farm cluster1:
Use this command to remove the
org.apache.geronimo.samples/HelloWorld/1.0/car plugin from plugin list p1:
Access the Plugin portlet form the Administration console to verify the installation result for all farm members.
The following features could be added in the future: