The Templeton specific configuration is split into two layers:
-
templeton-default.xml - All the configuration variables
+
webhcat-default.xml - All the configuration variables
that Templeton needs. This file sets the defaults that ship with Templeton and
should only be changed by Templeton developers. Do not copy this file and/or
- change it to maintain local installation settings. Because templeton-default.xml
+ change it to maintain local installation settings. Because webhcat-default.xml
is present in the Templeton war file, editing a local copy of it will not change the
configuration.
-
templeton-site.xml - The (possibly empty) configuration
+
webhcat-site.xml - The (possibly empty) configuration
file in which the system administrator can set variables for their Hadoop cluster.
Create this file and maintain entries in it for configuration variables
that require you to override default values based on your local installation.
Note: The location of the log files created by Templeton and some other properties
- of the logging system are set in the templeton-log4j.properties file.
+ of the logging system are set in the webhcat-log4j.properties file.
Variables
@@ -87,13 +87,13 @@ ${env.PIG_HOME}/bin/pig
Set the TEMPLETON_HOME environment variable to the base of the
- HCatalog REST server installation. This will usually be HCATALOG_HOME/webhcat.
+ HCatalog REST server installation. This will usually be same as
+ HCATALOG_HOME.
This is used to find the Templeton
configuration.
+
Set JAVA_HOME,HADOOP_PREFIX, and HIVE_HOME environment variables
Review the configuration
- and update or create templeton-site.xml as required. Ensure that
+ and update or create webhcat-site.xml as required. Ensure that
site specific component installation locations are accurate, especially
the Hadoop configuration path. Configuration variables that use a filesystem
path try to have reasonable defaults, but it's always safe to specify a full
@@ -48,7 +50,7 @@
Start the REST server with the command
bin/templeton_server.sh start.
Check that your local install works. Assuming that the server is running
- on port 8080, the following command would give output similar to that shown.
+ on port 50111, the following command would give output similar to that shown.
% curl -i http://localhost:50111/templeton/v1/status
HTTP/1.1 200 OK
@@ -65,8 +67,8 @@ Server: Jetty(7.6.0.v20120127)
Server Commands
ZooKeeper is required if you are using
the ZooKeeper storage class. (Be sure to review
and update the ZooKeeper related Templeton
configuration.)
HCatalog.
- Version 0.4.0 or higher. The hcat executable must be both in the
+ Version 0.5.0 or higher. The hcat executable must be both in the
PATH and properly configured in the Templeton configuration.
Hive:
- Download
- the HCatalog tar.gz file and place it in HDFS. (If you need a version
- that is not yet released, you may need to build it yourself following the HCatalog
- instructions.)
+ Download
+ the hive tar.gz file and place it in HDFS.
-hadoop fs -put /tmp/hcatalog-0.5.0.tar.gz /user/templeton/hcatalog-0.5.0.tar.gz
+hadoop fs -put /tmp/hive-0.10.0.tar.gz /apps/templeton/hive-0.10.0.tar.gz
@@ -129,7 +129,7 @@ hadoop fs -put /tmp/hcatalog-0.5.0.tar.gz /user/templeton/hcatalog-0.5.0.tar.gz
Download
the Pig tar.gz file and place it into HDFS. For example:
-hadoop fs -put /tmp/pig-0.9.2.tar.gz /user/templeton/pig-0.9.2.tar.gz
+hadoop fs -put /tmp/pig-0.10.1.tar.gz /apps/templeton/pig-0.10.1.tar.gz
@@ -138,18 +138,18 @@ hadoop fs -put /tmp/pig-0.9.2.tar.gz /user/templeton/pig-0.9.2.tar.gz
following command, substituting your path to the jar for the one below.
hadoop fs -put $HADOOP_PREFIX/hadoop-0.20.205.0/contrib/streaming/hadoop-streaming-0.20.205.0.jar \
- /user/templeton/hadoop-streaming.jar
+ /apps/templeton/hadoop-streaming.jar
Override Jars:
- Place override jars required (if any) into HDFS. Note: As of this writing, all
- released versions of Hadoop require a patch to properly run Templeton. This patch is
+ Place override jars required (if any) into HDFS. Note: Hadoop versions
+ prior to 1.0.3 require a patch (HADOOP-7987) to properly run Templeton. This patch is
distributed with Templeton (located at
templeton/src/hadoop_temp_fix/ugi.jar)
and should be placed into HDFS, as reflected in the current default configuration.
-hadoop fs -put ugi.jar /user/templeton/ugi.jar
+hadoop fs -put ugi.jar /apps/templeton/ugi.jar