This is the documentation for CDH 4.6.0.
Documentation for other versions is available at Cloudera Documentation.

Installing the HCatalog RPM or Debian Packages

Installing the HCatalog RPM or Debian packages is more convenient than installing the HCatalog tarball because the packages:

  • Handle dependencies
  • Provide for easy upgrades
  • Automatically install resources to conventional locations

HCatalog comprises the following packages:

  • hcatalog - HCatalog wrapper for accessing the Hive metastore, libraries for MapReduce and Pig, and a command-line program
  • webhcat - A REST API server for HCatalog
  • webhcat-server - Installs webhcat and a server init script
  Important:

If you have not already done so, install Cloudera's yum, zypper/YaST or apt repository before using the following commands to install HCatalog. For instructions, see CDH4 Installation.

Installing the WebHCat REST Server

To install the WebHCat REST server on a Red Hat system:

$ sudo yum install webhcat-server

To install the WebHCat REST server components on an Ubuntu or other Debian system:

$ sudo apt-get install webhcat-server

To install the WebHCat REST server components on a SLES system:

$ sudo zypper install webhcat-server
  Note:
  • It is not necessary to install WebHCat if you will not be using the REST API. Pig and MapReduce do not need it.
  • You can change the default port 50111 by creating or editing the following file and restarting WebHCat:
    /etc/webhcat/conf/webhcat-site.xml
The property to change is:
<configuration>
  <property>
    <name>templeton.port</name>
    <value>50111</value>
    <description>The HTTP port for the main server.</description>
  </property>
</configuration>
  • To uninstall WebHCat you must remove two packages: webhcat-server and webhcat.

Installing HCatalog for Use with Pig and MapReduce

On hosts that will be used to launch Pig scripts or MapReduce applications using table information, install HCatalog as follows: To install the HCatalog client components on a Red Hat system:

$ sudo yum install hcatalog

To install the HCatalog client components on an Ubuntu or other Debian system:

$ sudo apt-get install hcatalog

To install the HCatalog client components on a SLES system:

$ sudo zypper install hcatalog