Database Server Not Found

Modified on Sat, 25 Jul at 11:57 PM

Overview

A new installation or upgrade may report that it completed successfully, but the QQube Configuration Tool then displays a database server error:

QQube database server not found message

Possible Causes

QQube was installed or upgraded under the wrong Windows user or without full machine-level administrative rights.
Database settings from a previous installation are missing or damaged.

Resolution 1: Correct the Windows User and Permissions

Installation requirements

QQube must be installed or upgraded while logged in as the same Windows user under which it was originally installed.

That user must have full administrative rights to the computer during the installation. Selecting Run as administrator from another Windows user does not satisfy this requirement.

If the update was installed under the wrong Windows user:

Log in to the Windows user that performed the incorrect installation.
Uninstall QQube from that user.
Log in as the Windows user under which QQube was originally installed.
Confirm that the user has full administrative rights to the computer.
Install QQube again.

Resolution 2: Restore the Database Settings

After closing the initial error message, the database administration window may appear with a missing Engine Name, missing Database Path, and a stopped database service:

QQube database administration window with missing settings

1. Restore the Database Path

Select the browse button to the right of Database Path.

Locate the current QQube database file. It may be named qqube.db, qqube1.db, qqube2.db, or similarly. Use the file modification date to identify the current database.

Selecting the current QQube database file

Advanced recovery procedure

The next step uses Windows Registry Editor. Change only the value described below. Incorrect registry changes can affect Windows or installed applications.

2. Recover the Engine Name

Open regedit.exe and locate the registry section for the most recent previous QQube version.

QQube engine name in the Windows registry

Find the previous Engine Name value and enter it in the QQube database administration window exactly as shown. The engine name is case-sensitive.

3. Start the Database

Select Start Database to save the restored settings and start the QQube database.

4. Reopen the QQube Configuration Tool

You may receive the following message when closing the database administration window:

QQube message after restoring the database settings

Close the message and open the QQube Configuration Tool again.

Expected Result

The QQube Configuration Tool should open normally and connect to the restored database without displaying the database server error.