/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.jackrabbit.oak.plugins.document;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
import java.util.Properties;
import com.mongodb.DB;
import com.mongodb.MongoClient;
import com.mongodb.MongoClientOptions;
import com.mongodb.MongoClientURI;
import org.apache.felix.scr.annotations.Activate;
import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.ConfigurationPolicy;
import org.apache.felix.scr.annotations.Deactivate;
import org.apache.felix.scr.annotations.Property;
import org.apache.jackrabbit.oak.api.jmx.CacheStatsMBean;
import org.apache.jackrabbit.oak.kernel.KernelNodeStore;
import org.apache.jackrabbit.oak.osgi.ObserverTracker;
import org.apache.jackrabbit.oak.osgi.OsgiWhiteboard;
import org.apache.jackrabbit.oak.plugins.document.mongo.MongoDocumentStore;
import org.apache.jackrabbit.oak.plugins.document.util.MongoConnection;
import org.apache.jackrabbit.oak.spi.state.NodeStore;
import org.apache.jackrabbit.oak.spi.whiteboard.Registration;
import org.apache.jackrabbit.oak.spi.whiteboard.Whiteboard;
import org.apache.sling.commons.osgi.PropertiesUtil;
import org.osgi.framework.BundleContext;
import org.osgi.framework.ServiceRegistration;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import static org.apache.jackrabbit.oak.spi.whiteboard.WhiteboardUtils.registerMBean;
/**
* The OSGi service to start/stop a DocumentNodeStore instance.
*/
@Component(metatype = true,
label = "%oak.documentns.label",
description = "%oak.documentns.description",
policy = ConfigurationPolicy.REQUIRE
)
public class DocumentNodeStoreService {
private static final String DEFAULT_URI = "mongodb://localhost:27017/oak";
private static final int DEFAULT_CACHE = 256;
private static final int DEFAULT_OFF_HEAP_CACHE = 0;
private static final String DEFAULT_DB = "oak";
private static final String PREFIX = "oak.documentstore.";
/**
* Name of framework property to configure Mongo Connection URI
*/
private static final String FWK_PROP_URI = "oak.mongo.uri";
/**
* Name of framework property to configure Mongo Database name
* to use
*/
private static final String FWK_PROP_DB = "oak.mongo.db";
//DocumentMK would be done away with so better not
//to expose this setting in config ui
@Property(boolValue = false, propertyPrivate = true)
private static final String PROP_USE_MK = "useMK";
@Property(value = DEFAULT_URI)
private static final String PROP_URI = "mongouri";
@Property(value = DEFAULT_DB)
private static final String PROP_DB = "db";
@Property(intValue = DEFAULT_CACHE)
private static final String PROP_CACHE = "cache";
@Property(intValue = DEFAULT_OFF_HEAP_CACHE)
private static final String PROP_OFF_HEAP_CACHE = "offHeapCache";
private static final long MB = 1024 * 1024;
private final Logger logger = LoggerFactory.getLogger(this.getClass());
private ServiceRegistration reg;
private final List<Registration> registrations = new ArrayList<Registration>();
private DocumentMK mk;
private ObserverTracker observerTracker;
private BundleContext bundleContext;
@Activate
protected void activate(BundleContext context, Map<String, ?> config) throws Exception {
this.bundleContext = context;
String uri = PropertiesUtil.toString(prop(config, PROP_URI, FWK_PROP_URI), DEFAULT_URI);
String db = PropertiesUtil.toString(prop(config, PROP_DB, FWK_PROP_DB), DEFAULT_DB);
int offHeapCache = PropertiesUtil.toInteger(prop(config, PROP_OFF_HEAP_CACHE), DEFAULT_OFF_HEAP_CACHE);
int cacheSize = PropertiesUtil.toInteger(prop(config, PROP_CACHE), DEFAULT_CACHE);
boolean useMK = PropertiesUtil.toBoolean(config.get(PROP_USE_MK), false);
MongoClientOptions.Builder builder = MongoConnection.getDefaultBuilder();
MongoClientURI mongoURI = new MongoClientURI(uri,builder);
if(logger.isInfoEnabled()){
// Take care around not logging the uri directly as it
// might contain passwords
String type = useMK ? "MK" : "NodeStore" ;
logger.info("Starting Document{} with host={}, db={}, cache size (MB)={}, Off Heap Cache size (MB)={}",
new Object[] {type, mongoURI.getHosts(), db, cacheSize, offHeapCache});
logger.info("Mongo Connection details {}", MongoConnection.toString(mongoURI.getOptions()));
}
MongoClient client = new MongoClient(mongoURI);
DB mongoDB = client.getDB(db);
mk = new DocumentMK.Builder()
.memoryCacheSize(cacheSize * MB)
.offHeapCacheSize(offHeapCache * MB)
.setMongoDB(mongoDB)
.open();
logger.info("Connected to database {}", mongoDB);
registerJMXBeans(mk.getNodeStore(), context);
NodeStore store;
if (useMK) {
KernelNodeStore kns = new KernelNodeStore(mk);
store = kns;
observerTracker = new ObserverTracker(kns);
} else {
DocumentNodeStore mns = mk.getNodeStore();
store = mns;
observerTracker = new ObserverTracker(mns);
}
observerTracker.start(context);
reg = context.registerService(NodeStore.class.getName(), store, new Properties());
}
private Object prop(Map<String, ?> config, String propName){
return prop(config,propName,PREFIX + propName);
}
private Object prop(Map<String, ?> config, String propName, String fwkPropName){
//Prefer framework property first
Object value = bundleContext.getProperty(fwkPropName);
if(value != null){
return value;
}
//Fallback to one from config
return config.get(propName);
}
@Deactivate
protected void deactivate() {
if(observerTracker != null){
observerTracker.stop();
}
for (Registration r : registrations) {
r.unregister();
}
if (reg != null) {
reg.unregister();
}
if (mk != null) {
mk.dispose();
}
}
private void registerJMXBeans(DocumentNodeStore store, BundleContext context) {
Whiteboard wb = new OsgiWhiteboard(context);
registrations.add(
registerMBean(wb,
CacheStatsMBean.class,
store.getNodeCacheStats(),
CacheStatsMBean.TYPE,
store.getNodeCacheStats().getName()));
registrations.add(
registerMBean(wb,
CacheStatsMBean.class,
store.getNodeChildrenCacheStats(),
CacheStatsMBean.TYPE,
store.getNodeChildrenCacheStats().getName())
);
registrations.add(
registerMBean(wb,
CacheStatsMBean.class,
store.getDiffCacheStats(),
CacheStatsMBean.TYPE,
store.getDiffCacheStats().getName()));
registrations.add(
registerMBean(wb,
CacheStatsMBean.class,
store.getDocChildrenCacheStats(),
CacheStatsMBean.TYPE,
store.getDocChildrenCacheStats().getName())
);
DocumentStore ds = store.getDocumentStore();
if (ds instanceof MongoDocumentStore) {
MongoDocumentStore mds = (MongoDocumentStore) ds;
registrations.add(
registerMBean(wb,
CacheStatsMBean.class,
mds.getCacheStats(),
CacheStatsMBean.TYPE,
mds.getCacheStats().getName())
);
}
//TODO Register JMX bean for Off Heap Cache stats
}
}