Connecting to HSQLDB using DBVisualizer

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

The purpose of this guide is to walk you through connecting to Bamboo's embedded Hypersonic SQL Database using the Database Administration tool DBVisualizer.

Below are step by step instructions on how to Configure DBVisualizer and connect it to HSQLDB.

Solution

Prerequisites

  1. Download and install the latest copy of DBVisualizer.

  2. You will also need to download a copy (preferably the latest version) of HSQLDB

  3. Extract the contents of the HSQLDB archive

  4. Ensure that Bamboo is not running.

Connection Procedure

Please ensure that you read and follow the instructions below carefully.

Remember to backup your <Bamboo-home>/database folder before attempting any modifications

1. Enter Connection Name

(Auto-migrated image: description temporarily unavailable)
  1. Click on the icon highlighted in Red

  2. Enter an identifiable name for the connection. e.g. conf2.5.4-std

2. Select JDBC Driver

(Auto-migrated image: description temporarily unavailable)
  1. From the drop down list select HSQLDB Embedded

  2. Click on Load Driver Files

  3. Browse to directory where the HSQLDB.jar file is located. Bamboo bundles this and it can be found at <Bamboo-installation>/Bamboo/webapp/WEB-INF/lib/hsqldb-*.jar.

3. Select Database Path

  1. Browse to your <Bamboo-Home> directory

  2. Open the Database folder

  3. Select the defaultdb.properties file

4. Enter Connection Details

(Auto-migrated image: description temporarily unavailable)
  1. Remove the ".properties" from the end of defaultdb

  2. Type in sa for the username

  3. Leave the password field blank

refer to the example screenshot above if you are unsure

5. Connect to embedded Database

(Auto-migrated image: description temporarily unavailable)
  1. Click on Test Connection to verify that the details are correct.

  2. Click on "Finish" to complete the setup

  3. Select the connection from the list on the left hand side.

  4. You can now click on "Connect" to connect to the embedded database.

HSQL database manager

Alternatively, you can use HSQLDB's database manager. Just copy the value of hibernate.connection.url in Bamboo.cfg.xml as the URL and you're good to go.

Related Topics

Universal SQL client Squirrel

HSQL

Updated on April 16, 2025

Still need help?

The Atlassian Community is here for you.