To upgrade HCatalog from CDH 4 to CDH 5, proceed as follows.

  Note:

If you have already performed the steps to uninstall CDH 4 and all components, as described under Upgrading from CDH 4 to CDH 5, you can skip Step 1 below and proceed with installing the new CDH 5 version of HCatalog.

  Important:

If you have installed the hive-hcatalog-server package in the past, you must remove it before you proceed; otherwise the upgrade will fail.

Follow instructions under Installing the WebHCat REST Server and Installing HCatalog for Use with Pig and MapReduce.

  Important: Configuration files

• If you install a newer version of a package that is already on the system, configuration files that you have modified will remain intact.
• If you uninstall a package, the package manager renames any configuration files you have modified from <file> to <file>.rpmsave. If you then re-install the package (probably to install a new version) the package manager creates a new <file> with applicable defaults. You are responsible for applying any changes captured in the original configuration file to the new configuration file. In the case of Ubuntu and Debian upgrades, you will be prompted if you have made changes to a file for which there is a new version; for details, see Automatic handling of configuration files by dpkg.

The upgrade is now complete.

  Note:

It is not necessary to install WebHCat if you will not be using the REST API. Pig and MapReduce do not need it.

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

$ sudo yum install hive-webhcat-server

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

$ sudo apt-get install hive-webhcat-server

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

$ sudo zypper install hive-webhcat-server

  Note:

• 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: hive-webhcat-server and hive-webhcat.

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 hive-hcatalog

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

$ sudo apt-get install hive-hcatalog

To install the HCatalog client components on a SLES system:

$ sudo zypper install hive-hcatalog