Dbvagent

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

========================================
DESCRIPTION: Dbvagent
========================================
The Dbvisit Agent (Dbvagent) is one of the core components used
by Dbvisit Standby version 8.  The agent is the gateway between 
the Dbvisit Standby Central Console (Dbvserver) and the Dbvisit 
Standby Core (Commang Line Interface).  Each database server 
must have the agent installed and running before using the Central 
Console.  

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) must already exist
        and be owned by the Oracle Database software owner ("oracle" on most UNIX based systems)
    2)  The default port used by the Dbvisit Agent is 7891.  This port may be changed on installaion
        or later by editing the dbvagnet configuration file located in DBVISIT_BASE/dbvagent/conf 
        It is important to make sure the port used by the Dbvisit Agent 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 Agent (dbvagent) is done as part of the 
        Dbvisit Standby Core Package installation.  The high level steps for installing the 
        core package (which include the agent) are:
        - 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 5 from the main menu (Installing the Core Packages - Dbvnet, Dbvagent and Standby Core)
        - Once the installation is complete which only takes a few seconds on most systems, 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 Agent - Dbvagent can be started with the following command:
        cd /usr/dbvisit/dbvagent
        ./dbvagent -d start
        
    3)  Stopping the agent is done using the following commands:
        cd /usr/dbvisit/dbvagent
        ./dbvagent -d stop
        
    4)  Default Configuration file used is located in ../dbvisit/dbvagent/conf/dbvagent.conf

    5)  Log files are located in ../dbvisit/dbvagent/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.    

