                   BitDefender Antivirus Scanner for Unices
                   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

                                   INSTALL


                                                Copyright (c) 2014 BITDEFENDER

    This  document  contains  the  Install  and Uninstall instructions for
    BitDefender Antivirus Scanner for Unices.

  BitDefender Antivirus Scanner for Unices can be installed on  package  based
  Linux  distributions  (rpm  or deb) and tbz based FreeBSD versions, but also
  all the other distributions are supported, using  a  pseudo-package  system,
  with the same functionality of the others. These packages are built as bzip2
  compressed tars and include all  the  necessary  pre-install,  post-install,
  pre-remove  and  post-remove  scripts.  The  adequate package type should be
  installed according to the distribution.



CONTENTS
========
  1. System requirements
  2. Package naming convention
  3. Getting BitDefender Antivirus Scanner for Unices
  4. Test the package for integrity
  5. Install the package
  6. Uninstall



1. System requirements
======================

  Before installing BitDefender Antivirus Scanner for Unices, you must  verify
  that your system meets the following system requirements.


1.1. Hardware system requirements
---------------------------------

 Processor type:
      x86  compatible,  minimum 166 MHz, but do not expect a great performance
      in this case. An i686 generation processor,  at  300MHz,  would  make  a
      better choice.

 Memory:
      The  minimum  accepted  value is 32MB, recommended is 64MB, for a better
      performance.

 Free disk space:
      The minimum free disk space to install  and  run  BitDefender  Antivirus
      Scanner  for  Unices  is  4MB.  But the log and the quarantine directory
      could require more space.

 Internet connection:
      Although BitDefender Antivirus Scanner  for  Unices  will  run  with  no
      Internet  connection,  the  update procedure will require an active HTTP
      link, even through some proxy server.  Therefore,  for  an  up  to  date
      protection, the Internet connection is a MUST.


1.2. Software system requirements
---------------------------------

 Linux requirements:
      The  Linux kernel should be 2.2, 2.4 or 2.6, the recommended one is 2.6,
      with support for a fast file system,  which  works  well  with  multiple
      small  files,  such  as  ext3 or reiserfs.  BitDefender requires 'glibc'
      version 2.3, at least, and 'libstdc++' from 'gcc 3.x' series.

 FreeBSD requirements:
      The  supported  FreeBSD  versions  are  5.3-RELEASE  and   greater   and
      6.0-RELEASE and greater.  FreeBSD 4 is no longer supported.



2. Package naming convention
============================

  BitDefender  Antivirus  Scanner  for Unices package is named considering the
  following scheme.


2.1. Linux convention
---------------------

 'BitDefender-scanner-{ver}.{os}.{arch}.{pkg}'
    -----------------------------------------------------------------------
    Variable       Description
    -----------------------------------------------------------------------
    '{ver}'        This is the package version. For example, 7.5-3 is
                   version 7, subversion 5, package build 3.

    '{os}'         The operating system is Linux.

    '{arch}'       The architecture contains the processor class and gcc
                   compiler version. i586 is the current development
                   version.

    '{pkg}'        This refers to the package management tool used to
                   install the files. This is one of 'rpm' , 'deb' or
                   'run' . 'rpm' uses the Red Hat Package Manager, 'deb'
                   uses the Debian package system and 'run' is a self-
                   extractable archive, the most portable method. Please
                   install the appropriate package for your system, as
                   described in the next chapters.
    -----------------------------------------------------------------------


2.2. FreeBSD convention
-----------------------

 'bitdefender-scanner-{ver}.tbz'
  Where  {ver}  is  the  package  version.  For  example,  7.5_3 is version 7,
  subversion 5, package build 3.



3. Getting BitDefender Antivirus Scanner for Unices
===================================================

  The package can be downloaded from BitDefender servers or it can be found on
  different  distribution  media,  such  as  CD-ROM.  When downloading for the
  BitDefender servers, you will be asked to  fill  in  a  form  and  you  will
  receive  an  email  to the address you have provided in this form. The email
  contains the download location.

  The Linux package come in three flavours.
    * 'rpm' for distributions using the RedHat Linux package management
    * 'deb' for distributions using Debian Linux packaging system
    * 'run' , a self-extractable archive, suited for any other distribution

  The FreeBSD package is a tbz (.tar.bz) compressed archive, adequate for  the
  versions 5 and 6.



4. Test the package for integrity
=================================

  Before  you  begin  the  installation  process we recommend you to check the
  installation kit is not corrupted (this can happen sometimes, especially  if
  you downloaded it).


4.1. Test the rpm and deb packages
----------------------------------

  For  an  increased security, the 'rpm' and 'deb' packages are GPG signed. To
  test the packages integrity, you can verify their signature.

  First, you  need  to  fetch  the  BitDefender  Packages  GPG  key  (key  id:
  '0x0EC4FE05') from a key server, running the following command.

  # gpg --recv 0x0EC4FE05 --keyserver http://pgp.mit.edu

  Then, export the key to a local file:

  # gpg --armor --export 0x0EC4FE05  > bd-pack.key

  For  the  rpm  packages, you have to import the key into rpm key ring, using
  the next command.

  # rpm --import bd-pack.key

  When you wish to check a rpm package, just issue a command  similar  to  the
  following. You should get no error.

  # rpm --checksig bitdefender-*.rpm

  In  case  you  are  using the deb packages, you have to run only one command
  over the deb files.

  # dpkg-sig --verify bitdefender-*.deb


4.2. Test the self-extractable archive
--------------------------------------

  To check the integrity of the self-extractable archive, you need to run  the
  following command and get the corresponding answer.

  # ./BitDefender-scanner-{ver}.{os}.{arch}.run --check
  Verifying archive integrity... MD5 checksums are OK. All good.


  If  you get a different answer, an error, please download the package again.


4.3. Test the FreeBSD tbz package
---------------------------------

  When installing the package downloaded from  the  BitDefender  servers,  you
  shoud run 'md5sum' on the package and compare the output with the value from
  the 'md5sums' file. This file is located in  the  same  directory  you  have
  downloaded the package from.

  When  installing  from  the ports collection, the integrity is automatically
  checked.



5. Install the package
======================

  The installation process depends on the package type.  There  are  different
  methods  for 'rpm', 'deb' and self-extractable archive, as well as a typical
  method for FreeBSD.


5.1. Install the rpm package
----------------------------

  To install BitDefender Antivirus  Scanner  for  Unices  on  a  RedHat  based
  distribution,  using  the  RedHat  package  manager,  you  have  to  run the
  following command.

  # rpm -i bitdefender-scanner-{ver}.{os}.{arch}.rpm


5.2. Install the deb package
----------------------------

  To install BitDefender Antivirus  Scanner  for  Unices  on  a  Debian  based
  distribution, using 'dpkg', you have to run the following command.

  # dpkg -i bitdefender-scanner-{ver}.{os}.{arch}.deb


5.3. Install the self-extractable archive
-----------------------------------------

  The  self-extractable archive is a package containing all the required files
  for the installation. It acts as a shell script (you can open it with a text
  editor)  and  can  be given several parameters in the command line. Usually,
  for a normal installation, there are no parameters required, simply run  the
  script.


5.3.1. Run the self-extractable archive

  This package should be installed using the following command.

  # ./BitDefender-scanner-{ver}.{os}.{arch}.run

  This  will  unpack  the BitDefender files (engines, core, etc.), the install
  and uninstall scripts, and will launch the installer, which, in  turn,  will
  install  all  the  provided BitDefender components, as described in the next
  section.


5.3.2. Additional parameters

  For the not-so-inpatient user, the  self-extractable  archive  supports  few
  command line parameters, described in the following table.

    ------------------------------------------------------------------------
    Parameter       Description
    ------------------------------------------------------------------------
    '--help'        Prints the short help messages.

    '--info'        This will print archive information, such as the title,
                    the default target directory, the embedded script to be
                    run  after  unpacking, the compression method used, the
                    uncompressed size, the date of packaging.

    '--list'        This option will print  the  content  of  the  embedded
                    archive.  The listed files are the engines, the program
                    binaries, the embedded documentation, the  install  and
                    uninstall script along with their size and permissions.

    '--check'       This is one of the  most  useful  options,  because  it
                    enables  the  user  to verify the package integrity, as
                    stated above. The integrity is  checked  comparing  the
                    embedded md5 checksum (generated during packaging) with
                    the one computed the moment of checking. If they match,
                    the output will be the following:

                    MD5 checksums are OK. All good.
                    If  not, an error message will be shown, displaying the
                    unequal stored and computed checksums, such as

                    Error in MD5 checksums: X is different from Y

    '--confirm'     The user will be asked to confirm  every  step  of  the
                    install process.

    '--keep'        By  default,  the  archive  content  is  extracted to a
                    temporary directory, which will be  removed  after  the
                    embedded installer exits. Passing this parameter to the
                    script will not remove the directory.

    '--target       You  can  specify  another  directory  to  extract  the
    directory'      archive to, if you don't want to use the default  name.
                    Note that this target directory will not be removed.

    '--uninstall'   Run the embedded  uninstaller  script  instead  of  the
                    normal installer.
    ------------------------------------------------------------------------


5.4. Install the FreeBSD package
--------------------------------

  To  install  BitDefender  Antivirus Scanner for Unices on a FreeBSD machine,
  you have two methods: you can install the package you have  downloaded  from
  the BitDefender servers or you can install from the ports collection.


5.4.1. Install a locally downloaded package

  To  install  a  local  downloaded  package,  run  the  next  command  in its
  directory.

  # pkg_add bitdefender-scanner-{ver}.tbz


5.4.2. Install from the ports collection

  To install from  the  ports  collection,  you  have  to  run  the  following
  commands.

  # cd /usr/ports/security/bitdefender-bdscan
  # make install clean



6. Uninstall
============

  If  you  ever need to remove BitDefender Antivirus Scanner for Unices, there
  are several methods to do it, depending on the package type.


6.1. Uninstall the rpm package
------------------------------

  To uninstall BitDefender Antivirus Scanner for  Unices  on  a  RedHat  based
  distribution,  using  the  RedHat  package  manager,  you  have  to  run the
  following command.

  # rpm -e bitdefender-scanner


6.2. Uninstall the deb package
------------------------------

  To uninstall BitDefender Antivirus Scanner for  Unices  on  a  Debian  based
  distribution, using 'dpkg', you have to run the following command.

  # dpkg -r bitdefender-scanner


6.3. Uninstall using the self-extractable archive
-------------------------------------------------

  To  proceed,  you need the original self-extractable install archive and use
  the method described  below.  This  is  necessary  since  the  program  will
  automatically undo all the settings used for integration with the system.

  All you have to do is to run the following command.

  # ./BitDefender-scanner-{ver}.{os}.{arch}.run --uninstall

  First,  the  installation  directory  is  requested from you. By default, it
  should  be  '/opt',  but  if  you  have  selected  another  one  during  the
  installation,  you have to specify it when asked. The uninstall program will
  check whether the directory is correct, by verifying whether  'bdscan'  file
  exists inside of it. If there is something wrong, the uninstall will quit.

  Next,  the  uninstall  procedure  begins by removing installation directory,
  '/opt/BitDefender-scanner'. The MANPATH environment variable is restored  to
  its  previous  value.  Finally, the '/usr/bin/bdscan' symlink is deleted. At
  this moment, the system should be left in the same condition as found before
  installing.


6.4. Uninstall the FreeBSD package
----------------------------------

  To  uninstall  the  FreeBSD  package, you have two methods, according to the
  installation way.


6.4.1. Uninstall a package downloaded locally

  To uninstall a package you have installed form a  local  download,  run  the
  next command.

  # pkg_delete bitdefender-scanner


6.4.2. Uninstall from the ports collection

  To  uninstall  the  package installed from the ports collection, you can use
  the previos method or run the following commands.

  # cd /usr/ports/security/bitdefender-bdscan
  # make deinstall clean


--
 BitDefender
 http://www.bitdefender.com/
