/
Using Dbvcontrol Webconsole

Using Dbvcontrol Webconsole

This page describes only generic usage dbvcontrol webserver GUI for all database platforms. If you require information for specific task for specific database platform, check relevant dedicated Documentation section. For example for how to execute Oracle Graceful Switchover from dbvcontrol, check the Oracle specific documentation.

1. First Login

To use dbvcontrol webserver interface, you will need to enter following URL into your browser:

https://<hostname>:4433

Use the hostname or IP of the host where you installed dbvcontrol component and make sure to check dbvcontrol is up and running on that host:

Installation

Starting and Stopping Dbvisit StandbyMP

You will be able to see login page similar to this one:

image-20250304-092612.png

Default username: admin

Default password: admin

When logged in for the first time or when no configuration exists, you will be directed to the New Configuration page:

image-20250304-092818.png

From which you can proceed.

dbvagentmanagers which you install will connect to the dbvcontrol automatically, there’s no need to “add” the hosts. If you can’t see the host when creating configruation, it either means that dbvagentmanager is not running on that particular host or that there are communication issues.

2. Dbvcontrol options

When using dbvcontrol you can use following options:

image-20250304-093332.png

DASHBOARD

Provides you with an overview of all of your current configurations and enables you to perform various actions

NEW CONFIGURATION

Start a guided process to create Oracle, SQL Server or Postgres configuration

SQL SERVER INSTANCES

Provides interface to add, edit or remove SQL Server instances. This is described in more detail in SQL Server Guide

USERS

You can add users and modify their roles to dbvcontrol. User are local users only, there’s no interface with AD or LDAP authentication

TASKS & EVENTS

provides comprehensive task overview with filtering based on configuration

SETTINGS

User can enable various options for dbvcontrol such as laguage and amount of tasks displayed

LOGOUT

logs user out

3. Dashboard

Dashboard provides you with complete overview of your configurations, enables you to view the current status and gives you possibility to perform various actions. All three database platforms share same GUI concept, but there are minor differences of each platform.

You are able to control and see configurations of all three database platform in single Dashboard.

The dashboard contains full set of information about your DR configurations, current warnings / alerts and an overview of recent tasks.

image-20250304-110220.png

Explanation of the whole dashboard:

Picture Number

Name

Explanation

Picture Number

Name

Explanation

1

ACTIONS Pane Button

When user mouseovers next to configuration name, ACTION pane button becomes visible.

2

DDC (Dbvisit Database Configuration Name)

DDC name which specified when creating the configuration. Used for dbvcli and dbvctl command line tools.

3 + 4

Primary and Standby Database Status

Current status of primary and standby database. See below for more details

5

Tasks

summary of latest taks. Tasks can have status “Completed Successfully” (Green), “Completed with error” (Red), “Pending” (Blue)

6

Feature Status

Summary of currently enabled and disabled features

7

SQL Server Instance Pair

SQL Server only - DDCs for SQL Server are grouped by instance pair on the dashboard.

8

Quick Database Platform Filter

quick filter enablig users to display DDCs for particular database platform only

9

Detailed Filter

using detailed filter, users can filter by hostnames, standby database state etc ..

10

Dbvcontrol version

Displays current dbvcontrol version.

3.1 ACTIONS Pane

Actions pane becomes visible after clicking on ACTIONS button and is specific to selected DDC:

image-20250304-110625.png

The DDC Name (1) specifies for which DDC the available actions (2) will be performed. User can also view & change licensing information (3)

Note that the visible actions are by default limited and defined by current primary and standby database status and also by DDC status. So for example if primary database is down, option to backup & send logs will not be visible. To see complete list of actions including unavailable one, toggle the eye icon (4). Note that you will still be unable to perform the actions:

image-20250304-110926.png

3.2 Database Status

Database status displays the actual status of databases. Some database statuses are shared among all 3 platforms, some statuses are specific to certain database platform.

The database roles positions are fixed: source on the left, standby on the right. If databases would switch roles, the server names will be changed, but the source will be always in the left column.

The possible statuses databases can have are:

Statuses Shared among all platforms

ERROR

Dbvagentmanager on the host is unreachable or cannot retrieve database status. Any actions pefrormed in GUI will skip unreachable agent

ONLINE

Oracle, SQL Server or Postgres database in Read-Write mode

OFFLINE

Oracle, SQL Server or Postgresql database when shut down

READ ONLY

Oracle, SQL Server or Postgresql database in Read-Only mode

UNKNOWN

Oracle, SQL Server or Postgres database in undeterminable mode

Oracle Specific Statuses

RECOVERING

Oracle Database with Standby Controlfile in MOUNT mode

MOUNT

Oracle Database with Primary Controlfile in MOUNT mode

STARTED NOMOUNT

Oracle Database in NOMOUNT mode

SQL Server Specific Statuses

RESTORING

SQL Server Database in Restoring state

Postrgesql Specific Statuses

HOT STANDBY

Postgresql Streaming or Wal Archiving Target Database in Hot Standby mode

WARM STANDBY

Postgresql Streaming or Wal Archiving Target Database in Warm Standby mode

3.3 Feature Status

Status icons indicate whether various feature are enabled or not for specific configuration. The status icons are grey (not enabled) or blue (enabled):

image-20250304-100550.png

DR Readiness Score

Counts amount of DR features which are used for specific DDC. The more features used (for example apply delay, notifications … ) the higher the score

image-20250304-100550.png

DR Readiness Score

Counts amount of DR features which are used for specific DDC. The more features used (for example apply delay, notifications … ) the higher the score

image-20250304-100636.png

Automated Standby Update

Indicates whether Automated Standby update (ASU) is active

image-20250304-100659.png

Standby Log Application Delay

Indicates whether Standby Log application delay is active

image-20250304-100714.png

Observer Active

Indicates whether observer is active

image-20250304-100722.png

Mail Settings Provided and Mail notifications

Indicates whether email settings were provided and whether the email notification are enabled

image-20250304-100911.png

Standby Read Only Schedule (SQL Server only)

Indicates if there is read-only schedule active for the SQL Server configuration

image-20250304-100540.png

Error / Warning

Error, but can be also yellow icon (Warning). Indicates a minor error which needs to be addressed

image-20250304-103316.png

Number of databases in cluster (Postgresql only)

Indicates the total number of databases are in pgsql primary cluster

There’s always tooltip available with detailed onformation on mouse-over.

3.4 Tasks Pane

If ACTIONS pane is not opened for any DDC, the list of tasks and events will be visible on the right side of the Dashboard. The tasks provide at first glance overview whether the task was successful. Clicking on the task will bring up detailed information:

image-20250304-114012.png
image-20250304-114107.png

It is possible to delete the task and therefore hide it after clicking on “Hide Task” (1)

Clicking on Hide Task for running/pending Task will not cancel its processing

Events share the pane with tasks. Events can be of various origin: dbvagentmanager, observer and database. Events can be:

  • ongoing errors (red)

  • ongoing warnings (yellow)

  • cleared (green)

  • Inactive (greyed-out)

The event is cleared only in case the next check for failed metric is successful. Events can’t be manually cleared.

Notifications are sent only for some event types

3.5 Sorting and Filtering

User can sort & filter based on database platform by selecting the appropriate tab (1):

image-20250304-115414.png

Or you can bring up more complex filtering pop-up window (2):

image-20250304-115452.png

In this case, you can filter displayed DDC configurations based on various criteria and also sort.

3.6 Multiple Configurations Actions

To ease up most frequent administraion tasks, there is a possibility to perform same actions on multiple configurations. This is possible across database platforms, but only some actions can be performed this way. Available Multiple Configuration Actions are:

Oracle

SQL Server

Postrgresql

Oracle

SQL Server

Postrgresql

Setup Disaster Recovery

Setup Disaster Recovery

Setup Disaster Recovery

Backup and Apply Logs

Backup and Apply Logs

Graceful Switchover

Graceful Switchover

Graceful Switchover

Activate Standby

Activate Standby

Activate Standby

Remove Configuration

Remove Configuration

Remove Configuration

 

Automated Standby Update

Automated Standby Update

 

Standby Update Delay

Standby Update Delay

 

To perform Multiple Configuration Actions, first select all DDCs you want to perform specific action on:

image-20250304-120630.png

Once you select at least two DDCs (1,2) you will be able to see “Open Multiple Configurations Actions” (3). You can cancel the select by clicking on (4) or (5)

image-20250304-120856.png

After clicking the Open Multiple Configuration Actions, you will be able to perform specific action for all selected DDCs:

image-20250304-121014.png

Modifying Automated Standby, Standby Update Delay and Observer update will overwrite all selected DDCs with specified values.

4. Users

In Users section, new users can be added and it is possible to modify existing and Admin user properties including password.

image-20250307-081645.png

Each user has property “Email” which only servers as contact address for the user and has no other than informational purpose (for example it is not used in monitoring)

Changing the password for admin user is done by entering the password and clicking save (leave blank to keep current password):

image-20250307-085217.png

it is not possible to remove or change role of admin user

When Adding a new user it is possible to choose from three roles:

image-20250307-085308.png

Administrator: same privileges as default “admin” user. Privileges are unrestricted.

Monitor: user is able to perform only actions related to monitoring (read-only), rest of the actions are unavailable. For example:

image-20250307-083137.png

Some read-write actions (such as Start/Stop Database in this example screenshot) serve only for checking status or viewing current settings. Any change or modification is not possible.

Operator: same privileges as default “admin” user, except:

  • adding and modifying dbvcontrol users

  • modifying dbvcontrol settings

  • removing DDC configurations from dashboard

  • adding SQL Server instances

5. Tasks & Events

This section is an extension of the Tasks & event pane in the dashboard and here you can view complete list of tasks & event while also being able to filter according to entity/task type as well as configuration name:

image-20250307-090658.png

6. Settings

Dbvcontrol settings will allow you to disable DR Readiness Score (1) (visible in the dashboard for each DDC), number of stored Events (2), number of stored Tasks (3) and language (4):

image-20250307-102830.png

Available Laguages are:

  • Chinese (Simplified)

  • Chinese (Traditional)

  • French

  • English (default laguage)

  • Japanese

  • Spanish

If you change language, you will be logged out.

Related content