***********************************************************
*** Installation                                        ***
***********************************************************

1)  Unpack the archive somewhere:
    $ tar xvf vdradmin-VERSION.tar.bz2
    $ cd vdradmin-VERSION

2)  If you want to run VDRAdmin using a language other than set on
    our system, then before running it you have to issue:
    $ export LANG="<language code>"

    Where <language code> has to be one of: de_DE, es_ES, fi_FI or fr_FR
    (en_GB is default).

3)  Check if your system provides all requirements and optionally install
    the missing Perl modules:
    $ ./install.sh -p

4)  Now you have to deside wether you want to run VDRAdmin locally (3a)
    in this directory or install it into your system (3b).

4a) run locally (=no installation)
    First you have to configure VDRAdmin. This only has to be done once.
    $ ./vdradmind.pl --config

    Some questions about the configuration will be asked.

    Now you're done and you can run VDRAdmin:
    $ ./vdradmind.pl

4b) install into system
    $ ./install.sh

    Now you have to configure VDRAdmin:
    $ vdradmind.pl --config

    Some questions about the configuration will asked.

    Now you're done and you can run VDRAdmin:
    $ vdradmind.pl

5)  If you want VDRAdmin to run automatically on system boot, you have
    to add a startup script to the wanted runlevel. Please consult your
    Linux distribution's documentation. Maybe you'll also find some help
    in VDRAdmin's "contrib" directory.
    Please also note that you might have to set the wanted language in
    that startup as shown in (2).

6)  No matter how you run VDRAdmin, you now can point your browser to
    the given parameters (e.g. http://localhost:8001).


***********************************************************
*** Removing VDRAdmin from your system                  ***
***********************************************************

1)  Uninstall depends on the kind of installation you did:

1a) run locally (=no installation)
    There is not much to do.
    Simply remove to folder VDRAdmin has been created while unpacking:
    $ rm -rf vdradmin-VERSION.tar.bz2

1b) installed to your system
    You need the unpacked VDRAdmin archive. Enter it and run uninstall.sh:
    $ cd vdradmin-VERSION.tar.bz2
    $ ./uninstall.sh

    You might want to delete your VDRAdmin's configuration files:
    $ rm -rf /etc/vdradmin

    This of course only works if you didn't change the default install
    locations! If you've change them you must call uninstall.sh with those
    locations.
    If you don't know what I'm talking about, you probably didn't change
    the default values ;)

2)  You're done!


***********************************************************
*** Hide VDRAdmin behind apache                         ***
***********************************************************

  you will need apache with mod_proxy and these lines in httpd.conf:

  <IfModule mod_proxy.c>
    ProxyRequests Off
    ProxyPass /vdradmin/ http://127.0.0.1:8001/
  </IfModule>


***********************************************************
*** Hint from Martin Neuditschko for apache2 (untested) ***
***********************************************************

  I have summarized the needed changes for my Apache (Apache2, SuSE 8.2):
  Following modules have to be activated additionally:
  proxy, html_proxy, rewrite

  Following has to be added to the httpd.conf:
  <VirtualHost *>
    RewriteEngine On
    RewriteRule ^/vdradmin(.*) http://localhost:8001$1 [P,L]
  </VirtualHost>


***********************************************************
*** See who's calling (you need an ISDN card for this)  ***
***********************************************************

  Insert this in your isdn.conf:

  [MSN]
  NUMBER = <yourmsn>
  START = {
    [FLAG]
    FLAGS = I|O|R
    PROGRAM = /path/to/vdradmind.pl --displaycall "Call from \$2"
  }

  Restart isdnlog.