BitDefender Antivirus Scanner for Unices ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INSTALL Copyright (c) 2006 SOFTWIN 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 - Secure Your Every Bit http://www.bitdefender.com/