The Syslog-Ng Open Source Edition 3.2 Administrator Guide
Total Page:16
File Type:pdf, Size:1020Kb
The syslog-ng Open Source Edition 3.2 Administrator Guide First Edition Publication date November 17, 2010 This manual is the primary documentation of the syslog-ng Open Source Edition 3.2 application. The syslog-ng Open Source Edition 3.2 Administrator Guide Product Marketing and Documentation Department Revision History First Revision November 17, 2010 Minor corrections and cleanup. Second draft Revision October 29, 2010 Updated to cover most of the new features in syslog-ng OSE 3.2beta1. First draft Revision October 7, 2010 Heavily restructured the original adminguide, and updated a few chapters for syslog-ng OSE 3.2. Update still in progress. Copyright © 2006-2010 BalaBit IT Security Ltd. This guide is published under the Creative Commons Attribution-Noncommercial-No Derivative Works (by-nc-nd) 3.0 license. The latest version is always available at http://www.balabit.com/support/documentation. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/). This product includes cryptographic software written by Eric Young ([email protected]) This documentation and the product it describes are considered protected by copyright according to the applicable laws. The syslog-ng™ name and the syslog-ng™ logo are registered trademarks of BalaBit. The BalaBit™ name and the BalaBit™ logo are registered trademarks of BalaBit. Linux™ is a registered trademark of Linus Torvalds. Debian™ is a registered trademark of Software in the Public Interest Inc. Windows™ XP, 2003 Server, Vista, and 2008 Server are registered trademarks of Microsoft Corporation. MySQL™ is a registered trademark of MySQL AB in the United States, the European Union and other countries. Oracle™, JD Edwards™, PeopleSoft™, and Siebel™ are registered trademarks of Oracle Corporation and/or its affiliates. Red Hat™, Inc., Red Hat™ Enterprise Linux™ and Red Hat™ Linux™ are trademarks of Red Hat, Inc. SUSE™ is a trademark of SUSE AG, a Novell business. Solaris™ is a registered trademark of Sun Microsystems, Inc. AIX™, AIX 5L™, AS/400™, BladeCenter™, eServer™, IBM™, the IBM™ logo, IBM System i™, IBM System i5™, IBM System x™, iSeries™, i5/OS™, Netfinity™, NetServer™, OpenPower™, OS/400™, PartnerWorld™, POWER™, ServerGuide™, ServerProven™, and xSeries™ are trademarks or registered trademarks of International Business Machines. Alliance Log Agent for System i™ is a registered trademark of Patrick Townsend & Associates, Inc. All other product names mentioned herein are the trademarks of their respective owners. Some rights reserved. DISCLAIMER BalaBit is not responsible for any third-party Web sites mentioned in this document. BalaBit does not endorse and is not responsible or liable for any content, advertising, products, or other material on or available from such sites or resources. BalaBit will not be responsible or liable for any damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through any such sites or resources. www.balabit.com 2 Table of Contents Preface .............................................................................................................................................. xi 1. Summary of contents ................................................................................................................ xi 2. Target audience and prerequisites .............................................................................................. xii 3. Products covered in this guide ................................................................................................... xii 4. Typographical conventions ....................................................................................................... xiii 5. Contact and support information ............................................................................................. xiii 5.1. Sales contact ................................................................................................................ xiv 5.2. Support contact ........................................................................................................... xiv 5.3. Training ...................................................................................................................... xiv 6. About this document .............................................................................................................. xiv 6.1. Summary of changes ..................................................................................................... xiv 6.2. Feedback ...................................................................................................................... xv 6.3. Acknowledgments ......................................................................................................... xv 1. Introduction to syslog-ng ................................................................................................................ 1 1.1. What syslog-ng is .................................................................................................................... 1 1.2. What syslog-ng is not .............................................................................................................. 1 1.3. Why is syslog-ng needed? ......................................................................................................... 2 1.4. What is new in syslog-ng Open Source Edition 3.2? .................................................................... 2 1.5. Who uses syslog-ng? ............................................................................................................... 2 1.6. Supported platforms ............................................................................................................... 3 2. The concepts of syslog-ng ............................................................................................................... 4 2.1. The philosophy of syslog-ng .................................................................................................... 4 2.2. Logging with syslog-ng ............................................................................................................ 4 2.2.1. The route of a log message in syslog-ng .......................................................................... 5 2.3. Modes of operation ................................................................................................................. 6 2.3.1. Client mode ................................................................................................................. 6 2.3.2. Relay mode .................................................................................................................. 7 2.3.3. Server mode ................................................................................................................ 7 2.4. Global objects ........................................................................................................................ 7 2.5. Timezones and daylight saving ................................................................................................. 8 2.5.1. A note on timezones and timestamps ............................................................................. 9 2.6. Stable and feature releases of syslog-ng OSE .............................................................................. 9 2.7. The license of syslog-ng OSE ................................................................................................. 10 2.8. High availability support ........................................................................................................ 10 2.9. The structure of a log message ................................................................................................ 10 2.9.1. BSD-syslog or legacy-syslog messages ........................................................................... 10 2.9.2. IETF-syslog messages ................................................................................................. 12 3. Installing syslog-ng ....................................................................................................................... 16 3.1. Installing syslog-ng using the .run installer ............................................................................... 16 3.1.1. Installing syslog-ng in client or relay mode ..................................................................... 17 3.1.2. Installing syslog-ng in server mode ............................................................................... 19 3.1.3. Installing syslog-ng without user-interaction .................................................................. 21 3.2. Installing syslog-ng on RPM-based platforms (Red Hat, SUSE, AIX) .......................................... 22 3.2.1. Installing syslog-ng on RPM-based systems ................................................................... 22 3.3. Installing syslog-ng on Debian-based platforms ........................................................................ 23 www.balabit.com iii 3.3.1. Installing syslog-ng on Debian-based systems ................................................................ 23 3.4. Compiling syslog-ng from source ............................................................................................ 23 3.4.1. Compiling syslog-ng from source ................................................................................. 23 3.5. Uninstalling syslog-ng ...........................................................................................................