The syslog-ng Administrator Guide

Procedure 4.2. Installing syslog-ng on Debian-based systems

1. Use the your username and password received together with your syslog-ng Premium Edition license to download the following binaries. Make sure to download the package specific for the processor architecture of the host.

   • The syslog-ng Premium Edition package (syslog-ng-premium-edition_<version>) from

     http://www.balabit.com/downloads/files/syslog-ng/binaries/premium-edition/pool/s/syslog-ng-premium-edition/

   • The libdbi8 package from

     http://www.balabit.com/downloads/files/syslog-ng/binaries/premium-edition/pool/l/libdbi8/

   • If you plan to use an SQL destination (including Oracle), download the package corresponding to your database from

     http://www.balabit.com/downloads/files/syslog-ng/binaries/premium-edition/pool/l/libdbi8-drivers/

     If you plan to use a Microsoft SQL (MSSQL) destination, download the freetds driver.

   • If you plan to use the Oracle destination, download the Oracle Instant Client package corresponding to your platform from

     http://www.balabit.com/downloads/files/syslog-ng/binaries/premium-edition/pool/o/

2. Remove the existing system logging package from the host. Issue the following command as root if the host is running syslog: dpkg -r sysklogd, or dpkg -r syslog-ng if the host is running the open source version of syslog-ng.

3. Issue the following command as root:

   dpkg -i libdbi8_<version>_<arch>.deb syslog-ng-premium-edition_<version>_<arch>.deb

4. If you use an SQL destination, issue the command corresponding to the database:

   • For MSSQL:

     dpkg -i libdbd8-freetds_<version>_<arch>.deb

   • For MySQL:

     dpkg -i libdbd8-mysql_<version>_<arch>.deb

   • For Oracle:

     dpkg -i libdbd8-oracle_<version>_<arch>.deb

   • For PostgreSQL:

     dpkg -i libdbd8-pgsql_<version>_<arch>.deb

   • For SQLite:

     dpkg -i libdbd8-sqlite_<version>_<arch>.deb

5. Optional step: If you use an Oracle database destination, complete the following steps:

   Download Oracle Instant Client Basic Package version 10.2.0.X for your platform from http://www.oracle.com/technology/software/tech/oci/instantclient/index.html and unzip the package into a single directory (e.g., /usr/local/oracle/instantclient_10_2). You need to register to access the package, but registration is free.

   Note

   The syslog-ng application currently supports only Oracle Instant Client Basic Package version 10.2.0.X. This does not mean that you have to use version 10 of the Oracle database, because the different versions of the Instant Client all support the same protocol. Multiple versions of the Oracle Instant Client can be run simultaneously if other applications running on your system require a different version.

   Edit the /etc/init.d/syslog-ng file and add the following lines before the case block. Replace /usr/local/oracle/instantclient_10_2 with the actual path of Oracle Instant Client version 10.2.0.3.

   	Note
   	On Solaris 8 and 9, you have to edit the /etc/init.d/syslog file.

   LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/oracle/instantclient_10_2
   export LD_LIBRARY_PATH

6. Optional step: If Novell AppArmor is used on the computer, copy the /usr/share/doc/syslog-ng/sbin.syslog-ng file into the /etc/apparmor.d/ directory and restart AppArmor.

7. Optional step: When installing syslog-ng to the central syslog-ng server, copy the license.txt license file to the /etc/syslog-ng/ directory of the server.