Added by Isabel Drost, last edited by Isabel Drost on Oct 09, 2009
Introduction
This quick start page describes how to run the recommendation examples provided by Mahout. Mahout comes with four recommendation mining examples. They are based on netflixx, jester, grouplens and bookcrossing respectively.
Steps
Testing it on one single machine w/o cluster
In the examples directory type:
mvn -q exec:java -Dexec.mainClass="org.apache.mahout.cf.taste.example.bookcrossing.BookCrossingRecommenderEvaluatorRunner" -Dexec.args="<OPTIONS>" mvn -q exec:java -Dexec.mainClass="org.apache.mahout.cf.taste.example.netflix.NetflixRecommenderEvaluatorRunner" -Dexec.args="<OPTIONS>" mvn -q exec:java -Dexec.mainClass="org.apache.mahout.cf.taste.example.netflix.TransposeToByUser" -Dexec.args="<OPTIONS>" mvn -q exec:java -Dexec.mainClass="org.apache.mahout.cf.taste.example.jester.JesterRecommenderEvaluatorRunner" -Dexec.args="<OPTIONS>" mvn -q exec:java -Dexec.mainClass="org.apache.mahout.cf.taste.example.grouplens.GroupLensRecommenderEvaluatorRunner" -Dexec.args="<OPTIONS>"
Running it on the cluster
- In $MAHOUT_HOME/, build the jar containing the job (mvn install) The job will be generated in $MAHOUT_HOME/core/target/ and it's name will contain the Mahout version number. For example, when using Mahout 0.1 release, the job will be mahout-core-0.1.jar
- (Optional) 1 Start up Hadoop: $HADOOP_HOME/bin/start-all.sh
- Put the data: $HADOOP_HOME/bin/hadoop fs -put <PATH TO DATA> testdata
- Run the Job: $HADOOP_HOME/bin/hadoop jar $MAHOUT_HOME/core/target/mahout-core-<MAHOUT VERSION>.job org.apache.mahout.cf.taste.example.<JOB> <OPTIONS>
- Get the data out of HDFS and have a look. Use bin/hadoop fs -lsr output to view all outputs.
Command line options
Usage: <JOB> --input (-i) input The Path for input preferences. This argument is optional except for the netflix example. --help (-h) Print out help