polardbxengine/storage/ndb/include/kernel/signaldata/NodePing.hpp

90 lines
2.9 KiB
C++

/*
Copyright (c) 2010, 2013, Oracle and/or its affiliates. All rights reserved.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License, version 2.0,
as published by the Free Software Foundation.
This program is also distributed with certain software (including
but not limited to OpenSSL) that is licensed under separate terms,
as designated in a particular file or component or in included license
documentation. The authors of MySQL hereby grant you an additional
permission to link the program and your derivative works with the
separately licensed software that they have included with MySQL.
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 General Public License, version 2.0, for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef NODEPING_HPP
#define NODEPING_HPP
#include "SignalData.hpp"
#define JAM_FILE_ID 213
/*
* NodePingReq/Conf is sent between QMGR nodes to help determine the
* available connectivity in a cluster experiencing heartbeat problems
*
* When a node detects that it has not received a heartbeat from a
* connected node for the heartbeat period, it initiates a global
* connectivity check protocol by sending a NODE_PING_REQ signal to all
* nodes considered to be running.
*
* On receiving this signal, a node will respond with NODE_PING_CONF to
* the sender, and begin its own connectivity check, if it is not
* already involved in one.
*
* In this way, all nodes reachable within some latency n will begin
* a connectivity check. If they do not receive a NODE_PING_CONF from a
* peer node within some further latency m, then they consider it to
* be suspect, and after a further latency p they consider it failed.
*
* In environments where latency between nodes fluctuates, but
* connectivity is maintained (for example where TCP connections observe
* latency due to underlying IP re-routing/failover), the connectivity
* check allows nodes to arm themselves in preparation for the potential
* race of FAIL_REP signals that can arise in these situations, by marking
* connections experiencing latency as SUSPECT. Once a node is marked as
* SUSPECT, FAIL_REP signals originating from it may not be trusted or
* acted upon.
*/
class NodePingReq {
/**
* Sender(s) / Receiver(s)
*/
friend class Qmgr;
public:
STATIC_CONST( SignalLength = 2 );
Uint32 senderData;
Uint32 senderRef;
};
class NodePingConf {
/**
* Sender(s) / Receiver(s)
*/
friend class Qmgr;
public:
STATIC_CONST( SignalLength = 2 );
Uint32 senderData;
Uint32 senderRef;
};
#undef JAM_FILE_ID
#endif