Package org.apache.hadoop.hdfs.qjournal.server

Class JournalNodeRpcServer

java.lang.Object

org.apache.hadoop.hdfs.qjournal.server.JournalNodeRpcServer

All Implemented Interfaces:

InterQJournalProtocol, QJournalProtocol

@Private
@VisibleForTesting
public class JournalNodeRpcServer
extends java.lang.Object
implements QJournalProtocol, InterQJournalProtocol

Field Summary

Fields inherited from interface org.apache.hadoop.hdfs.qjournal.protocol.InterQJournalProtocol

versionID

Fields inherited from interface org.apache.hadoop.hdfs.qjournal.protocol.QJournalProtocol

versionID

Method Summary

Modifier and Type	Method	Description
void	acceptRecovery(RequestInfo reqInfo, QJournalProtocolProtos.SegmentStateProto log, java.net.URL fromUrl)	Accept a proposed recovery for the given transaction ID.
java.lang.Boolean	canRollBack(java.lang.String journalId, java.lang.String nameServiceId, StorageInfo storage, StorageInfo prevStorage, int targetLayoutVersion)
void	discardSegments(java.lang.String journalId, java.lang.String nameServiceId, long startTxId)	Discard journal segments whose first TxId is greater than or equal to the given txid.
void	doFinalize(java.lang.String journalId, java.lang.String nameServiceId)
void	doPreUpgrade(java.lang.String journalId)
void	doRollback(java.lang.String journalId, java.lang.String nameServiceId)
void	doUpgrade(java.lang.String journalId, StorageInfo sInfo)
void	finalizeLogSegment(RequestInfo reqInfo, long startTxId, long endTxId)	Finalize the given log segment on the JournalNode.
void	format(java.lang.String journalId, java.lang.String nameServiceId, NamespaceInfo nsInfo, boolean force)	Format the underlying storage for the given namespace.
java.net.InetSocketAddress	getAddress()
QJournalProtocolProtos.GetEditLogManifestResponseProto	getEditLogManifest(java.lang.String jid, java.lang.String nameServiceId, long sinceTxId, boolean inProgressOk)
QJournalProtocolProtos.GetEditLogManifestResponseProto	getEditLogManifestFromJournal(java.lang.String jid, java.lang.String nameServiceId, long sinceTxId, boolean inProgressOk)
protected int	getHandlerCount()
java.lang.Long	getJournalCTime(java.lang.String journalId, java.lang.String nameServiceId)
QJournalProtocolProtos.GetJournaledEditsResponseProto	getJournaledEdits(java.lang.String jid, java.lang.String nameServiceId, long sinceTxId, int maxTxns)	Fetch edit logs present in the Journal's in-memory cache of edits (JournaledEditsCache).
QJournalProtocolProtos.GetJournalStateResponseProto	getJournalState(java.lang.String journalId, java.lang.String nameServiceId)	Get the current state of the journal, including the most recent epoch number and the HTTP port.
void	heartbeat(RequestInfo reqInfo)	Heartbeat.
boolean	isFormatted(java.lang.String journalId, java.lang.String nameServiceId)
void	journal(RequestInfo reqInfo, long segmentTxId, long firstTxnId, int numTxns, byte[] records)	Journal edit records.
QJournalProtocolProtos.NewEpochResponseProto	newEpoch(java.lang.String journalId, java.lang.String nameServiceId, NamespaceInfo nsInfo, long epoch)	Begin a new epoch.
QJournalProtocolProtos.PrepareRecoveryResponseProto	prepareRecovery(RequestInfo reqInfo, long segmentTxId)	Begin the recovery process for a given segment.
void	purgeLogsOlderThan(RequestInfo reqInfo, long minTxIdToKeep)
void	startLogSegment(RequestInfo reqInfo, long txid, int layoutVersion)	Start writing to a new log segment on the JournalNode.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getHandlerCount

@VisibleForTesting
protected int getHandlerCount()

getAddress

public java.net.InetSocketAddress getAddress()

isFormatted

public boolean isFormatted(java.lang.String journalId,
                           java.lang.String nameServiceId)
                    throws java.io.IOException

Specified by:

isFormatted in interface QJournalProtocol

Returns:

true if the given journal has been formatted and contains valid data.

Throws:

java.io.IOException

getJournalState

public QJournalProtocolProtos.GetJournalStateResponseProto getJournalState(java.lang.String journalId,
                                                                           java.lang.String nameServiceId)
                                                                    throws java.io.IOException

Description copied from interface: QJournalProtocol

Get the current state of the journal, including the most recent epoch number and the HTTP port.

Specified by:

getJournalState in interface QJournalProtocol

Throws:

java.io.IOException

newEpoch

public QJournalProtocolProtos.NewEpochResponseProto newEpoch(java.lang.String journalId,
                                                             java.lang.String nameServiceId,
                                                             NamespaceInfo nsInfo,
                                                             long epoch)
                                                      throws java.io.IOException

Description copied from interface: QJournalProtocol

Begin a new epoch. See the HDFS-3077 design doc for details.

Specified by:

newEpoch in interface QJournalProtocol

Throws:

java.io.IOException

format

public void format(java.lang.String journalId,
                   java.lang.String nameServiceId,
                   NamespaceInfo nsInfo,
                   boolean force)
            throws java.io.IOException

Description copied from interface: QJournalProtocol

Format the underlying storage for the given namespace.

Specified by:

format in interface QJournalProtocol

Throws:

java.io.IOException

journal

public void journal(RequestInfo reqInfo,
                    long segmentTxId,
                    long firstTxnId,
                    int numTxns,
                    byte[] records)
             throws java.io.IOException

Description copied from interface: QJournalProtocol

Journal edit records. This message is sent by the active name-node to the JournalNodes to write edits to their local logs.

Specified by:

journal in interface QJournalProtocol

Throws:

java.io.IOException

heartbeat

public void heartbeat(RequestInfo reqInfo)
               throws java.io.IOException

Description copied from interface: QJournalProtocol

Heartbeat. This is a no-op on the server, except that it verifies that the caller is in fact still the active writer, and provides up-to-date information on the most recently committed txid.

Specified by:

heartbeat in interface QJournalProtocol

Throws:

java.io.IOException

startLogSegment

public void startLogSegment(RequestInfo reqInfo,
                            long txid,
                            int layoutVersion)
                     throws java.io.IOException

Description copied from interface: QJournalProtocol

Start writing to a new log segment on the JournalNode. Before calling this, one should finalize the previous segment using QJournalProtocol.finalizeLogSegment(RequestInfo, long, long).

Specified by:

startLogSegment in interface QJournalProtocol

txid - the first txid in the new log

layoutVersion - the LayoutVersion of the new log

Throws:

java.io.IOException

finalizeLogSegment

public void finalizeLogSegment(RequestInfo reqInfo,
                               long startTxId,
                               long endTxId)
                        throws java.io.IOException

Description copied from interface: QJournalProtocol

Finalize the given log segment on the JournalNode. The segment is expected to be in-progress and starting at the given startTxId.

Specified by:

finalizeLogSegment in interface QJournalProtocol

startTxId - the starting transaction ID of the log

endTxId - the expected last transaction in the given log

Throws:

java.io.IOException - if no such segment exists

purgeLogsOlderThan

public void purgeLogsOlderThan(RequestInfo reqInfo,
                               long minTxIdToKeep)
                        throws java.io.IOException

Specified by:

purgeLogsOlderThan in interface QJournalProtocol

Throws:

java.io.IOException

See Also:

LogsPurgeable.purgeLogsOlderThan(long)

getEditLogManifest

public QJournalProtocolProtos.GetEditLogManifestResponseProto getEditLogManifest(java.lang.String jid,
                                                                                 java.lang.String nameServiceId,
                                                                                 long sinceTxId,
                                                                                 boolean inProgressOk)
                                                                          throws java.io.IOException

Specified by:

getEditLogManifest in interface QJournalProtocol

Parameters:

jid - the journal from which to enumerate edits

sinceTxId - the first transaction which the client cares about

inProgressOk - whether or not to check the in-progress edit log segment

Returns:

a list of edit log segments since the given transaction ID.

Throws:

java.io.IOException

getJournaledEdits

public QJournalProtocolProtos.GetJournaledEditsResponseProto getJournaledEdits(java.lang.String jid,
                                                                               java.lang.String nameServiceId,
                                                                               long sinceTxId,
                                                                               int maxTxns)
                                                                        throws java.io.IOException

Description copied from interface: QJournalProtocol

Fetch edit logs present in the Journal's in-memory cache of edits (JournaledEditsCache). To enable this cache, in-progress edit log tailing must be enabled via the "dfs.ha.tail-edits.in-progress" configuration key.

Specified by:

getJournaledEdits in interface QJournalProtocol

Parameters:

jid - The ID of the journal from which to fetch edits.

nameServiceId - The ID of the namespace for which to fetch edits.

sinceTxId - Fetch edits starting at this transaction ID

maxTxns - Request at most this many transactions to be returned

Returns:

Response containing serialized edits to be loaded

Throws:

java.io.IOException - If there was an issue encountered while fetching edits from the cache, including a cache miss (cache does not contain the requested edits). The caller should then attempt to fetch the edits via the streaming mechanism (starting with QJournalProtocol.getEditLogManifest(String, String, long, boolean)).

See Also:

JournaledEditsCache

prepareRecovery

public QJournalProtocolProtos.PrepareRecoveryResponseProto prepareRecovery(RequestInfo reqInfo,
                                                                           long segmentTxId)
                                                                    throws java.io.IOException

Description copied from interface: QJournalProtocol

Begin the recovery process for a given segment. See the HDFS-3077 design document for details.

Specified by:

prepareRecovery in interface QJournalProtocol

Throws:

java.io.IOException

acceptRecovery

public void acceptRecovery(RequestInfo reqInfo,
                           QJournalProtocolProtos.SegmentStateProto log,
                           java.net.URL fromUrl)
                    throws java.io.IOException

Description copied from interface: QJournalProtocol

Accept a proposed recovery for the given transaction ID.

Specified by:

acceptRecovery in interface QJournalProtocol

Throws:

java.io.IOException

doPreUpgrade

public void doPreUpgrade(java.lang.String journalId)
                  throws java.io.IOException

Specified by:

doPreUpgrade in interface QJournalProtocol

Throws:

java.io.IOException

doUpgrade

public void doUpgrade(java.lang.String journalId,
                      StorageInfo sInfo)
               throws java.io.IOException

Specified by:

doUpgrade in interface QJournalProtocol

Throws:

java.io.IOException

doFinalize

public void doFinalize(java.lang.String journalId,
                       java.lang.String nameServiceId)
                throws java.io.IOException

Specified by:

doFinalize in interface QJournalProtocol

Throws:

java.io.IOException

canRollBack

public java.lang.Boolean canRollBack(java.lang.String journalId,
                                     java.lang.String nameServiceId,
                                     StorageInfo storage,
                                     StorageInfo prevStorage,
                                     int targetLayoutVersion)
                              throws java.io.IOException

Specified by:

canRollBack in interface QJournalProtocol

Throws:

java.io.IOException

doRollback

public void doRollback(java.lang.String journalId,
                       java.lang.String nameServiceId)
                throws java.io.IOException

Specified by:

doRollback in interface QJournalProtocol

Throws:

java.io.IOException

discardSegments

public void discardSegments(java.lang.String journalId,
                            java.lang.String nameServiceId,
                            long startTxId)
                     throws java.io.IOException

Description copied from interface: QJournalProtocol

Discard journal segments whose first TxId is greater than or equal to the given txid.

Specified by:

discardSegments in interface QJournalProtocol

Throws:

java.io.IOException

getJournalCTime

public java.lang.Long getJournalCTime(java.lang.String journalId,
                                      java.lang.String nameServiceId)
                               throws java.io.IOException

Specified by:

getJournalCTime in interface QJournalProtocol

Throws:

java.io.IOException

getEditLogManifestFromJournal

public QJournalProtocolProtos.GetEditLogManifestResponseProto getEditLogManifestFromJournal(java.lang.String jid,
                                                                                            java.lang.String nameServiceId,
                                                                                            long sinceTxId,
                                                                                            boolean inProgressOk)
                                                                                     throws java.io.IOException

Specified by:

getEditLogManifestFromJournal in interface InterQJournalProtocol

Parameters:

jid - the journal from which to enumerate edits

sinceTxId - the first transaction which the client cares about

inProgressOk - whether or not to check the in-progress edit log segment

Returns:

a list of edit log segments since the given transaction ID.

Throws:

java.io.IOException