Get and install Wildfly 8.1.0: http://download.jboss.org/wildfly/8.1.0.Final/wildfly-8.1.0.Final.zip
It's currently been tested against WF 8.1.0 and the default server configuration (standalone-cassdandra.xml) is configured for WF 8. But apart from that there should be no reason to not use it on WF 9.
Checkout and build cassandra trunk from the apache repo. This will put it to your local maven repo:
git clone http://git-wip-us.apache.org/repos/asf/cassandra.git cassandra-trunk
cd cassandra-trunk; ant mvn-install
(For further details on how to build cassandra please see http://wiki.apache.org/cassandra/HowToContribute)
Build the top level project:
mvn clean install
This will also create a wildfly-cassandra-overlay.zip, that can be installed on Wildfly:
unzip target/wildfly-cassandra-overlay.zip -d $WILDFLY_HOME
This will add an additional module that contains the cassandra extension and subsystem:
modules/system/layers/base/org/wildfly/extension/cassandra/main/
The following contents will be installed when you unpack the wildfly-cassandra-overlay.zip:
bin/nodetool (1) modules/system/layers/base/org/wildfly/extension/cassandra/main/module.xml (2) modules/system/layers/base/org/wildfly/extension/cassandra/main/*.jar (3) standalone/configuration/standalone-cassandra.xml (4) domain/configuration/cassandra-domain.xml (5) domain/configuration/cassandra-host.xml (6)
- A patched nodetool that allows full JMX urls (i.e service:jmx:http-remoting-jmx://127.0.0.1:9990)
- The module descriptor
- Required libraries to run cassandra on Wildfly
- An example configuration for standalone servers
- An example configuration for managed domains
- An example host configuration (seed nodes)
The wildfly-cassandra-overlay.zip installs server profiles for both standalone and domain mode that can be used to start a pre-configured Wildfly instance:
./bin/standalone.sh -c standalone-cassandra.xml -b 127.0.0.1 -Dcassandra.boot_without_jna=true
(yes, the jna switch matters)
./bin/domain.sh --domain-config=cassandra-domain.xml --host-config=cassandra-host.xml -b 127.0.0.1
The service configuration can be accessed like any other wildfly resource:
`[standalone@localhost:9990 /] /subsystem=cassandra/cluster=WildflyCluster:read-resource
{
"outcome" => "success",
"result" => {
"authenticator" => "AllowAllAuthenticator",
"authorizer" => "AllowAllAuthorizer",
"broadcast-address" => expression "${jboss.default.multicast.address:230.0.0.4}",
"client-encryption-enabled" => false,
"commitlog-sync" => "periodic",
"commitlog-sync-period-in-ms" => 10000,
"debug" => false,
"endpoint-snitch" => "SimpleSnitch",
"hinted-handoff-enabled" => true,
"internode-authenticator" => "org.apache.cassandra.auth.AllowAllInternodeAuthenticator",
"listen-address" => expression "${jboss.bind.address:127.0.0.1}",
"native-transport-port" => 9042,
"num-tokens" => 256,
"partitioner" => "org.apache.cassandra.dht.Murmur3Partitioner",
"request-scheduler" => "org.apache.cassandra.scheduler.NoScheduler",
"rpc-port" => 9160,
"seed-provider-class-name" => "org.apache.cassandra.locator.SimpleSeedProvider",
"seed-provider-seeds" => expression "${jboss.bind.address:127.0.0.1}",
"server-encryption-enabled" => false,
"start-native-transport" => true,
"start-rpc" => true
}
}`
If you discover any problems or see room for improvement, feel free to file an issue and we'll discuss it: https://github.com/rhq-project/wildfly-cassandra/issues
The best way to reach out and discuss the cassandra subsystem is currently the RHQ mailing list and/or the Chat Room:
- Mailing List: https://lists.fedorahosted.org/mailman/listinfo/rhq-devel
- IRC: irc://freenode.org/#rhq