diff options
-rw-r--r-- | README.md | 33 |
1 files changed, 32 insertions, 1 deletions
@@ -1,10 +1,17 @@ # puppet-rsyslog +================ Manage rsyslog client and server via Puppet -## How to use +## REQUIREMENTS + +* Puppet >=2.6 if using parameterized classes +* Currently supports Ubuntu >=11.04 & Debian running rsyslog >=4.5 + +## USAGE ### Client + #### Using default values ``` class { 'rsyslog::client': } @@ -23,6 +30,7 @@ Manage rsyslog client and server via Puppet ``` ### Server + #### Using default values ``` class { 'rsyslog::server': } @@ -41,6 +49,29 @@ Manage rsyslog client and server via Puppet Both can be installed at the same time. + +## PARAMETERS + +The following lists all the class parameters this module accepts. + + RSYSLOG::SERVER CLASS PARAMETERS VALUES DESCRIPTION + -------------------------------------------------------------- + enable_tcp true,false Enable TCP listener. Defaults to true. + enable_udp true,false Enable UDP listener. Defaults to true. + server_dir STRING Folder where logs will be stored on the server. Defaults to '/srv/log/' + custom_config STRING Specify your own template to use for server config. Defaults to undef. Example usage: custom_config => 'rsyslog/my_config.erb' + high_precision_timestamps true,false Whether or not to use high precision timestamps. + + RSYSLOG::CLIENT CLASS PARAMETERS VALUES DESCRIPTION + -------------------------------------------------------------- + log_remote true,false Log Remotely. Defaults to true. + remote_type 'tcp','udp' Which protocol to use when logging remotely. Defaults to 'tcp'. + log_local true,false Log locally. Defualts to false. + log_auth_local true,false Just log auth facility locally. Defaults to false. + custom_config STRING Specify your own template to use for client config. Defaults to undef. Example usage: custom_config => 'rsyslog/my_config.erb + server STRING Rsyslog server to log to. Will be used in the client configuration file. + + ### Other notes Due to a missing feature in current RELP versions (InputRELPServerBindRuleset option), |