Page History

This chapter will demonstrate how to configure failover deployments.

Simple Lock File

The Simple Lock File mechanism is intended for failover configurations where instances reside on one host machine.

To use this feature the following must be set on each system in the master/slave setup:

...

DEFAULT_JAVA_OPTS="-server $DEFAULT_JAVA_OPTS -Dcom.sun.management.jmxremote.port=1100 -Dcom.sun.management.jmxremote.authenticate=false"

JDBC Locking

The JDBC locking mechanism is intended for failover configurations where instances exist on separate machines. In this deployment the master instance holds a lock on a servicemix locking table hosted on a database. If the master losses this lock then an awaiting slave process may gain access to the locking table, then fully start its container. The former master upon detection of lock loss will switch run levels as configured by lock level.

To use this feature the following must be set on each system in the master/slave setup:

• Classpath updated to include JDBC driver.
• $SERVICEMIX_HOME/etc/system.properties file updated to reflect the below entries.
• $SERVICEMIX_HOME/bin/servicemix updated to have unique jmx remote port set if instances reside on same host.

servicemix.lock=true
servicemix.lock.class=org.apache.servicemix.kernel.main.DefaultJDBCLock
servicemix.lock.level=50
servicemix.lock.delay=10
servicemix.lock.jdbc.url=jdbc:derby://dbserver:1527/sample
servicemix.lock.jdbc.driver=org.apache.derby.jdbc.ClientDriver
servicemix.lock.jdbc.user=user
servicemix.lock.jdbc.password=password
servicemix.lock.jdbc.table=SERVICEMIX_LOCK
servicemix.lock.jdbc.clustername=smx4
servicemix.lock.jdbc.timeout=30

...

• Will fail if jdbc driver is not on classpath.
• The database name "sample" will be created if it does not exist on the db.
• First SMX4 instance to acquire the locking table is the master instance.
• If connection to the DB is lost then the master instance will attempt to gracefully shutdown, allowing a slave instance to become master when the DB service is restored. The former master will require manual restart.

The Container Level locking mechanism allows bundles to be loaded into the slave kernel instance in order to provide faster failover performance. The Container Level refers to the starting priority assigned to each bundle in the OSGI container. These start levels are specified in $SERVICEMIX_HOME/etc/startup.properties, in the format jar.name=level. The core system bundles have levels below 50, where as user bundles have levels greater than 50.