Page History

...

1. Ensure that the required related installations are in place, and place required files into the Hadoop distributed cache.
2. Download and unpack the HCatalog distribution.
3. Set the TEMPLETON_HOME environment variable to the base of the HCatalog REST server installation. This will usually be same as HCATALOG_HOME. This is used to find the WebHCat (Templeton) configuration.
4. Set JAVA_HOME, HADOOP_PREFIX, and HIVE_HOME environment variables.
5. Review the configuration 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 and complete path.
6. Verify that HCatalog is installed and that the hcat executable is in the PATH.
7. Build HCatalog using the command ant jar from the top level HCatalog directory.
8. Start the REST server with the command sbin/webhcat_server.sh start.
9. Check that your local install works. Assuming that the server is running on port 50111, the following command would give output similar to that shown.

   No Format
   % curl -i http://localhost:50111/templeton/v1/status HTTP/1.1 200 OK Content-Type: application/json Transfer-Encoding: chunked Server: Jetty(7.6.0.v20120127) {"status":"ok","version":"v1"} %

...

• Ant, version 1.8 or higher
• Hadoop, version 1.0.3 or higher
• ZooKeeper is required if you are using the ZooKeeper storage class. (Be sure to review and update the ZooKeeper-related WebHCat configuration.)
• HCatalog, version 0.5.0 or higher. The hcat executable must be both in the PATH and properly configured in the WebHCat configuration.
• Permissions must be given to the user running the server. (See below.)
• If running a secure cluster, Kerberos keys and principals must be created. (See below.)
• Hadoop Distributed Cache. To use Hive, Pig, or Hadoop Streaming resources, see instructions below for placing the required files in the Hadoop Distributed Cache.

...

The location of these files in the cache, and the location of the installations inside the archives, can be specified using the following WebHCat configuration variables. (See the Configuration documentation for more information on changing WebHCat configuration parameters.) Some default values vary depending on release number; defaults shown below are for the version of WebHCat that is included in Hive release 0.11.0. Defaults for the previous release are shown in the HCatalog 0.5.0 documentation.

...