Introduction

Dbvserver is the Web server that provides the web interface to Dbvisit. This component is optional and only required if:

• Dbvisit Standby is configured and run through a web browser.
• Dbvisit Standby is to be scheduled using the built in web based scheduler (Dbvserver scheduler).

The default http port for Dbvserver is 8081 and for https it is 8443.

The default username and password is admin

Dbvserver should be running on all primary and standby servers, if not used, Dbvserver can be shutdown.  It is important that DBVNET is running on all nodes.

Supported Platforms

Starting Dbvserver on Linux/Unix

Dbvserver can be started on Linux/Unix as follows. Dbvserver will start in the background and the session can be exited.

/usr/local/dbvisit> dbvserverd 
/usr/local/dbvisit> exit

Some erroneous messages may appear on the console if the session is not exited. This is normal.

Stopping Dbvserver on Linux/Unix

Dbvserver can be stopped on Linux/Unix by killing the dbvserverd processes or by running the following command:

/usr/local/dbvisit> dbvserverd stop

Starting and stopping Dbvserver on Windows

Dbvserver on Windows is a Windows service, which can be started, and stopped as a regular Windows service. 

The Dbvserver service logs on as the Oracle windows account user.

Managing the Dbvserver service on Windows

The Dbvserver service can be managed using the dbvisit_install_win32 executable.

Start the Dbvisit Standby Command Console and change directory to the Dbvserver\bin directory.

To delete or remove the service

C:\Program Files (x86)\Dbvisit\installer> dbvisit_install_win32 delete

To create the service, the path to the dbvserverd.exe is required, also the Oracle account owner and the password.

C:\Program Files (x86)\Dbvisit\installer> dbvisit_install_win32 create "c:\program files (x86)\dbvisit" oracle passwd

To show service

C:\Program Files (x86)\Dbvisit\installer> dbvisit_install_win32 show

For help

C:\Program Files (x86)\Dbvisit\installer> dbvisit_install_win32

Dbvserver directories

Dbvserver includes the following directories under the main dbvserver directory

• log. This contains the log files for:
• Dbvserver log files.
• Scheduler log files.
• Http access log files.
• Optional debug log files.
• etc. This contains the following files:
  
  • dbvserver.conf, which is the configuration file for Dbvserver.
  • scheduler.conf, which is the configuration file for the scheduler.
  • init.d directory, which contains the init.d templates to auto start Dbvserver at boot time.
• tmp. Temporary directory used by Dbvserver.

Backing up Dbvserver configuration files

A backup of the Dbvserver configuration files can be made by backing up the /etc folder. This will ensure there is a backup of the

• dbvserver.conf, which is the configuration file for Dbvserver.
• scheduler.conf, which is the configuration file for the scheduler.
• init.d directory, which contains the init.d templates to auto start Dbvserver at boot time.

Dbvserver scheduler

Dbvisit Standby needs to be scheduled on the primary server and the standby server. Please see 

Auto start Dbvserver at boot

If Dbvserver is used, then it is recommended to auto start the Dbvserver process at boot.
On Windows, this can be done by setting the Startup Type on the Dbvserver service to automatic:

On Unix/Linux this can be done by creating an init.d script to auto start Dbvserver at boot time. Example template init.d files can be found in:

/usr/local/dbvisit/dbvserver/etc/init.d

An example init.d script for redhat is:

# Source function library.

. /etc/init.d/functions

DBVISIT=/usr/local/dbvisit

DBVSERVERD=$DBVISIT/dbvserverd

PIDFILE=$DBVISIT/dbvserver/tmp/dbvserverd.pid

PATH=/usr/bin:/bin:/usr/sbin:/sbin

RETVAL=0

prog="dbvserverd"

start() {

    # Check if already running

    echo -n $"Starting $prog: "

    sudo -u oracle $DBVSERVERD

    RETVAL=$?

    echo     return $RETVAL

}

stop() {    

    echo -n $"Stopping $prog: "

    if [ -f "$PIDFILE" ]; then

       killproc $DBVSERVERD

    fi

    RETVAL=$?

     echo

     return $RETVAL

     }

restart() {

    stop

    start

 } case "$1" in

start)

    start

    ;;

stop)

    stop

    ;;

restart)

    restart

    ;;

*)

    echo $"Usage: $0 {start|stop|restart}"

    exit 1

esac 

exit $? e

xit $RETVAL

Dbvserver configuration

The Dbvserver configuration is determined by the settings in the dbvserver.conf file which is located in the etc or conf directory.
This configuration file can be edited manually or updated through the web-based interface by going to the Settings page.

The settings page should also be used to update the default password.

Whenever a change is made in the configuration, Dbvserver has to be restarted to read the new config file. 

Parameters can be turned off by commenting them out. 

Dbvserver Configuration Parameters

Dbvserver debugging

Dbvserver debugging can be turned on by setting debug = 1 in the dbvserver.conf file.
The debug information will be written to the dbvserver file on the log directory.