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

Class JournalNode

java.lang.Object

org.apache.hadoop.hdfs.qjournal.server.JournalNode

All Implemented Interfaces:

org.apache.hadoop.conf.Configurable, JournalNodeMXBean, org.apache.hadoop.util.Tool

@Private
public class JournalNode
extends java.lang.Object
implements org.apache.hadoop.util.Tool, org.apache.hadoop.conf.Configurable, JournalNodeMXBean

The JournalNode is a daemon which allows namenodes using the QuorumJournalManager to log and retrieve edits stored remotely. It is a thin wrapper around a local edit log directory with the addition of facilities to participate in the quorum protocol.

Field Summary

Fields

Modifier and Type	Field	Description
static org.slf4j.Logger	LOG

Constructor Summary

Constructors

Constructor	Description
JournalNode()

Method Summary

Modifier and Type	Method	Description
java.lang.Boolean	canRollBack(java.lang.String journalId, StorageInfo storage, StorageInfo prevStorage, int targetLayoutVersion, java.lang.String nameServiceId)
void	discardSegments(java.lang.String journalId, long startTxId, java.lang.String nameServiceId)
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)
java.net.InetSocketAddress	getBoundHttpAddress()
java.net.InetSocketAddress	getBoundIpcAddress()
java.util.List<java.lang.String>	getClusterIds()	Get list of the clusters of JournalNode's journals as one JournalNode may support multiple clusters.
org.apache.hadoop.conf.Configuration	getConf()
java.lang.String	getHostAndPort()	Get host and port of JournalNode.
java.net.InetSocketAddress	getHttpAddress()
static java.net.InetSocketAddress	getHttpAddress(org.apache.hadoop.conf.Configuration conf)
java.net.InetSocketAddress	getHttpsAddress()
protected java.net.InetSocketAddress	getHttpServerBindAddress(org.apache.hadoop.conf.Configuration configuration)
java.lang.String	getHttpServerURI()
long	getJNStartedTimeInMillis()	Get the start time of the JournalNode.
Journal	getJournal(java.lang.String jid)
java.lang.Long	getJournalCTime(java.lang.String journalId, java.lang.String nameServiceId)
java.lang.String	getJournalsStatus()	Get status information (e.g., whether formatted) of JournalNode's journals.
JournalNodeSyncer	getJournalSyncer(java.lang.String jid)
boolean	getJournalSyncerStatus(java.lang.String jid)
Journal	getOrCreateJournal(java.lang.String jid)
Journal	getOrCreateJournal(java.lang.String jid, java.lang.String nameServiceId)
JournalNodeRpcServer	getRpcServer()
java.util.List<java.lang.String>	getStorageInfos()	Get the list of the storage infos of JournalNode's journals.
java.lang.String	getVersion()	Gets the version of Hadoop.
boolean	isStarted()
static void	main(java.lang.String[] args)
int	run(java.lang.String[] args)
void	setConf(org.apache.hadoop.conf.Configuration conf)
void	start()	Start listening for edits via RPC.
void	stop(int rc)	Stop the daemon with the given status code
void	stopAndJoin(int rc)

Methods inherited from class java.lang.Object

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

Field Detail

LOG

public static final org.slf4j.Logger LOG

Constructor Detail

JournalNode

public JournalNode()

Method Detail

getJournalSyncer

@VisibleForTesting
public JournalNodeSyncer getJournalSyncer(java.lang.String jid)

getJournalSyncerStatus

@VisibleForTesting
public boolean getJournalSyncerStatus(java.lang.String jid)

getOrCreateJournal

@VisibleForTesting
public Journal getOrCreateJournal(java.lang.String jid)
                           throws java.io.IOException

Throws:

java.io.IOException

getOrCreateJournal

public Journal getOrCreateJournal(java.lang.String jid,
                                  java.lang.String nameServiceId)
                           throws java.io.IOException

Throws:

java.io.IOException

setConf

public void setConf(org.apache.hadoop.conf.Configuration conf)

Specified by:

setConf in interface org.apache.hadoop.conf.Configurable

getConf

public org.apache.hadoop.conf.Configuration getConf()

Specified by:

getConf in interface org.apache.hadoop.conf.Configurable

run

public int run(java.lang.String[] args)
        throws java.lang.Exception

Specified by:

run in interface org.apache.hadoop.util.Tool

Throws:

java.lang.Exception

start

public void start()
           throws java.io.IOException

Start listening for edits via RPC.

Throws:

java.io.IOException

isStarted

public boolean isStarted()

getBoundIpcAddress

public java.net.InetSocketAddress getBoundIpcAddress()

Returns:

the address the IPC server is bound to

getHttpServerURI

public java.lang.String getHttpServerURI()

stop

public void stop(int rc)

Stop the daemon with the given status code

Parameters:

rc - the status code with which to exit (non-zero should indicate an error)

stopAndJoin

public void stopAndJoin(int rc)
                 throws java.lang.InterruptedException

Throws:

java.lang.InterruptedException

getJournalsStatus

public java.lang.String getJournalsStatus()

Description copied from interface: JournalNodeMXBean

Get status information (e.g., whether formatted) of JournalNode's journals.

Specified by:

getJournalsStatus in interface JournalNodeMXBean

Returns:

A string presenting status for each journal

getHostAndPort

public java.lang.String getHostAndPort()

Description copied from interface: JournalNodeMXBean

Get host and port of JournalNode.

Specified by:

getHostAndPort in interface JournalNodeMXBean

Returns:

colon separated host and port.

getClusterIds

public java.util.List<java.lang.String> getClusterIds()

Description copied from interface: JournalNodeMXBean

Get list of the clusters of JournalNode's journals as one JournalNode may support multiple clusters.

Specified by:

getClusterIds in interface JournalNodeMXBean

Returns:

list of clusters.

getVersion

public java.lang.String getVersion()

Description copied from interface: JournalNodeMXBean

Gets the version of Hadoop.

Specified by:

getVersion in interface JournalNodeMXBean

Returns:

the version of Hadoop.

getJNStartedTimeInMillis

public long getJNStartedTimeInMillis()

Description copied from interface: JournalNodeMXBean

Get the start time of the JournalNode.

Specified by:

getJNStartedTimeInMillis in interface JournalNodeMXBean

Returns:

the start time of the JournalNode.

getStorageInfos

public java.util.List<java.lang.String> getStorageInfos()

Description copied from interface: JournalNodeMXBean

Get the list of the storage infos of JournalNode's journals. Storage infos include layout version, namespace id, cluster id and creation time of the File system state.

Specified by:

getStorageInfos in interface JournalNodeMXBean

Returns:

the list of storage infos associated with journals.

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

Throws:

java.lang.Exception

doPreUpgrade

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

Throws:

java.io.IOException

doUpgrade

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

Throws:

java.io.IOException

doFinalize

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

Throws:

java.io.IOException

canRollBack

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

Throws:

java.io.IOException

doRollback

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

Throws:

java.io.IOException

discardSegments

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

Throws:

java.io.IOException

getJournalCTime

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

Throws:

java.io.IOException

getJournal

@VisibleForTesting
public Journal getJournal(java.lang.String jid)

getHttpAddress

public static java.net.InetSocketAddress getHttpAddress(org.apache.hadoop.conf.Configuration conf)

getHttpServerBindAddress

protected java.net.InetSocketAddress getHttpServerBindAddress(org.apache.hadoop.conf.Configuration configuration)

getRpcServer

@VisibleForTesting
public JournalNodeRpcServer getRpcServer()

getBoundHttpAddress

public java.net.InetSocketAddress getBoundHttpAddress()

Returns:

the actual JournalNode HTTP/HTTPS address.

getHttpAddress

public java.net.InetSocketAddress getHttpAddress()

Returns:

JournalNode HTTP address

getHttpsAddress

public java.net.InetSocketAddress getHttpsAddress()

Returns:

JournalNode HTTPS address