Package org.apache.hadoop.hdfs.server.namenode

Class SecondaryNameNode

java.lang.Object

org.apache.hadoop.hdfs.server.namenode.SecondaryNameNode

All Implemented Interfaces:

java.lang.Runnable, SecondaryNameNodeInfoMXBean, VersionInfoMXBean

@Private
public class SecondaryNameNode
extends java.lang.Object
implements java.lang.Runnable, SecondaryNameNodeInfoMXBean

The Secondary NameNode is a helper to the primary NameNode. The Secondary is responsible for supporting periodic checkpoints of the HDFS metadata. The current design allows only one Secondary NameNode per HDFs cluster. The Secondary NameNode is a daemon that periodically wakes up (determined by the schedule specified in the configuration), triggers a periodic checkpoint and then goes back to sleep. The Secondary NameNode uses the NamenodeProtocol to talk to the primary NameNode.

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor	Description
SecondaryNameNode(org.apache.hadoop.conf.Configuration conf)	Create a connection to the primary namenode.
SecondaryNameNode(org.apache.hadoop.conf.Configuration conf, org.apache.hadoop.hdfs.server.namenode.SecondaryNameNode.CommandLineOpts commandLineOpts)

Method Summary

Modifier and Type	Method	Description
boolean	doCheckpoint()	Create a new checkpoint
void	doWork()
java.lang.String[]	getCheckpointDirectories()
java.lang.String[]	getCheckpointEditlogDirectories()
java.lang.String	getCompileInfo()
FSNamesystem	getFSNamesystem()
java.lang.String	getHostAndPort()	Gets the host and port colon separated.
static java.net.InetSocketAddress	getHttpAddress(org.apache.hadoop.conf.Configuration conf)
long	getLastCheckpointDeltaMs()
long	getLastCheckpointTime()
java.lang.String	getSoftwareVersion()
long	getStartTime()
boolean	isSecurityEnabled()	Gets if security is enabled.
static void	main(java.lang.String[] argv)	main() has some simple utility methods.
void	run()
void	shutdown()	Shut down this instance of the secondary namenode.
void	startCheckpointThread()
void	startInfoServer()	Start the web server.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

LOG

public static final org.slf4j.Logger LOG

Constructor Detail

SecondaryNameNode

public SecondaryNameNode(org.apache.hadoop.conf.Configuration conf)
                  throws java.io.IOException

Create a connection to the primary namenode.

Throws:

java.io.IOException

SecondaryNameNode

public SecondaryNameNode(org.apache.hadoop.conf.Configuration conf,
                         org.apache.hadoop.hdfs.server.namenode.SecondaryNameNode.CommandLineOpts commandLineOpts)
                  throws java.io.IOException

Throws:

java.io.IOException

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getFSNamesystem

@VisibleForTesting
public FSNamesystem getFSNamesystem()

getHttpAddress

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

shutdown

public void shutdown()

Shut down this instance of the secondary namenode. Returns only after shutdown is complete.

run

public void run()

Specified by:

run in interface java.lang.Runnable

doWork

public void doWork()

startInfoServer

@VisibleForTesting
public void startInfoServer()
                     throws java.io.IOException

Start the web server.

Throws:

java.io.IOException

doCheckpoint

@VisibleForTesting
public boolean doCheckpoint()
                     throws java.io.IOException

Create a new checkpoint

Returns:

if the image is fetched from primary or not

Throws:

java.io.IOException

main

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

main() has some simple utility methods.

Parameters:

argv - Command line parameters.

Throws:

java.lang.Exception - if the filesystem does not exist.

startCheckpointThread

public void startCheckpointThread()

getHostAndPort

public java.lang.String getHostAndPort()

Description copied from interface: SecondaryNameNodeInfoMXBean

Gets the host and port colon separated.

Specified by:

getHostAndPort in interface SecondaryNameNodeInfoMXBean

isSecurityEnabled

public boolean isSecurityEnabled()

Description copied from interface: SecondaryNameNodeInfoMXBean

Gets if security is enabled.

Specified by:

isSecurityEnabled in interface SecondaryNameNodeInfoMXBean

Returns:

true, if security is enabled.

getStartTime

public long getStartTime()

Specified by:

getStartTime in interface SecondaryNameNodeInfoMXBean

Returns:

the timestamp of when the SNN starts

getLastCheckpointTime

public long getLastCheckpointTime()

Specified by:

getLastCheckpointTime in interface SecondaryNameNodeInfoMXBean

Returns:

the timestamp of the last checkpoint

getLastCheckpointDeltaMs

public long getLastCheckpointDeltaMs()

Specified by:

getLastCheckpointDeltaMs in interface SecondaryNameNodeInfoMXBean

Returns:

the number of msec since the last checkpoint, or -1 if no checkpoint has been done yet.

getCheckpointDirectories

public java.lang.String[] getCheckpointDirectories()

Specified by:

getCheckpointDirectories in interface SecondaryNameNodeInfoMXBean

Returns:

the directories that store the checkpoint images

getCheckpointEditlogDirectories

public java.lang.String[] getCheckpointEditlogDirectories()

Specified by:

getCheckpointEditlogDirectories in interface SecondaryNameNodeInfoMXBean

Returns:

the directories that store the edit logs

getCompileInfo

public java.lang.String getCompileInfo()

Specified by:

getCompileInfo in interface VersionInfoMXBean

Returns:

the compilation information which contains date, user and branch

getSoftwareVersion

public java.lang.String getSoftwareVersion()

Specified by:

getSoftwareVersion in interface VersionInfoMXBean

Returns:

the software version