Home Home Screenshots Download Documentation Contact Licensing Licensing

Documentation: Aqua Data Studio 6.0 - New Features     HTML Documentation download, ZIP: ads-docs.zip (Size: 20MB) / ads-docs-no-shots.zip (Size: 368KB)
  Getting Started
  Installation
  JDBC Drivers
  I. Oracle
  II. DB2 UDB
  III. SQL Server
  IV. Sybase ASE
  V. Sybase Anywhere
  VI. Sybase IQ
  VII. Informix
  VIII. PostgreSQL
  IX. MySQL
  Memory Configuration
  Character sets
  Registering Servers
  I. MSDE 2000
  II. SQL Express 2005
  III. PostgreSQL SSL
  Application
  I. Browser and Scripting
  II. Visual Editing
  III. SQL History
  IV. Shortcut Toolbar
  V. Key Mappings
  VI. Custom Keymap Profiles
  VII. Options
  VIII. Settings
  Query Window
  I. Basics
  II. Toolbar
  III. Server Side Comments
  IV. SQL Automation
  V. Variable Binding
  VI. Results
  VII. Save Results
  VIII. Auto-completion
  IX. SQL Formatter
  X. Permissions
  XI. Parameterized
  Editors
  I. SQL Editor
  II. Text Editor
  III. HTML Editor
  IV. XML Editor
  V. Regular Expressions
  Image Viewer
  Visual Explain Plan
  I. Basics
  II. Explain Plan
  III. Explain Diagram
  IV. Whiteboard
  Procedure/Package Editor
  Tools
  I. Table Data Editor
  II. Script Generator
  III. ER Diagram
  IV. Query Builder
  V. Import Tool
  VI. Export Tool
  VII. Execution Monitor
  Difference Tools
  I. Schema Diff
  II. Tab Diff
  III. Directory Diff
  IV. File Diff
  V. Copy History Diff
  Oracle DBA Tools
  I. Instance Manager
  II. Storage Manager
  III. Rollback Manager
  IV. Log Manager
  V. Security Manager
  VI. Session Manager
  VII. SGA Manager
  VIII. Server Statistics
  SQL Server DBA Tools
  I. Instance Manager
  II. Storage Manager
  III. Security Manager
  IV. Session Manager
  V. SQL Agent Manager
  Sybase DBA Tools
  I. Instance Manager
  II. Storage Manager
  III. Security Manager
  IV. Session Manager

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 programm 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-2006 AquaFold, Inc. All Rights Reserved