Dbvserver

========================================
DBVISIT STANDBY USERS GUIDE
========================================
See http://www.dbvisit.com for the Dbvisit Standby Quick Start Guide.

========================================
DESCRIPTION: Dbvserver
========================================
The Dbvisit Central Console (Dbvserver) is the new web-based user interface of Dbvisit Standby.
It is recommended that Dbvserver be installed on its own server.  This may be using physical hardware
a Virtual Machine or even a Docker image (as long as persistent storage is used to store the repository)

During the installaiton of the Dbvisit Agent a passphrase is reqeusted
which is used to allow secure encrypted communication between the 
Central Console and the agent.

========================================
INSTALLATION AND UPGRADE INSTRUCTIONS
========================================

Prerequisites:
    1)  The Dbvisit Base directory (default is /usr/dbvisit) should already exist prior to starting the 
        installation.  The central console my be installed as any non super user (root).
        To keep it consistent using a username similar to the user on the Oracle Database software owner
        is recommended - example "oracle" on Unix based systems.
    2)  The default port used by the Dbvisit Central Console is 4433.  This port may be changed on installaion
        or later by editing the dbvserver configuration file located in DBVISIT_BASE/dbvserver/conf 
        It is important to make sure the port used by the Dbvisit Central Console is not blocked by any 
        firewall (this include the local firewall - IPTABLES or Firewalld or Windows Firewall)
    3)  Make note of the passphrase used by the Dbvisit Agent as this will be required by
        the Central Console to establish a secure connection.

Installation:
    1)  Installation of the Dbvisit Central Console (dbvserver) is similar to the installation of the 
        Dbvisit Standby Core components - with the exception that only the Dbvserver component is selected
        for installation.  It is possible to install the dbvserver component together with the other 
        core components on the database server, but this is not recommended.  One key reason for this is 
        if you have a disaster and the database server - example primary database server where dbvserver
        was installed - you will not have a central console available as the primary database server might
        not be accessible.  The recommended approach is to install dbvserver on its own small Virtual Server.
        In most configurations 1GB memory and 500MB of spare disk space should be suffucient.  
        The following high level steps can be followed to install the Central Console:
        - Download the latest Dbvisit Standby installer package from www.dbvisit.com
        - Copy the installer package to a temporary folder - example /home/oracle/8.0
        - Uncompress the installer package using "unzip <package-name>.zip"
        - Extract the installer archive using "tar <package-name>.tar"
        - Navigate to the dbvisit/installer sub directory extracted by the above commands
        - Start the Installer by executing the command "./install-dbvisit"
        - The first question will be to confirm the Dbvisit Base directory, this is the base destination 
          folder where the Dbvisit Standby software will be installed into.  The default and recommended
          folder is /usr/dbvisit (This folder must be pre-created and be owned by the Oracle Database 
          software owner - "oracle" in most cases)
        - Follow the installation menu selection to install the new components, which is 
          option 4 (dbvserver) from the main menu. 
        - Once the installation is complete which only takes a few seconds, exit the installer
        - You can now remove the installer package - example remove the /home/oracle/8.0 folder from
          where the installer was executed.
    		        
    2)  The Dbvisit Central Console - Dbvserver can be started with the following command:
        cd /usr/dbvisit/dbvserver
        ./dbvserver -d start
        
    3)  Stopping the dbvserver component is done using the following commands:
        cd /usr/dbvisit/dbvserver
        ./dbvserver -d stop
        
    4)  Default Configuration file used is located in ../dbvisit/dbvserver/conf/dbvserver.conf
        It is important to note that the Central Console does store information of tasks and users in its
        own repository which is also located in the dbvserver/conf sub directory.  This repository is small
        and may grow over time as tasks are performed.  

    5)  Log files are located in ../dbvisit/dbvserver/log/



========================================
CONTACT INFORMATION
========================================
Web:       http://www.dbvisit.com
Support:   http://support.dbvisit.com
Resources: http://www.dbvisit.com/support/resources/
========================================
COPYRIGHT AND TRADE MARKS
========================================

Dbvisit Software Limited 2016.
Dbvisit is a registered trade mark of Dbvisit Software Limited.
Oracle is a registered trade mark of Oracle Corporation.
Windows is a registered trade mark of Microsoft Corporation.
This product is not sold, but is licensed by Dbvisit Software Limited.    

