Author: hashutosh
Date: Fri Sep 30 21:11:17 2011
New Revision: 1177838
URL: http://svn.apache.org/viewvc?rev=1177838&view=rev
Log:
Issues with install instructions and release notes in release candidate
Modified:
incubator/hcatalog/trunk/CHANGES.txt
incubator/hcatalog/trunk/RELEASE_NOTES.txt
incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/install.xml
Modified: incubator/hcatalog/trunk/CHANGES.txt
URL:
http://svn.apache.org/viewvc/incubator/hcatalog/trunk/CHANGES.txt?rev=1177838&r1=1177837&r2=1177838&view=diff
==============================================================================
--- incubator/hcatalog/trunk/CHANGES.txt (original)
+++ incubator/hcatalog/trunk/CHANGES.txt Fri Sep 30 21:11:17 2011
@@ -28,6 +28,8 @@ Trunk (unreleased changes)
HCAT-63. RPM package integration with Hadoop (khorgath via hashutosh)
IMPROVEMENTS
+ HCAT-111. Issues with install instructions and release notes in release
candidate (gates via hashutosh)
+
HCAT-103. Update documentation after rpm changes per HCATALOG-63 (khorgath
via hashutosh)
HCAT-99. HCatalog V2 Docs (chandec via hashutosh)
Modified: incubator/hcatalog/trunk/RELEASE_NOTES.txt
URL:
http://svn.apache.org/viewvc/incubator/hcatalog/trunk/RELEASE_NOTES.txt?rev=1177838&r1=1177837&r2=1177838&view=diff
==============================================================================
--- incubator/hcatalog/trunk/RELEASE_NOTES.txt (original)
+++ incubator/hcatalog/trunk/RELEASE_NOTES.txt Fri Sep 30 21:11:17 2011
@@ -1,4 +1,4 @@
-These notes are for HCatalog 0.1.0 release.
+These notes are for HCatalog 0.2.0 release.
Highlights
==========
@@ -13,58 +13,34 @@ System Requirements
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 Cloudera in their CDH3 release or from the 0.20.203 branch
- of Apache Hadoop (not yet released).
-4. This release is compatible with Pig 0.8.1.
-5. This release is compatible with Hive 0.7.0.
+ 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-0.1.0.tar.gz
-2. Unpack the file: tar -xzvf hcatalog-0.1.0.tar.gz
-3. Move into the installation directory: cd hcatalog-0.1.0
-TODO need install instructions
-4. To use with Hadoop MapReduce jobs, use the HCatInputFormat and
- HCatOutputFormat classes.
-5. To use with Pig, use the HCatLoader and HCatStorer classes.
-6. To use the command line interface, set HADOOP_CLASSPATH to the directory
- that contains the configuration files for your cluster, and use bin/hcat.sh
+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.1.0
-These notes are for HCatalog 0.1.0 release.
+See http://incubator.apache.org/hcatalog/docs/r0.2.0
+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 Cloudera in their CDH3 release or from the 0.20.203 branch
- of Apache Hadoop (not yet released).
-4. This release is compatible with Pig 0.8.1.
-5. This release is compatible with Hive 0.7.0.
-
-Trying the Release
-==================
-1. Download hcatalog-0.1.0.tar.gz
-2. Unpack the file: tar -xzvf hcatalog-0.1.0.tar.gz
-3. Move into the installation directory: cd hcatalog-0.1.0
-TODO need install instructions
-4. To use with Hadoop MapReduce jobs, use the HCatInputFormat and
- HCatOutputFormat classes.
-5. To use with Pig, use the HCatLoader and HCatStorer classes.
-6. To use the command line interface, set HADOOP_CLASSPATH to the directory
- that contains the configuration files for your cluster, and use bin/hcat.sh
-
-Relevant Documentation
-======================
-See http://incubator.apache.org/hcatalog/docs/r0.1.0
Modified:
incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/install.xml
URL:
http://svn.apache.org/viewvc/incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/install.xml?rev=1177838&r1=1177837&r2=1177838&view=diff
==============================================================================
---
incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/install.xml
(original)
+++
incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/install.xml
Fri Sep 30 21:11:17 2011
@@ -71,7 +71,7 @@
<p>Use the database installation script found in the package to create the
database</p>
- <p><code>mysql -u hive -D hivemetastoredb
-h</code><em>hcatdb.acme.com</em><code> -p <
scripts/hive-schema-0.7.0.mysql.sql</code></p>
+ <p><code>mysql -u hive -D hivemetastoredb
-h</code><em>hcatdb.acme.com</em><code> -p <
share/hcatalog/hive/external/metastore/scripts/upgrade/mysql/hive-schema-0.7.0.mysql.sql</code></p>
<p><strong>Thrift Server Setup</strong></p>
@@ -100,13 +100,16 @@
server installation script. You will need to know the directory you chose
as <em>root</em> and the
directory you installed the MySQL Java connector libraries into (referred
- to in the command below as <em>dbroot</em>).</p>
+ to in the command below as <em>dbroot</em>). You will also need your
+ <em>hadoop_home</em>, the directory where you have Hadoop installed, and
+ the port number you wish HCatalog to operate on which you will use to set
+ <em>portnum</em>.</p>
<p><code>tar zxf hcatalog-</code><em>version</em><code>.tar.gz
cd hcatalog-</code><em>version</em></p>
- <p><code>scripts/hcat_server_install.sh -r </code><em>root</em><code> -d
</code><em>dbroot</em></p>
+ <p><code>share/hcatalog/scripts/hcat_server_install.sh -r
</code><em>root</em><code> -d </code><em>dbroot</em><code> -h
</code><em>hadoop_home</em><code> -p </code><em>portnum</em></p>
- <p>Now you need to edit your <em>root</em><code>/conf/hive-site.xml</code>
file.
+ <p>Now you need to edit your
<em>root</em><code>/etc/hcatalog/hive-site.xml</code> file.
Open this file in your favorite text editor. The following table shows the
values you need to configure.</p>
@@ -165,7 +168,7 @@
<p>Start the HCatalog server by switching directories to
<em>root</em> and invoking the start script
- <code>bin/hcat_server_start.sh</code></p>
+ <code>share/hcatalog/scripts/hcat_server_start.sh</code></p>
</section>
@@ -185,7 +188,7 @@
<p>To stop the HCatalog server, change directories to the <em>root</em>
directory and invoke the stop script
- <code>bin/hcat_server_stop.sh</code></p>
+ <code>share/hcatalog/scripts/hcat_server_stop.sh</code></p>
</section>
@@ -200,7 +203,7 @@
<p><code>tar zxf hcatalog-</code><em>version</em><code>.tar.gz</code></p>
- <p>Now you need to edit your <em>root</em><code>/conf/hive-site.xml</code>
file.
+ <p>Now you need to edit your
<em>root</em><code>/etc/hcatalog/hive-site.xml</code> file.
Open this file in your favorite text editor. The following table shows the
values you need to configure. These values should match the values set on
the HCatalog server. Do <strong>NOT</strong> copy the configuration file
@@ -228,7 +231,7 @@
</table>
<p>The HCatalog command line interface (CLI) can now be invoked as
- <em>root</em><code>/bin/hcat.sh</code>.</p>
+ <em>root</em><code>/bin/hcat</code>.</p>
</section>
