AVG Admin Server
----------------

This file describes how to install AVG Admin Server on GNU/Linux.

AVG Admin Server requires one of the following Firebird Servers:
	- Firebird Super Server 2.0 (recommended)
	- Firebird Classic Server 2.0

1. Installation of the Firebird Server

    - Example for Debian/Ubuntu:
    # apt-get install firebird2.0-super
    # dpkg-reconfigure firebird2.0-super

    - If your distribution does not contain one of the supported Firebird
      Servers, you can download and install a Firebird Server from the
      Firebird project webpage at
      http://sourceforge.net/project/showfiles.php?group_id=9028

    - If you want to create a special "firebird" user account for Admin Server 
      DataCenter database, use the following:
      /opt/firebird/bin/gsec -user SYSDBA -password masterkey -add <user> -pw <password>
      /opt/firebird/bin/gsec -user SYSDBA -password masterkey -display
      You will be asked for this user name and password later on, during Admin 
      Server installation.

    - If your Firebird Server is running under a user other than "firebird", 
      please do not forget to specify it during Admin Server installation.

2. Installation and configuration of the AVG Admin Server

   2.1 Download the latest avgadmsrv-9.0.x.i386.tar.gz installation package
       from http://www.avg.com.

   2.2 Install the AVG Admin Server
       - You do not need to uninstall the old version of Admin server (8.0 and 
         higher) if you have one; you will be asked to keep or replace the old  
         database and configuration file during installation. It is recommended 
         to backup these first.

       - Unpack the installation file
       $ tar xvzf avgadmsrv-9.0.x.i386.tar.gz
	     
       - Switch to the avgadmsrv directory
       $ cd avgadmsrv-9.0.x
   
       - Start the interactive installation script as root
       # ./install.sh

       - Main configuration is based on questions during installation, so 
         that after successful installation, Admin Server is ready to be 
         started by init scripts:
         # /etc/init.d/avgadmsrvd start

       - If you want to use some non-standard settings, like firebird server 
         listening on non-default port, please set it in the configuration file
         /opt/avg/avgadmsrv/etc/avgadmsrv.conf.
         It is loaded when Admin Server [re]starts. This configuration can be 
         also used as default for next reinstallation, if you choose so.

3. Manual upgrade of the AVG DataCenter database 
   (if not chosen to be done during installation, i.e. automatically)

    - copy your old database to the
       /opt/avg/avgadmsrv/var/db directory as avgdb.fdb

    - stop the AVG Admin Server
    # /etc/init.d/avgadmsrv stop 

    - get database version:
    $ avgadmsrv --versionDB

    - if your database version is 249 (beta build 269, 271), you need to run
      a small hotfix before you continue:
    $ avgadmsrv --executeSQLscript /opt/avg/avgadmsrv/var/db/scripts/FireBird_Scripts/ameh.guid.fix.sql

    - upgrade database:
    $ avgadmsrv --upgradeDB

    - check if the database version has changed successfully:
    $ avgadmsrv --versionDB

4. Security

   - The AVG Admin Server does not require root rights to run properly. It is
     recommended to run the AVG Admin Server under non-privileged user account.

5. License

   - You need a corresponding license to run the AVG Admin Server. Without
     registration, the AVG Admin Server will not work.

6. Quick test

   - Try to connect to the AVG Admin Server from an AVG client or from the
     AVG Admin Console.
	 
7. Troubleshooting

   - See FAQ file
   - Check the AVG Admin Server log file for error messages
   - Check the Firebird Server log file for error messages

For more information about AVG Remote Administration, please refer
to documentation at http://www.avg.com.

