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 "hcatalog/sbin/webhcat_server.sh start" for Hive 0.11.0 releases and later, or "sbin/webhcat_server.sh start" for installations prior to HCatalog merging with Hive.
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: sbin/webhcat_server.sh start (HCatalog 0.5.0 and earlier – prior to Hive release 0.11.0)
  • hcatalog/sbin/webhcat_server.sh start (Hive release 0.11.0 and later)
• Stop the server: sbin/webhcat_server.sh stop (HCatalog 0.5.0 and earlier – prior to Hive release 0.11.0)
  • hcatalog/sbin/webhcat_server.sh stop (Hive release 0.11.0 and later)
• End-to-end build, run, test: ant e2e

...