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


1. Installation

   1.1 Admin Server is running, status page is loaded, but it is empty.
       Log message: Parsing of license failed (error code 0xE0010402)

       Check license. You probably forgot to register Admin Server:
       # avgadmsrv -r <LICENSE NUMBER>


2. Re-installation

   2.1 Admin Server is running, status page cannot be loaded.
       Log message: Parsing of license failed (error code 0xE0010404)

       Admin Server licensing has changed from previous version. 
       Please re-register Admin Server:
       # avgadmsrv -r <LICENSE NUMBER>


3. Database connection 

   3.1 Admin Server and Firebird Server are running, but connection to Admin's 
       database failed.
       Log message: Cannot acquire database connection - pool is not connected

       Check if your Firebird Server version is 2.0 or higher.
       Check if the following options are set correctly: 
          ConnectionString, DBAUserName, DBAPassword  in avgadmsrv.conf file.
       Check firebird.log
       Try connecting via isql to Admin's database:
       # /opt/firebird/bin/isql -u SYSDBA -p masterkey
       CONNECT /opt/avg/avgadmsrv/var/db/avgdb.fdb
   

4. Init scripts

   4.1 Admin Server is launched via init scripts under root user (instead of 
       specifed user), "This account is currently not available" or "No shell"
       message appears in console.

       If launching under specified user fails, Admin Server is launched 
       under root user. On some old distributions, "su" command requires  
       user's login shell, and ignores "-m" or "-s /bin/sh" options. 
       If you want to run Admin Server under specifed user, add the respective
       login shell for this user to /etc/passwd instead of "/sbin/nologin".

   4.2 Status check reports: "avgadmsrv dead but subsys locked".

       This happens when Admin Server is correctly launched via init script, 
       and correctly ended otherwise. It can be killed by signal, or go down
       because of invalid license or settings.

   4.3 Status check reports: "avgadmsrv dead but pidfile exists".

       Admin server crashed, or was killed by SIGKILL signal.
       

5. Windows/Linux compatibility

   5.1 Database file.

       Since version 9.0, Linux Admin Server has not stored binary data (such 
       as firewall configuration) in UNICODE encoding, like Windows Admin Server
       does. For this reason, changing database file between Admin Server for 
       Windows and Linux is forbidden. The correct way to do this is to use 
       export, import database.

       This also solves the difference between encoding strings stored in the 
       database on Windows Admin Server, and on Linux Admin Server (cp1250,... 
       vs UTF-8).


6. Network services

   6.1 How to configure firewall.

       The following table describes the default ports used for communication 
       between AVG products and related services. Most of these ports can be 
       changed in config settings.

       TCP 80   - Update proxy         AVG Admin Server  ->  AVG update server
       TCP 4158 - basic communication  AVG Admin Server  <-  AVG station, AVG Admin console
       TCP 6051 - communication        AVG Admin Server  ->  AVG station
       TCP 6054 - communication        AVG Admin Server  ->  AVG Admin console 

       TCP 25   - SMTP                 AVG Admin Server  ->  SMTP server
       TCP 3050 - database connection  AVG Admin Server  ->  Firebird server
       Ping     - availability test    AVG Admin console ->  AVG station

       When port 6054 is in use, a higher number is used. 

       For more detailed information, see the adminguide_en.pdf documentation in 
       AVG Admin Server for windows.


7. Database deployment

   7.1 Upgrade of database failed during importing of database from files 
       exported by Linux Admin Server in version 8.5.

       Please remove files AVG_DefDatabase.dct and AVG_DefTables.dct from 
       exported files and try it again. This files contains metadata which 
       should not be imported.
