These notes are for HCatalog 0.2.0 release.

Highlights
==========

This is the initial relase of Apache HCatalog.  It provides read and write capability for Pig and Hadoop, and read capability for Hive.

System Requirements
===================

1. Java 1.6.x or newer, preferably from Sun. Set JAVA_HOME to the root of your
   Java installation
2. Ant build tool, version 1.8 or higher:  http://ant.apache.org - to build
   source only
3. This release is compatible with Hadoop 0.20.x with security.  Currently this
   is available from the 0.20.204 branch of Apache Hadoop
4. This release is compatible with Pig 0.8.1 and Pig 0.9.1.
5. This release is compatible with Hive 0.7.1.

Trying the Release
==================
1. Download hcatalog-src-0.2.0-incubating.tar.gz
2. Unpack the file: tar -xzvpf hcatalog-src-0.2.0-incubating.tar.gz
3. Move into the installation directory: cd hcatalog-0.2.0-incubating
4. Run "umask 0022 && ant jar test -Dhcatalog.version=0.2.0" to run unit tests.
5. Run ant tar -Dforrest.home=/path/to/forrest/install -Dhcatalog.version=0.2.0
   to build installable tarball.
6. cd build
7. Move hcatalog-0.2.0.tar.gz to somewhere you have write permissions (e.g. /home/me/hcat-insall)
8. cd to your tar-ball location (e.g. cd /home/me/hcat-install)
9. Untar hcatalog-0.2.0.tar.gz: tar -xvzpf hcatalog-0.2.0.tar.gz
10. Move into hcatalog-0.2.0
11. Install the hcatalog server by running share/hcatalog/scripts/hcat_server_install.sh
    You may find instructions in share/doc/hcatalog/install.html useful
12. Export HADOOP_HOME and HADOOP_CONF_DIR to appropriate values.
13. Run share/hcatalog/scripts/hcat_server_start.sh to start the hcatalog server.
14. To use the command line interface use bin/hcat
15. To use with Hadoop MapReduce jobs, use the HCatInputFormat and
    HCatOutputFormat classes.
16. To use with Pig, use the HCatLoader and HCatStorer classes.

Relevant Documentation
======================
See http://incubator.apache.org/hcatalog/docs/r0.2.0
These notes are for HCatalog 0.2.0 release.