/**
* Copyright 2014 MongoDB Inc.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License, version 3,
* as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see .
*
* As a special exception, the copyright holders give permission to link the
* code of portions of this program with the OpenSSL library under certain
* conditions as described in each individual source file and distribute
* linked combinations including the program with the OpenSSL library. You
* must comply with the GNU Affero General Public License in all respects for
* all of the code used other than as permitted herein. If you modify file(s)
* with this exception, you may extend this exception to your version of the
* file(s), but you are not obligated to do so. If you do not wish to do so,
* delete this exception statement from your version. If you delete this
* exception statement from all source files in the program, then also delete
* it in the license file.
*/
#pragma once
#include
#include
#include "mongo/base/status.h"
#include "mongo/db/repl/replica_set_tag.h"
#include "mongo/util/net/hostandport.h"
#include "mongo/util/time_support.h"
namespace mongo {
class BSONObj;
namespace repl {
/**
* Representation of the configuration information about a particular member of a replica set.
*/
class MemberConfig {
public:
typedef std::vector::const_iterator TagIterator;
static const std::string kIdFieldName;
static const std::string kVotesFieldName;
static const std::string kPriorityFieldName;
static const std::string kHostFieldName;
static const std::string kHiddenFieldName;
static const std::string kSlaveDelayFieldName;
static const std::string kArbiterOnlyFieldName;
static const std::string kBuildIndexesFieldName;
static const std::string kTagsFieldName;
static const std::string kInternalVoterTagName;
static const std::string kInternalElectableTagName;
static const std::string kInternalAllTagName;
/**
* Default constructor, produces a MemberConfig in an undefined state.
* Must successfully call initialze() before calling validate() or the
* accessors.
*/
MemberConfig() : _slaveDelay(0) {}
/**
* Initializes this MemberConfig from the contents of "mcfg".
*
* If "mcfg" describes any tags, builds ReplicaSetTags for this
* configuration using "tagConfig" as the tag's namespace. This may
* have the effect of altering "tagConfig" when "mcfg" describes a
* tag not previously added to "tagConfig".
*/
Status initialize(const BSONObj& mcfg, ReplicaSetTagConfig* tagConfig);
/**
* Performs basic consistency checks on the member configuration.
*/
Status validate() const;
/**
* Gets the identifier for this member, unique within a ReplicaSetConfig.
*/
int getId() const { return _id; }
/**
* Gets the canonical name of this member, by which other members and clients
* will contact it.
*/
const HostAndPort& getHostAndPort() const { return _host; }
/**
* Gets this member's priority. Higher means more likely to be elected
* primary.
*/
double getPriority() const { return _priority; }
/**
* Gets the amount of time behind the primary that this member will atempt to
* remain. Zero seconds means stay as caught up as possible.
*/
Seconds getSlaveDelay() const { return _slaveDelay; }
/**
* Returns true if this member may vote in elections.
*/
bool isVoter() const { return _votes != 0; }
/**
* Returns the number of votes that this member gets.
*/
int getNumVotes() const { return isVoter() ? 1 : 0; }
/**
* Returns true if this member is an arbiter (is not data-bearing).
*/
bool isArbiter() const { return _arbiterOnly; }
/**
* Returns true if this member is hidden (not reported by isMaster, not electable).
*/
bool isHidden() const { return _hidden; }
/**
* Returns true if this member should build secondary indexes.
*/
bool shouldBuildIndexes() const { return _buildIndexes; }
/**
* Gets the number of replica set tags, including internal '$' tags, for this member.
*/
size_t getNumTags() const { return _tags.size(); }
/**
* Returns true if this MemberConfig has any non-internal tags, using "tagConfig" to
* determine the internal property of the tags.
*/
bool hasTags(const ReplicaSetTagConfig& tagConfig) const;
/**
* Gets a begin iterator over the tags for this member.
*/
TagIterator tagsBegin() const { return _tags.begin(); }
/**
* Gets an end iterator over the tags for this member.
*/
TagIterator tagsEnd() const { return _tags.end(); }
/**
* Returns true if this represents the configuration of an electable member.
*/
bool isElectable() const { return !isArbiter() && getPriority() > 0; }
/**
* Returns the member config as a BSONObj, using "tagConfig" to generate the tag subdoc.
*/
BSONObj toBSON(const ReplicaSetTagConfig& tagConfig) const;
private:
int _id;
HostAndPort _host;
double _priority; // 0 means can never be primary
int _votes; // Can this member vote? Only 0 and 1 are valid. Default 1.
bool _arbiterOnly;
Seconds _slaveDelay;
bool _hidden; // if set, don't advertise to drivers in isMaster.
bool _buildIndexes; // if false, do not create any non-_id indexes
std::vector _tags; // tagging for data center, rack, etc.
};
} // namespace repl
} // namespace mongo