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 Classic Server 2.0
	- Firebird Super Server 2.0
	- For Firebird 1.5 support, you can choose the respective option
	  during installation, however please note it has not been tested
	  thoroughly.

1. Installation of the Firebird Server

    - 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 of the AVG Admin Server

   2.1 Download the latest avgadmsrv-8.5.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-8.5.x.i386.tar.gz
	     
       - Switch to the avgadmsrv directory
       $ cd avgadmsrv-8.5.x
   
       - Start the interactive installation script as root
       # ./install.sh

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

    - 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. Configuration of the AVG Admin Server

   - Please see the /opt/avg/avgadmsrv/etc/avgadmsrv.conf configuration file.

5. 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.

6. License

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

7. Before starting AVG Admin Server

   - Please check the access rights for the avgdb.fdb file. The Firebird Server
     must have read/write access to the avgdb.fdb database.

8. Quick test

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

   - 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.

