| 1 |
.\" Copyright (c) International Business Machines Corp., 2007 |
| 2 |
.\" |
| 3 |
.\" This program is free software; you can redistribute it and/or |
| 4 |
.\" modify it under the terms of the GNU General Public License as |
| 5 |
.\" published by the Free Software Foundation; either version 2 of |
| 6 |
.\" the License, or (at your option) any later version. |
| 7 |
.\" |
| 8 |
.\" This program is distributed in the hope that it will be useful, |
| 9 |
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 10 |
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See |
| 11 |
.\" the GNU General Public License for more details. |
| 12 |
.\" |
| 13 |
.\" You should have received a copy of the GNU General Public License |
| 14 |
.\" along with this program; if not, write to the Free Software |
| 15 |
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, |
| 16 |
.\" MA 02111-1307 USA |
| 17 |
.\" |
| 18 |
.\" Changelog: |
| 19 |
.\" 2007-10-06, created by Klaus Heinrich Kiwi <[email protected]> |
| 20 |
.\" |
| 21 |
.TH ZOS\-REMOTE.CONF 5 "Oct 2007" "IBM" "System Administration Utilities" |
| 22 |
.SH NAME |
| 23 |
zos\-remote.conf \- the audisp-racf plugin configuration file |
| 24 |
.SH DESCRIPTION |
| 25 |
.B zos\-remote.conf |
| 26 |
controls the configuration for the |
| 27 |
.BR audispd\-zos\-remote (8) |
| 28 |
Audit dispatcher plugin. The default location for this file is |
| 29 |
.IR /etc/audit/zos\-remote.conf , |
| 30 |
however, a different file can be specified as the first argument to the |
| 31 |
.B audispd\-zos\-remote |
| 32 |
plugin. See |
| 33 |
.BR audispd\-zos\-remote (8) |
| 34 |
and |
| 35 |
.BR auditd (8). |
| 36 |
The options available are as follows: |
| 37 |
.TP |
| 38 |
.I server |
| 39 |
This is the IBM z/OS ITDS server hostname or IP address |
| 40 |
.TP |
| 41 |
.I port |
| 42 |
The port number where ITDS is running on the z/OS server. Default is 389 (ldap port) |
| 43 |
.TP |
| 44 |
.I user |
| 45 |
The z/OS RACF user ID which the audispd\-zos\-remote plugin will use to perform Remote Audit requests. This user needs READ access to FACILITY Class resource IRR.LDAP.REMOTE.AUDIT (See |
| 46 |
.BR audispd\-zos\-remote (8)). |
| 47 |
.TP |
| 48 |
.I password |
| 49 |
The password associated the the z/OS user ID configured above. |
| 50 |
.TP |
| 51 |
.I timeout |
| 52 |
The number in seconds that |
| 53 |
.B audispd\-zos\-remote |
| 54 |
plugin will wait before giving up in connection attempts and event submissions. The default value is 15 |
| 55 |
.TP |
| 56 |
.I q_depth |
| 57 |
The |
| 58 |
.B audispd\-zos\-remote |
| 59 |
plugin will queue inputted events to the maximum of |
| 60 |
.I q_depth |
| 61 |
events while trying to submit those remotely. This can handle burst of events or in case of a slow network connection. However, the |
| 62 |
.B audispd\-zos\-remote |
| 63 |
plugin will drop events in case the queue is full. The default queue depth is 64 - Increase this value in case you are experiencing event drop due to full queue |
| 64 |
.RB ( audispd\-zos\-remote |
| 65 |
will log this to syslog). |
| 66 |
.SH "SEE ALSO" |
| 67 |
.BR audispd\-zos\-remote (8) |
| 68 |
.SH AUTHOR |
| 69 |
Klaus Heinrich Kiwi <[email protected]> |