AquaFold
HOME SCREENSHOTS DOWNLOAD DOCUMENTATION SUPPORT LICENSING CONTACT
 

Documentation: Aqua Data Studio 6.5 - New Features     HTML Documentation download, ZIP: ads-docs.zip (Size: 84.7MB) / ads-docs-no-shots.zip (Size: 1.2MB)
  Getting Started
  Installation
  JDBC Drivers
   Oracle 8i
   Oracle 9i
   Oracle 10g
   DB2 7.2
   DB2 8.1
   DB2 9.0
   SQL Server
   Sybase ASE
   Sybase Anywhere
   Sybase IQ
   Informix
   PostgreSQL
   MySQL
  Memory Configuration
  Character sets
  Registering Servers
   MSDE 2000
   SQL Express 2005
   PostgreSQL SSL
  Application
   Application Menus
   Application Toolbar
   Browser and Scripting
   Visual Editing
   SQL History and Archive
   Shortcut Toolbar
   Key Mappings
   Key Mapping Assistant
   Custom Keymap Profiles
   Options
   Settings
   New Frame Window
   Details View
   Command Line
  Query Window
   Basics
   Toolbar
   Server Side Comments
   SQL Automation
   Aqua Commands
   Morph to Delimited List
   Results
   Save Results
   Auto-completion
   Popup Menu
   SQL Formatter
   Permissions
   Parameterized
   Pivot Results (Grid and Chart)
   Grid Results (Grid and Chart)
  Editors
   SQL Editor
   Text Editor
   HTML Editor
   XML Editor
   Regular Expressions
  Image Viewer
  Visual Explain Plan
   Basics
   Explain Plan
   Explain Diagram
   Whiteboard
  Procedure/Package Editor
  SQL Debugger
   Sybase Debugger
   Oracle Debugger
  Tools
   Table Data Editor
   Schema Script Generator
   Server Script Generator
   ER Diagram
   Query Builder
   Import Tool
   Export Tool
   Execution Monitor
   Object Search
  Compare Tools
   Schema Compare
   Tab Compare
   Directory Compare
   File Compare
   Copy History Compare
   Results Compare
  Oracle DBA Tools
   Instance Manager
   Storage Manager
   Rollback Manager
   Log Manager
   Security Manager
   Session Manager
   SGA Manager
   Server Statistics
  SQL Server DBA Tools
   Instance Manager
   Storage Manager
   Security Manager
   Session Manager
   SQL Agent Manager
  Sybase DBA Tools
   Instance Manager
   Storage Manager
   Security Manager
   Session Manager
  Source Control
   Subversion
   CVS
Registering Servers - PostgreSQL SSL

To enable SSL for PostgreSQL the user must import an SSL certificate into the keystore of the Java Virtual Machine that is being used to run Aqua Data Studio.

Create a quick self-signed certificate using the following OpenSSL command:

    openssl req -new -text -out server.req
            

Fill out the information that openssl asks for. The challenge password can be left blank. The program will generate a key that is passphrase protected; it will not accept a passphrase that is less than four characters long. To remove the passphrase (as you must if you want automatic start-up of the server), run the commands

    openssl rsa -in privkey.pem -out server.key
    rm privkey.pem
            

Enter the old passphrase to unlock the existing key. Now do

    openssl req -x509 -in server.req -text -key server.key -out server.crt
    chmod og-rwx server.key
            

to turn the certificate into a self-signed certificate and copy the key and certificate to the data directory of the server. Now convert the server.crt to a format java can import on the client:

    openssl x509 -in server.crt -out server.crt.der -outform der
            

Now import the cert into the java keystore:

keytool -keystore [your java home here]/lib/security/cacerts -alias
    [any name for the cert you like] -import -file server.crt.der
            

enter the password for the cacerts keystore (default is 'changeit'). Say yes to trust this cert.

Make sure your Aqua Data Studio instance knows which keystore to use for the SSL connection by adding to the startup script the parameter -Djavax.net.ssl.trustStore=<JAVA_HOME>\lib\cacerts

Windows: (Executable) - Modify the [ADS_INSTALL]\datastudio.cfg
 - Add to the beginning of the 3rd line "-Djavax.net.ssl.trustStore=<JAVA_HOME>\lib\cacerts"

Windows: (Batch) - Modify the [ADS_INSTALL]\datastudio.bat or datastudio-bundled.bat
 - Last line should execute java with the parameter between "java" and "-cp" such as ...
"java -Djavax.net.ssl.trustStore=<JAVA_HOME>\lib\cacerts -cp"

OSX: - Modify /Aqua Data Studio/Contents/Info.plist

> ..
> 
>    <key>VMOptions</key>
>
> <string>-Djavax.net.ssl.trustStore=/Library/Java/Home/lib/security/cacerts
> -Xmx256m</string>
>     <key>MainClass</key>
>     <string>com.aquafold.datastudio.DataStudio</string>
> ...
Unix: (Script)
 - Last line should execute java with the parameter between "java" and "-cp" such as ...
"java -Djavax.net.ssl.trustStore=<JAVA_HOME>\lib\cacerts -cp"


To use SSL in Aqua Data Studio, you must add the option "?ssl=true" in the "Driver Param:" in the Advanced Tab of a Server Registration.

Home Screenshots Downloads Documentation Support Licensing Contact Copyright© 2001-2007 AquaFold, Inc. All Rights Reserved