Skip to content

Embedded Database Console

Darryl L. Pierce edited this page Jun 25, 2022 · 3 revisions

Overview

This page shows how to access the database console when running ComiXed. This feature is useful for viewing the embedded database at runtime. The H2 console allows an administrator to use their browser to run SQL queries on the database managed by ComiXed while the application is running.

CAUTION: You run the risk of adversely affect (IOW, breaking) your database if you use this feature to start changing data.

Proceed at your own risk.

Accessing The Console

Start With The Console Enabled

When you start ComiXed use the -C option to enable the H2 console, as follows:

For Mac Or Linux Users

$ ./run.sh -C

** For Windows Users**

C:\> run.bat -C

Connect To The Console

From your browser, navigate to http://localhost:7171/dbconsole (replace the hostname with the name of the server running ComiXed if necessary). You should see a screen similar to this:

Screen Shot 2022-06-25 at 8 22 50 AM

Leave the default username as sa and the password as blank. Click on Test Connection, which should return Test successful if all is working correctly.

Click on Connect to connect to the database console.

Using The Console

Once logged in, you should see a page similar to the following:

Screen Shot 2022-06-25 at 7 59 31 AM

From here you can execute any SQL queries against the contents of the database while the application is running, such as those to check the state of an import.

But, remember, as someone's famous uncle once said, "With great power comes great responsibility." Be very careful with what you do, you could potentially irreversibly break your database.

Clone this wiki locally