karaf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jbono...@apache.org
Subject git commit: [KARAF-1545] Update the document about the JDBC locking mechanism and driver loading
Date Thu, 10 Jul 2014 06:31:17 GMT
Repository: karaf
Updated Branches:
  refs/heads/karaf-2.x 7ba6261d8 -> 07abaf4fe


[KARAF-1545] Update the document about the JDBC locking mechanism and driver loading


Project: http://git-wip-us.apache.org/repos/asf/karaf/repo
Commit: http://git-wip-us.apache.org/repos/asf/karaf/commit/07abaf4f
Tree: http://git-wip-us.apache.org/repos/asf/karaf/tree/07abaf4f
Diff: http://git-wip-us.apache.org/repos/asf/karaf/diff/07abaf4f

Branch: refs/heads/karaf-2.x
Commit: 07abaf4fe0cef305fe2d840100e1fc5d492a980b
Parents: 7ba6261
Author: Jean-Baptiste Onofré <jbonofre@apache.org>
Authored: Thu Jul 10 08:30:40 2014 +0200
Committer: Jean-Baptiste Onofré <jbonofre@apache.org>
Committed: Thu Jul 10 08:30:40 2014 +0200

----------------------------------------------------------------------
 manual/src/main/webapp/users-guide/failover.conf | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/karaf/blob/07abaf4f/manual/src/main/webapp/users-guide/failover.conf
----------------------------------------------------------------------
diff --git a/manual/src/main/webapp/users-guide/failover.conf b/manual/src/main/webapp/users-guide/failover.conf
index aaa55de..539a317 100644
--- a/manual/src/main/webapp/users-guide/failover.conf
+++ b/manual/src/main/webapp/users-guide/failover.conf
@@ -49,6 +49,11 @@ karaf.lock.jdbc.timeout=30
 * The first Karaf instance to acquire the locking table is the master instance.
 * If the connection to the database is lost, the master instance tries to gracefully shutdown,
allowing a slave instance to become master when the database service is restored. The former
master will require a manual restart.
 
+{warning}
+Apache Karaf won't start if the JDBC driver is not present in the {{lib/ext}} folder. In
order to be loaded correctly,
+the JDBC driver jar file has to be prefixed with {{karaf-}} (for instance the {{ojdbc14.jar}}
has to be renamed as {{karaf-ojdbc14.jar}} in the {{lib/ext}} folder.
+{warning}
+
 h3. JDBC locking on Oracle
 
 If you are using Oracle as your database for JDBC locking, the {{karaf.lock.class}} property
in the {{$KARAF_HOME/etc/system.properties}} file must point to {{org.apache.karaf.main.OracleJDBCLock}}.
@@ -67,13 +72,13 @@ karaf.lock.jdbc.clustername=karaf
 karaf.lock.jdbc.timeout=30
 {noformat}
 
-As with the default JDBC locking setup, the Oracle JDBC driver JAR file must be in your classpath.
You can ensure this by copying the {{ojdbc14.jar}} into Karaf's {{lib}} folder before starting
Karaf.
+As with the default JDBC locking setup, the Oracle JDBC driver JAR file must be in your classpath.
You can ensure this by copying the {{ojdbc14.jar}} into Karaf's {{lib/ext}} folder and prefixed
with {{karaf-}} before starting Karaf.
 
 *Note*: The {{karaf.lock.jdbc.url}} requires an active SID, which means you must manually
create a database instance before using this particular lock.
 
 h3. Derby
 
-The same rules apply when using derby.  Make sure you have the driver jar file in the Karaf
{{lib}} folder before starting Karaf.
+The same rules apply when using derby.  Make sure you have the driver jar file in the Karaf
{{lib/ext}} folder and prefixed with {{karaf-}} before starting Karaf.
 
 Then make you update the properties in {{$KARAF_HOME/etc/system.properties}} to look something
like this example:
 
@@ -91,9 +96,7 @@ karaf.lock.jdbc.timeout=30
 
 h3. MySQL
 
-Make sure you have the MySQL driver jar file in the Karaf {{lib}} folder before starting
Karaf.
-
-*NOTE*: for 2.2.x, 2.3.x you need to rename the MySQL Driver jar to prefix with 'karaf-'
in order for karaf to pick it up, otherwise you will see karaf just hang on startup and the
log will show you that it could not find the driver.
+Make sure you have the MySQL driver jar file in the Karaf {{lib/ext}} folder and prefixed
with {{karaf-}} before starting Karaf.
 
 Then make you update the properties in {{$KARAF_HOME/etc/system.properties}} to look something
like this example:
 
@@ -111,9 +114,7 @@ karaf.lock.jdbc.timeout=30
 
 h3. PostgreSQL
 
-Make sure you have the PostgreSQL driver jar file in the Karaf {{lib}} folder before starting
Karaf.
-
-*NOTE*: for 2.2.x, 2.3.x you need to rename the PostgreSQL Driver jar to prefix with 'karaf-'
in order for karaf to pick it up, otherwise you will see karaf just hang on startup and the
log will show you that it could not find the driver.
+Make sure you have the PostgreSQL driver jar file in the Karaf {{lib/ext}} folder and prefixed
with {{karaf-}} before starting Karaf.
 
 Then make you update the properties in {{$KARAF_HOME/etc/system.properties}} to look something
like this example:
 


Mime
View raw message