The document provides steps to connect a SQL client called SqlWorkbenchJ running on Windows to Apache Phoenix and HBase running in a Hortonworks Sandbox instance hosted on Linux. It details downloading necessary software, configuring the SQL client, and modifying files like hosts to allow the connection. The steps include extracting SqlWorkbenchJ, copying necessary JAR files, configuring the connection profile in the client to point to the Sandbox, and testing the connection by querying Phoenix tables.

1. How to Connect HBase in Hortonworks SandBox Using SqlWorkbenchJ As
Phoenix GUI Client From Windows
While Iwas testing Apache Phoenix withhbase in Hortonworkssandbox 2.2.0.0-2041, I foundno
Phoenix wasinstalled, soI downloadedand installednewestversionof Phoenix 4.3.1andrun into
some problems, ItriedtobuildPheonix fromsource,buildingwassmoothbutthere were somany
runtime exceptions,mostlylibcompatibilityissues.Atthattime,anew versionof sandbox was
released, Idownloadednewversionof Sandbox 2.2.4.2-2whichcomeswithPhoenix.Phoenix officail
website recommendtouse Squirrel asclient,butSquirrel clientisnotcompatible withPhoenix innew
versionof sandBox,pleasesee https://issues.apache.org/jira/browse/PHOENIX-1613.Hortonworkssaid
the issue will be resolvedinnextrelease.
CertainlyIcouldnotwaittill newSquirrel clientrelease.Afterall,Squirrel justaJDBCclient,there must
be otheralternatives. ItriedSqlWorkbench,which workslike acharmp.Youmay install SqlWorkbench
inSandbox,butthismethodhas serious drawbacks,because UIcomponentusesalotof memory,it
leaveslessmemoryforthe componentstorun, and inmy case, sandbox ishostedin ESXI and I only
have commandlinesaccess i.gconnectviassh,install SqlWorkbenchJinsandbox will notwork.
I couldnot finddocumenttosetupSql clientinwindowsandinteractwithPhoenix inLinux. Tome itis
crucial to separate GUI clientwithserver,whichmotivatesme towrite thisarticle. Ittookme some
time to finda workable solution, mostlybecauseIwasnot aware there issecondaryip insandbox,
untill IinstalledtcpdumpandwiresharkandIwentthroughstepsto rule outit wasnot because of
firewall thatcausedconnectionreset. Ihope myarticle will be helpful toothers.
Software todownload :
downloadHortonworkssandbox 2.2.4, http://hortonworks.com/products/hortonworks-sandbox/
downloadwinutils.exe, http://public-repo-1.hortonworks.com/hdp-win-alpha/winutils.exe
downloadSqlWorkbenchJ, http://www.sql-workbench.net/downloads.html
downloadhadoop-common-2.6.0jar, http://mvnrepository.com/artifact/org.apache.hadoop/hadoop-
common/2.6.0
Setup
Extract SqlWorkbenchJtoatarget directory
Put winutil.exetoa directory andchange sqlworkbench.cmdtopointto the directory
Copy phoenix-4.2.0.2.2.4.2-2-client.jartoSqlworkbenchJinstall directory
Copy hadoop-common-2.6.0toSqlWorkbenchinstall directory
Example:
Copy winutil.exeto C:UsersmxuDownloadsFake_Hadoopbin
Add–Dhadoop.home.dirin sqlworkbench.cmdfile
:gui

2. start "SQL Workbench/J" "%JAVA_BINPATH%javaw.exe"^
-Xmx512m ^
-Dvisualvm.display.name=SQLWorkbench ^
-Dsun.awt.keepWorkingSetOnMinimize=true ^
-Dsun.java2d.dpiaware=true ^
-Dsun.java2d.noddraw=true ^
-Dhadoop.home.dir=C:UsersmxuDownloadsFake_Hadoop ^
-jar %wbdir%sqlworkbench.jar %*
goto :eof
Add sandbox ip(s) to hosts file
If vm is not hosted in local PC, check for secondary IP, see command below and add secondary in
hosts file
[root@sandbox mxu]# ip addr list dev eth0
Configure SqlWorkbenchJ
Add phoenix driver
Click file -> Manage Driver and add phoenix driver

3. Create new connection profile
Click File ->Connect Window -> Create a new connection profile
Selectthe Phoenixdriveryoujustcreatedandfillinyourusername andpasswordtologinsandbox.
Click OK, it will start to connect to Hbase.
To start the application, double click SqlWorkbenchJ64.exe
Note:Inmy testing, put either primary or secondary ip in connection URL, connection works fine.
My Windows version: Windows 7 professional service pack 1
References:
https://github.com/spring-projects/spring-hadoop/wiki/Using-a-Windows-client-together-with-a-
Linux-cluster
http://phoenix.apache.org/installation.html