/* * * 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. * */ #include "HaBroker.h" #include "QueueReplicator.h" #include "ReplicatingSubscription.h" #include "Settings.h" #include "qpid/broker/Bridge.h" #include "qpid/broker/Broker.h" #include "qpid/broker/Link.h" #include "qpid/broker/Queue.h" #include "qpid/broker/QueueObserver.h" #include "qpid/broker/QueueRegistry.h" #include "qpid/broker/SessionHandler.h" #include "qpid/broker/SessionHandler.h" #include "qpid/framing/SequenceSet.h" #include "qpid/framing/FieldTable.h" #include "qpid/log/Statement.h" #include "qpid/Msg.h" #include namespace { const std::string QPID_REPLICATOR_("qpid.replicator-"); const std::string TYPE_NAME("qpid.queue-replicator"); const std::string QPID_HA("qpid.ha-"); } namespace qpid { namespace ha { using namespace broker; using namespace framing; using namespace std; using sys::Mutex; const std::string QueueReplicator::DEQUEUE_EVENT_KEY(QPID_HA+"dequeue"); const std::string QueueReplicator::POSITION_EVENT_KEY(QPID_HA+"position"); const std::string QueueReplicator::QPID_SYNC_FREQUENCY("qpid.sync_frequency"); std::string QueueReplicator::replicatorName(const std::string& queueName) { return QPID_REPLICATOR_ + queueName; } bool QueueReplicator::isReplicatorName(const std::string& name) { return name.compare(0, QPID_REPLICATOR_.size(), QPID_REPLICATOR_) == 0; } bool QueueReplicator::isEventKey(const std::string key) { const std::string& prefix = QPID_HA; bool ret = key.size() > prefix.size() && key.compare(0, prefix.size(), prefix) == 0; return ret; } class QueueReplicator::ErrorListener : public SessionHandler::ErrorListener { public: ErrorListener(const std::string& prefix) : logPrefix(prefix) {} void connectionException(framing::connection::CloseCode, const std::string& msg) { QPID_LOG(error, logPrefix << "Connection error: " << msg); } void channelException(framing::session::DetachCode, const std::string& msg) { QPID_LOG(error, logPrefix << "Channel error: " << msg); } void executionException(framing::execution::ErrorCode, const std::string& msg) { QPID_LOG(error, logPrefix << "Execution error: " << msg); } void detach() { QPID_LOG(debug, logPrefix << "Session detached"); } private: std::string logPrefix; }; class QueueReplicator::QueueObserver : public broker::QueueObserver { public: QueueObserver(boost::shared_ptr qr) : queueReplicator(qr) {} void enqueued(const Message&) {} void dequeued(const Message&) {} void acquired(const Message&) {} void requeued(const Message&) {} void consumerAdded( const Consumer& ) {} void consumerRemoved( const Consumer& ) {} // Queue observer is destroyed when the queue is. void destroy() { queueReplicator->destroy(); } private: boost::shared_ptr queueReplicator; }; QueueReplicator::QueueReplicator(HaBroker& hb, boost::shared_ptr q, boost::shared_ptr l) : Exchange(replicatorName(q->getName()), 0, q->getBroker()), haBroker(hb), logPrefix("Backup queue "+q->getName()+": "), queue(q), link(l), brokerInfo(hb.getBrokerInfo()), subscribed(false), settings(hb.getSettings()) { args.setString(QPID_REPLICATE, printable(NONE).str()); Uuid uuid(true); bridgeName = replicatorName(q->getName()) + std::string(".") + uuid.str(); framing::FieldTable args = getArgs(); args.setString(QPID_REPLICATE, printable(NONE).str()); setArgs(args); } // This must be separate from the constructor so we can call shared_from_this. void QueueReplicator::activate() { Mutex::ScopedLock l(lock); if (!queue) return; // Already destroyed std::pair result = queue->getBroker()->getLinks().declare( bridgeName, *link, false, // durable queue->getName(), // src getName(), // dest "", // key false, // isQueue false, // isLocal "", // id/tag "", // excludes false, // dynamic 0, // sync? // Include shared_ptr to self to ensure we are not deleted // before initializeBridge is called. boost::bind(&QueueReplicator::initializeBridge, shared_from_this(), _1, _2) ); bridge = result.first; bridge->setErrorListener( boost::shared_ptr(new ErrorListener(logPrefix))); boost::shared_ptr observer(new QueueObserver(shared_from_this())); queue->addObserver(observer); } QueueReplicator::~QueueReplicator() {} void QueueReplicator::destroy() { // Called from Queue::destroyed() Mutex::ScopedLock l(lock); if (!bridge) return; QPID_LOG(debug, logPrefix << "Destroyed."); bridge->close(); // Need to drop shared pointers to avoid pointer cycles keeping this in memory. queue.reset(); link.reset(); bridge.reset(); getBroker()->getExchanges().destroy(getName()); } // Called in a broker connection thread when the bridge is created. void QueueReplicator::initializeBridge(Bridge& bridge, SessionHandler& sessionHandler) { Mutex::ScopedLock l(lock); if (!queue) return; // Already destroyed AMQP_ServerProxy peer(sessionHandler.out); const qmf::org::apache::qpid::broker::ArgsLinkBridge& args(bridge.getArgs()); FieldTable arguments; arguments.setInt(ReplicatingSubscription::QPID_REPLICATING_SUBSCRIPTION, 1); arguments.setInt(QPID_SYNC_FREQUENCY, 1); // FIXME aconway 2012-05-22: optimize? arguments.setInt(ReplicatingSubscription::QPID_BACK, queue->getPosition()); arguments.setTable(ReplicatingSubscription::QPID_BROKER_INFO,brokerInfo.asFieldTable()); SequenceNumber front, back; queue->getRange(front, back, broker::REPLICATOR); if (front <= back) arguments.setInt(ReplicatingSubscription::QPID_FRONT, front); try { peer.getMessage().subscribe( args.i_src, args.i_dest, 0/*accept-explicit*/, 1/*not-acquired*/, false/*exclusive*/, "", 0, arguments); peer.getMessage().setFlowMode(getName(), 1); // Window peer.getMessage().flow(getName(), 0, settings.getFlowMessages()); peer.getMessage().flow(getName(), 1, settings.getFlowBytes()); } catch(const exception& e) { QPID_LOG(error, QPID_MSG(logPrefix + "Cannot connect to primary: " << e.what())); throw; } qpid::Address primary; link->getRemoteAddress(primary); QPID_LOG(info, logPrefix << "Connected to " << primary << "(" << bridgeName << ")"); QPID_LOG(trace, logPrefix << "Subscription arguments: " << arguments); } namespace { template T decodeContent(Message& m) { std::string content = m.getContent(); Buffer buffer(const_cast(content.c_str()), content.size()); T result; result.decode(buffer); return result; } } void QueueReplicator::dequeue(SequenceNumber n, Mutex::ScopedLock&) { boost::shared_ptr q; { Mutex::ScopedLock l(lock); if (!queue) return; // Already destroyed q = queue; } // Thread safe: only calls thread safe Queue functions. queue->dequeueMessageAt(n); } namespace { bool getSequence(const Message& message, SequenceNumber& result) { result = message.getSequence(); return true; } bool getNext(broker::Queue& q, SequenceNumber position, SequenceNumber& result) { QueueCursor cursor(REPLICATOR); return q.seek(cursor, boost::bind(&getSequence, _1, boost::ref(result)), position+1); } } // namespace // Called in connection thread of the queues bridge to primary. void QueueReplicator::route(Deliverable& msg) { try { const std::string& key = msg.getMessage().getRoutingKey(); Mutex::ScopedLock l(lock); if (!queue) return; // Already destroyed if (!isEventKey(key)) { msg.deliverTo(queue); // We are on a backup so the queue is not modified except via this. QPID_LOG(trace, logPrefix << "Enqueued message " << queue->getPosition()); } else if (key == DEQUEUE_EVENT_KEY) { SequenceSet dequeues = decodeContent(msg.getMessage()); QPID_LOG(trace, logPrefix << "Dequeue: " << dequeues); //TODO: should be able to optimise the following for (SequenceSet::iterator i = dequeues.begin(); i != dequeues.end(); i++) dequeue(*i, l); } else if (key == POSITION_EVENT_KEY) { SequenceNumber position = decodeContent(msg.getMessage()); QPID_LOG(trace, logPrefix << "Position moved from " << queue->getPosition() << " to " << position); // Verify that there are no messages after the new position in the queue. SequenceNumber next; if (getNext(*queue, position, next)) throw Exception(QPID_MSG(logPrefix << "Invalid position " << position << " preceeds message at " << next)); queue->setPosition(position); } // Ignore unknown event keys, may be introduced in later versions. } catch (const std::exception& e) { haBroker.shutdown(QPID_MSG(logPrefix << "Replication failed: " << e.what())); } } // Unused Exchange methods. bool QueueReplicator::bind(boost::shared_ptr, const std::string&, const FieldTable*, qpid::broker::AsyncStore* const) { return false; } bool QueueReplicator::unbind(boost::shared_ptr, const std::string&, const FieldTable*, qpid::broker::AsyncStore* const) { return false; } bool QueueReplicator::isBound(boost::shared_ptr, const std::string* const, const FieldTable* const) { return false; } std::string QueueReplicator::getType() const { return TYPE_NAME; } // DataSource interface - used to write persistence data to async store uint64_t QueueReplicator::getSize() { return 0; } void QueueReplicator::write(char* /*target*/) {} }} // namespace qpid::broker