Setting up Hadoop with MongoDB on Windows 7 64-bit

Transcription

1 SGT WHITE PAPER Setting up Hadoop with MongoDB on Windows 7 64-bit HCCP Big Data Lab 2015 SGT, Inc. All Rights Reserved 7701 Greenbelt Road, Suite 400, Greenbelt, MD Tel: (301) Fax: (301)

2 Setting up Hadoop with MongoDB on Windows 7 64 bit Tools and Technologies used in this article: 1. Apache Hadoop Source codes 2. Windows 7 OS 3. Microsoft Windows SDK v Maven Protocol Buffers Cygwin 7. JDK MongoDB 9. Mongo-Hadoop Connector 10. Mongo Java Driver Build Hadoop bin distribution for Windows 1. Download and install Microsoft Windows SDK v Download and install JDK 1.6 (must be JDK, not JRE) 3. Download and install Unix command-line tool Cygwin. 4. Download and install Maven Unzip the distribution archive, i.e. apache-maven bin.zip to the directory you wish to install Maven These instructions assume you chose C:\Program Files\Apache Software Foundation. The subdirectory apache-maven will be created from the archive. 6. Add the M2_HOME environment variable by opening up the system properties (WinKey + Pause), selecting the "Advanced" tab, and the "Environment Variables" button, then adding the M2_HOME variable in the user variables with the value C:\Program Files\Apache Software Foundation\apache-maven Be sure to omit any quotation marks around the path even if it contains spaces. 7. In the same dialog, add the M2 environment variable in the user variables with the value %M2_HOME%\bin. 8. Optional: In the same dialog, add the MAVEN_OPTS environment variable in the user variables to specify JVM properties, e.g. the value -Xms256m -Xmx512m. This environment variable can be used to supply extra options to Maven. 9. In the same dialog, update/create the Path environment variable in the user variables and prepend the value %M2% to add Maven available in the command line. 10. In the same dialog, make sure that JAVA_HOME exists in your user variables or in the system variables and it is set to the location of your JDK, e.g. C:\Program Files\Java\jdk1.5.0_02 and that %JAVA_HOME%\bin is in your Path environment variable.

3 11. Open a new command prompt (Winkey + R then type cmd) and run mvn --version to verify that it is correctly installed. 5. Download Protocol Buffers and extract to a folder (say c:\protobuf). 6. Add Environment Variables JAVA_HOME, M2_HOME and Platform if not added already. Add Environment Variables: Note : 1. Variable name Platform is case sensitive. And value will be either x64 or Win32 for building on a 64-bit or 32-bit system. 2. If JDK installation path contains any space then use Windows shortened name (say 'PROGRA~1' for 'Program Files') for the JAVA_HOME environment variable. Edit Path Variable to add bin directory of Cygwin (say C:\cygwin64\bin), bin directory of Maven (say C:\maven\bin) and installation path of Protocol Buffers (say c:\protobuf). Edit Path Variable:

4 7. Download hadoop src.tar.gz and extract to a folder having short path (say c:\hdfs) to avoid runtime problem due to maximum path length limitation in Windows. To extract a tar file in Windows, open cygwin and cd to the directory that contains hadoop src.tar.gz. Enter tar xvzf hadoop src.tar.gz /cygdrive/c/hdfs. The file should now be extracted to C:\hdfs 8. A patch needs to be added to C:\hdfs\hadoop-common-project\hadoop-auth\pom.xml, open the file with any text editor and add the following highlighted section after line 57:

5 9. Select Start --> All Programs --> Microsoft Windows SDK v7.1 and open Windows SDK 7.1 Command Prompt. Change directory to Hadoop source code folder (c:\hdfs). Execute mvn package with options -Pdist,native-win -DskipTests -Dtar to create Windows binary tar distribution. Windows SDK 7.1 Command Prompt? Setting SDK environment relative to C:\Program Files\Microsoft SDKs\Windows\v7.1\. Targeting Windows 7 x64 Debug 5 C:\Program Files\Microsoft SDKs\Windows\v7.1>cd c:\hdfs 6 C:\hdfs>mvn package -Pdist,native-win -DskipTests -Dtar 7 [INFO] Scanning for projects... 8 [INFO] [INFO] Reactor Build Order: 11 [INFO] 12 [INFO] Apache Hadoop Main 13 [INFO] Apache Hadoop Project POM 14 [INFO] Apache Hadoop Annotations 15 [INFO] Apache Hadoop Assemblies 16 [INFO] Apache Hadoop Project Dist POM 17 [INFO] Apache Hadoop Maven Plugins 18 [INFO] Apache Hadoop Auth 19 [INFO] Apache Hadoop Auth Examples 20 [INFO] Apache Hadoop Common 21 [INFO] Apache Hadoop NFS 22 [INFO] Apache Hadoop Common Project Note : I have pasted only the starting few lines of huge logs generated by maven. This building step requires Internet connection as Maven will download all the required dependencies. 10. If everything goes well in the previous step, then native distribution hadoop tar.gz will be created inside C:\hdfs\hadoop-dist\target\hadoop directory.

6 Install Hadoop 1. Extract hadoop tar.gz to a folder (say c:\hadoop). 2. Add Environment Variable HADOOP_HOME and edit Path Variable to add bin directory of HADOOP_HOME (say C:\hadoop\bin). Add Environment Variables: Configure Hadoop Make following changes to configure Hadoop File: C:\hadoop\etc\hadoop\core-site.xml? <?xml version="1.0" encoding="utf-8"?> <?xml-stylesheet type="text/xsl" href="configuration.xsl"?> <!--

7 4 5 6 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. See accompanying LICENSE file. 15--> 16 17<!-- Put site-specific property overrides in this file. --> 18 19<configuration> <property> <name>fs.defaultfs</name> <value>hdfs://localhost:9000</value> </property> 24</configuration> fs.defaultfs: The name of the default file system. A URI whose scheme and authority determine the FileSystem implementation. The uri's scheme determines the config property (fs.scheme.impl) naming the FileSystem implementation class. The uri's authority is used to determine the host, port, etc. for a filesystem. File: C:\hadoop\etc\hadoop\hdfs-site.xml? <?xml version="1.0" encoding="utf-8"?> <?xml-stylesheet type="text/xsl" href="configuration.xsl"?> <!-- Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.

8 6 You may obtain a copy of the License at Unless required by applicable law or agreed to in writing, software 11 distributed under the License is distributed on an "AS IS" BASIS, 12 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 See the License for the specific language governing permissions and 14 limitations under the License. See accompanying LICENSE file. 15--> 16 17<!-- Put site-specific property overrides in this file. --> 18 19<configuration> 20 <property> 21 <name>dfs.replication</name> 22 <value>1</value> 23 </property> 24 <property> 25 <name>dfs.namenode.name.dir</name> 26 <value>file:/hadoop/data/dfs/namenode</value> 27 </property> 28 <property> 29 <name>dfs.datanode.data.dir</name> 30 <value>file:/hadoop/data/dfs/datanode</value> 31 </property> 32</configuration> dfs.replication: Default block replication. The actual number of replications can be specified when the file is created. The default is used if replication is not specified in create time. dfs.namenode.name.dir: Determines where on the local filesystem the DFS name node should store the name table(fsimage). If this is a comma-delimited list of directories then the name table is replicated in all of the directories, for redundancy.

9 dfs.datanode.data.dir: Determines where on the local filesystem an DFS data node should store its blocks. If this is a comma-delimited list of directories, then data will be stored in all named directories, typically on different devices. Directories that do not exist are ignored. Note : Create namenode and datanode directory under c:/hadoop/data/dfs/. File: C:\hadoop\etc\hadoop\yarn-site.xml? <?xml version="1.0"?> <!-- Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. See accompanying LICENSE file. 14--> 15<configuration> <property> <name>yarn.nodemanager.aux-services</name> <value>mapreduce_shuffle</value> </property> <property> <name>yarn.nodemanager.aux-services.mapreduce.shuffle.class</name> <value>org.apache.hadoop.mapred.shufflehandler</value> </property> <property> <name>yarn.application.classpath</name> <value>

10 %HADOOP_HOME%\etc\hadoop, %HADOOP_HOME%\share\hadoop\common\*, %HADOOP_HOME%\share\hadoop\common\lib\*, %HADOOP_HOME%\share\hadoop\mapreduce\*, %HADOOP_HOME%\share\hadoop\mapreduce\lib\*, %HADOOP_HOME%\share\hadoop\hdfs\*, %HADOOP_HOME%\share\hadoop\hdfs\lib\*, %HADOOP_HOME%\share\hadoop\yarn\*, %HADOOP_HOME%\share\hadoop\yarn\lib\* </value> </property> 38</configuration> yarn.nodemanager.aux-services: The auxiliary service name. Default value is omapreduce_shuffle yarn.nodemanager.aux-services.mapreduce.shuffle.class: The auxiliary service class to use. Default value is org.apache.hadoop.mapred.shufflehandler yarn.application.classpath: CLASSPATH for YARN applications. A comma-separated list of CLASSPATH entries. File: C:\hadoop\etc\hadoop\mapred-site.xml? <?xml version="1.0"?> <?xml-stylesheet type="text/xsl" href="configuration.xsl"?> <!-- Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

11 13 14 See the License for the specific language governing permissions and limitations under the License. See accompanying LICENSE file. 15--> 16 17<!-- Put site-specific property overrides in this file. --> 18 19<configuration> <property> <name>mapreduce.framework.name</name> <value>yarn</value> </property> 24</configuration> mapreduce.framework.name: The runtime framework for executing MapReduce jobs. Can be one of local, classic or yarn. Format namenode Before you start Hadoop for the first time only, namenode needs to be formatted. Command Prompt? 1 2 Microsoft Windows [Version ] Copyright (c) 2009 Microsoft Corporation. All rights reserved. 3 4 C:\Users\abhijitg>cd c:\hadoop\bin c:\hadoop\bin>hdfs namenode -format 13/11/03 18:07:47 INFO namenode.namenode: STARTUP_MSG: /************************************************************ STARTUP_MSG: Starting NameNode 10STARTUP_MSG: 11STARTUP_MSG: host = ABHIJITG/x.x.x.x args = [-format] 12STARTUP_MSG: version = 2.2.0

12 13STARTUP_MSG: classpath = <classpath jars here> 14STARTUP_MSG: build = Unknown -r Unknown; compiled by ABHIJITG on T13:42Z 16STARTUP_MSG: java = 1.7.0_03 17************************************************************/ 18Formatting using clusterid: CID-1af0bd9f-efee-4d4e-9f03-a0032c22e5eb 1913/11/03 18:07:48 INFO namenode.hostfilemanager: read includes: 20HostSet( 21) 2213/11/03 18:07:48 INFO namenode.hostfilemanager: read excludes: 23HostSet( 24) 2513/11/03 18:07:48 INFO blockmanagement.datanodemanager: 26dfs.block.invalidate.limit= /11/03 18:07:48 INFO util.gset: Computing capacity for map BlocksMap 2813/11/03 18:07:48 INFO util.gset: VM type = 64-bit 2913/11/03 18:07:48 INFO util.gset: 2.0% max memory = MB 3013/11/03 18:07:48 INFO util.gset: capacity = 2^21 = entries 3113/11/03 18:07:48 INFO blockmanagement.blockmanager: 32dfs.block.access.token.enable=false 3313/11/03 18:07:48 INFO blockmanagement.blockmanager: 34defaultReplication = /11/03 18:07:48 INFO blockmanagement.blockmanager: 36maxReplication = /11/03 18:07:48 INFO blockmanagement.blockmanager: 38minReplication = /11/03 18:07:48 INFO blockmanagement.blockmanager: 40maxReplicationStreams = /11/03 18:07:48 INFO blockmanagement.blockmanager: 42shouldCheckForEnoughRacks = false 4313/11/03 18:07:48 INFO blockmanagement.blockmanager: 44replicationRecheckInterval = /11/03 18:07:48 INFO blockmanagement.blockmanager:

13 46encryptDataTransfer = false 4713/11/03 18:07:48 INFO namenode.fsnamesystem: fsowner = ABHIJITG 48(auth:SIMPLE) 4913/11/03 18:07:48 INFO namenode.fsnamesystem: supergroup = 50supergroup 5113/11/03 18:07:48 INFO namenode.fsnamesystem: ispermissionenabled = true 5213/11/03 18:07:48 INFO namenode.fsnamesystem: HA Enabled: false 5313/11/03 18:07:48 INFO namenode.fsnamesystem: Append Enabled: true 5413/11/03 18:07:49 INFO util.gset: Computing capacity for map INodeMap 5513/11/03 18:07:49 INFO util.gset: VM type = 64-bit 5613/11/03 18:07:49 INFO util.gset: 1.0% max memory = MB 5713/11/03 18:07:49 INFO util.gset: capacity = 2^20 = entries 5813/11/03 18:07:49 INFO namenode.namenode: Caching file names occuring more 59than 10 times 6013/11/03 18:07:49 INFO namenode.fsnamesystem: 61dfs.namenode.safemode.threshold-pct = /11/03 18:07:49 INFO namenode.fsnamesystem: 63dfs.namenode.safemode.min.datanodes = /11/03 18:07:49 INFO namenode.fsnamesystem: 65dfs.namenode.safemode.extension = /11/03 18:07:49 INFO namenode.fsnamesystem: Retry cache on namenode is 67enabled 13/11/03 18:07:49 INFO namenode.fsnamesystem: Retry cache will use 0.03 of total heap and retry cache entry expiry time is millis 13/11/03 18:07:49 INFO util.gset: Computing capacity for map Namenode Retry Cache 13/11/03 18:07:49 INFO util.gset: VM type = 64-bit 13/11/03 18:07:49 INFO util.gset: % max memory = MB 13/11/03 18:07:49 INFO util.gset: capacity = 2^15 = entries 13/11/03 18:07:49 INFO common.storage: Storage directory \hadoop\data\dfs\namenode has been successfully formatted. 13/11/03 18:07:49 INFO namenode.fsimage: Saving image file

14 \hadoop\data\dfs\namenode\current\fsimage.ckpt_ using no compression 13/11/03 18:07:49 INFO namenode.fsimage: Image file \hadoop\data\dfs\namenode\current\fsimage.ckpt_ o f size 200 bytes saved in 0 seconds. 13/11/03 18:07:49 INFO namenode.nnstorageretentionmanager: Going to retain 1 images with txid >= 0 13/11/03 18:07:49 INFO util.exitutil: Exiting with status 0 13/11/03 18:07:49 INFO namenode.namenode: SHUTDOWN_MSG: /************************************************************ SHUTDOWN_MSG: Shutting down NameNode at ABHIJITG/x.x.x.x ************************************************************/ Start HDFS (Namenode and Datanode) Command Prompt? 1C:\Users\abhijitg>cd c:\hadoop\sbin 2c:\hadoop\sbin>start-dfs Two separate Command Prompt windows will be opened automatically to run Namenode and Datanode.

15 Start MapReduce aka YARN (Resource Manager and Node Manager) Command Prompt? 1C:\Users\abhijitg>cd c:\hadoop\sbin 2c:\hadoop\sbin>start-yarn 3starting yarn daemons Similarly, two separate Command Prompt windows will be opened automatically to run Resource Manager and Node Manager. Verify Installation If everything goes well then you will be able to open the Resource Manager and Node Manager at and Namenode at Node Manager:

16 Namenode: Install MongoDB Download MongoDB and unzip the file to any location, preferably something simple without spaces in the path (Cygwin doesn t work well with spaces in file names) such as C:\mongodb. You will also need to create a directory to store the data from mongodb. Create a folder called data and a folder called db inside of data so that you have the default directory structure C:\data\db (if you want to use another location for data you can, but you will need to override the default location when you load data into MongoDB).

17 Add C:\mongodb\bin to the Path system variable To start MongoDB open a windows command terminal and type mongod In a second command terminal, type mongo

18 If it is setup properly it should connect and you will see the next line in the prompt change from the windows prompt of C:\Users\UserName> (or whatever directory you re in) to the MongoDB prompt >. Install Mongo-Hadoop Connector Download the Mongo-Hadoop Connector and unzip it into your Cygwin user directory (i.e. C:\cygwin\home\UserName\mongo-hadoop. In a Cygwin terminal, go to this directory by entering the command cd ~/mongo-hadoop. Open the file ~/mongo-hadoop/build.sbt with Notepad++ (or another text editor, but if you use a standard windows text editor, you may have to run unix2dos and dos2unix on the file) and change the line: hadooprelease in ThisBuild := "x.x" To: hadooprelease in ThisBuild := "2.2" Save the file and close it. To compile the connector, enter./sbt package into the cygwin terminal while still in the same directory.

19 Note: Internet connection is required, because the script will be downloading files also. Note: If you are using a 64-bit version of windows, Cygwin will give you a warning that states that the compiler is using a Windows path, but prefers a Cygwin path, but you can ignore this warning, it will still compile fine, However, if you are using a 32-bit version of windows, the connector won t build properly without a Cygwin Path. To fix this, open ~/mongo-hadoop/sbt and change the value of sbt_jar to the Cygwin location of your sbt-launch.jar (should be something like /cygdrive/c/home/username/.sbt/launch/0.12.2/sbt-launch.jar) right before the final command is run (execrunner) at line 460. The build process should generate a JAR file in ~/mongo-hadoop/core/target. You must copy the jars to the lib directory on each node in your hadoop cluster. This should be located at the location $HADOOP_HOME/share/hadoop/common/lib, assuming you are using Hadoop v Download the latest stable version of the mongo java driver and place this jar in this directory as well. Testing the Mongo-Hadoop Connector Everything should now be installed correctly, so all we have left to do is test the configuration. To do this we will run the Treasury_Yield example that came with the mongo-hadoop connector. If you don t already have MongoDB and Hadoop running, start both of them in the way described above. Open a windows command prompt and enter (change the path to your path to yield_historical_in.json): mongoimport d mongo_hadoop c yield_historical.in c:\cygwin64\home\username\mongohadoop\examples\treasury_yield\src\main\resources\yield_historical_in.json To verify this worked go to your mongo.exe that should be running for MongoDB and type: use mongo_hadoop

20 db.yield_historical.in.find().foreach(printjson) You should see a long list of MongoDB documents that look like the following: { } "_id" : ISODate(" T00:00:00Z"), "dayofweek" : "THURSDAY ", "bc3year" : 0.64, "bc5year" : 1.27, "bc10year" : 2.53, "bc20year" : 3.38, "bc1month" : 0.14, "bc2year" : 0.42, "bc3month" : 0.16, "bc30year" : 3.69, "bc1year" : 0.27, "bc7year" : 1.91, "bc6month" : 0.19 From your Cygwin home directory, find the file mongo-hadoop/examples/treasury_yield/src/main/ resources/mongo-treasury_yield. Open the file and change the Output value class for the mapper (lines 91-95) to: <property> <!-- Output value class for the mapper [optional] --> <name>mongo.job.mapper.output.value</name> <value>org.apache.hadoop.io.doublewritable</value> </property> Input & Output Databases: in this file, line 21, <value>mongodb:// /mongo_hadoop.yield_historical.in</value>, is your input MongoDB database.collection, and line 26, <value>mongodb:// /mongo_hadoop.yield_historical.out</value>, is your output MongoDB database.collection. If the output database or collection doesn t exist yet, it will be automatically created. Note: In this file you will find many important options that must be set to run a map reduce job in hadoop. For this example, they are already set for us, however, when you are creating your own map reduce jobs, you will have to set these:

21 Class for Mapper: This must match the class path to the java Mapper class in the jar file. Class for the Reducer: This must match the class path to the java Reducer class in the jar file. Input Format Class: This should always be set to com.mongodb.hadoop.mongoinputformat if input is from MongoDB. Output Format Class: This should always be set to com.mongodb.hadoop.mongooutputformat if output needs to write to MongoDB. Output Key Class for the Output Format: This class path needs to match the class of the key that is being used. Output Key Class for the Mapper: This class path needs to match the class that the third class that the Mapper class extends. For example, in the TreasuryYieldMapper.java file, the class that it matches is the following: public class TreasuryYieldMapper extends Mapper<Object, BSONObject, IntWritable, DoubleWritable> { Class path in the xml file: <value>org.apache.hadoop.io.intwritable</value> Output Value Class for the Mapper: This class path needs to match the class that the fourth class that the Mapper class extends. For example, in the TreasuryYieldMapper.java file, the class that it matches is the following: public class TreasuryYieldMapper extends Mapper<Object, BSONObject, IntWritable, DoubleWritable> { Class path in the xml file: <value>org.apache.hadoop.io.doublewritable</value> Open the file mongo-hadoop/examples/treasury_yield/src/main/java/com/mongodb/hadoop/examples/ treasury/treasuryxmlconfig.java. Change lines to:

22 // Configuration.addDefaultResource("src/examples/hadoop local.xml"); Configuration.addDefaultResource("mongo defaults.xml"); Configuration.addDefaultResource("mongo treasury_yield.xml"); Once this is done, to compile this example cd to ~/mongo-hadoop. Run./sbt treasury example/package. This should create the jar file ~/mongo-hadoop/examples/treasury_yield/target/treasury-example_ jar. Copy this file to your %HADOOP_HOME% directory that you set in windows. Open a command prompt and enter: cd %HADOOP_HOME% hadoop jar treasury example_ jar com.mongodb.hadoop.examples.treasury.treasuryyieldxmlconfig If all has goes well, we should be able to see the output in the mongo.exe. From your mongo.exe enter the following: use mongo_hadoop db.historical_yield.out.find().foreach(printjson) You should now see the output from the map reduce job. Sources: