The syslog-ng Administrator Guide

Procedure 4.6. Installing syslog-ng on Sun Solaris 10

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/

   • The libiconv-1.11-sol9-sparc-local.gz and libgcc-3.4.6-sol9-sparc-local.gz packages from http://www.sunfreeware.com. These packages (originally created for Solaris 9) are required by the libdbi8 package.

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

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

     Also download the package corresponding to the database, architecture, and Solaris version you plan to use from http://www.sunfreeware.com. The Sunfreeware.com website includes details on installing the database, and any required dependencies.

     • For MySQL, download the mysql-5.0.41-sol9-sparc-local and openssl-0.9.8e-sol9-sparc-local packages.

     • For PostgreSQl, the required packages are available on the Solaris 10 installation DVD.

     • For SQLite, download the sqlite-3.3.6-sol9-sparc-local.gz package.

     	Note
     	The database packages contain the full database applications, but syslog-ng does not use the databases, only the .so file. Installing the database packages does not start the database services.

2. Download or copy the syslog-ng_<version_number>_sparc.pkg.gz package to your computer running Solaris.

3. Unpack and install the syslog-ng Premium Edition, the libdbi8, the libiconv and the libgcc packages by issuing the following commands from the command line:

   # gunzip libiconv-1.11-sol9-sparc-local.gz
   # gunzip libgcc-3.4.6-sol9-sparc-local.gz 
   # gunzip syslog-ng_<version_number>_sparc.pkg.gz
   # gunzip libdbi8_<version>_<arch>.gz
   # pkgadd -d libiconv-1.11-sol9-sparc-local.gz
   # pkgadd -d libgcc-3.4.6-sol9-sparc-local.gz
   # pkgadd -d syslog-ng_<version_number>_sparc.pkg
   # pkgadd -d libdbi8_<version>_<arch>.pkg

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

   • For MySQL:

     # gunzip mysql-5.0.41-sol9-sparc-local
     # gunzip openssl-0.9.8e-sol9-sparc-local
     # gunzip libdbd8-mysql_<version>_<arch>.gz
     # pkgadd -d mysql-5.0.41-sol9-sparc-local
     # pkgadd -d openssl-0.9.8e-sol9-sparc-local
     # pkgadd -d libdbd8-mysql_<version>_<arch>.pkg

   • For PostgreSQL:

     Make sure that the SUNWpostgr-libs package has been installed. It is available on the Solaris 10 installation DVD. (It is the part of the Postgresql software package in the installer. It is not the same as the Postgresql-8.2 package. If it is not already installed on the system, insert the Solaris 10 installation DVD, change to the Solaris_10/Product/ directory of the DVD (e.g., cd /cdrom/sol_10_807_sparc/s0/Solaris_10/Product/), and issue the following command:

     # pkgadd -d . SUNWpostgr-libs

     Issue the following commands to install the libdbi8 driver packages for PostgreSQL:

     # gunzip libdbd8-pgsql_<version>_<arch>.gz
     # pkgadd -d libdbd8-pgsql_<version>_<arch>.pkg

   • For SQLite:

     # gunzip sqlite-3.3.6-sol9-sparc-local.gz 
     # pkgadd -d sqlite-3.3.6-sol9-sparc-local
     # gunzip libdbd8-sqlite_<version>_<arch>.gz
     # pkgadd -d libdbd8-sqlite_<version>_<arch>.pkg

5. Rename the syslog-ng.conf.sample file (located under /opt/syslog-ng/etc/) to syslog-ng.conf.

   # mv /opt/syslog-ng/etc/syslog-ng.conf.sample /opt/syslog-ng/etc/syslog-ng.conf

6. Modify the syslog-ng.conf.to suit your needs. For details on how to configure syslog-ng, see The syslog-ng Administrator Guide, Chapter 3, Configuring syslog-ng.

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

8. Disable the original syslogd application.

   # svcadm -v disable svc:/system/system-log

9. Copy the following files to their proper places by issuing the following commands and modify them if needed.

   # cp /opt/syslog-ng/doc/syslog-ng.example.xml \ /var/svc/manifest/system/syslog-ng.xml
   # cp /opt/syslog-ng/doc/syslog-ng.method /lib/svc/method/syslog-ng

10. Validate and import the syslog-ng.xml file using svccfg.

    # svccfg
    svc:> validate /var/svc/manifest/system/syslog-ng.xml
    svc:> import /var/svc/manifest/system/syslog-ng.xml
    svc:> quit

11. Enable and start syslog-ng.

    # svcadm enable -t svc:/system/syslog-ng

12. Verify that syslog-ng is running.

    # svcs -a | grep syslog

    You should receive a similar output: online 10:15:01 svc:/system/syslog-ng:default