Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: revise general navigation links

Installation from Tarball

Table of Contents
Info
titleDISCLAIMER

This information is adapted from the HCatalog 0.5.0 installation instructions. Now that HCatalog is part of the Hive project, it is installed with Hive and therefore much of the information below is obsolete. Furthermore, there is no such thing as "HCatalog 0.11.0" although that fiction has been substituted below for "HCatalog 0.5.0" — until this wikidoc is revised to reflect current realities, you should be skeptical of what you read here.

Server Installation from Source

Prerequisites

  • machine to put the installation tar on
  • machine on which the server can be installed — this should have access to the Hadoop cluster in question, and be accessible from the machines you launch jobs from
  • an RDBMS — we recommend MySQL and provide instructions for it
  • Hadoop cluster
  • Unix user that the server will run as, and, if you are running your cluster in secure mode, an associated Kerberos service principal and keytabs.

Throughout these instructions when you see a word in italics it indicates a place where you should replace the word with a locally appropriate value such as a hostname or password.

Tarball Location

A binary tarball for HCatalog 0.11.0 is provided in the build directory:

...

If it is in another location, move it to the HCatalog build directory.

Database Setup

If you do not already have Hive installed with MySQL, the following will walk you through how to do so. If you have already set this up, you can skip this step.

...

mysql -u hive -D hivemetastoredb -hhivedb.acme.com -p < hive_home/scripts/metastore/upgrade/mysql/hive-schema-0.11.0.mysql.sql

Thrift Server Setup

If you do not already have Hive running a metastore server using Thrift, you can use the following instructions to set up and run one. You may skip this step if you already are using a Hive metastore server.

...

You can now proceed to starting the server.

Starting the Server

To start your server, HCatalog needs to know where Hive is installed. This is communicated by setting the environment variable HIVE_HOME to the location you installed Hive. Start the HCatalog server by switching directories to root and invoking "HIVE_HOME=hive_home sbin/hcat_server.sh start".

Logging

Server activity logs are located in root/var/log/hcat_server. Logging configuration is located at root/conf/log4j.properties. Server logging uses DailyRollingFileAppender by default. It will generate a new file per day and does not expire old log files automatically.

Stopping the Server

To stop the HCatalog server, change directories to the root directory and invoke "HIVE_HOME=hive_home sbin/hcat_server.sh stop".

Client Installation

Select a root directory for your installation of HCatalog client. We recommend /usr/local/hcat. If necessary, create the directory.

...

Panel
titleColorindigo
titleBGColorsilver
titleNavigation Links

Previous: Overview
Next: Load and Store Interfaces

General: HCatalog ManualWebHCat (Templeton) ManualHive Wiki Home Hive Project Site
Old version (HCatalog 0.5.0): Installation from Tarball