Author: lmccay Date: Sun Mar 22 18:53:44 2015 New Revision: 1668445 URL: http://svn.apache.org/r1668445 Log: fixed horizontal scrolling of users guide
Modified: knox/site/books/knox-0-6-0/user-guide.html knox/trunk/books/0.6.0/book_gateway-details.md knox/trunk/books/0.6.0/service_hive.md Modified: knox/site/books/knox-0-6-0/user-guide.html URL: http://svn.apache.org/viewvc/knox/site/books/knox-0-6-0/user-guide.html?rev=1668445&r1=1668444&r2=1668445&view=diff ============================================================================== --- knox/site/books/knox-0-6-0/user-guide.html (original) +++ knox/site/books/knox-0-6-0/user-guide.html Sun Mar 22 18:53:44 2015 @@ -332,7 +332,7 @@ https://{gateway-host}:{gateway-port}/{g </ul></li> <li>Hive JDBC <ul> - <li>Gateway: <code>jdbc:hive2://{gateway-host}:{gateway-port}/;ssl=true;sslTrustStore={gateway-trust-store-path};trustStorePassword={gateway-trust-store-password}?hive.server2.transport.mode=http;hive.server2.thrift.http.path={gateway-path}/{cluster-name}/hive</code></li> + <li>Gateway: jdbc:hive2://{gateway-host}:{gateway-port}/;ssl=true;sslTrustStore={gateway-trust-store-path};trustStorePassword={gateway-trust-store-password}?hive.server2.transport.mode=http;hive.server2.thrift.http.path={gateway-path}/{cluster-name}/hive</li> <li>Cluster: <code>http://{hive-host}:10001/cliservice</code></li> </ul></li> </ul><p>The values for <code>{gateway-host}</code>, <code>{gateway-port}</code>, <code>{gateway-path}</code> are provided via the gateway configuration file (i.e. <code>{GATEWAY_HOME}/conf/gateway-site.xml</code>).</p><p>The value for <code>{cluster-name}</code> is derived from the file name of the cluster topology descriptor (e.g. <code>{GATEWAY_HOME}/deployments/{cluster-name}.xml</code>).</p><p>The value for <code>{webhdfs-host}</code>, <code>{webhcat-host}</code>, <code>{oozie-host}</code>, <code>{hbase-host}</code> and <code>{hive-host}</code> are provided via the cluster topology descriptor (e.g. <code>{GATEWAY_HOME}/conf/topologies/{cluster-name}.xml</code>).</p><p>Note: The ports 50070, 50111, 11000, 60080 (default 8080) and 10001 are the defaults for WebHDFS, WebHCat, Oozie, Stargate/HBase and Hive respectively. Their values can also be provided via the cluster topology descriptor if your Hadoop cluster uses different ports.</p><h3><a id="Configuration"></a>Configuration</h 3><h4><a id="Topology+Descriptors"></a>Topology Descriptors</h4><p>The topology descriptor files provide the gateway with per-cluster configuration information. This includes configuration for both the providers within the gateway and the services within the Hadoop cluster. These files are located in <code>{GATEWAY_HOME}/conf/topologies</code>. The general outline of this document looks like this.</p> @@ -2867,11 +2867,11 @@ session.shutdown(10, SECONDS) <tbody> <tr> <td>Gateway </td> - <td><code>jdbc:hive2://{gateway-host}:{gateway-port}/;ssl=true;sslTrustStore={gateway-trust-store-path};trustStorePassword={gateway-trust-store-password}?hive.server2.transport.mode=http;hive.server2.thrift.http.path={gateway-path}/{cluster-name}/hive</code> </td> + <td>jdbc:hive2://{gateway-host}:{gateway-port}/;ssl=true;sslTrustStore={gateway-trust-store-path};trustStorePassword={gateway-trust-store-password}?hive.server2.transport.mode=http;hive.server2.thrift.http.path={gateway-path}/{cluster-name}/hive</td> </tr> <tr> <td>Cluster </td> - <td><code>http://{hive-host}:{hive-port}/{hive-path}</code> </td> + <td><code>http://{hive-host}:{hive-port}/{hive-path}</code></td> </tr> </tbody> </table><h4><a id="Hive+Examples"></a>Hive Examples</h4><p>This guide provides detailed examples for how to to some basic interactions with Hive via the Apache Knox Gateway.</p><h5><a id="Hive+Setup"></a>Hive Setup</h5> @@ -2886,7 +2886,7 @@ session.shutdown(10, SECONDS) <li>hive-jdbc-0.14.0-standalone.jar;</li> <li>commons-logging-1.1.3.jar;</li> </ul></li> - <li>Connection URL has to be following: <code>jdbc:hive2://{gateway-host}:{gateway-port}/;ssl=true;sslTrustStore={gateway-trust-store-path};trustStorePassword={gateway-trust-store-password}?hive.server2.transport.mode=http;hive.server2.thrift.http.path={gateway-path}/{cluster-name}/hive</code></li> + <li>Connection URL has to be following: jdbc:hive2://{gateway-host}:{gateway-port}/;ssl=true;sslTrustStore={gateway-trust-store-path};trustStorePassword={gateway-trust-store-password}?hive.server2.transport.mode=http;hive.server2.thrift.http.path={gateway-path}/{cluster-name}/hive</li> <li>Look at <a href="https://cwiki.apache.org/confluence/display/Hive/GettingStarted#GettingStarted-DDLOperations">https://cwiki.apache.org/confluence/display/Hive/GettingStarted#GettingStarted-DDLOperations</a> for examples. Hint: For testing it would be better to execute <code>set hive.security.authorization.enabled=false</code> as the first statement. Hint: Good examples of Hive DDL/DML can be found here <a href="http://gettingstarted.hadooponazure.com/hw/hive.html">http://gettingstarted.hadooponazure.com/hw/hive.html</a></li> </ol></li> </ol><h5><a id="Customization"></a>Customization</h5><p>This example may need to be tailored to the execution environment. In particular host name, host port, user name, user password and context path may need to be changed to match your environment. In particular there is one example file in the distribution that may need to be customized. Take a moment to review this file. All of the values that may need to be customized can be found together at the top of the file.</p> Modified: knox/trunk/books/0.6.0/book_gateway-details.md URL: http://svn.apache.org/viewvc/knox/trunk/books/0.6.0/book_gateway-details.md?rev=1668445&r1=1668444&r2=1668445&view=diff ============================================================================== --- knox/trunk/books/0.6.0/book_gateway-details.md (original) +++ knox/trunk/books/0.6.0/book_gateway-details.md Sun Mar 22 18:53:44 2015 @@ -63,7 +63,7 @@ The actual port number may be different * Gateway: `https://{gateway-host}:{gateway-port}/{gateway-path}/{cluster-name}/hbase` * Cluster: `http://{hbase-host}:60080` * Hive JDBC - * Gateway: `jdbc:hive2://{gateway-host}:{gateway-port}/;ssl=true;sslTrustStore={gateway-trust-store-path};trustStorePassword={gateway-trust-store-password}?hive.server2.transport.mode=http;hive.server2.thrift.http.path={gateway-path}/{cluster-name}/hive` + * Gateway: jdbc:hive2://{gateway-host}:{gateway-port}/;ssl=true;sslTrustStore={gateway-trust-store-path};trustStorePassword={gateway-trust-store-password}?hive.server2.transport.mode=http;hive.server2.thrift.http.path={gateway-path}/{cluster-name}/hive * Cluster: `http://{hive-host}:10001/cliservice` The values for `{gateway-host}`, `{gateway-port}`, `{gateway-path}` are provided via the gateway configuration file (i.e. `{GATEWAY_HOME}/conf/gateway-site.xml`). Modified: knox/trunk/books/0.6.0/service_hive.md URL: http://svn.apache.org/viewvc/knox/trunk/books/0.6.0/service_hive.md?rev=1668445&r1=1668444&r2=1668445&view=diff ============================================================================== --- knox/trunk/books/0.6.0/service_hive.md (original) +++ knox/trunk/books/0.6.0/service_hive.md Sun Mar 22 18:53:44 2015 @@ -58,8 +58,8 @@ By default the gateway is configured to #### Hive JDBC URL Mapping #### | ------- | ------------------------------------------------------------------------------- | -| Gateway | `jdbc:hive2://{gateway-host}:{gateway-port}/;ssl=true;sslTrustStore={gateway-trust-store-path};trustStorePassword={gateway-trust-store-password}?hive.server2.transport.mode=http;hive.server2.thrift.http.path={gateway-path}/{cluster-name}/hive` | -| Cluster | `http://{hive-host}:{hive-port}/{hive-path}` | +| Gateway | jdbc:hive2://{gateway-host}:{gateway-port}/;ssl=true;sslTrustStore={gateway-trust-store-path};trustStorePassword={gateway-trust-store-password}?hive.server2.transport.mode=http;hive.server2.thrift.http.path={gateway-path}/{cluster-name}/hive| +| Cluster |`http://{hive-host}:{hive-port}/{hive-path}`| #### Hive Examples #### @@ -74,8 +74,7 @@ This guide provides detailed examples fo 1. Hive JDBC in HTTP mode depends on following minimal libraries set to run successfully(must be in the classpath): * hive-jdbc-0.14.0-standalone.jar; * commons-logging-1.1.3.jar; - 2. Connection URL has to be following: - `jdbc:hive2://{gateway-host}:{gateway-port}/;ssl=true;sslTrustStore={gateway-trust-store-path};trustStorePassword={gateway-trust-store-password}?hive.server2.transport.mode=http;hive.server2.thrift.http.path={gateway-path}/{cluster-name}/hive` + 2. Connection URL has to be following: jdbc:hive2://{gateway-host}:{gateway-port}/;ssl=true;sslTrustStore={gateway-trust-store-path};trustStorePassword={gateway-trust-store-password}?hive.server2.transport.mode=http;hive.server2.thrift.http.path={gateway-path}/{cluster-name}/hive 3. Look at https://cwiki.apache.org/confluence/display/Hive/GettingStarted#GettingStarted-DDLOperations for examples. Hint: For testing it would be better to execute `set hive.security.authorization.enabled=false` as the first statement. Hint: Good examples of Hive DDL/DML can be found here http://gettingstarted.hadooponazure.com/hw/hive.html