******************************************************************************************
INSTALL

first:  do not try to extract this tar file on windows (you will get various errors!)
        instead copy it to the ipcop machine by doing the following:

- enable ssh   on your ipcop machine through the admin web pages (needed for file transfer)
- enable squid on your ipcop machine through the admin web pages (needed for privoxy to work)

- copy the package to the ipcop firewall, 
  you will need a ssh client on windows in order to do this, putty served me quite well, 
  so you might give it a try (http://www.chiark.greenend.org.uk/~sgtatham/putty/)
  after installing putty, you can use the following command to transfer your package to your 
  ipcop machine into the /root directory:
  pscp -P 222 <package_name> root@<youripaddress>:/root
  example   pscp -P 222 copfilter-0.0.92.tgz root@1.1.1.1:/root

  or you might use winscp http://winscp.sourceforge.net/eng/   a graphical SCP tool for windows
  to copy the file to the ipcop machine, the GUI is pretty nice and easy to use


- login to the ipcop machine with an ssh client (like putty)

- if you are updating, first uninstall the old version:
  everything which was copfilter related will be deleted without confirmation, 
  backup any files you changed before uninstalling!
  /var/log/copfilter//default/uninstall.sh

- extract the package on your ipcop machine:
  cd /root
  tar xzvf copfilter-0.0.92.tgz

- install the package
  ./setup.sh           (this actually executes install.sh)

- configure the package
  open the IPCop web configuration interface with a browser and go to Services/Copfilter
  most important: enter your email address and your smtp host
  also configure the automatic virus signature update intervall
  enable the services you want to use and click on "save"

- increase pop3 timeout on your email client 
  this is extremly important, especially on a slow internet connection, otherwise your email 
  client will get a timeout if you try to download a email with a huge attachment. 
  this can be configured in the pop3 settings of your email account, if could send me 
  a detailed explantion on how this can be done on mozilla,netscape,evolution,outlook i'd 
  be glad to include it in this documentation
  read the FAQ for a more detailed explanation

- if you are a home user, you could also install the fprot virus scanner (free for home use) 
  so that your email will be scanned by 2 different virus scanners which increases security 
  this package only includes clamav virusscanner 
  you can install fprot with the included installation script: 

  /root/copfilter/install_f-prot.sh     
      this example tries to download the files automatically, 
      you need a working internet connection for this to work 

  or

  /root/copfilter/install_f-prot.sh fp-linux-ws-4.3.3.tar.gz
      does not need an internet connection
      file has to be downloaded manually

  home      users please read http://www.f-prot.com/products/home_use/linux/
  corporate users please read http://www.f-prot.com/products/corporate_users/unix/index.html

  after installing fprot, enable it in the webgui (an additional checkbox will appear)

******************************************************************************************
TESTING



execute /root/copfilter/tests/make_all_tests.sh for all debug tests, 


this will send you
+ an email with a (harmless) exe attachment (to test renattach)
+ an email with a (harmless) virus attachment (to test virus scanner)
+ an email containing spam (to test spamassassin)
+ an email with the current clamav virus signatures
+ an email with the current fprot virus signatures (only if installed)


- this will only work if you entered your email address and smtp server in the webgui like describe above
- read the TESTING file for more details