Installing

There are two ways to install DbVisualizer, using an Installer or extracting from an archive file.

Installing with a Setup Installer

To install DbVisualizer, just execute the Installer you have downloaded and follow the instructions in the screens. The setup installer optionally creates a desktop shortcut used to launch DbVisualizer which is not the case for the other installers below.

Installation from an archive file

ZIP archives (Windows)

Unpack the distribution file with the built-in zip archive extraction utility in Windows.

The ZIP archive installer will not add any entries to the Start menu, add desktop launchers or register the software in the Windows registry. Start DbVisualizer by runningDbVisualizer\dbvis.

To uninstall, simply delete the DbVisualizer directory.

DMG archives (macOS)

Open the installer file:

open dbvis_macos_<version>.dmg

In the mount window drag the DbVisualizer.app to the Applications folder.

To uninstall, remove /Applications/DbVisualizer.app.

TGZ archives (macOS)

Open the installer file:

open dbvis_macos_<version>.tgz

A DbVisualizer.app directory is created in the same directory. Start DbVisualizer:

open DbVisualizer.app

To uninstall DbVisualizer installed via a TGZ archive, simply delete the DbVisualizer.app directory.

TAR.GZ archives (Linux)

All files are contained in an enclosing folder namedDbVisualizer.

Unpack the distribution file in a terminal window with:

tar xvfz dbvis_linux_<version>.tar.gz

Start DbVisualizer by executing the command:

sh DbVisualizer/dbvis.sh

To uninstall DbVisualizer installed via a TAR archive, simply delete the complete DbVisualizer directory.

RPM archives (Linux)

Install the RPM package with:

sudo rpm -i dbvis_linux-<version>.rpm

Start DbVisualizer by either finding the application and double-clicking on its icon or by executing the dbvis command in a shell.

To uninstall DbVisualizer installed via an RPM archive, run:

sudo rpm -e dbvis

DEB archives (Linux)

Install the package with the following command in a terminal window (or use your favorite package manager):

sudo dpkg -i dbvis_linux_<version>.deb

Start DbVisualizer by either finding the application and double-clicking on its icon or by executing thedbvis command in a shell.

To uninstall DbVisualizer installed via an DEB archive, run sudo dpkg --remove dbvis.

Silent Install

In order to start a silent installation, the installer has to be invoked with the -q argument. The installer will perform the installation as if the user had accepted all default settings.

There is no user interaction on the terminal. The installer will install the application to the default installation directory, unless you pass the -dir parameter to the installer. The parameter after -dir must be the desired installation directory. Example:

dbvis_windows-x64_<version>_jre.exe -q -dir "d:\myapps\DbVisualizer"

The output of the installer is not printed to the command line for silent installation. If you pass the -console parameter after the -q parameter, a console will be allocated that displays the output to the user. This is useful for debugging purposes.

If the installation was successful, the exit code of the installer will be 0, if no suitable JRE could be found it will be 83, for other types of failure it will be 1.

For more options check the command line options for the installer.

See the following for examples on respective operating system.

Windows

dbvis_windows-x64_<version>_jre.exe -q -console
echo %errorlevel%

macOS

DbVisualizer Installer.app/Contents/MacOS/JavaApplicationStub -q -console
echo $?

Linux

dbvis_linux_<version>.sh -q -console
echo $?

The -console argument may be used for debugging purposes. The echo command verifies the exit code from the installer which may be useful if automating the installation.

Upgrading

When upgrading DbVisualizer from one major version to a new major version, user settings for the old version of DbVisualizer are migrated for use with the new version.