HUE-8740 [librdbms] Make jdbc plugin build fully off by default

Author: romainr

Makefile

@@ -119,7 +119,9 @@ docs:
 # Install parent POM
 ###################################
 parent-pom:
+ifneq (,$(BUILD_DB_PROXY))
 	cd $(ROOT)/maven && mvn install $(MAVEN_OPTIONS)
+endif
 
 .PHONY: parent-pom
 

desktop/libs/librdbms/Makefile

@@ -63,6 +63,7 @@ else
 $(DB_PROXY_JAR):
 	$(error Cannot build DBProxy plugin without source)
 endif
-else:
+else
+$(DB_PROXY_JAR):
 	@echo 'Skipping DB Proxy Jar build as BUILD_DB_PROXY not set.'
 endif

docs/docs-site/content/administrator/installation/dependencies/_index.md

@@ -7,14 +7,12 @@ weight: -1
 
 ## Dependencies
 
-Hue employs some Python modules which use native code and requires
-certain development libraries be installed on your system. To install from the
-tarball, you'll need these library development packages and tools installed on your system:
+Hue employs some Python modules which use native code and requires certain development libraries be installed on your system. To install from the tarball, you'll need these library development packages and tools installed on your system:
 
 * Python 2.7
-* Python 3 (not available yet [HUE-8737](https://issues.cloudera.org/browse/HUE-8737))
+* Python 3 (can be tested cf. instructions on [HUE-8737](https://issues.cloudera.org/browse/HUE-8737))
 * [MySQL InnoDB or PostgreSQL or Oracle](https://www.cloudera.com/documentation/enterprise/latest/topics/hue_dbs_0.html)
-* Java (but only for the JDBC proxy, should be removed when [SQL Alchemy](https://issues.cloudera.org/browse/HUE-8740) is mature)
+
 
 ### Ubuntu
 
@@ -27,19 +25,10 @@ tarball, you'll need these library development packages and tools installed on y
     sudo apt-get install -y nodejs
 
 
-**Install Oracle JDK**
-
-On Ubuntu 16.04 or less only:
-
-    sudo add-apt-repository ppa:webupd8team/java
-    sudo apt-get update
-    sudo apt-get install oracle-java8-installer
-
 ### CentOS/RHEL
 
     sudo yum install ant asciidoc cyrus-sasl-devel cyrus-sasl-gssapi cyrus-sasl-plain gcc gcc-c++ krb5-devel libffi-devel libxml2-devel libxslt-devel make mysql mysql-devel openldap-devel python-devel sqlite-devel gmp-devel
 
-* [Oracle JDK](https://www.digitalocean.com/community/tutorials/how-to-install-java-on-centos-and-fedora)
 * mvn (from [``apache-maven``](https://gist.github.com/sebsto/19b99f1fa1f32cae5d00) package or maven3 tarball)
 * libtidy (for unit tests only)
 * openssl-devel (for version 7+)
@@ -99,11 +88,10 @@ for more details, refer to this link: [https://docs.oracle.com/cd/E37670_01/E590
 
 * Xcode command line tools
 * [Homebrew](https://brew.sh)
-* [Oracle Instant Client](http://www.oracle.com/technetwork/database/database-technologies/instant-client/downloads/index.html)
 
 Install Dependencies via Homebrew
 
-    brew install [email protected] maven gmp openssl libffi && brew cask install adoptopenjdk
+    brew install [email protected] maven gmp openssl libffi
 
 Install Xcode command line tools
 
@@ -164,6 +152,31 @@ Tip: Going to where is the Oracle client, e.g. /usr/local/share/oracle then crea
 
 There is more details on this [Apply Temporary Workaround for Oracle 12 Client](https://docs.cloudera.com/documentation/enterprise/latest/topics/hue_dbs_oracle_pkg.html#concept_qx3_hfw_4z).
 
+
+#### Mac
+
+* [Oracle Instant Client](http://www.oracle.com/technetwork/database/database-technologies/instant-client/downloads/index.html)
+
+### Java
+
+Java is only for the [JDBC proxy](/developer/connectors/#jdbc) connector.
+
+**Install Oracle JDK**
+
+On Ubuntu 16.04 or less only:
+
+    sudo add-apt-repository ppa:webupd8team/java
+    sudo apt-get update
+    sudo apt-get install oracle-java8-installer
+
+On Centos:
+
+* [Oracle JDK](https://www.digitalocean.com/community/tutorials/how-to-install-java-on-centos-and-fedora)
+
+On Mac:
+
+    brew cask install adoptopenjdk
+
 ### Supported Browsers
 
 The two latest LTS versions of each browsers:

docs/docs-site/content/developer/connectors/_index.md

@@ -23,10 +23,11 @@ This [asynchronous API](https://github.com/cloudera/hue/tree/master/apps/beeswax
 
 ### Custom
 
-If the built-in HiveServer2 (Hive, Impala, Spark SQL), RDBMS (MySQL, PostgreSQL, Oracle, SQLite), and JDBC interfaces don’t meet your needs, you can implement your own connector to the notebook app:
+If the built-in HiveServer2 (Hive, Impala, Spark SQL), SqlAlchemy (MySQL, PostgreSQL, Oracle, Presto...) don’t meet your needs, you can implement your own connector to the notebook app:
 
-* List of [all connectors](https://github.com/cloudera/hue/tree/master/desktop/libs/notebook/src/notebook/connectors)
-* Each connector API subclasses the [Base API](https://github.com/cloudera/hue/blob/master/desktop/libs/notebook/src/notebook/connectors/base.py) and must implement the methods defined within. Refer to the [JDBC](https://github.com/cloudera/hue/blob/master/desktop/libs/notebook/src/notebook/connectors/jdbc.py) or [RdbmsApi](https://github.com/cloudera/hue/blob/master/desktop/libs/notebook/src/notebook/connectors/rdbms.py) for representative examples
+* List of the existing [Notebook Connectors](https://github.com/cloudera/hue/tree/master/desktop/libs/notebook/src/notebook/connectors)
+* Each connector API subclasses the [Base API](https://github.com/cloudera/hue/blob/master/desktop/libs/notebook/src/notebook/connectors/base.py) and must implement the methods defined within
+* Refer to the [JdbcApi](https://github.com/cloudera/hue/blob/master/desktop/libs/notebook/src/notebook/connectors/jdbc.py) or [RdbmsApi](https://github.com/cloudera/hue/blob/master/desktop/libs/notebook/src/notebook/connectors/rdbms.py) for representative examples
 
 * [Kafka SQL](https://github.com/cloudera/hue/blob/master/desktop/libs/notebook/src/notebook/connectors/ksql.py)
 * [Solr SQL](https://github.com/cloudera/hue/blob/master/desktop/libs/notebook/src/notebook/connectors/solr.py)