Index: src/docs/src/documentation/content/xdocs/install.xml
===================================================================
--- src/docs/src/documentation/content/xdocs/install.xml (revision 1299332)
+++ src/docs/src/documentation/content/xdocs/install.xml (working copy)
@@ -24,16 +24,16 @@
- Server Installation
+ Server Installation from Source
Prerequisites
- Machine on which the server can be installed - this should have
- access to the hadoop cluster in question, and be accessible from
+ access to the Hadoop cluster in question, and be accessible from
the machines you launch jobs from
- - MySQL db
+ - an RDBMS - we recommend MySQL and provide instructions for it
- Hadoop cluster
- - Unix user that the server will run as, and an associated kerberos
+
- Unix user that the server will run as, and an associated Kerberos
service principal and keytabs.
@@ -65,12 +65,12 @@
mysql> flush privileges;
mysql> quit;
- In a temporary directory, untar the HCatalog artifact
+ In a temporary directory, untar the HCatalog artifact.
tar xzf hcatalog-version.tar.gz
Use the database installation script found in the package to create the
- database
+ database.
mysql -u hive -D hivemetastoredb -hhcatdb.acme.com -p < share/hcatalog/hive/external/metastore/scripts/upgrade/mysql/hive-schema-0.7.0.mysql.sql
Thrift Server Setup
@@ -126,20 +126,20 @@
| javax.jdo.option.ConnectionPassword |
dbpassword value you used in setting up the MySQL server
- above |
+ above.
| hive.metastore.warehouse.dir |
The directory can be a URI or an absolute file path. If it is an absolute file path, it will be resolved to a URI by the metastore:
-- If default hdfs was specified in core-site.xml, path resolves to HDFS location.
-- Otherwise, path is resolved as local file: URI.
- This setting becomes effective when creating new tables (takes precedence over default DBS.DB_LOCATION_URI at time of table creation).
+ This setting becomes effective when creating new tables (it takes precedence over default DBS.DB_LOCATION_URI at the time of table creation).
|
| hive.metastore.uris |
- You need to set the hostname to your Thrift
- server. Replace SVRHOST with the name of the
+ | Set the hostname of your Thrift
+ server by replacing SVRHOST with the name of the
machine you are installing the Thrift server on. You can also
change the port the Thrift server runs on by changing the default
value of 3306. |
@@ -147,19 +147,19 @@
| hive.metastore.sasl.enabled |
Set to true by default. Set to false if you do not wish to
- secure the thrift interface. This can be convenient for testing.
+ secure the Thrift interface. This can be convenient for testing.
We do not recommend turning this off in production. |
| hive.metastore.kerberos.keytab.file |
- The path to the Kerberos keytab file containg the metastore
- thrift server's service principal. |
+ The path to the Kerberos keytab file containing the metastore
+ Thrift server's service principal. |
| hive.metastore.kerberos.principal |
- The service principal for the metastore thrift server. You can
+ | The service principal for the metastore Thrift server. You can
reference your host as _HOST and it will be replaced with your
- actual hostname |
+ actual hostname.
@@ -188,7 +188,7 @@
Logging
- Server activity logs and gc logs are located in
+
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
@@ -233,13 +233,13 @@
The directory can be a URI or an absolute file path. If it is an absolute file path, it will be resolved to a URI by the metastore:
-- If default hdfs was specified in core-site.xml, path resolves to HDFS location.
-- Otherwise, path is resolved as local file: URI.
- This setting becomes effective when creating new tables (takes precedence over default DBS.DB_LOCATION_URI at time of table creation).
+ This setting becomes effective when creating new tables (it takes precedence over default DBS.DB_LOCATION_URI at the time of table creation).
|
| hive.metastore.uris |
- You need to set the hostname wish your Thrift
- server to use by replacing SVRHOST with the name of the
+ | Set the hostname of your Thrift
+ server by replacing SVRHOST with the name of the
machine you are installing the Thrift server on. You can also
change the port the Thrift server runs on by changing the default
value of 3306. |