AIX errlogger example.

doc/aix-errlogger.md

@@ -0,0 +1,85 @@
+# AIX errlogger to remote syslog
+
+Instructions for how to forward errlogger messages from IBM AIX and IBM Power Systems VIO Servers to a remote logging solution.
+
+More information on the AIX errlogger is available on the IBM [knowledge center](https://www.ibm.com/support/knowledgecenter/ssw_aix_72/generalprogramming/error_notice.html).
+
+## On each AIX / VIO Server
+
+### Prepare the local syslog service
+
+Configure the local syslog service to forward messages to our remote [syslogd](https://bitbucket.org/mnellemann/syslogd/) service.
+
+Create an empty local log file:
+
+```shell
+touch /var/log/error.log
+```
+
+Add the following to the /etc/syslog.conf file:
+
+```text
+# Remote logging to remote host on port 514/UDP (AIX does not support non-default port number)
+*.warn @10.32.64.1
+
+# Also log to a local file, rotated daily and kept for 7 days
+*.warn /var/log/error.log rotate time 1d files 7
+```
+We use *10.32.64.1* as our remote syslog server in the above example.
+
+
+Restart the syslogd service:
+
+```shell
+refresh -s syslogd
+```
+
+### Forward errlogger to the local syslog
+
+We configure the errloger to forward messages to the local syslog service.
+
+Create an odm errnotify logging template file:
+
+```shell
+cat << EOF >/tmp/err.tpl
+errnotify:
+en_name = "syslog1"
+en_persistenceflg = 1
+en_method = "/usr/bin/logger -plocal0.err [errnotify] seq: \$1 - \$(/usr/bin/errpt -l \$1 | tail -1)"
+EOF
+```
+
+Add the template:
+
+```shell
+odmadd /tmp/err.tpl
+```
+
+
+Verify messages show up in the local syslog */var/log/error.log* file:
+
+```shell
+odmget -q"en_name='syslog1'" errnotify
+errlogger system Test
+```
+
+#### Notes
+
+If you need to delete the errnotify again:
+
+```shell
+odmdelete -o errnotify -q"en_name=syslog1"
+```
+
+To lookup err message details by a seq. no, run:
+
+```shell
+errpt -a -l [seq-no]
+```
+
+Or from the padmin shell:
+
+```shell
+errlog -ls -seq [seq-no]
+```
+