WebHCat Installation

WebHCat Installed with Hive

If you install Hive from the binary tarball, the WebHCat server command webhcat_server.sh is in the hcatalog/sbin directory.

Hive installation is documented here.

WebHCat Installation Procedure

Note: WebHCat was originally called Templeton. For backward compatibility the name still appears in URLs, log file names, variable names, etc.

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 hcatalog/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"} %

Server Commands

• Start the server: hcatalog/sbin/webhcat_server.sh start
• Stop the server: hcatalog/sbin/webhcat_server.sh stop
• End-to-end build, run, test: ant e2e

...